La Preview 3 développeur du SDK Android XR est disponible. Nous aimerions connaître votre avis ! Essayez-les et contactez-nous sur notre page d'assistance.

Cette page a été traduite par l'API Cloud Translation.

Commencer à créer des expériences immersives

Appareils XR concernés

Ces conseils vous aident à créer des expériences pour ces types d'appareils XR.

En savoir plus sur les types d'appareils XR

Casques XR

Lunettes XR filaires

En savoir plus sur les types d'appareils XR

Après avoir installé et configuré Android Studio, créé un projet et configuré le SDK Jetpack XR, vous êtes prêt à créer des expériences immersives.

Avant de découvrir toutes les façons de créer, consultez les informations et effectuez les tâches des sections suivantes pour vous assurer que votre application est configurée pour le développement XR immersif.

Configurer le fichier manifeste de votre application

Comme pour les autres projets d'applications Android, votre application Android XR doit disposer d'un fichier AndroidManifest.xml avec des paramètres de fichier manifeste spécifiques. Le fichier manifeste fournit aux outils de compilation Android, au système d'exploitation Android et à Google Play des informations essentielles sur votre application. Pour en savoir plus, consultez le guide de présentation du fichier manifeste d'application.

Pour les applications différenciées XR, votre fichier manifeste doit contenir les éléments et attributs suivants :

Propriété PROPERTY_XR_ACTIVITY_START_MODE

La propriété android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE" indique au système qu'une activité doit être lancée dans un mode spécifique lorsqu'elle démarre.

Cette propriété accepte les valeurs suivantes :

XR_ACTIVITY_START_MODE_HOME_SPACE (SDK Jetpack XR uniquement)
XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED (SDK Jetpack XR uniquement)

XR_ACTIVITY_START_MODE_HOME_SPACE

Utilisez ce mode de démarrage pour lancer votre application dans l'espace d'accueil. Dans l'espace Maison, plusieurs applications peuvent s'exécuter côte à côte, ce qui permet aux utilisateurs d'effectuer plusieurs tâches à la fois. Toute application Android mobile ou pour grand écran peut fonctionner dans l'espace d'accueil, ainsi que les applications XR conçues à l'aide du SDK 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

Utilisez ce mode de démarrage pour lancer votre application en mode Full Space. En mode Plein écran, une seule application s'exécute à la fois, sans limites spatiales, et toutes les autres applications sont masquées.


<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>

Propriété PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

La propriété android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED" indique que l'application doit être lancée avec un type de limite spécifique. Votre application doit spécifier XR_BOUNDARY_TYPE_LARGE si elle est conçue pour permettre aux utilisateurs de se déplacer dans leur espace physique. Si vous spécifiez XR_BOUNDARY_TYPE_NO_RECOMMENDATION, aucune recommandation n'est fournie pour le type de limite de sécurité. Le système utilise donc le type déjà en place.

<manifest ... >

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

Fonctionnalités de PackageManager pour les applications XR

Lorsque vous distribuez des applications sur le Google Play Store, vous pouvez spécifier les fonctionnalités matérielles ou logicielles requises dans le fichier manifeste de l'application. L'élément uses-feature permet au Play Store de filtrer correctement les applications affichées aux utilisateurs.

Les fonctionnalités suivantes sont spécifiques aux applications différenciées XR.

android.software.xr.api.spatial

Les applications créées à l'aide du SDK Jetpack XR doivent inclure cette fonctionnalité dans le fichier manifeste de l'application. La valeur que vous définissez pour l'attribut android:required dépend de la piste de publication de votre application.

Si votre application regroupe des fonctionnalités ou du contenu XR différenciés dans un APK mobile existant et qu'elle est publiée sur le canal de publication mobile, définissez l'attribut android:required sur 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" />

Si votre application est conçue spécifiquement pour les appareils compatibles avec la réalité XR et qu'elle est publiée sur le canal de publication dédié Android XR, définissez l'attribut android:required sur 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

Cette fonctionnalité indique que l'application nécessite une entrée d'un contrôleur de mouvement 6 DoF (degrés de liberté) de haute précision pour fonctionner correctement. Si votre application est compatible avec les manettes et ne peut pas fonctionner sans elles, définissez la valeur sur true. Si votre application est compatible avec les manettes, mais peut fonctionner sans, définissez-la sur 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

Cet indicateur indique que l'application nécessite un suivi des mains haute fidélité pour fonctionner correctement, y compris la position, l'orientation et la vitesse des articulations de la main de l'utilisateur. Si votre application est compatible avec le suivi des mains et ne peut pas fonctionner sans, définissez la valeur sur true. Si votre application est compatible avec le suivi des mains, mais peut fonctionner sans, définissez-le sur 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

Ce flag indique que l'application nécessite un suivi oculaire haute fidélité pour que la saisie fonctionne correctement. Si votre application est compatible avec le suivi du regard pour la saisie et ne peut pas fonctionner sans, définissez la valeur sur true. Si votre application est compatible avec le suivi du regard pour la saisie, mais peut fonctionner sans, définissez-le sur 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" />

Éléments à prendre en compte concernant la compatibilité du fichier manifeste de l'application pour les applications mobiles et pour grand écran

Comme décrit dans la section Fonctionnalités de PackageManager pour les applications XR, les applications déclarent qu'elles utilisent une fonctionnalité en la déclarant dans un élément <uses-feature> du fichier manifeste de l'application. Il est possible que certaines fonctionnalités, comme la téléphonie ou le GPS, ne soient pas compatibles avec tous les appareils.

Pour obtenir la liste des fonctionnalités activées pour un appareil, exécutez la commande adb shell pm list features.

Fonctionnalités non compatibles

Le Google Play Store filtre les applications disponibles pour l'installation sur un appareil à l'aide des déclarations de fonctionnalités Android suivantes.

Étapes suivantes

Maintenant que vous avez terminé de configurer le fichier manifeste de votre application et d'examiner les informations importantes, découvrez comment créer des expériences immersives :

Commencer à créer des expériences immersives Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Configurer le fichier manifeste de votre application

Propriété PROPERTY_XR_ACTIVITY_START_MODE

XR_ACTIVITY_START_MODE_HOME_SPACE

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

Propriété PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

Fonctionnalités de PackageManager pour les applications XR

android.software.xr.api.spatial

android.hardware.xr.input.controller

android.hardware.xr.input.hand_tracking

android.hardware.xr.input.eye_tracking

Éléments à prendre en compte concernant la compatibilité du fichier manifeste de l'application pour les applications mobiles et pour grand écran

Fonctionnalités non compatibles

Module photo

Connectivité

Configuration de l'appareil

Configuration du facteur de forme

Entrée

Position

Technologie NFC (communication en champ proche)

Configuration de la sécurité et matériel

Capteurs

Configuration logicielle

Téléphonie

Réalité virtuelle (ancienne)

Widgets

Étapes suivantes

Commencer à créer des expériences immersives