Documentation / Guides / Scanner des billets
Spécification du protocoleRéférence APIGuides
Documentation / Guides / Scanner des billets
GUIDE · V1

Scanner des billets

Scan par caméra, résultats de validation, flux de check-in

Ouvrir le scanner

Appuyez sur Scanner des billets depuis l'écran d'accueil pour ouvrir le scanner de la caméra.

Si c'est votre première utilisation, l'application vous demandera l'autorisation d'accéder à la caméra. Vous devez l'accorder pour utiliser le scanner.

Vue caméra

Le scanner affiche :

  • Flux vidéo de la caméra en plein écran
  • Un cadre de superposition indiquant où viser
  • Un compteur de scans de session en bas (par ex., « 5 scannés »)
  • Un bouton de fermeture dans le coin supérieur

Scanner un QR code

  1. Pointez la caméra vers un QR code de billet
  2. Le code est détecté automatiquement
  3. Une vibration haptique confirme la détection
  4. La fenêtre modale de résultat apparaît

Un délai anti-rebond de 3 secondes empêche le même QR code d'être scanné deux fois en succession rapide.

Fenêtre modale de résultat

Après le scan, une fenêtre modale affiche le résultat de la validation.

Icône de statut

Le haut de la fenêtre modale affiche un cercle coloré avec une icône :

  • Cercle vert avec coche pour les billets valides
  • Cercle ambre avec triangle d'avertissement pour les conditions d'avertissement
  • Cercle rouge avec X pour les erreurs

Détails du billet

Si le QR code contient des données de billet valides, la fenêtre modale affiche :

Champ Description
Détenteur Nom du détenteur du billet
Type Type de billet (par ex., « Entrée générale »)
Événement Nom de l'événement
Date Date et heure de l'événement
Enregistré à Heure du check-in précédent (uniquement pour les billets déjà utilisés)

Statuts des résultats de scan

Statut Icône Couleur Signification
Billet valide Coche Vert Le billet est valide et prêt pour le check-in
Déjà enregistré Avertissement Ambre Le billet a déjà été scanné ; l'heure du check-in est affichée
Billet révoqué X Rouge Le billet a été révoqué par l'organisateur
Billet expiré Avertissement Ambre La date d'expiration du billet est passée
Mauvais événement Avertissement Ambre Le billet est pour un événement différent de ceux pour lesquels ce scanner est enregistré
Billet non trouvé X Rouge L'identifiant du billet n'est pas reconnu par le serveur
Billet invalide X Rouge La vérification de la signature numérique a échoué (possible contrefaçon)
QR code invalide X Rouge Le QR code n'est pas dans un format de billet valide
Non enregistré Avertissement Ambre Le scanner n'est pas enregistré pour l'événement de ce billet. Affiche le nom de l'événement
Émetteur inconnu Avertissement Ambre La clé publique de l'émetteur n'a pas été trouvée ; impossible de vérifier la signature
Déjà utilisé (local) Avertissement Ambre Déjà scanné localement dans cette session (détection de doublon hors ligne)
Mauvaise porte Avertissement Ambre Le billet est valide mais n'est pas assigné à la porte de ce scanner

Flux de check-in

Lorsqu'un billet est Valide :

  1. La fenêtre modale affiche les détails du billet et un bouton Marquer comme utilisé
  2. Appuyez sur Marquer comme utilisé pour enregistrer le participant
  3. L'application envoie le check-in au serveur
  4. En cas de succès : retour haptique vert, la fenêtre modale se ferme et le compteur de scans s'incrémente
  5. Si vous ne souhaitez pas enregistrer le participant, appuyez sur Annuler pour fermer la fenêtre modale

Pour tous les autres statuts, la fenêtre modale affiche un bouton Fermer pour continuer à scanner.

Check-in hors ligne

Si le serveur est inaccessible lorsque vous appuyez sur Marquer comme utilisé :

  1. Le check-in est mis en file d'attente localement
  2. La fenêtre modale affiche « Admis (synchronisation en attente) »
  3. Un retour haptique vert confirme l'admission
  4. Le check-in est enregistré dans l'historique de scan local avec le statut « Synchronisation en attente »

Le check-in en file d'attente sera synchronisé automatiquement lorsque la connectivité sera rétablie. Voir Mode hors ligne pour plus de détails.

Conseils

  • Tenez le téléphone stable à environ 15-20 cm du QR code pour de meilleurs résultats
  • Assurez-vous d'un éclairage suffisant ; la caméra doit pouvoir voir clairement le QR code
  • Si un QR code n'est pas détecté, essayez d'ajuster l'angle ou la distance
  • Le compteur de session se réinitialise chaque fois que vous quittez et revenez au scanner