Synthèse
Un environnement de développement Rokid Glass3 permet à une équipe en entreprise de créer des applications Android pour [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) et de tester la communication avec un téléphone Android. Commencez par le firmware entreprise, Android Studio, le JDK 17, le dépôt Maven de Rokid et le câble de débogage de données Glass3. Le câble de charge ordinaire ne permet ni d'installer ni de déboguer l'application des lunettes.
Cette procédure sous Windows 11 ouvre les deux projets de démonstration officiels de Rokid, vérifie leur configuration de build, installe chaque application et envoie un exemple de message de travail aux lunettes. Elle s'appuie sur le SDK entreprise et sur un test de communication local. Les services vocaux et d'IA en ligne relèvent d'intégrations distinctes. Les instructions ont été vérifiées par rapport à la documentation officielle et au code source de la démo ; aucun essai sur appareil physique n'a été réalisé.
Pour le contexte matériel, consultez la page produit Rokid AI Glasses Enterprise. Rokid documente l'architecture et l'environnement d'exécution de cet appareil entreprise dans le cadre du Glass3 Enterprise SDK. Vérifiez auprès de votre fournisseur l'appareil livré et son firmware avant de considérer un autre produit Rokid comme compatible.
Configuration requise pour le développement Rokid Glass3
Matériel : PC sous Windows 11, Rokid Glass3 Enterprise (firmware entreprise), téléphone Android de test dédié (Android 13 ou ultérieur recommandé) et le câble de débogage de données Glass3.
Logiciels : Android Studio avec Android SDK Platform 34 et Build-Tools 35.0.0.
Environnement de build : JDK 17, AGP 8.4.2, Gradle 8.6 et Kotlin 2.2.0.
SDK : Glasses SDK et Phone SDK 2.2.0-E.
Étape 1 Préparer le matériel entreprise
· Vérifier le système : Le firmware est le logiciel système intégré des lunettes. Demandez à votre fournisseur le modèle des lunettes, la version du firmware entreprise installée et la compatibilité du SDK. Selon la FAQ de Rokid, les versions professionnelles contiennent généralement un e dans leur numéro de version. Utilisez la démo entreprise avec un firmware entreprise. Le nom du produit ne suffit pas à établir la compatibilité.
· Vérifier le câble : Procurez-vous explicitement le câble de débogage de données Glass3. Branchez-le directement sur l'ordinateur de développement lors de l'installation de la démo. Une charge réussie ne prouve pas que la transmission de données USB fonctionne.
· Préparer le test : Chargez les deux appareils et gardez-les à proximité l'un de l'autre. Utilisez un téléphone dédié et l'exemple de message de l'étape 10. Avant l'appairage, déconnectez tout autre téléphone précédemment connecté à ces lunettes.
Câble de débogage de données Glass3 présenté dans le guide de démarrage rapide de Rokid. C'est le câble requis pour le développement en mode filaire.
Câble de charge Glass3 ordinaire présenté par Rokid. Il ne peut pas remplacer le câble de débogage de données. Vérifiez la fonction du câble fourni auprès du vendeur.
Étape 2 Installer Android Studio et le SDK Android (si c'est déjà fait, passez à l'étape suivante)
· Télécharger le programme d'installation : Téléchargez et installez Android Studio depuis https://developer.android.com/studio.
· Ouvrir l'application : Ouvrez Android Studio. Au premier lancement, sélectionnez Do not import settings si cette option est proposée, puis choisissez l'option Standard de configuration. Passez en revue les licences du SDK, acceptez celles approuvées par votre entreprise et terminez le téléchargement des composants.
· Installer les paquets requis : Depuis l'écran d'accueil, cliquez sur More Actions > SDK Manager. Sous SDK Platforms, sélectionnez Android 14 / API 34. Sous SDK Tools, sélectionnez Android SDK Platform-Tools. Activez Show Package Details, développez Android SDK Build-Tools et sélectionnez 35.0.0. À noter : le plugin Android Gradle de la démo installe, lors de la première synchronisation, les build tools 34.0.0 dont il a besoin. Cliquez sur Apply, vérifiez la liste des paquets, puis cliquez sur OK pour lancer l'installation.
· Noter l'emplacement du SDK : Notez le chemin indiqué dans Android SDK Location pour configurer ADB à l'étape 8.
Étape 3 Télécharger et ouvrir les deux projets de démonstration
· Récupérer le code source : Dans votre navigateur, accédez au dépôt officiel de la démo entreprise Glass3 (par exemple https://github.com/RokidSuuport/glass3_sdk_demo.git – à noter qu'il s'agit bien du dépôt Git officiel, même si « Support » y est mal orthographié) ou au dépôt Git fourni par votre fournisseur. Cliquez sur le bouton vert Code, puis sur Download ZIP. Dans Explorateur de fichiers > Téléchargements, faites un clic droit sur le fichier ZIP et sélectionnez Extraire tout > Extraire. Conservez le dossier extrait dans un emplacement de développement approuvé par l'entreprise.
· Ouvrir le projet téléphone : Dans l'écran d'accueil d'Android Studio, cliquez sur Open. Parcourez le dossier extrait, sélectionnez glass3sdkphonedemo et cliquez sur OK. Si une demande de confiance s'affiche, vérifiez qu'il s'agit bien de la source officielle que vous avez téléchargée avant de l'approuver. Le dossier racine du dépôt n'est pas le projet Android.
· Ouvrir le projet lunettes : Choisissez File > Open, sélectionnez le dossier voisin glassdemo et choisissez New Window lorsque vous y êtes invité. Gardez les deux fenêtres ouvertes. Chacune possède sa propre configuration Gradle et un module app, la partie qui produit l'application installable.
· Utiliser la vue des fichiers : Dans chaque fenêtre, ouvrez View > Tool Windows > Project. Dans la liste déroulante en haut du panneau de gauche, choisissez Project. Cela affiche les dossiers et fichiers réels utilisés ci-dessous. Si la première synchronisation signale une erreur, effectuez les étapes 4 et 5 avant de réessayer.
Étape 4 Sélectionner le JDK 17 pour les deux projets
· Ouvrir les paramètres Gradle : Dans la fenêtre du projet téléphone, choisissez File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Repérez la liste déroulante Gradle JDK. Elle détermine la version de Java utilisée pour compiler le projet, indépendamment de l'environnement d'exécution Java qui lance Android Studio.
· Sélectionner ou télécharger Java 17 : Choisissez un JDK installé portant la mention 17. S'il n'y en a aucun, choisissez Download JDK, sélectionnez Version 17, choisissez un fournisseur approuvé par le service informatique et cliquez sur Download. Sélectionnez le JDK téléchargé dans Gradle JDK, puis cliquez sur Apply > OK. Répétez l'opération dans la fenêtre du projet lunettes.
· Conserver les cibles de code existantes : Dans la démo, sourceCompatibility, targetCompatibility et le paramètre Kotlin jvmTarget sont définis sur 1.8. Ils décrivent la compatibilité du code compilé ; ils ne signifient pas que Gradle doit s'exécuter sur le JDK 8. Laissez-les inchangés pour cette démo. Le guide de Google sur la compilation Java fait la distinction entre ces paramètres.
Étape 5 Vérifier les dépendances Maven et aligner les outils de build
Un dépôt Maven est un serveur sur lequel Gradle trouve les paquets de bibliothèques, y compris le SDK de Rokid.
· Vérifier le dépôt : Dans le panneau de gauche de chaque projet, double-cliquez sur settings.gradle. Repérez dependencyResolutionManagement > repositories et vérifiez que l'URL Maven de Rokid ci-dessous est présente. Ajoutez uniquement la ligne manquante à l'intérieur du bloc existant. Conservez les autres dépôts de la démo, nécessaires à ses autres dépendances ; si un proxy d'entreprise les bloque, demandez au service informatique d'en autoriser l'accès.
// Dans settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Vérifier les deux paquets SDK : Ouvrez app > build.gradle dans chaque fenêtre. Dans dependencies, conservez une seule entrée active pour le SDK approprié. Les extraits ci-dessous sont en Groovy, la syntaxe utilisée par cette démo. N'ajoutez pas le SDK des lunettes au projet téléphone et ne collez pas un second bloc dependencies. org.slf4j est un groupe de bibliothèques de journalisation ; l'exclusion évite les classes de journalisation en double.
// glassdemo/app/build.gradle > dependencies
implementation("com.rokid.security:glass3.open.sdk:2.2.0-E") {
exclude group: "org.slf4j"
}
// glass3sdkphonedemo/app/build.gradle > dependencies
implementation("com.rokid.security:phone.sdk:2.2.0-E") {
exclude group: "org.slf4j"
}
· Aligner AGP et Gradle : Kotlin est le langage de programmation utilisé par ces démos. Pour la version examinée, ouvrez gradle > libs.versions.toml dans les deux projets. Sous [versions], modifiez uniquement agp pour le définir sur 8.4.2 si ce n'est pas déjà le cas ; conservez kotlin = "2.2.0". Ouvrez ensuite gradle > wrapper > gradle-wrapper.properties et remplacez uniquement distributionUrl par la ligne ci-dessous. Le wrapper télécharge la version de Gradle choisie. Google documente la correspondance entre Gradle et le JDK pour AGP 8.10.
# gradle/libs.versions.toml > [versions]
agp = "8.4.2"
kotlin = "2.2.0"
# gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
· Synchroniser et vérifier le résultat : Enregistrez les fichiers modifiés, puis choisissez File > Sync Project with Gradle Files dans les deux fenêtres. Ouvrez View > Tool Windows > Build et vérifiez la sortie de la synchronisation. N'acceptez pas les mises à niveau automatiques sans rapport. La démo inclut déjà des règles d'empaquetage des bibliothèques natives ; conservez-les. Une bibliothèque native est du code compilé pour l'appareil, empaqueté avec l'APK.
Étape 6 Configurer une démo métier locale
· Désactiver les services en ligne pour ce test : Dans le projet téléphone, ouvrez app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. En haut de MainPhoneActivity.kt, conservez l'import NetServiceType existant. S'il est absent, ajoutez la ligne suivante avec les autres imports :
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Repérez ensuite banServiceList dans initSDK(). Remplacez sa déclaration active par la ligne ci-dessous. Conservez les champs vides existants de UserAuthInfo ainsi que les identifiants client. La source documente cette option pour désactiver les services réseau ; elle ne désactive pas le test Bluetooth local.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Garder les futurs identifiants à part : AK est une clé d'accès et SK le secret associé. Pour les services authentifiés ultérieurs, demandez les identifiants de service entreprise à votre contact commercial ou partenaire chez Rokid. Dans UserAuthInfo, appId reçoit l'AK et secret reçoit le SK. Utilisez une configuration de projet protégée pour les identifiants de test et ne commitez jamais de vraies clés. Ce premier essai local ne nécessite pas ces fonctionnalités en ligne.
· Ajouter des logs d'initialisation en anglais : dans le projet téléphone, ouvrez app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Dans initSDK(), ajoutez un log en anglais dans le callback de succès :
Kotlin
Log.d(TAG, “Phone SDK ready”)
Dans le projet lunettes, ouvrez app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() appelle GlassSdkUtils.initSdk(), puis collecte GlobalData.sdkInitState ; dans ce collecteur, juste après la ligne Log.d(TAG, “SDK 初始化成功”), ajoutez le log en anglais :
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Remarque : si Android Studio surligne des références de classe en rouge, appuyez sur Alt + Entrée pour importer automatiquement les paquets requis.)
· Éviter de modifier le comportement au démarrage : Dans le projet lunettes, ouvrez app > src > main > java > com > rokid > glass > HomeActivity.kt. Dans onCreate(), mettez en commentaire la ligne existante suivante en ajoutant // à son début. Cette ligne configure le lancement automatique après un redémarrage ; elle n'est pas nécessaire pour un premier test sur un appareil d'entreprise.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Limiter le test de réception au texte : Dans le même dossier com > rokid > glass, ouvrez MessageReceiveActivity.kt. Remplacez uniquement sa fonction onTextMessage dans mMessageListener par le code ci-dessous. Le texte reçu reste affiché et journalisé, sans faire appel aux services vocaux. Un callback est une fonction que le SDK appelle lorsqu'un événement survient.
override fun onTextMessage(msg: String) {
log(msg)
}
Étape 7 Compiler et lancer l'application téléphone
· Activer le débogage USB du téléphone : Sur le téléphone de test, ouvrez Paramètres et utilisez le champ de recherche pour trouver Numéro de build. Ouvrez la page d'informations sur l'appareil correspondante et appuyez sept fois sur Numéro de build ; saisissez le code PIN de l'appareil si demandé. Revenez aux Paramètres, recherchez Options pour les développeurs, ouvrez-les et activez Débogage USB. L'emplacement des menus varie selon le fabricant du téléphone.
· Connecter et autoriser : Branchez le téléphone à l'ordinateur avec son câble de données USB. Dans la boîte de dialogue Autoriser le débogage USB ? du téléphone, vérifiez qu'il s'agit bien de l'ordinateur de développement et appuyez sur Autoriser. Dans la barre d'outils supérieure du projet téléphone, choisissez app comme configuration d'exécution et sélectionnez le téléphone connecté dans la liste déroulante des appareils, juste à côté.
· Lancer l'application : Cliquez sur le triangle vert Run ou choisissez Run > Run app. Android Studio compile, installe et ouvre la démo téléphone. Le nom de l'application examinée peut être Rokid Enterprise Demo ou rokid白板, et l'interface de la démo est probablement en chinois. Dans les boîtes de dialogue d'autorisation, accordez l'accès Appareils à proximité et l'accès Wi-Fi nécessaires à ce test ; les versions plus anciennes d'Android peuvent demander l'accès à la localisation. Si vous les avez refusés auparavant, passez par Paramètres > Applications > la démo > Autorisations pour modifier l'autorisation concernée.
· Vérifier l'initialisation : Ouvrez View > Tool Windows > Logcat, sélectionnez le téléphone et saisissez package:com.rokid.phone dans le champ de filtre. Recherchez Phone SDK ready, qui indique que l'initialisation du SDK téléphone a réussi. Laissez l'application ouverte. Si la politique du téléphone de test bloque le débogage ou les autorisations requises, demandez au service informatique de configurer cet appareil de développement dédié avant de continuer.
Étape 8 Connecter les lunettes et lancer leur application
Vérifier les paramètres développeur des lunettes : Sur les Rokid Glass3, accédez à Settings > System > Developer Options et vérifiez que USB Debugging est sur ON. Si le menu des options est verrouillé ou masqué sur votre build entreprise, contactez votre distributeur matériel pour qu'il flashe/provisionne un firmware avec les options développeur activées avant de poursuivre.
· Vérifier ADB avec le bon câble : Branchez les lunettes allumées à l'aide du câble de débogage de données Glass3. Dans le projet lunettes, choisissez View > Tool Windows > Terminal. Tapez cd " suivi de l'emplacement du SDK noté à l'étape 2, puis \platform-tools", et appuyez sur Entrée. Dans ce dossier, exécutez la commande ci-dessous. Le numéro de série est l'identifiant de l'appareil affiché dans la première colonne.
.\adb.exe devices -l
· Lire l'état de l'appareil : Recherchez le numéro de série des lunettes suivi de device, et non de offline ou unauthorized. Si une boîte de dialogue d'autorisation s'affiche sur les lunettes, approuvez cet ordinateur de développement. Si rien ne s'affiche, vérifiez d'abord le câble et le port USB. Les builds entreprise peuvent restreindre le débogage ; s'il est bloqué, demandez au fournisseur de mettre en place l'accès de développement documenté. N'appliquez pas à la place les instructions de l'application compagnon grand public.
· Installer et lancer : Dans la barre d'outils du projet lunettes, sélectionnez app, choisissez la cible lunettes, par exemple Rokid RG-glasses, et cliquez sur Run. Le nom de l'application est glassdemo. Ouvrez Logcat, sélectionnez les lunettes et filtrez avec package:com.rokid.glesse. Recherchez Glasses SDK ready, le log ajouté à l'étape 6, qui confirme la réussite de l'initialisation du SDK.
· Afficher l'interface en miroir : scrcpy est un outil Android d'affichage et de contrôle d'écran ; son utilisation filaire est documentée par Rokid. Ouvrez les instructions officielles de scrcpy pour Windows, téléchargez le ZIP Windows 64 bits et utilisez Extraire tout dans l'Explorateur de fichiers. Ouvrez le dossier extrait et double-cliquez sur open_a_terminal_here.bat. Exécutez adb devices, puis la commande ci-dessous, en remplaçant GLASSES_SERIAL par le numéro de série des lunettes. La fenêtre miroir vous permet de cliquer dans l'interface des lunettes avec la souris de l'ordinateur.
scrcpy -s GLASSES_SERIAL --no-audio
Étape 9 Appairer les démos entreprise
· Ouvrir l'écran de connexion du téléphone : Dans Rokid Enterprise Demo, appuyez sur l'icône + en haut à droite pour ouvrir Discover Bluetooth. Pour la version chinoise, dans la démo téléphone (rokid 白板), sur la page 设备 (Device), appuyez sur l'icône + en haut à droite pour ouvrir 发现蓝牙 (Discover Bluetooth). Dans la mise en page active de cette révision du code source, il n'y a pas d'onglet Device en bas de l'écran. Cet écran lance une recherche ; choisissez l'entrée Glass3_… correspondant à vos lunettes. Si la recherche se bloque, appuyez sur l'icône d'actualisation de cet écran.
· Finaliser l'appairage : Acceptez toute boîte de dialogue d'appairage Bluetooth Android qui s'affiche et vérifiez si une demande de connexion apparaît sur les lunettes. Attendez que l'indicateur de connexion de l'écran Device du téléphone indique que le Bluetooth Classic est connecté. Si la page de recherche ou de connexion reste ouverte après l'appairage, appuyez sur la commande Retour d'Android pour revenir à Device. Le Bluetooth doit être activé sur les deux appareils, et les lunettes ne doivent être connectées à aucun autre téléphone. La page de dépannage Bluetooth de Rokid répertorie ces vérifications.
· Commencer par un test simple : La démo peut aussi négocier une connexion Wi-Fi P2P et en affiche l'état séparément. Le Bluetooth suffit pour le test de texte ci-dessous. Si le P2P n'est pas connecté, n'en concluez pas à un échec de la connexion Bluetooth. Les fichiers volumineux et les médias en direct nécessitent une validation P2P distincte.
Étape 10 Envoyer un message de travail et vérifier le fonctionnement de la démo
· Définir le message de test : Dans le projet téléphone, ouvrez app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Repérez binding.btSendTextBtn.setOnClickListener et remplacez l'intégralité de ce bloc listener par le code ci-dessous.
(Remarque : dans SendMessageActivity.kt, conservez l'import PSecuritySDK existant. S'il est absent, ajoutez la ligne suivante en haut du fichier, avec les autres imports : import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample est l'identifiant client de réception déjà enregistré par la démo des lunettes ; laissez-le inchangé des deux côtés.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Lancer l'application téléphone modifiée : Dans la fenêtre du projet téléphone d'Android Studio, sélectionnez le téléphone connecté et cliquez sur Run > Run app pour recompiler et installer l'application modifiée. Attendez que l'initialisation du SDK réussisse et vérifiez que le Bluetooth se reconnecte. Accédez ensuite à Message Receive sur les lunettes via scrcpy. Cliquez directement dans la fenêtre scrcpy active sur le bureau pour lui donner le focus. Comme les lunettes émulent des commandes matérielles de type croix directionnelle (D-pad), utilisez les touches Flèche droite ou Flèche gauche du clavier de votre ordinateur pour parcourir le menu jusqu'à ce que Message Receive ou 消息接收 (Message Receive), le deuxième élément du menu, soit mis en surbrillance, puis appuyez sur Entrée pour ouvrir l'activité. La démo associe ces touches à la sélection de menu dans HomeActivity.kt. Laissez cette page de réception affichée ; c'est elle qui enregistre l'écouteur de messages utilisé par ce test.
· Envoyer depuis le téléphone : Sur la page Device ou 设备 du téléphone, faites défiler jusqu'à la carte Message Send ou 消息发送 et appuyez dessus. Sur la page suivante, appuyez sur Send text via Bluetooth ou 蓝牙发送文本. Ce bouton envoie la chaîne fixe ci-dessus ; il n'y a aucun champ de saisie à remplir. Recherchez Work item 001 ready sur la page de réception des lunettes.
· Consigner la condition de réussite : Dans le Logcat des lunettes, filtrez avec package:com.rokid.glesse tag:MessageActivity et vérifiez que le même message est bien arrivé. Le log d'envoi du téléphone ne suffit pas à lui seul à prouver la réception. Enregistrez avec votre résultat les versions du SDK, le build du firmware, la révision du code source et les modifications des outils de build. Le test est réussi lorsque les deux applications fonctionnent, que le Bluetooth est connecté et que les lunettes reçoivent visiblement le message de test.
Problèmes de configuration courants
· Les lunettes se chargent mais ne sont pas détectées : Utilisez le câble de débogage de données et refaites la vérification ADB de l'étape 8. Le câble de charge ordinaire est la première cause à écarter.
· Gradle ne parvient pas à télécharger une bibliothèque : Dans Build, développez l'erreur et notez le paquet exact ainsi que l'URL du serveur. Vérifiez les entrées de dépôt de l'étape 5 et l'accès via le proxy de l'entreprise. La démo inclut d'autres dépôts et dépendances en plus des deux SDK de Rokid ; ne les supprimez pas sans discernement et n'ajoutez pas un miroir quelconque.
· Erreurs de journalisation en double ou de bibliothèques natives : Recherchez d'éventuelles entrées SDK en double et vérifiez l'exclusion org.slf4j. Conservez les règles packagingOptions existantes pour libr2aud.so dans l'application des lunettes et pour libc++_shared.so dans l'application téléphone. Une erreur de bibliothèque en double signifie que deux dépendances ont empaqueté le même fichier.
· L'appairage fonctionne mais aucun message n'arrive : Gardez la page de réception des lunettes ouverte et vérifiez que GlassSample n'a pas été modifié. Dans Logcat, vérifiez la présence des deux messages de réussite de l'initialisation avant d'envoyer. Si l'appareil est introuvable, vérifiez les autorisations Appareils à proximité du téléphone et déconnectez d'abord tout autre téléphone.
Conclusion
La configuration d'un environnement de développement Rokid Glass3 commence par des lunettes compatibles avec l'usage entreprise et le bon câble de débogage de données, puis passe par Android Studio, le JDK 17, les dépendances Maven et une configuration de build cohérente. Lancer les démos téléphone et lunettes, puis vérifier la réception d'un message de travail, permet d'établir une base concrète avant d'ajouter la logique métier ou des services en ligne. Pour les entreprises, cette démarche peut réduire les retards de configuration évitables, faciliter la reproduction des projets pilotes et offrir aux développeurs une base plus claire pour des applications qui fournissent des informations utiles tout en laissant les mains des employés libres.
Vérifiez la prise en charge du matériel entreprise, du câble de débogage de données et du firmware avant d'acheter un kit de développement ou de demander un projet pilote pour votre entreprise.
