A Conferência de Desenvolvedores Android está de volta com uma faixa dedicada ao Android XR. Aproveite, teste os recursos e envie seu feedback.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Começar a criar experiências imersivas

Dispositivos XR relevantes

Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.

Saiba mais sobre esses dispositivos →

Headsets XR

Óculos XR com fio

Saiba mais sobre esses dispositivos →

Depois de instalar e configurar o Android Studio, criar um projeto e configurar o SDK do Jetpack para XR, você vai poder começar a criar experiências imersivas para dispositivos como headsets XR e óculos XR com fio.

Antes de começar a explorar todas as maneiras de criar, leia as informações e conclua as tarefas nas seções a seguir para garantir que o app esteja configurado para o desenvolvimento de XR imersiva.

Configurar o arquivo de manifesto do app

Assim como em outros projetos de apps Android, seu app Android XR precisa ter um arquivo AndroidManifest.xml com configurações de manifesto específicas. O arquivo de manifesto descreve informações essenciais sobre o app para as ferramentas de build do Android, para o sistema operacional Android e para o Google Play. Consulte o guia de visão geral do manifesto do app para mais informações.

Para apps diferenciados de XR, o arquivo de manifesto precisa conter os seguintes elementos e atributos:

Propriedade PROPERTY_XR_ACTIVITY_START_MODE

A propriedade android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE" permite que o sistema saiba que uma atividade precisa ser iniciada em um modo específico quando ela é iniciada.

Essa propriedade tem os seguintes valores:

XR_ACTIVITY_START_MODE_HOME_SPACE (somente SDK do Jetpack XR)
XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED (somente SDK do Jetpack XR)

XR_ACTIVITY_START_MODE_HOME_SPACE

Use esse modo de início para abrir o app no Espaço Compacto. No Espaço Compacto, vários apps podem ser executados lado a lado para que os usuários realizem várias tarefas. Qualquer app Android para dispositivos móveis ou telas grandes pode operar no Espaço Compacto, assim como os apps de XR criados com o SDK do Jetpack XR.

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

Use esse modo de inicialização para abrir o app no Espaço Ampliado. No Espaço Ampliado, apenas um app é executado por vez, sem limites de espaço, e todos os outros apps ficam ocultos.


<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

Propriedade PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

A propriedade android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED" indica que o aplicativo precisa ser iniciado com um tipo específico de limite. Seu app precisa especificar XR_BOUNDARY_TYPE_LARGE se ele foi projetado para permitir que os usuários se movam pelo espaço físico. Especificar XR_BOUNDARY_TYPE_NO_RECOMMENDATION não fornece recomendações para o tipo de limite de segurança. Portanto, o sistema usa o tipo que já está em uso.

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED"
           android:value="XR_BOUNDARY_TYPE_LARGE" />
   </application>
</manifest>

Recursos do PackageManager para apps de XR

Ao distribuir apps pela Google Play Store, é possível especificar os recursos de hardware ou software necessários no manifesto do app. O elemento uses-feature permite que a Google Play Store filtre adequadamente os apps mostrados aos usuários.

Os recursos a seguir são específicos para apps diferenciados de XR.

android.software.xr.api.spatial

Os apps criados com o SDK do Jetpack para XR precisam incluir esse recurso no manifesto do app. O valor definido para o atributo android:required depende da faixa de lançamento do app.

Se o app agrupar recursos ou conteúdo diferenciados de XR em um APK para dispositivos móveis existente e for publicado na faixa de lançamento para dispositivos móveis, defina o atributo android:required como false:

<!-- If you are publishing an existing mobile APK using the mobile release track, set android:required to false.-->
<uses-feature android:name="android.software.xr.api.spatial" android:required="false" />

Se o app foi criado especificamente para dispositivos com XR e é publicado na faixa de lançamento dedicada ao Android XR, defina o atributo android:required como true:

<!-- If you are publishing a separate APK for XR using the dedicated Android XR release track, set android:required to true.-->
<uses-feature android:name="android.software.xr.api.spatial" android:required="true" />

android.hardware.xr.input.controller

Esse recurso indica que o app precisa de entrada de um controlador de movimento de alta precisão e 6DoF (graus de liberdade) para funcionar corretamente. Se o app oferece suporte a controles e não funciona sem eles, defina o valor como true. Se o app for compatível com controles, mas puder funcionar sem eles, defina-o como false.

<!-- Sets android:required to true, indicating that your app can't function on devices without controllers. -->
<uses-feature android:name="android.hardware.xr.input.controller" android:required="true" />

android.hardware.xr.input.hand_tracking

Essa flag indica que o app precisa de captura de movimentos das mãos de alta fidelidade para funcionar corretamente, incluindo posição, orientação e velocidade das articulações na mão do usuário. Se o app for compatível com a captura de movimentos das mãos e não puder funcionar sem ela, defina o valor como true. Se o app for compatível com a captura de movimentos das mãos, mas puder funcionar sem ela, defina como false.

<!-- Sets android:required to true, indicating that your app can't function on devices without hand tracking. -->
<uses-feature android:name="android.hardware.xr.input.hand_tracking" android:required="true" />

android.hardware.xr.input.eye_tracking

Essa flag indica que o app requer acompanhamento ocular de alta fidelidade para que a entrada funcione corretamente. Se o app oferece suporte ao acompanhamento ocular para entrada e não pode funcionar sem ele, defina o valor como true. Se o app aceitar o acompanhamento ocular para entrada, mas puder funcionar sem ele, defina como false.

<!-- Sets android:required to true, indicating that your app can't function on devices without eye tracking. -->
<uses-feature android:name="android.hardware.xr.input.eye_tracking" android:required="true" />

android.hardware.xr.input.face_tracking

Essa flag indica que o app requer hardware de captura de expressões faciais para funcionar corretamente. Se o app for compatível com a captura de expressões faciais e não funcionar sem ela, defina o valor como true. Se o app for compatível com a captura de expressões faciais, mas puder funcionar sem ela, defina como false.

<!-- Sets android:required to true, indicating that your app can't function on devices without face tracking. -->
<uses-feature android:name="android.hardware.xr.input.face_tracking" android:required="true" />

Considerações sobre a compatibilidade do manifesto do app para apps de dispositivos móveis e telas grandes

Conforme descrito na seção Recursos do PackageManager para apps de XR, os apps declaram que usam um recurso em um elemento <uses-feature> no manifesto do app. Alguns recursos, como telefonia ou GPS, podem não ser compatíveis com todos os dispositivos.

Para ver uma lista dos recursos ativados em um dispositivo, execute adb shell pm list features.

Recursos não suportados

A Google Play Store filtra os aplicativos disponíveis para instalação em um dispositivo usando as seguintes declarações de recursos do Android.

Próximas etapas

Agora que você terminou de configurar o manifesto do app e de analisar informações importantes, conheça as maneiras de criar experiências imersivas:

Começar a criar experiências imersivas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Configurar o arquivo de manifesto do app

Propriedade PROPERTY_XR_ACTIVITY_START_MODE

XR_ACTIVITY_START_MODE_HOME_SPACE

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

Propriedade PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Recursos do PackageManager para apps de XR

android.software.xr.api.spatial

android.hardware.xr.input.controller

android.hardware.xr.input.hand_tracking

android.hardware.xr.input.eye_tracking

android.hardware.xr.input.face_tracking

Considerações sobre a compatibilidade do manifesto do app para apps de dispositivos móveis e telas grandes

Recursos não suportados

Hardware da câmera

Conectividade

Configuração do dispositivo

Configuração do formato

Entrada

Local

Comunicação a curta distância (NFC)

Configuração de segurança e hardware

Sensores

Configuração de software

Telefonia

Realidade virtual (legado)

Widgets

Próximas etapas

Começar a criar experiências imersivas