Assistance humaine
LCC.assist permet aux scripts exécutés sur l'appareil d'envoyer des demandes d'assistance humaine au centre de contrôle. Le script peut joindre une capture d'écran et des instructions, attendre de manière bloquante la réponse de l'opérateur, puis poursuivre son exécution.
Types de demandes
| Type | API | Cas d'utilisation | Traitement habituel du script |
|---|---|---|---|
| Réponse textuelle | LCC.assist.ask_text() | CAPTCHA, code SMS, mot de passe, jeton à usage unique | Saisir result.text dans le champ actif |
| Sélection de coordonnées | LCC.assist.pick_point() | L'opérateur doit décider où cliquer, par exemple un bouton graphique ou une boîte de dialogue d'erreur | Appeler directement touch.tap(result.x, result.y) |
| Contrôle humain à distance | LCC.assist.request_control() | Curseur, vérification anti-robot, connexion, contrôle de sécurité, boîte de dialogue d'autorisation ou autre flux instable | Une fois le contrôle à distance terminé, reprendre une capture d'écran et réévaluer l'écran |
Les instructions destinées à l'opérateur doivent être concrètes et exécutables. N'écrivez pas une indication abstraite comme « informations complémentaires ». Préférez « Contrôlez l'appareil à distance, terminez la vérification puis cliquez sur Terminé », « Saisissez le code affiché sur la capture » ou « Cliquez au centre du bouton de confirmation ».
Sources des captures d'écran
Une demande d'assistance peut recevoir une image de plusieurs façons :
screenshotLocalPath: Chemin d’une image locale sur l’appareil ; le SDK l’envoie au centre de contrôle comme ressource temporaire.screenshotPath: si l'image se trouve déjà sous la racinefilesdu centre de contrôle, transmettez directement son chemin relatif.screenshotImage:ImageObjectde XXTouch ; le SDK le convertit en data URL sans enregistrer préalablement un fichier.screenshotImageData: données binaires d'une image PNG/JPEG ; le SDK les convertit en data URL.input.imageSrc: si le script possède déjà une adresse d'imagedata:image/...,http(s)://...ou/api/..., transmettez-la dansinputafin que l'interface l'affiche.
input.imageSrc n'est pas remplacé par le SDK. Ce n'est que si input.imageSrc et les captures par chemin ne sont pas fournis que le SDK convertit screenshotImage ou screenshotImageData en input.imageSrc.
Cycle de vie
Les états sont pending (en attente), active (en cours), submitted (résultat envoyé), cancelled (annulée) et expired (expirée). Seul submitted indique qu’un résultat humain est disponible.
Si l’attente de LCC.assist.request() expire, une annulation de la demande est tentée. À la fin normale du script, une annulation des demandes inachevées de l’instance courante est tentée. Les tâches et les résultats ne sont pas conservés après le redémarrage du centre de contrôle ; enregistrez séparément les résultats à réutiliser.
Lorsque le centre de contrôle reçoit l’état d’arrêt d’un appareil, il annule ses demandes d’aide lua-script encore en pending / active. Cette annulation groupée ne touche ni les autres appareils, ni les autres sources, ni les résultats déjà soumis.
Les captures envoyées automatiquement sont supprimées au démarrage du centre de contrôle. Pour les réutiliser durablement, conservez une copie dans un chemin de ressources que vous gérez ; ne considérez pas le screenshotPath généré comme une référence permanente.
Les images intégrées ne sont plus conservées après l’envoi du résultat, l’annulation ou l’expiration de la demande.
Liste des API
- Options communes et objets de retour
- Créer une demande d'assistance humaine
LCC.assist.create() - Attendre le résultat de l'assistance humaine
LCC.assist.wait() - Créer puis attendre une demande
LCC.assist.request() - Demander une réponse textuelle
LCC.assist.ask_text() - Demander une sélection de coordonnées
LCC.assist.pick_point() - Demander un contrôle humain à distance
LCC.assist.request_control() - Révoquer une demande précise
LCC.assist.cancel() - Révoquer les demandes du script courant
LCC.assist.cancel_all()