Zum Hauptinhalt springen

Menschliche Unterstützung

LCC.assist ermöglicht es einem Geräteskript, eine Unterstützungsanfrage an die Zentrale zu senden. Das Skript kann einen Screenshot und Anweisungen anhängen, auf das Ergebnis der Bedienperson warten und anschließend fortfahren.

Anfragetypen​

TypAPIGeeignete SzenarienÜbliche Verarbeitung im Skript
TextantwortLCC.assist.ask_text()Captcha, SMS-Code, Passwort, Einmal-Tokenresult.text in das aktuelle Eingabefeld eingeben
Punkt auswählenLCC.assist.pick_point()Die Bedienperson muss eine Stelle auswählen, etwa eine Grafikschaltfläche oder eine Schaltfläche in einem FehlerdialogDirekt touch.tap(result.x, result.y) aufrufen
FernsteuerungLCC.assist.request_control()Schieber, Mensch-Maschine-Prüfungen, Anmeldung, Sicherheitsprüfungen, Berechtigungsdialoge und andere instabile AbläufeNach Abschluss der Fernsteuerung erneut screenshotten und weiterprüfen

Anweisungen für die Bedienperson sollten konkret und ausführbar sein. Vermeiden Sie abstrakte Angaben wie „Weitere Informationen“ und schreiben Sie beispielsweise „Steuern Sie das Gerät fern, schließen Sie die aktuelle Prüfung ab und klicken Sie auf Erledigt“, „Geben Sie das Captcha aus dem Screenshot ein“ oder „Klicken Sie auf die Mitte der Bestätigungsschaltfläche“.

Screenshot-Quellen​

Eine Unterstützungsanfrage kann auf mehrere Arten ein Bild enthalten:

  • screenshotLocalPath: Lokaler Bildpfad auf dem Gerät; das SDK lädt das Bild als temporäre Ressource auf die Zentrale hoch.
  • screenshotPath: relativer Pfad, wenn das Bild bereits unter dem files-Stammverzeichnis der Zentrale liegt.
  • screenshotImage: XXTouch-ImageObject; das SDK wandelt es ohne vorheriges Speichern in eine Data-URL um.
  • screenshotImageData: binäre PNG-/JPEG-Bilddaten; das SDK wandelt sie in eine Data-URL um.
  • input.imageSrc: Wenn das Skript bereits eine Bildadresse wie data:image/..., http(s)://... oder /api/... besitzt, kann sie in input zur Anzeige an das Frontend weitergereicht werden.

Das SDK überschreibt input.imageSrc nicht. Nur wenn weder input.imageSrc noch ein Screenshotpfad übergeben wurde, wandelt es screenshotImage oder screenshotImageData in input.imageSrc um.

Lebenszyklus​

Anfragestatus sind pending (wartend), active (in Bearbeitung), submitted (Ergebnis übermittelt), cancelled (abgebrochen) und expired (abgelaufen). Nur submitted bedeutet, dass ein menschliches Ergebnis vorliegt.

Bei einem Warte-Timeout versucht LCC.assist.request(), die Anfrage abzubrechen. Beim regulären Skriptende wird versucht, die offenen Anfragen der aktuellen Instanz abzubrechen. Aufgaben und Ergebnisse bleiben nach einem Neustart der Zentrale nicht erhalten; speichern Sie später benötigte Ergebnisse separat.

Wenn die Zentrale den Stoppstatus eines Geräts erhält, bricht sie dessen lua-script-Hilfsanfragen im Status pending / active ab. Dieser gebündelte Abbruch betrifft weder andere Geräte oder Quellen noch bereits übermittelte Ergebnisse.

Automatisch hochgeladene Screenshots werden beim Start der Zentrale gelöscht. Speichern Sie für eine dauerhafte Wiederverwendung eine Kopie unter einem selbst verwalteten Ressourcenpfad; behandeln Sie den erzeugten screenshotPath nicht als dauerhaften Dateiverweis.

Eingebettete Bilder werden nach dem Übermitteln des Ergebnisses, Abbrechen oder Ablaufen einer Anfrage nicht mehr gespeichert.

API-Übersicht​