X-SCAN
INTEGRATION DANS
DES APPLICATIONS
TIERCEs
PÉRIMÈTRE
Ce document présente les 3 options possibles pour intégrer le support du X-SCAN dans une
application tierce
• Option 1 – Injection dans champ texte
• Option 2 - Intent Crosscall
• Option 3 – Intégration SDK
Les avantages et les limites de chaque méthode sont précisés ci-après
ETAPES D’UTILISATION DU X-SCAN
L’utilisation de X-SCAN avec une application tierce nécessite les 3 étapes suivantes :
configuration du
X-SCAN
Déclenchement du
X-SCAN
Traitement du
contenu scanné
Ces étapes sont gérées différemment selon le mode d’intégration choisi
OPTION 1 : INJECTION DANS CHAMP TEXTE
Principe
Aucune intégration n'est requise dans l'application tierce
Nécessite l’application X-TRACK pour la configuration et le contrôle de X-SCAN.
Le scan peut être déclenché via :
•
•
Un bouton programmable
Un bouton flottant
Le contenu du code scanné est inséré dans le champ texte sélectionné sur le smartphone.
Deux modes d’injection sont supportés :
•
•
Presse-papier (Plus rapide mais incompatible avec certaines applications comme Excel)
Appui clavier (Fiable mais plus lent)
OPTION 1 : INJECTION DANS CHAMP TEXTE
Expérience Utilisateur
Le contenu du code
scanné est injecté
dans le champ texte
sélectionné
Appui sur le bouton
programmable ou le
bouton flottant
Configuration du X-SCAN dans l’application X-TRACK
OPTION 2 : INTENT CROSSCALL
Principe
Effort d’intégration dans l’application tierce limité
Besoin d’utiliser l’application X-TRACK pour la configuration et le contrôle du X-SCAN
Le scan peut être déclenché via le bouton programmable ou le bouton flottant
À chaque scan réussi, un message Intent est diffusé avec les caractéristiques suivantes:
ACTION : com.crosscall.xtrack.action.BARCODE
VARIABLE : com.crosscall.xtrack.data_string
L’application tierce intercepte ce message et implémente la logique associée
OPTION 2 : INTENT CROSSCALL
Expérience Utilisateur
L’application tierce
intercepte l’intent et
implémente la logique
associée
Code scanned
35698500245
Appui sur le bouton
programmable ou le
bouton flottant
Configuration du X-SCAN dans l’application X-TRACK
OPTION 3 : INTÉGRATION SDK
Principe
Le X-SCAN est totalement géré par l’application tierce:
• La configuration de l’appareil
• Le déclenchement du scan
• Le traitement du code scanné
L’application X-TRACK n’est pas nécessaire dans le cas de l’utilisation du SDK
OPTION 3 : INTÉGRATION SDK
Intégration de la librairie
Ajout du fichier *.AAR addition dans Android STUDIO
OPTION 3 : INTÉGRATION SDK
Initialisation = Configuration du SDK et du X-SCAN
•
•
•
•
•
Symbologies (Types & Longueur)
Mode de lecture (Level, Pulse, Sense, Batch)
Mode centre
Réglages audio et vibration
Sensibilité
OPTION 3 : INTÉGRATION SDK
Initialisation = Configuration du SDK et du X-SCAN
OPTION 3 : INTÉGRATION SDK
Activation (en function du mode sélectionné)
•
•
•
•
Level Mode : Capture instantanée / Actif pendant 5 sec
Pulse mode : Capture instantanée / Actif tant que le bouton est maintenu appuyé
Sense mode : Détection de mouvement
Batch mode : Détection de lot / Exclusion de réplica
Une unique commande est utilisée pour lancer quel que soit le mode sélectionné. Le mode est
préalablement défini dans les réglages
OPTION 3 : INTÉGRATION SDK
Traitement des callbacks
Traitement des événements de scan propre à chaque application tierce
OPTION 3 : INTÉGRATION SDK
Désactivation
Déconnexion du X-SCAN
SYNTHÈSE
X-TRACK
OPTION 1 (INJECTION)
OPTION 2 (INTENT)
OPTION 3 (SDK)
Configuration du X-SCAN
Géré par X-TRACK
Géré par X-TRACK
Géré par l’application tierce
Déclenchement du X-SCAN
Géré par X-TRACK
Géré par X-TRACK
Géré par l’application tierce
Traitement du code scanné
Géré par X-TRACK
Géré par l’application tierce
Géré par l’application tierce
Effort d’intégration
Nul
Limité (1 à 2 jours)
Simple (2 à 3 jours)
Avantages
•
•
Aucune modification de
l’application tierce requise
Peut-être utilisé avec
n’importe quelle application
Android ou web dès lors
qu’elle dispose d’un champ
texte
•
•
Impact limité pour
l’application tierce
Fonctionne sans obligation
d’avoir un champ texte dans
l’application
•
•
•
•
Cible
•
•
Petite/Moyenne entreprises
sans équipe de
développement
Tests du X-SCAN
•
Entreprises avec équipe de
développement
•
X-TRACK non nécessaire
Meilleures performances de
scan
Contrôle total et dynamique
de la configuration du XSCAN (Gestion torche, mode
écran…)
Contrôle total de l’UX
Entreprises avec équipe de
développement
">
