Ancrages spatiaux partagés

• Décrire la fonctionnalité des ancrages spatiaux partagés dans un environnement multijoueur.
• Expliquer la procédure de configuration d’une application pour le partage des ancrages spatiaux.
• Définir le processus de création, d’enregistrement, de partage et de chargement d’un ancrage spatial à l’aide des méthodes OVRSpatialAnchor.

• Un moyen de partager et de charger des ancrages en utilisant un UUID de groupe arbitraire
• Moins de conditions requises que pour le partage basé sur l’utilisateur ou l’utilisatrice
• Prise en charge assurée dans la version 71 et les versions ultérieures
• Approche recommandée pour le partage et le chargement des ancrages

• Un moyen de partager et de charger des ancrages qui cible l’utilisateur ou l’utilisatrice en particulier en utilisant son identifiant Oculus
• Nécessite la création d’une application Quest Store afin de demander des autorisations d’accès aux données d’identification et de profil utilisateur ou utilisatrice
• Davantage de conditions requises que pour la version basée sur le groupe

public static OVRTask<OVRResult<OVRAnchor.ShareResult>> ShareAsync(IEnumerable<OVRSpatialAnchor> anchors, Guid groupUuid);

public static OVRTask<OVRResult<OVRAnchor.ShareResult>> ShareAsync(IEnumerable<OVRSpatialAnchor> anchors, IEnumerable<Guid> groupUuids);

public static OVRTask<OVRResult<List<UnboundAnchor>, OperationResult>> LoadUnboundSharedAnchorsAsync(Guid groupUuid, List<UnboundAnchor> unboundAnchors)

• Meta Quest 2, Quest Pro, Quest 3 ou Quest 3S
• Version 71 ou ultérieure du SDK Meta XR Core⁠

Dans votre OVRCameraRig, ouvrez l’inspecteur Unity, puis activez Shared Spatial Anchors (Ancrages spatiaux partagés) et Passthrough (Caméra réelle) dans la section des fonctionnalités Quest d’OVRManager.

<uses-permission android:name=”com.oculus.permission.USE_ANCHOR_API” />
<uses-permission android:name=”com.oculus.permission.IMPORT_EXPORT_IOT_MAP_DATA” android:required=”false” />
<uses-feature android:name=”com.oculus.feature.PASSTHROUGH” android:required=”true” />

1. Le joueur ou la joueuse qui partage les ancrages spatiaux n’a pas besoin de garder la trace des identifiants utilisateur ou utilisatrice avec lesquels effectuer le partage. Au lieu de cela, il est possible d’effectuer le partage via un identifiant de groupe unique auquel tous les clients peuvent faire référence.
2. Il n’est plus nécessaire de gérer une liste d’identifiants d’ancrage uniques à charger, car l’identifiant de groupe peut servir à rechercher l’ensemble complet des ancrages déjà partagés avec le groupe.

// Share multiple anchors with a group
public static OVRTask<OperationResult> ShareAsync(
    IEnumerable<OVRSpatialAnchor> anchors,
    Guid groupUuid);

public static OVRTask<OVRResult<List<UnboundAnchor>, OperationResult>> LoadUnboundSharedAnchorsAsync(
    Guid groupUuid,
    List<UnboundAnchor> unboundAnchors)

public OVRTask<OperationResult> ShareAsync(OVRSpaceUser user);

public OVRTask<OperationResult> ShareAsync(OVRSpaceUser user1, OVRSpaceUser user2);

public OVRTask<OperationResult> ShareAsync(OVRSpaceUser user1, OVRSpaceUser user2, OVRSpaceUser user3);

public OVRTask<OperationResult> ShareAsync(OVRSpaceUser user1, OVRSpaceUser user2, OVRSpaceUser user3, OVRSpaceUser user4);

public OVRTask<OperationResult> ShareAsync(IEnumerable<OVRSpaceUser> users);

public static OVRTask<OperationResult> ShareAsync(IEnumerable<OVRSpatialAnchor> anchors, IEnumerable<OVRSpaceUser> users);

public static OVRTask<OVRResult<List<UnboundAnchor>, OVRAnchor.FetchResult>> LoadUnboundAnchorsAsync(IEnumerable<Guid> uuids, List<UnboundAnchor> unboundAnchors, Action<List<UnboundAnchor>, int> onIncrementalResultsAvailable = null);

public static OVRTask<OVRResult<List<UnboundAnchor>, OperationResult>> LoadUnboundSharedAnchorsAsync(IEnumerable<Guid> uuids, List<UnboundAnchor> unboundAnchors)

Sélectionnez votre OVRCameraRig dans la hiérarchie de l’éditeur Unity, accédez à l’inspecteur Unity, puis dans la section Quest Features (Fonctionnalités Quest) d’OVRManager, activez Shared Spatial Anchors (Ancrages spatiaux partagés) et Passthrough (Caméra réelle).

<uses-permission android:name=”com.oculus.permission.USE_ANCHOR_API” />
<uses-permission android:name=”com.oculus.permission.IMPORT_EXPORT_IOT_MAP_DATA” android:required=”false” />
<uses-feature android:name=”com.oculus.feature.PASSTHROUGH” android:required=”true” />

• Le/la développeur·se est membre d’une équipe de développeur·ses vérifiée.
  • Comment créer et gérer une équipe de développement.
  • Comment vérifier une équipe de développement
• Les développeur·ses sont des utilisateurs et utilisatrices test pour l’équipe de développement propriétaire de l’application.
  • Comment gérer les utilisateurs et utilisatrices test
  • Comment importer une application dans une équipe de développement
• Le développeur ou la développeuse reçoit l’invitation d’une équipe de développeur·ses pour rejoindre un quelconque canal de sortie autre que le canal LIVE/Production de l’application.
  • Comment ajouter des utilisateur·ices à un canal de sortie
  • Comment importer une application dans une équipe de développement

1. Obtenez l’accès admin à votre application si vous ne l’avez pas déjà.
2. Connectez-vous au Tableau de bord développeur(se) Meta Horizon.
3. Sélectionnez votre application.
4. Dans le volet de navigation de gauche, cliquez sur Conditions requises > Contrôle de l’utilisation des données.
5. Ajoutez les fonctionnalités de plateforme ID utilisateur et Profil utilisateur, puis soumettez la demande.

// Share multiple anchors with a group
public static OVRTask<OperationResult> ShareAsync(
    IEnumerable<OVRSpatialAnchor> anchors,
    IEnumerable<OVRSpaceUser> users);

public static OVRTask<OVRResult<List<UnboundAnchor>, OperationResult>> LoadUnboundSharedAnchorsAsync(
    IEnumerable<Guid> uuids,
    List<UnboundAnchor> unboundAnchors)

1. Pour connecter les utilisateurs et utilisatrices les un·es avec les autres, créez un salon en utilisant la solution réseau. Invitez les utilisateurs et utilisatrices à rejoindre ce salon, via l’adhésion, le tableau d’activité ou une invitation. Par exemple, les fonctions de matchmaking et de lobby de Photon peuvent vous y aider.
2. Créez un ancrage en instanciant un objet qui contient le composant OVRSpatialAnchor.
3. Enregistrez l’ancrage en utilisant OVRSpatialAnchor.SaveAnchorAsync(), puis patientez le temps que l’appel prenne fin avant de partager l’ancrage.
4. Partagez l’ancrage avec un ensemble d’utilisateurs et d’utilisatrices en utilisant OVRSpatialAnchor.ShareAsync() pour la totalité des joueurs et joueuses du salon. Les autres joueur·ses peuvent charger l’ancrage SSA dès la fin de cet appel.
5. Diffusez l’UUID de l’ancrage. Par exemple, diffusez l’UUID de l’ancrage SSA à l’ensemble des joueurs et joueuses du salon en utilisant la solution réseau.
6. Chargez l’ancrage. Chaque joueur·se peut à présent charger l’ancrage à partir de l’UUID obtenu à l’étape ci-dessus en utilisant OVRSpatialAnchor.LoadUnboundSharedAnchorsAsync().
7. Tous les joueurs et toutes les joueuses peuvent désormais utiliser l’ancrage comme cadre de coordonnées partagées, ou origine.

public async void ShareExample(
    OVRSpatialAnchor spatialAnchor,
    IEnumerable<OVRSpaceUser> users)
{
    var result = await spatialAnchor.ShareAsync(users);
    if (result.IsSuccess())
    {
        BroadcastUuidToUsers(spatialAnchor.Uuid);
        return;
    }

    switch (result)
    {
        case OVRSpatialAnchor.OperationResult.Failure_SpaceNetworkRequestFailed:
        {
            // Unable to reach Meta servers.
            // Instruct user to check internet connection
            break;
        }
        case OVRSpatialAnchor.OperationResult.Failure_SpaceCloudStorageDisabled:
        {
            // inform user to turn on Enhanced Spatial Services
            // Settings > Privacy and Safety > Device Permissions > Turn on "Enhanced Spatial Services"
            break;
        }
        // ...
    }
}

var users = new OVRSpaceUser[]
{
    new OVRSpaceUser(userId1),
    new OVRSpaceUser(userId2),
};

ShareExample(anchor, users);

async void ShareExample(OVRSpatialAnchor anchor, OVRSpaceUser[] users)
{
    var shareResult = await anchor.ShareAsync(users);
    if (shareResult.IsError())
    {
        Debug.LogError($"Sharing failed with {shareResult}");
        return;
    }

    Debug.Log($"Anchor {anchor.Uuid} shared with {users.Length} users.");
}

• Étapes à reproduire
  • Hôte : appelle ShareAsync
  • Hôte : quitte l’application
  • Hôte : ne déplace pas de manière significative son appareil Quest
  • Hôte : rouvre l’application
  • Hôte : appelle ShareAsync
  • Invité : appelle LoadUnboundSharedAnchorsAsync
  • Invité : peut observer un ancrage spatial partagé qui ne se charge pas au bon endroit
• Résolution
  • Si l’hôte quitte l’application, il doit déplacer son appareil Quest.

• Résolution
  • Accédez à Paramètres > Confidentialité > Effacer l’historique de l’espace physique.

• L’application de démonstration Unity-SharedSpatialAnchors⁠ est une application éprouvée qui présente l’implémentation d’ancrages spatiaux partagés et permet aux utilisateur·ices d’interagir avec des objets en réseau dans un espace en colocation. La page Exemple d’ancrages spatiaux partagés fournit une documentation sur la procédure de création et d’utilisation de l’exemple.
• L’application de démonstration Unity-Discover⁠ est une application plus récente avec moins de fonctionnalités qui montre comment utiliser efficacement un seul ancrage SSA dans une application multifonction. Pour comprendre comment la fonctionnalité SSA est implémentée, consultez Présentation des ancrages spatiaux partagés (SSA)

• Tutoriel sur les ancrages spatiaux
• Présentation des ancrages spatiaux partagés
• Recommandations
• Dépannage

• Unity-Discover⁠
• Unity-SharedSpatialAnchors⁠
• Unity-StarterSamples⁠