Resumen ejecutivo
Un entorno de desarrollo para Rokid Glass3 permite a un equipo empresarial crear aplicaciones Android para [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) y probar la comunicación con un teléfono Android. Empiece con el firmware empresarial, Android Studio, JDK 17, el repositorio Maven de Rokid y el cable de datos y depuración de Glass3. El cable de carga normal no permite instalar ni depurar la aplicación de las gafas.
Este flujo de trabajo en Windows 11 abre los dos proyectos de demostración oficiales de Rokid, comprueba su configuración de compilación, instala cada aplicación y envía un mensaje de trabajo de ejemplo a las gafas. Utiliza el SDK empresarial y una prueba de comunicación local. Los servicios de voz e IA en línea son integraciones independientes. Las instrucciones se han verificado con la documentación oficial y el código fuente de la demo; no se ha realizado ninguna ejecución en un dispositivo físico.
Para contextualizar el hardware, consulte la página de producto de Rokid AI Glasses Enterprise. Rokid documenta la arquitectura y el entorno de ejecución de este dispositivo empresarial en el SDK Glass3 Enterprise. Confirme con su proveedor el dispositivo y el firmware entregados antes de considerar compatible otro producto de Rokid.
Requisitos para el desarrollo con Rokid Glass3
Hardware: PC con Windows 11, Rokid Glass3 Enterprise (firmware empresarial), teléfono Android de pruebas dedicado (se recomienda Android 13 o superior) y el cable de datos y depuración de Glass3.
Software: Android Studio con Android SDK Platform 34 y Build-Tools 35.0.0.
Entorno de compilación: JDK 17, AGP 8.4.2, Gradle 8.6 y Kotlin 2.2.0.
SDK: Glasses SDK y Phone SDK 2.2.0-E.
Paso 1: Preparar el hardware empresarial
· Confirme el sistema: El firmware es el software de sistema integrado en las gafas. Pida a su proveedor el modelo de las gafas, la versión del firmware empresarial instalada y la compatibilidad con el SDK. Según las preguntas frecuentes de Rokid, las versiones de trabajo suelen incluir una e en el número de versión. Utilice la demo empresarial con firmware empresarial. El nombre del producto por sí solo no basta para establecer la compatibilidad.
· Compruebe el cable: Solicite expresamente el cable de datos y depuración de Glass3. Conéctelo directamente al ordenador de desarrollo al instalar la demo. Que la carga funcione no demuestra que funcione la transmisión de datos por USB.
· Prepare la prueba: Cargue ambos dispositivos y manténgalos cerca el uno del otro. Utilice un teléfono dedicado y el mensaje de ejemplo del paso 10. Antes del emparejamiento, desconecte cualquier otro teléfono que se haya conectado previamente a estas gafas.
Cable de datos y depuración de Glass3 mostrado en la guía de inicio rápido de Rokid. Este es el cable necesario para el desarrollo por cable.
Cable de carga normal de Glass3 mostrado por Rokid. No puede sustituir al cable de datos y depuración. Confirme con el proveedor la función del cable suministrado.
Paso 2: Instalar Android Studio y el Android SDK (si ya están instalados, pase al siguiente paso)
· Descargue el instalador: Descargue e instale Android Studio desde https://developer.android.com/studio.
· Abra la aplicación: Abra Android Studio. En el primer inicio, seleccione Do not import settings si se le ofrece y, a continuación, utilice la opción Standard de configuración. Revise las licencias del SDK, acepte las aprobadas por su empresa y complete la descarga de componentes.
· Instale los paquetes necesarios: En la pantalla de bienvenida, haga clic en More Actions > SDK Manager. En SDK Platforms, seleccione Android 14 / API 34. En SDK Tools, seleccione Android SDK Platform-Tools. Active Show Package Details, despliegue Android SDK Build-Tools y seleccione 35.0.0. Cabe señalar que el Android Gradle Plugin de la demo instala las build tools 34.0.0 que necesita durante la primera sincronización. Haga clic en Apply, revise la lista de paquetes y, después, en OK para instalar.
· Guarde la ubicación del SDK: Anote la ruta de Android SDK Location para configurar ADB en el paso 8.
Paso 3: Descargar y abrir los dos proyectos de demostración
· Obtenga el código fuente: En el navegador, vaya al repositorio oficial de la demo empresarial de Glass3 (p. ej., https://github.com/RokidSuuport/glass3_sdk_demo.git; cabe señalar que este es realmente el repositorio Git oficial, aunque «Support» está mal escrito) o al repositorio Git facilitado por su proveedor. Haga clic en el botón verde Code y, a continuación, en Download ZIP. En Explorador de archivos > Descargas, haga clic con el botón derecho en el ZIP y seleccione Extraer todo > Extraer. Guarde la carpeta extraída en una ubicación de desarrollo aprobada por la empresa.
· Abra el proyecto del teléfono: En la pantalla de bienvenida de Android Studio, haga clic en Open. Navegue dentro de la carpeta extraída, seleccione glass3sdkphonedemo y haga clic en OK. Si aparece un aviso de confianza, compruebe que se trata de la fuente oficial que ha descargado antes de confiar en ella. La carpeta exterior del repositorio no es el proyecto Android.
· Abra el proyecto de las gafas: Elija File > Open, seleccione la carpeta contigua glassdemo y elija New Window cuando se le pregunte. Mantenga ambas ventanas abiertas. Cada una tiene su propia configuración de Gradle y un módulo app, la parte que genera la aplicación instalable.
· Use la vista de archivos: En cada ventana, abra View > Tool Windows > Project. En el desplegable de la parte superior del panel izquierdo, elija Project. Así se muestran las carpetas y los archivos reales que se utilizan a continuación. Si la primera sincronización da error, complete los pasos 4 y 5 antes de volver a intentarlo.
Paso 4: Seleccionar JDK 17 para ambos proyectos
· Abra la configuración de Gradle: En la ventana del proyecto del teléfono, elija File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Busque el desplegable Gradle JDK. Este controla la versión de Java que se usa para compilar el proyecto, con independencia del entorno de ejecución de Java que inicia Android Studio.
· Seleccione o descargue Java 17: Elija un JDK instalado con la etiqueta 17. Si no aparece ninguno, elija Download JDK, seleccione Version 17, elija un proveedor aprobado por el departamento de TI y haga clic en Download. Seleccione el JDK descargado en Gradle JDK y, a continuación, haga clic en Apply > OK. Repita el proceso en la ventana del proyecto de las gafas.
· Mantenga los destinos de código existentes: Los parámetros sourceCompatibility, targetCompatibility y jvmTarget de Kotlin de la demo están establecidos en 1.8. Describen la compatibilidad del código compilado; no significan que Gradle deba ejecutarse con JDK 8. No los modifique para esta demo. La guía de compilación de Java de Google explica la diferencia entre estos ajustes.
Paso 5: Comprobar las dependencias de Maven y alinear las herramientas de compilación
Un repositorio Maven es un servidor en el que Gradle encuentra paquetes de bibliotecas, incluido el SDK de Rokid.
· Compruebe el repositorio: En el panel izquierdo de cada proyecto, haga doble clic en settings.gradle. Busque dependencyResolutionManagement > repositories y confirme que está presente la URL de Maven de Rokid que se indica a continuación. Añada solo la línea que falte dentro del bloque existente. Conserve los demás repositorios de la demo para sus otras dependencias; si un proxy de la empresa los bloquea, pida al departamento de TI que apruebe el acceso.
// Dentro de settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Compruebe los dos paquetes del SDK: Abra app > build.gradle en cada ventana. En dependencies, mantenga una sola entrada activa para el SDK correspondiente. Los fragmentos siguientes están en Groovy, la sintaxis que utiliza esta demo. No añada el SDK de las gafas al proyecto del teléfono ni pegue un segundo bloque de dependencias. org.slf4j es un grupo de bibliotecas de registro; la exclusión evita clases de registro duplicadas.
// 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"
}
· Alinee AGP y Gradle: Kotlin es el lenguaje de programación que utilizan estas demos. Para la versión inspeccionada, abra gradle > libs.versions.toml en ambos proyectos. En [versions], cambie únicamente agp a 8.4.2 si aún no tiene ese valor; mantenga kotlin = "2.2.0". Después, abra gradle > wrapper > gradle-wrapper.properties y sustituya únicamente distributionUrl por la línea siguiente. El wrapper descarga la versión de Gradle elegida. Google documenta la combinación de Gradle y JDK para 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
· Sincronice y revise el resultado: Guarde los archivos editados y, a continuación, elija File > Sync Project with Gradle Files en ambas ventanas. Abra View > Tool Windows > Build y compruebe la salida de la sincronización. No acepte actualizaciones automáticas que no estén relacionadas. La demo ya incluye reglas de empaquetado de bibliotecas nativas; consérvelas. Una biblioteca nativa es código compilado para el dispositivo que se empaqueta con el APK.
Paso 6: Configurar una demo empresarial local
· Desactive los servicios en línea para esta prueba: En el proyecto del teléfono, abra app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. En la parte superior de MainPhoneActivity.kt, mantenga la importación existente de NetServiceType. Si falta, añada la siguiente línea junto a las demás importaciones:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
A continuación, busque banServiceList dentro de initSDK(). Sustituya su declaración activa por la línea siguiente. Mantenga los campos vacíos existentes de UserAuthInfo y los ID de cliente. El código fuente documenta esta opción para desactivar los servicios de red; no desactiva la prueba local por Bluetooth.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Mantenga separadas las futuras credenciales: AK es una clave de acceso y SK es su secreto. Para servicios autenticados posteriores, solicite las credenciales del servicio empresarial a su contacto comercial o de ventas de Rokid. En UserAuthInfo, appId recibe la AK y secret recibe la SK. Utilice una configuración de proyecto protegida para las credenciales de prueba y nunca suba claves reales al repositorio. Esta primera ejecución local no necesita esas funciones en línea.
· Añada registros de inicialización en inglés: en el proyecto del teléfono, abra app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. En initSDK(), añada un registro en inglés dentro de la callback de éxito:
Kotlin
Log.d(TAG, “Phone SDK ready”)
En el proyecto de las gafas, abra app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() llama a GlassSdkUtils.initSdk() y, a continuación, recopila GlobalData.sdkInitState; dentro de ese recolector, justo después de la línea Log.d(TAG, “SDK 初始化成功”), añada el registro en inglés:
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Nota: si Android Studio resalta en rojo referencias a clases, pulse Alt + Intro para importar automáticamente los paquetes necesarios.)
· Evite cambiar el comportamiento de arranque: En el proyecto de las gafas, abra app > src > main > java > com > rokid > glass > HomeActivity.kt. Dentro de onCreate(), comente la siguiente línea existente añadiendo // al principio. Esa línea configura el inicio automático tras un reinicio; no es necesaria para una primera prueba en un dispositivo de la empresa.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Limite la prueba de recepción a texto: En la misma carpeta com > rokid > glass, abra MessageReceiveActivity.kt. Sustituya únicamente su función onTextMessage dentro de mMessageListener por el código siguiente. El texto recibido sigue mostrándose y registrándose, sin invocar los servicios de voz. Una callback es una función a la que llama el SDK cuando llega un evento.
override fun onTextMessage(msg: String) {
log(msg)
}
Paso 7: Compilar y ejecutar la aplicación del teléfono
· Active la depuración USB en el teléfono: En el teléfono de pruebas, abra Ajustes y utilice el cuadro de búsqueda para encontrar Número de compilación. Abra la página de información del dispositivo correspondiente y toque Número de compilación siete veces; introduzca el PIN del dispositivo si se le solicita. Vuelva a Ajustes, busque Opciones de desarrollador, ábralas y active Depuración USB. La ubicación de los menús varía según el fabricante del teléfono.
· Conecte y autorice: Conecte el teléfono al ordenador con su cable de datos USB. En el cuadro de diálogo ¿Permitir depuración USB? del teléfono, compruebe que se trata del ordenador de desarrollo y toque Permitir. En la barra de herramientas superior del proyecto del teléfono, elija app como configuración de ejecución y seleccione el teléfono conectado en el desplegable de dispositivos contiguo.
· Ejecute la aplicación: Haga clic en el triángulo verde Run o elija Run > Run app. Android Studio compila, instala y abre la demo del teléfono. La etiqueta de la aplicación inspeccionada puede ser Rokid Enterprise Demo o rokid白板, y es probable que la interfaz de la demo esté en chino. En los cuadros de diálogo de permisos, conceda el acceso a Dispositivos cercanos y a la Wi-Fi que se solicita y que es necesario para esta prueba; las versiones anteriores de Android pueden solicitar la ubicación. Si los denegó anteriormente, use Ajustes > Aplicaciones > la demo > Permisos para cambiar el permiso correspondiente.
· Compruebe la inicialización: Abra View > Tool Windows > Logcat, seleccione el teléfono e introduzca package:com.rokid.phone en el campo de filtro. Busque Phone SDK ready, que indica que la inicialización del SDK del teléfono se ha realizado correctamente. Mantenga la aplicación abierta. Si la política del teléfono de pruebas bloquea la depuración o los permisos necesarios, pida al departamento de TI que configure este dispositivo de desarrollo dedicado antes de continuar.
Paso 8: Conectar y ejecutar la aplicación de las gafas
Verifique los ajustes de desarrollador de las gafas: En las Rokid Glass3, vaya a Settings > System > Developer Options y confirme que USB Debugging está en ON. Si el menú de opciones está bloqueado u oculto en su versión empresarial, póngase en contacto con su distribuidor de hardware para que instale o aprovisione un firmware con las opciones de desarrollador habilitadas antes de continuar.
· Compruebe ADB con el cable correcto: Conecte las gafas encendidas con el cable de datos y depuración de Glass3. En el proyecto de las gafas, elija View > Tool Windows > Terminal. Escriba cd " seguido de la ubicación del SDK guardada en el paso 2 y, después, \platform-tools", y pulse Intro. En esa carpeta, ejecute el siguiente comando. El número de serie es el identificador del dispositivo que aparece en la primera columna.
.\adb.exe devices -l
· Lea el estado del dispositivo: Busque el número de serie de las gafas seguido de device, no offline ni unauthorized. Si aparece un cuadro de diálogo de autorización en las gafas, apruebe este ordenador de desarrollo. Si no aparece nada, compruebe primero el cable y el puerto USB. Las versiones empresariales pueden restringir la depuración; si está bloqueada, pida al proveedor que habilite el acceso de desarrollo documentado. No recurra a las instrucciones de la aplicación complementaria para consumidores.
· Instale e inicie: En la barra de herramientas del proyecto de las gafas, seleccione app, elija las gafas como destino, por ejemplo Rokid RG-glasses, y haga clic en Run. La etiqueta de la aplicación es glassdemo. Abra Logcat, seleccione las gafas y filtre por package:com.rokid.glesse. Busque Glasses SDK ready, el registro añadido en el paso 6, para confirmar que la inicialización del SDK se ha realizado correctamente.
· Duplique la interfaz: scrcpy es una herramienta para ver y controlar la pantalla de dispositivos Android; Rokid documenta su uso por cable. Abra las instrucciones oficiales de scrcpy para Windows, descargue el ZIP para Windows de 64 bits y use Extraer todo en el Explorador de archivos. Abra la carpeta extraída y haga doble clic en open_a_terminal_here.bat. Ejecute adb devices y, después, el siguiente comando, sustituyendo GLASSES_SERIAL por el número de serie de las gafas. La ventana de duplicación le permite hacer clic en la interfaz de las gafas con el ratón del ordenador.
scrcpy -s GLASSES_SERIAL --no-audio
Paso 9: Emparejar las demos empresariales
· Abra la pantalla de conexión del teléfono: En Rokid Enterprise Demo, toque el icono + de la parte superior derecha para abrir Discover Bluetooth. En la versión china, en la demo del teléfono (rokid 白板), en la página 设备 (Dispositivo), toque el icono + de la parte superior derecha para abrir 发现蓝牙 (Descubrir Bluetooth). En el diseño activo de esta revisión del código fuente no hay una pestaña Device en la parte inferior. Se inicia una búsqueda; elija la entrada Glass3_… que corresponda a sus gafas. Si la búsqueda se detiene, toque el icono de actualizar de esa pantalla.
· Complete el emparejamiento: Apruebe cualquier cuadro de diálogo de emparejamiento Bluetooth de Android que aparezca y compruebe si hay una solicitud de conexión en las gafas. Espere a que el indicador de conexión de la pantalla Device del teléfono muestre que el Bluetooth clásico está conectado. Si la página de búsqueda o de conexión sigue abierta tras el emparejamiento, toque el control Atrás de Android para volver a Device. Ambos dispositivos deben tener el Bluetooth activado y las gafas no deben estar conectadas a otro teléfono. La página de solución de problemas de Bluetooth de Rokid recoge estas comprobaciones.
· Mantenga la primera prueba sencilla: La demo también puede negociar Wi-Fi P2P y muestra esa conexión por separado. El Bluetooth basta para la prueba de texto siguiente. Si P2P no está conectado, no lo interprete como un fallo de la conexión Bluetooth. Los archivos grandes y los contenidos multimedia en directo requieren una validación de P2P aparte.
Paso 10: Enviar un mensaje de trabajo y confirmar que la demo funciona
· Defina el mensaje de prueba: En el proyecto del teléfono, abra app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Busque binding.btSendTextBtn.setOnClickListener y sustituya todo ese bloque del listener por el código siguiente.
(Nota: en SendMessageActivity.kt, mantenga la importación existente de PSecuritySDK. Si falta, añada la siguiente línea en la parte superior del archivo, junto a las demás importaciones: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample es el ID de cliente receptor que ya registra la demo de las gafas; no lo modifique en ninguno de los dos lados.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Ejecute la aplicación del teléfono modificada: En la ventana del proyecto del teléfono de Android Studio, seleccione el teléfono conectado y haga clic en Run > Run app para recompilar e instalar la aplicación modificada. Espere a que la inicialización del SDK se complete correctamente y confirme que el Bluetooth se vuelve a conectar. A continuación, vaya a Message Receive en las gafas mediante scrcpy. Haga clic directamente dentro de la ventana activa de scrcpy en el escritorio para darle el foco. Como las gafas emulan controles físicos de cruceta (D-pad), utilice la tecla Flecha derecha o Flecha izquierda del teclado del ordenador para desplazarse por el menú hasta que quede resaltado Message Receive o 消息接收 (Recepción de mensajes), el segundo elemento del menú; después, pulse Intro para abrir la actividad. La demo asigna estas teclas a la selección del menú en HomeActivity.kt. Deje visible esta página de recepción; registra el listener de mensajes que utiliza esta prueba.
· Envíe desde el teléfono: En la página Device o 设备 del teléfono, desplácese hasta la tarjeta Message Send o 消息发送 y tóquela. En la página siguiente, toque Send text via Bluetooth o 蓝牙发送文本. Este botón envía la cadena fija indicada arriba; no hay ningún campo de texto que rellenar. Busque Work item 001 ready en la página de recepción de las gafas.
· Registre la condición de éxito: En el Logcat de las gafas, filtre por package:com.rokid.glesse tag:MessageActivity y confirme que ha llegado el mismo mensaje. El registro de envío del propio teléfono no demuestra por sí solo la recepción. Guarde junto con el resultado las versiones del SDK, la versión del firmware, la revisión del código fuente y los cambios en las herramientas de compilación. El éxito significa que ambas aplicaciones se ejecutan, el Bluetooth se conecta y las gafas reciben visiblemente el mensaje de prueba.
Problemas de configuración habituales
· Las gafas se cargan pero no se detectan: Utilice el cable de datos y depuración y repita la comprobación de ADB del paso 8. El cable de carga normal es lo primero que hay que descartar.
· Gradle no puede descargar una biblioteca: En Build, despliegue el error y anote el paquete exacto y la URL del servidor. Compruebe las entradas de repositorio del paso 5 y el acceso a través del proxy de la empresa. La demo incluye repositorios y dependencias adicionales además de los dos SDK de Rokid; no los elimine indiscriminadamente ni añada una réplica cualquiera.
· Errores de registro duplicado o de bibliotecas nativas: Compruebe si hay entradas del SDK duplicadas y la exclusión de org.slf4j. Mantenga las reglas packagingOptions existentes para libr2aud.so en la aplicación de las gafas y libc++_shared.so en la aplicación del teléfono. Un error de biblioteca duplicada significa que dos dependencias han empaquetado el mismo archivo.
· El emparejamiento funciona pero no llega ningún mensaje: Mantenga abierta la página de recepción de las gafas y confirme que GlassSample no se ha modificado. En Logcat, verifique los dos mensajes de inicialización correcta antes de enviar. Si no se puede detectar el dispositivo, revise los permisos de Dispositivos cercanos del teléfono y desconecte primero cualquier otro teléfono.
Conclusión
La configuración de un entorno de desarrollo para Rokid Glass3 empieza por unas gafas compatibles con el entorno empresarial y el cable de datos y depuración correcto, y continúa con Android Studio, JDK 17, las dependencias de Maven y una configuración de compilación coherente. Ejecutar las demos del teléfono y de las gafas y verificar la recepción de un mensaje de trabajo establece una base práctica antes de añadir lógica de negocio o servicios en línea. Para las empresas, este proceso puede reducir retrasos evitables en la configuración, facilitar la reproducción de los proyectos piloto y ofrecer a los desarrolladores una base más clara para aplicaciones que proporcionen información útil mientras los empleados mantienen las manos libres.
Confirme la compatibilidad del hardware empresarial, el cable de datos y depuración y el firmware antes de adquirir un kit de desarrollo o solicitar un piloto para su empresa.
