Démarrage rapide : Créer un modèle Object Anchors à partir d’un modèle 3D

  • Article

Azure Object Anchors est un service cloud géré qui convertit les modèles 3D en modèles IA qui permettent des expériences de réalité mixte prenant en charge les objets pour HoloLens. Ce guide de démarrage rapide explique comment créer un modèle Object Anchors à partir d’un modèle 3D en utilisant le SDK de conversion Azure Object Anchors pour .NET.

Vous découvrirez comment effectuer les actions suivantes :

Prérequis

Pour suivre ce guide de démarrage rapide, veillez à avoir :

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Créer un compte Object Anchors

Tout d’abord, vous devez créer un compte avec le service Object Anchors.

  1. Accédez au portail Azure et sélectionnez Créer une ressource.

    Create a new resource

  2. Recherchez la ressource Object Anchors.

    Recherchez « Object Anchors ».

    Select the Object Anchors Resource

    Sur la ressource Object Anchors dans les résultats de la recherche, sélectionnez Créer -> Object Anchors.

    Create an Object Anchors Resource

  3. Dans la boîte de dialogue Compte Object Anchors :

    • Entrez un nom de ressource unique.
    • Sélectionnez l’abonnement auquel attacher la ressource.
    • Créez un groupe de ressources ou utilisez un groupe existant.
    • Sélectionnez la région dans laquelle vous souhaitez que votre ressource existe.

    Enter Object Anchors resource account details

    Sélectionnez Créer pour commencer à créer la ressource.

  4. Une fois la ressource créée, sélectionnez Accéder à la ressource.

    Go to resource

  5. Sur la page de présentation :

    Prenez note du Domaine du compte. Vous en aurez besoin ultérieurement.

    Copy the account domain for your Object Anchors resource

    Prenez note de l’ID de compte. Vous en aurez besoin ultérieurement.

    Copy the account ID for your Object Anchors resource

    Accédez à la page Clés d’accès et prenez note de la Clé primaire. Vous en aurez besoin ultérieurement.

    Copy the account key for your Object Anchors resource

Récupération de l’exemple de projet

Clonez le dépôt d’exemples en exécutant les commandes suivantes :

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

Convertir un modèle 3D

Vous pouvez maintenant continuer et convertir votre modèle 3D.

  1. Ouvrez quickstarts/conversion/Conversion.sln dans Visual Studio. Cette solution inclut un seul projet de console C#.

  2. Ouvrez le fichier Configuration.cs situé dans la racine du projet et remplacez les valeurs set-me dans le champs suivants :

    Champ Description
    AccountDomain Domaine de compte du compte Object Anchors créé ci-dessus.
    AccountId ID de compte du compte Object Anchors créé ci-dessus.
    AccountKey Clé primaire du compte Object Anchors créé ci-dessus

    Quatre champs supplémentaires nécessitent une vérification :

    Champ Description
    InputAssetPath Chemin d’accès absolu à un modèle 3D sur votre ordinateur local. Les formats de fichier pris en charge sont fbx, ply, obj et glb.
    AssetDimensionUnit Unité de mesure de votre modèle 3D. Toutes les unités de mesure prises en charge sont accessibles à l’aide de l’énumération Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit.
    Gravité Direction du vecteur de gravité du modèle 3D. Ce vecteur 3D donne la direction vers le bas dans le système de coordonnées de votre modèle. Par exemple, si y négatif représente la direction vers le bas dans l’espace 3D du modèle, cette valeur est Vector3(0.0f, -1.0f, 0.0f).
    DisableDetectScaleUnits À compter de Azure.MixedReality.ObjectAnchors.Conversion 0.3.0-beta.6, les unités de mise à l’échelle incorporées sont utilisées par défaut quand elles sont disponibles pour les fichiers fbx. Ce comportement peut être désactivé en définissant la valeur sur true. Cette option est ignorée pour les formats de fichiers autres que fbx.

  3. Générez et exécutez le projet pour charger votre modèle 3D, inscrivez un nouveau travail de conversion auprès du service, puis attendez qu’il soit terminé. Une fois le travail terminé, le modèle Object Anchors est téléchargé en regard du fichier spécifié dans InputAssetPath. Vous devriez obtenir un résultat similaire à la sortie de console suivante :

     Asset   : ***********
 Gravity : ***********
 Unit    : ***********
 Attempting to upload asset...
 Attempting to create asset conversion job...
 Successfully created asset conversion job. Job ID: ***********
 Waiting for job completion...

 Asset conversion job completed successfully.
 Attempting to download result as '***********'...
 Success!

    Prenez note de l’ID de travail pour référence ultérieure. Cela peut être utile lors du débogage ou de la résolution des problèmes.

  4. Une fois le travail terminé, vous devriez voir un fichier au format <Model-Filename-Without-Extension>_<JobID>.ou dans l’emplacement de sortie spécifié. Par exemple, si le nom de fichier de votre modèle 3D est chair.ply et que l’ID de votre travail est 00000000-0000-0000-0000-000000000000, le nom de fichier généré par le service sera chair_00000000-0000-0000-0000-000000000000.ou .

Codes d’erreur

Pour plus d’informations sur les différents codes d’erreur résultant d’un échec d’un travail de conversion de ressource et sur la façon de les gérer, consultez la page des codes d’erreur de conversion.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Dans ce démarrage rapide, vous avez créé un compte Object Anchors et converti un modèle 3D pour créer un modèle Object Anchors. Pour savoir comment intégrer ce modèle avec le Kit de développement logiciel (SDK) Object Anchors dans votre application de réalité mixte, passez à l’un des articles suivants :

Unity HoloLens

Unity HoloLens avec MRTK

HoloLens DirectX

SDK de conversion