Resumo executivo
Um ambiente de desenvolvimento para Rokid Glass3 permite que uma equipe empresarial crie aplicativos Android para os [Rokid AI Glasses Enterprise](https://ai.vr-expert.com/en/ai-glasses/rokid-ai-glasses) e teste a comunicação com um celular Android. Comece com o firmware enterprise, o Android Studio, o JDK 17, o repositório Maven da Rokid e o cabo de dados e depuração do Glass3. O cabo de carregamento comum não permite instalar nem depurar o aplicativo dos óculos.
Este fluxo de trabalho no Windows 11 abre os dois projetos de demonstração oficiais da Rokid, verifica a configuração de build de cada um, instala os dois aplicativos e envia uma mensagem de trabalho de exemplo para os óculos. Ele usa o SDK enterprise e um teste de comunicação local. Os serviços online de fala e de IA são integrações separadas. As instruções foram conferidas com a documentação oficial e o código-fonte da demo; não foi feita uma execução em dispositivo físico.
Para contexto sobre o hardware, consulte a página do produto Rokid AI Glasses Enterprise. A Rokid documenta a arquitetura e o runtime deste dispositivo enterprise no Glass3 Enterprise SDK. Confirme o dispositivo entregue e o firmware com seu fornecedor antes de considerar outro produto Rokid compatível.
Requisitos para desenvolvimento com Rokid Glass3
Hardware: PC com Windows 11, Rokid Glass3 Enterprise (firmware enterprise), celular Android dedicado para testes (recomenda-se Android 13 ou superior) e o cabo de dados e depuração do Glass3.
Software: Android Studio com Android SDK Platform 34 e Build-Tools 35.0.0.
Ambiente de build: JDK 17, AGP 8.4.2, Gradle 8.6 e Kotlin 2.2.0.
SDKs: Glasses SDK e Phone SDK 2.2.0-E.
Etapa 1: Prepare o hardware enterprise
· Confirme o sistema: O firmware é o software de sistema integrado dos óculos. Peça ao seu fornecedor o modelo dos óculos, a versão do firmware enterprise instalada e a compatibilidade com o SDK. Segundo o FAQ da Rokid, as versões para uso profissional costumam conter um e no número da versão. Use a demo enterprise com firmware enterprise. O nome do produto, por si só, não comprova a compatibilidade.
· Verifique o cabo: Solicite explicitamente o cabo de dados e depuração do Glass3. Conecte-o diretamente ao computador de desenvolvimento ao instalar a demo. Carregar com sucesso não prova que a transferência de dados via USB funciona.
· Prepare o teste: Carregue os dois dispositivos e mantenha-os próximos um do outro. Use um celular dedicado e a mensagem de exemplo da Etapa 10. Antes de parear, desconecte qualquer outro celular que já tenha sido conectado a estes óculos.
Cabo de dados e depuração do Glass3, conforme mostrado no Quick Start da Rokid. Este é o cabo necessário para o fluxo de desenvolvimento com fio.
Cabo de carregamento comum do Glass3, conforme mostrado pela Rokid. Ele não substitui o cabo de dados e depuração. Confirme a função do cabo fornecido com o fornecedor.
Etapa 2: Instale o Android Studio e o Android SDK (se já estiverem instalados, passe para a próxima etapa)
· Baixe o instalador: Baixe e instale o Android Studio a partir de https://developer.android.com/studio.
· Abra o aplicativo: Abra o Android Studio. Na primeira execução, selecione Do not import settings, se essa opção aparecer, e depois use o modo de configuração Standard (padrão). Revise as licenças do SDK, aceite as aprovadas pela sua empresa e conclua o download dos componentes.
· Instale os pacotes necessários: Na tela de boas-vindas, clique em More Actions > SDK Manager. Em SDK Platforms, selecione Android 14 / API 34. Em SDK Tools, selecione Android SDK Platform-Tools. Ative Show Package Details, expanda Android SDK Build-Tools e selecione 35.0.0. Vale observar que o Android Gradle Plugin da demo instala, na primeira sincronização, as build tools 34.0.0 de que precisa. Clique em Apply, revise a lista de pacotes e, em seguida, clique em OK para instalar.
· Salve o local do SDK: Anote o caminho de Android SDK Location para configurar o ADB na Etapa 8.
Etapa 3: Baixe e abra os dois projetos de demonstração
· Obtenha o código-fonte: No navegador, acesse o repositório oficial da demo enterprise do Glass3 (por exemplo, https://github.com/RokidSuuport/glass3_sdk_demo.git — vale observar que este é de fato o repositório Git oficial, embora “Support” esteja grafado incorretamente) ou o repositório Git indicado pelo seu fornecedor. Clique no botão verde Code e depois em Download ZIP. Em File Explorer > Downloads, clique com o botão direito no ZIP e selecione Extract All > Extract. Mantenha a pasta extraída em um local de desenvolvimento aprovado pela empresa.
· Abra o projeto do celular: Na tela de boas-vindas do Android Studio, clique em Open. Navegue até o interior da pasta extraída, selecione glass3sdkphonedemo e clique em OK. Se aparecer uma solicitação de confiança, verifique se esta é a fonte oficial que você baixou antes de confiar nela. A pasta externa do repositório não é o projeto Android.
· Abra o projeto dos óculos: Escolha File > Open, selecione a pasta glassdemo, que fica no mesmo nível, e escolha New Window quando for perguntado. Mantenha as duas janelas abertas. Cada uma tem sua própria configuração do Gradle e um módulo app, a parte que gera o aplicativo instalável.
· Use a visualização de arquivos: Em cada janela, abra View > Tool Windows > Project. No menu suspenso na parte superior do painel esquerdo, escolha Project. Isso exibe as pastas e os arquivos reais usados a seguir. Se a primeira sincronização relatar um erro, conclua as Etapas 4 e 5 antes de tentar novamente.
Etapa 4: Selecione o JDK 17 para os dois projetos
· Abra as configurações do Gradle: Na janela do projeto do celular, escolha File > Settings > Build, Execution, Deployment > Build Tools > Gradle. Localize o menu suspenso Gradle JDK. Ele controla a versão do Java usada para compilar o projeto, independentemente do runtime Java que inicia o Android Studio.
· Selecione ou baixe o Java 17: Escolha um JDK instalado identificado como 17. Se nenhum aparecer na lista, escolha Download JDK, selecione Version 17, escolha um fornecedor aprovado pela TI e clique em Download. Selecione o JDK baixado em Gradle JDK e clique em Apply > OK. Repita na janela do projeto dos óculos.
· Mantenha os alvos de código existentes: Na demo, sourceCompatibility, targetCompatibility e o jvmTarget do Kotlin usam 1.8. Eles descrevem a compatibilidade do código compilado; não significam que o Gradle deva rodar no JDK 8. Mantenha-os inalterados nesta demo. O guia de build Java do Google diferencia essas configurações.
Etapa 5: Verifique as dependências do Maven e alinhe as ferramentas de build
Um repositório Maven é um servidor em que o Gradle encontra pacotes de bibliotecas, incluindo o SDK da Rokid.
· Verifique o repositório: No painel esquerdo de cada projeto, clique duas vezes em settings.gradle. Localize dependencyResolutionManagement > repositories e confirme se a URL do Maven da Rokid indicada abaixo está presente. Adicione apenas a linha que estiver faltando, dentro do bloco existente. Mantenha os outros repositórios da demo, usados pelas demais dependências; se um proxy da empresa os bloquear, peça à TI que aprove o acesso.
// Dentro de settings.gradle > dependencyResolutionManagement
repositories {
google()
mavenCentral()
maven { url = uri("https://maven.rokid.com/repository/maven-public/") }
}
· Verifique os dois pacotes do SDK: Abra app > build.gradle em cada janela. Em dependencies, mantenha uma única entrada ativa para o SDK correto. Os trechos abaixo estão em Groovy, a sintaxe usada por esta demo. Não adicione o SDK dos óculos ao projeto do celular nem cole um segundo bloco de dependências. org.slf4j é um grupo de bibliotecas de log; a exclusão evita classes de log 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"
}
· Alinhe o AGP e o Gradle: Kotlin é a linguagem de programação usada por estas demos. No snapshot analisado, abra gradle > libs.versions.toml nos dois projetos. Em [versions], altere apenas agp para 8.4.2, caso ainda não esteja assim; mantenha kotlin = "2.2.0". Em seguida, abra gradle > wrapper > gradle-wrapper.properties e substitua apenas distributionUrl pela linha abaixo. O wrapper baixa a versão do Gradle escolhida. O Google documenta a combinação de Gradle e JDK do 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
· Sincronize e confira o resultado: Salve os arquivos editados e escolha File > Sync Project with Gradle Files nas duas janelas. Abra View > Tool Windows > Build e confira a saída da sincronização. Não aceite atualizações automáticas não relacionadas. A demo já inclui regras de empacotamento de bibliotecas nativas; mantenha-as. Uma biblioteca nativa é código compilado para o dispositivo, empacotado com o APK.
Etapa 6: Configure uma demo empresarial local
· Desative os serviços online para este teste: No projeto do celular, abra app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. No início de MainPhoneActivity.kt, mantenha o import existente de NetServiceType. Se ele não estiver presente, adicione a seguinte linha junto aos demais imports:
Kotlin
import com.rokid.security.phone.sdk.base.data.NetServiceType
Em seguida, localize banServiceList dentro de initSDK(). Substitua a declaração ativa dela pela linha abaixo. Mantenha os campos vazios existentes de UserAuthInfo e os IDs de cliente. O código-fonte documenta esta opção para desativar serviços de rede; ela não desativa o teste local por Bluetooth.
val banServiceList: List<NetServiceType> = arrayListOf(NetServiceType.ALL)
· Mantenha as credenciais futuras separadas: AK é uma chave de acesso (access key), e SK é o segredo correspondente. Para serviços autenticados posteriores, solicite as credenciais de serviço enterprise ao seu contato comercial ou de vendas da Rokid. Em UserAuthInfo, appId recebe a AK, e secret recebe a SK. Use uma configuração de projeto protegida para credenciais de teste e nunca faça commit de chaves reais. Esta primeira execução local não precisa desses recursos online.
· Adicione logs de inicialização em inglês: No projeto do celular, abra app > src > main > java > com > rokid > phone > ui > MainPhoneActivity.kt. Em initSDK(), adicione um log em inglês dentro do callback de sucesso:
Kotlin
Log.d(TAG, “Phone SDK ready”)
No projeto dos óculos, abra app > src > main > java > com > rokid > glass > HomeActivity.kt. initSDK() chama GlassSdkUtils.initSdk() e depois coleta GlobalData.sdkInitState; dentro desse coletor, logo após a linha Log.d(TAG, “SDK 初始化成功”), adicione o log em inglês:
Kotlin
Log.d(TAG, “Glasses SDK ready”)
(Observação: se o Android Studio destacar referências de classe em vermelho, pressione Alt + Enter para importar automaticamente os pacotes necessários.)
· Evite alterar o comportamento de inicialização: No projeto dos óculos, abra app > src > main > java > com > rokid > glass > HomeActivity.kt. Dentro de onCreate(), comente a linha existente abaixo colocando // no início dela. Essa linha configura a abertura automática após a reinicialização; ela é desnecessária em um primeiro teste em um dispositivo da empresa.
// DeviceUtil.setSystemProp("persist.vendor.boot.pkg", this.packageName)
· Deixe o teste de recebimento apenas com texto: Na mesma pasta com > rokid > glass, abra MessageReceiveActivity.kt. Substitua apenas a função onTextMessage dentro de mMessageListener pelo código abaixo. O texto recebido continua visível e registrado no log, sem acionar serviços de fala. Um callback é uma função que o SDK chama quando um evento chega.
override fun onTextMessage(msg: String) {
log(msg)
}
Etapa 7: Compile e execute o aplicativo do celular
· Ative a depuração USB no celular: No celular de teste, abra Configurações e use a caixa de pesquisa para encontrar Número da versão. Abra a página de informações do dispositivo correspondente e toque em Número da versão sete vezes; digite o PIN do dispositivo, se solicitado. Volte às Configurações, pesquise Opções do desenvolvedor, abra essa opção e ative Depuração USB. A localização dos menus varia conforme o fabricante do celular.
· Conecte e autorize: Conecte o celular ao computador com o cabo de dados USB dele. Na caixa de diálogo Permitir a depuração USB? do celular, verifique se este é o computador de desenvolvimento e toque em Permitir. Na barra de ferramentas superior do projeto do celular, escolha app como configuração de execução e selecione o celular conectado no menu suspenso de dispositivos ao lado.
· Execute o app: Clique no triângulo verde Run ou escolha Run > Run app. O Android Studio compila, instala e abre a demo do celular. O nome do app analisado pode ser Rokid Enterprise Demo ou rokid白板, e a interface da demo provavelmente estará em chinês. Nas caixas de diálogo de permissão, permita o acesso a Dispositivos por perto e ao Wi-Fi necessário para este teste; versões mais antigas do Android podem solicitar Localização. Se você tiver negado antes, use Configurações > Apps > a demo > Permissões para alterar a permissão em questão.
· Verifique a inicialização: Abra View > Tool Windows > Logcat, selecione o celular e digite package:com.rokid.phone no campo de filtro. Procure Phone SDK ready, que indica que a inicialização do SDK do celular foi bem-sucedida. Mantenha o app aberto. Se a política do celular de teste bloquear a depuração ou as permissões necessárias, peça à TI que configure este dispositivo de desenvolvimento dedicado antes de continuar.
Etapa 8: Conecte e execute o aplicativo dos óculos
Verifique as configurações de desenvolvedor dos óculos: No Rokid Glass3, acesse Settings > System > Developer Options e confirme se USB Debugging está ON. Se o menu de opções estiver bloqueado ou oculto na sua versão enterprise, entre em contato com seu distribuidor de hardware para gravar/provisionar um firmware com acesso de desenvolvedor antes de continuar.
· Verifique o ADB usando o cabo correto: Conecte os óculos ligados com o cabo de dados e depuração do Glass3. No projeto dos óculos, escolha View > Tool Windows > Terminal. Digite cd " seguido do local do SDK salvo na Etapa 2 e depois \platform-tools" e pressione Enter. Nessa pasta, execute o comando abaixo. O serial é o identificador do dispositivo exibido na primeira coluna.
.\adb.exe devices -l
· Leia o estado do dispositivo: Procure o serial dos óculos seguido de device, e não offline ou unauthorized. Se aparecer uma caixa de diálogo de autorização nos óculos, aprove este computador de desenvolvimento. Se nada aparecer, verifique primeiro o cabo e a porta USB. Versões enterprise podem restringir a depuração; se ela estiver bloqueada, peça ao fornecedor que provisione o acesso de desenvolvimento documentado. Não use em seu lugar instruções do aplicativo complementar para consumidores.
· Instale e abra: Na barra de ferramentas do projeto dos óculos, selecione app, escolha o destino dos óculos, como Rokid RG-glasses, e clique em Run. O nome do app é glassdemo. Abra o Logcat, selecione os óculos e filtre por package:com.rokid.glesse. Procure Glasses SDK ready, o log adicionado na Etapa 6 para confirmar que a inicialização do SDK foi bem-sucedida.
· Espelhe a interface: O scrcpy é uma ferramenta para visualizar e controlar a tela de dispositivos Android; o uso com fio é documentado pela Rokid. Abra as instruções oficiais do scrcpy para Windows, baixe o ZIP para Windows 64 bits e use Extract All no File Explorer. Abra a pasta extraída e clique duas vezes em open_a_terminal_here.bat. Execute adb devices e, em seguida, o comando abaixo, substituindo GLASSES_SERIAL pelo serial dos óculos. A janela de espelhamento permite clicar na interface dos óculos com o mouse do computador.
scrcpy -s GLASSES_SERIAL --no-audio
Etapa 9: Pareie as demos enterprise
· Abra a tela de conexão no celular: No Rokid Enterprise Demo, toque no ícone + no canto superior direito para abrir Discover Bluetooth. Na versão em chinês, na demo do celular (rokid 白板), na página 设备 (Device), toque no ícone + no canto superior direito para abrir 发现蓝牙 (Discover Bluetooth). Não há uma aba Device na parte inferior do layout ativo nesta revisão do código-fonte. Isso inicia uma busca; escolha a entrada Glass3_… correspondente aos seus óculos. Se a busca travar, toque no ícone de atualizar nessa tela.
· Conclua o pareamento: Aprove qualquer caixa de diálogo de pareamento Bluetooth do Android que aparecer e verifique se há uma solicitação de conexão nos óculos. Aguarde até que o indicador de conexão na tela Device do celular mostre que o Bluetooth Clássico está conectado. Se a página de descoberta ou de conexão continuar aberta após o pareamento, toque no controle Voltar do Android para retornar a Device. Os dois dispositivos precisam estar com o Bluetooth ativado, e os óculos não podem estar conectados a outro celular. A página de solução de problemas de Bluetooth da Rokid lista essas verificações.
· Mantenha o primeiro teste simples: A demo também pode negociar Wi-Fi P2P e mostra essa conexão separadamente. O Bluetooth é suficiente para o teste de texto a seguir. Se o P2P não estiver conectado, não interprete isso como falha na conexão Bluetooth. Arquivos grandes e mídia ao vivo exigem uma validação de P2P à parte.
Etapa 10: Envie uma mensagem de trabalho e confirme que a demo está funcionando
· Defina a mensagem de teste: No projeto do celular, abra app > src > main > java > com > rokid > phone > SendMessageActivity.kt. Localize binding.btSendTextBtn.setOnClickListener e substitua todo esse bloco de listener pelo código abaixo.
(Observação: em SendMessageActivity.kt, mantenha o import existente de PSecuritySDK. Se ele não estiver presente, adicione a seguinte linha no início do arquivo, junto aos demais imports: import com.rokid.security.phone.sdk.api.PSecuritySDK).
GlassSample é o ID do cliente receptor já registrado pela demo dos óculos; mantenha-o inalterado nos dois lados.
binding.btSendTextBtn.setOnClickListener {
val message = "Work item 001 ready"
PSecuritySDK.getMessageService()
?.sendTextMessageByClassicBT(message, "GlassSample")
log(message)
}
· Execute o app do celular modificado: Na janela do projeto do celular no Android Studio, selecione o celular conectado e clique em Run > Run app para recompilar e instalar o aplicativo modificado. Aguarde a inicialização do SDK ser concluída com sucesso e confirme que o Bluetooth se reconectou. Em seguida, navegue até Message Receive nos óculos usando o scrcpy. Clique diretamente dentro da janela ativa do scrcpy na área de trabalho para colocá-la em foco. Como os óculos emulam controles de D-pad de hardware, use a tecla Seta para a direita ou Seta para a esquerda do teclado do computador para navegar pelo menu até que Message Receive ou 消息接收 (Message Receive), o segundo item do menu, fique destacado; depois, pressione Enter para abrir a activity. A demo associa essas teclas à seleção do menu em HomeActivity.kt. Deixe esta página de recebimento visível; ela registra o listener de mensagens usado neste teste.
· Envie pelo celular: Na página Device ou 设备 do celular, role até o card Message Send ou 消息发送 e toque nele. Na página seguinte, toque em Send text via Bluetooth ou 蓝牙发送文本. Este botão envia a string fixa definida acima; não há campo de texto para preencher. Procure Work item 001 ready na página de recebimento dos óculos.
· Registre o critério de aprovação: No Logcat dos óculos, filtre por package:com.rokid.glesse tag:MessageActivity e confirme que a mesma mensagem chegou. O log de envio do próprio celular, sozinho, não comprova o recebimento. Salve as versões do SDK, a build do firmware, a revisão do código-fonte e as alterações nas ferramentas de build junto com o resultado. O sucesso significa que os dois apps são executados, o Bluetooth se conecta e os óculos recebem visivelmente a mensagem de teste.
Problemas comuns de configuração
· Os óculos carregam, mas não são detectados: Use o cabo de dados e depuração e repita a verificação do ADB da Etapa 8. O cabo de carregamento comum é a primeira coisa a descartar.
· O Gradle não consegue baixar uma biblioteca: Em Build, expanda o erro e anote o pacote e a URL do servidor exatos. Verifique as entradas de repositório da Etapa 5 e o acesso pelo proxy da empresa. A demo inclui repositórios e dependências adicionais além dos dois SDKs da Rokid; não os exclua indiscriminadamente nem adicione um mirror qualquer.
· Erros de log duplicado ou de bibliotecas nativas: Verifique se há entradas duplicadas do SDK e a exclusão de org.slf4j. Mantenha as regras existentes de packagingOptions para libr2aud.so no app dos óculos e libc++_shared.so no app do celular. Um erro de biblioteca duplicada significa que duas dependências empacotaram o mesmo arquivo.
· O pareamento funciona, mas nenhuma mensagem chega: Mantenha a página de recebimento dos óculos aberta e confirme que GlassSample não foi alterado. No Logcat, verifique as duas mensagens de inicialização bem-sucedida antes de enviar. Se o dispositivo não puder ser descoberto, verifique as permissões de Dispositivos por perto do celular e, antes de tudo, desconecte qualquer outro celular.
Conclusão
Configurar um ambiente de desenvolvimento para Rokid Glass3 começa com óculos compatíveis com o firmware enterprise e o cabo de dados e depuração correto, e depois passa pelo Android Studio, pelo JDK 17, pelas dependências do Maven e por uma configuração de build consistente. Executar as demos do celular e dos óculos e verificar o recebimento de uma mensagem de trabalho estabelece uma base prática antes de adicionar lógica de negócio ou serviços online. Para as empresas, esse processo pode reduzir atrasos evitáveis na configuração, facilitar a reprodução de pilotos e dar aos desenvolvedores uma base mais clara para aplicativos que fornecem informações úteis enquanto os funcionários mantêm as mãos livres.
Confirme o hardware enterprise, o cabo de dados e depuração e o suporte do firmware antes de comprar um kit de desenvolvimento ou solicitar um piloto para sua empresa.
