Mode poche

Nouveau dans la v2.7.0

Potato permet d'annoter depuis un téléphone ou une tablette. Activez le mode poche (Pocket Mode) et les appareils tactiles qui ouvrent votre tâche passent automatiquement à une interface mobile : une pile de cartes avec des boutons d'étiquette dans la zone du pouce, la navigation par balayage, l'annotation hors ligne avec synchronisation automatique et l'installation sur l'écran d'accueil sous forme de PWA. Sur ordinateur, l'interface habituelle ne change en rien.

Tous les types d'annotation n'ont pas leur place sur un téléphone. Le surlignage de spans et les boîtes englobantes sont des tâches de bureau. Potato l'assume explicitement : les tâches compatibles avec le tactile reçoivent l'interface mobile, celles qui ne le sont pas affichent un avertissement clair plutôt qu'une interface dégradée, et dans les deux cas le tableau de bord d'administration indique qui annote depuis quel type d'appareil.

Configuration

pocket:
  enabled: true        # master switch for the mobile interface (default: false)
  auto_redirect: true  # send phones/tablets to /pocket automatically (default: true)
  batch_size: 25       # items fetched per batch; also the offline queue depth (1-200)

Quels types d'annotation conviennent au mobile

Une tâche n'est compatible tactile que si tous ses schémas figurent dans la colonne de gauche. Une tâche qui mêle ne serait-ce qu'un schéma réservé au bureau n'est pas dégradée vers le tactile : les téléphones ne sont pas redirigés et voient un avis, que l'on peut fermer, signalant que la tâche n'est pas optimisée pour le mobile.

Si vous attendez des annotateurs sur mobile, concevez la tâche en conséquence. Une tâche à un seul radio est le cas idéal : une pression vaut un élément étiqueté.

Comment fonctionne l'aiguillage par appareil

La détection se fait en deux couches.

1. Côté serveur (User-Agent). Les téléphones et la plupart des tablettes s'identifient comme tels et sont redirigés avant même que la page de bureau ne s'affiche. Les clients d'API et les agents non reconnus comptent comme du bureau, si bien que les scripts et les intégrations ne sont jamais redirigés.
2. Côté client (test du pointeur). Certaines tablettes se font passer pour des ordinateurs de bureau. Safari sur iPadOS, par exemple, se présente comme un Mac. Un script sur la page d'annotation vérifie si le pointeur principal de l'appareil est grossier (un doigt) et redirige ces cas-là aussi. Les portables à écran tactile ne sont pas concernés, car leur pointeur principal est le pavé tactile.

L'aiguillage ne s'applique qu'aux annotateurs pendant la phase d'annotation. Les pages de consentement, de consignes et d'enquête ne sont pas touchées.

Depuis un ordinateur, on peut y aller volontairement : sur les tâches compatibles avec le mode poche, la barre de navigation affiche un lien Vue compacte vers /pocket, où la pile de cartes devient une vue d'étiquetage rapide à un clic par élément. Sur mobile, le lien Version ordinateur permet d'en sortir, et le choix vaut pour toute la session.

L'interface mobile

• Pile de cartes — un élément par carte. Balayez vers la gauche pour aller au suivant, vers la droite pour revenir au précédent, avec des boutons fléchés pour un usage sans tactile. Un retour haptique confirme chaque enregistrement sur les appareils qui le prennent en charge.
• Commandes dans la zone du pouce — les boutons d'étiquette occupent le tiers inférieur de l'écran, là où le pouce atteint vraiment. Les cibles tactiles font 48 px ou plus, les marges de zone sûre sont respectées sur les téléphones à encoche, et prefers-reduced-motion est pris en compte.
• Rendu des schémas — les tâches à un seul radio ou likert avancent d'elles-mêmes au toucher. Les cartes à plusieurs schémas affichent toutes les commandes plus un Enregistrer et suivant explicite.
• Annotation hors ligne — le lot en cours est préchargé et recopié dans localStorage. Si la connexion tombe, l'annotation continue, une pastille affiche "Offline — N saves queued", et la file se vide automatiquement à la reconnexion. Un service worker met en cache la coquille de l'application après la première visite, si bien que la page se charge sans connexion. Préchargez un lot en wifi, annotez n'importe où, puis synchronisez une fois l'appareil revenu dans la couverture réseau.
• Installation comme application — la page fournit un manifeste web, si bien que "Add to Home Screen" donne une application autonome avec sa propre icône.

Les enregistrements passent par le même point de terminaison /updateinstance et la même charge utile que la page de bureau. Le mode poche n'ajoute aucun nouveau chemin d'écriture : les exports, les statistiques d'accord, le tableau de bord d'administration et le contrôle qualité voient donc des annotations ordinaires.

L'onglet Appareils

Le tableau de bord d'administration gagne un onglet Appareils qui montre, pour chaque annotateur : le dernier appareil vu, le nombre de visites par classe d'appareil, combien de fois il a utilisé l'interface mobile et sa dernière visite. Une ligne de synthèse donne l'essentiel (« 3 utilisateurs sur 12 sont venus depuis un téléphone ou une tablette »).

Cela compte dans les deux sens. Si votre tâche n'est pas compatible tactile et que l'onglet Appareils montre malgré tout des annotateurs sur téléphone, ces annotateurs ont vu l'avertissement et ont continué : leur production mérite un coup d'œil. Et comme les visites sont suivies que le mode poche soit activé ou non, l'onglet répond à « activer le mode poche m'aiderait-il ? » avant même que vous ne l'activiez.

Les données vivent dans <output_annotation_dir>/pocket/device_visits.json, uniquement sous forme d'agrégats par utilisateur. Il n'y a aucun suivi par élément.

Dépannage

• Un téléphone n'est pas redirigé. Vérifiez que pocket.enabled et pocket.auto_redirect sont à true, que la tâche est compatible tactile (GET /pocket/api/routing indique capable: true) et que l'utilisateur n'a pas choisi « Version ordinateur » pour cette session.
• Un iPad reçoit la page de bureau au premier chargement. Safari sur iPadOS se présente comme un Mac, le serveur ne peut donc pas l'attraper. Le test du pointeur côté client le redirige dès que les scripts de la page s'exécutent.
• Un utilisateur a « terminé » sur mobile mais la page de bureau affiche des éléments restants. Il a peut-être des enregistrements hors ligne non synchronisés. La pastille de synchronisation montre la file, qui se vide quand l'appareil revient en ligne.

Pour aller plus loin

• Attribution des tâches — sur mobile, les annotateurs puisent dans la même file que tout le monde
• Tableau de bord d'administration — l'endroit où vit l'onglet Appareils
• Mener une étude sur Prolific et MTurk
• Documentation source