Créer un projet de script cloud simple

Dans cet article, vous allez créer et publier un projet simple à l’aide de Mesh Cloud Scripting. L’article part du principe que vous avez déjà configuré cloud Scripting sur votre système. Nous vous recommandons de vous familiariser avec la liste actuelle des problèmes connus du kit de ressources Mesh avant de commencer le développement avec Mesh Cloud Scripting.

En savoir plus sur l’infrastructure et la gestion de script cloud Mesh.

Créer une scène avec le script cloud Mesh

Les instructions suivantes montrent comment créer un environnement simple avec un cube qui pivote lorsqu’un utilisateur clique dessus.

1. Accédez à l’article nommé Créer ou mettre à jour un projet existant. Si vous créez un projet, veillez à suivre toutes les étapes de la section nommée Créer un projet. Si vous mettez à jour un projet existant, procédez de la même façon pour la section nommée Mettre à jour un projet existant.

2. Créez une scène.

3. Ajoutez un point de voyage à la scène.

4. Enregistrez la scène et nommez-la. Pour cet exemple, nous allons utiliser le nom MyFirstCloudScripting.

5. Dans la barre de menus, sélectionnez GameObject>Mesh Toolkit>Set-up Cloud Scripting.

   

   Notez qu’un objet de jeu nommé Mesh Cloud Scripting apparaît dans la hiérarchie et est sélectionné. Si vous cliquez sur le bouton Ouvrir le dossier d’application dans l’inspecteur ...

   

   ... Vous verrez dans l’Explorateur de fichiers Windows que cela crée également un projet ASP.NET Core nommé MyFirstCloudScripting.csproj dans les ressources > . Dossier MeshCloudScripting > MyFirstCloudScripting.

   

Modifier la scène

1. Configurez le mode Play avec l’émulation de maillage. Veillez à ajouter un GameObject à la scène qui peut agir comme un plancher et le définir sur la couche GroundCollision .

2. Lorsque vous configurez le mode Play avec l’émulation mesh, il ajoute le prefab MeshEmulatorSetup[NoUpoload] à la scène qui contient l’appareil photo sur lequel vous allez utiliser à partir de ce point. Vous n’avez plus besoin de l’appareil photo principal par défaut GameObject ; supprimez-le.

   

3. Dans la barre de menus, sélectionnez GameObject>3D object>Cube.

4. Dans la hiérarchie, faites glisser le cube vers l’objet Mesh Cloud Scripting pour que le cube soit un enfant de cet objet.

   

5. Une fois le cube sélectionné, dans l’inspecteur, accédez au composant Transform, puis remplacez les valeurs position et rotation du cube par les valeurs suivantes :

   Position : X = 0,1, Y = 1,5, Z = 3,3.

   Rotation : X = -15, Y = 0,8, Z = 0,1

   Conseil : l’appareil photo dans le prefab MeshEmulatorSetup[NoUpload] est un objet enfant d’AvatarHead.

   

6. Dans l’inspecteur, cliquez sur Ajouter un composant, puis sélectionnez Configuration interagissante mesh.

   

7. Enregistrez la scène.

Modifier le projet C#

1. Dans la hiérarchie, sélectionnez l’objet Mesh Cloud Scripting .

2. Dans l’Inspecteur, accédez au composant Mesh Cloud Scripting, puis cliquez sur le bouton Ouvrir le dossier de l’application. Cela s’ouvre Explorateur de fichiers et vous affiche une vue du contenu de votre projet.

   

3. Ouvrez le App.cs script dans votre éditeur de code.

4. Notez que dans la classe App, il existe deux variables :

   private readonly ILogger<App> _logger;
   private readonly ICloudApplication _app;
   

   Ajoutez ce qui suit en tant que troisième variable :

   private float _angle = 0;
   

5. La méthode StartAsync contient un commentaire unique : « Ajoutez le code de démarrage de votre application ici ». Remplacez cela par le code ci-dessous pour que la méthode StartAsync ressemble à ce qui suit :

   public Task StartAsync(CancellationToken token)
   {
       // First we find the TransformNode that corresponds to our Cube gameobject
       var transform = _app.Scene.FindFirstChild<TransformNode>();
   
       // Then we find the InteractableNode child of that TransformNode
       var sensor = transform.FindFirstChild<InteractableNode>();
   
       // Handle a button click
       sensor.Selected += (_, _) =>
       {
           // Update the angle on each click
           _angle += MathF.PI / 8;
           transform.Rotation = new Rotation { X = 1, Y = 0, Z = 0, Angle = _angle };
       };
   
       return Task.CompletedTask;
   }
   

6. Enregistrez votre travail.

Exécuter votre application localement

1. Dans Unity, cliquez sur le bouton Lecture de l’éditeur Unity.
2. Dans la fenêtre Jeu , cliquez sur le cube. Chaque fois que vous cliquez, le cube pivote sur son axe « X ».
3. Lorsque vous avez terminé, quittez le mode Play.

Déboguer votre application avec Visual Studio (facultatif)

1. Dans la hiérarchie, vérifiez que l’objet Mesh Cloud Scripting est sélectionné.

2. Dans l’inspecteur, accédez au composant Mesh Cloud Scripting, puis sélectionnez Activer le débogage d’application.

   

3. Entrez le mode Lecture et sélectionnez débogueur.

   

4. Ouvrez le fichier App.cs , puis ajoutez un point d’arrêt, puis poursuivez l’exécution.

   

5. Dans Unity, cliquez sur le cube.

   

Générer et publier l’environnement

Pour générer et publier l’environnement, suivez les instructions de l’article Générer et publiez votre environnement .

Se connecter au service de script cloud à partir d’Unity

1. Dans la hiérarchie, vérifiez que l’objet Mesh Cloud Scripting est sélectionné.
2. Dans l’Inspecteur, accédez au composant Mesh Cloud Scripting, puis ouvrez la liste déroulante Paramètres du développeur.
3. Désélectionnez Exécuter le serveur de script cloud local.
4. Cliquez sur le bouton Lecture de l’éditeur Unity.

Créer un événement et le joindre à partir de l’application Mesh

1. Créez un événement à l’aide de l’environnement que vous venez de créer et de publier. Si vous avez besoin d’aide, découvrez comment créer un événement dans le portail Mesh.
2. Rejoignez l’événement dans l’application Mesh.

Afficher les erreurs du service de script cloud Mesh dans l’application Microsoft Mesh (facultatif)

1. Les messages d’erreur du service de script cloud ne sont pas affichés par défaut dans l’application Mesh afin de réduire les interruptions utilisateur. Si vous devez afficher ces messages à des fins de débogage, procédez comme suit :

2. Ouvrez l’application Mesh.

3. Cliquez sur le bouton Menu , puis sélectionnez Paramètres.

   

4. Dans la barre de menus de gauche, sélectionnez Pour les développeurs.

   

5. Activez le bouton d’erreur Afficher le script Show Mesh sur « activé ».

   

Étapes suivantes