Installer le SDK dans Unity

Objectif

Installer com.tkorp.pulse.sdk et vérifier qu'Unity compile le package sans erreur.

Prérequis

• Unity 6000.3 ou supérieur ;
• un projet dont vous pouvez modifier Packages/manifest.json ;
• un accès Internet au registre Cloudsmith.

Le package dépend de com.unity.nuget.newtonsoft-json 3.2.2. Unity résout cette dépendance automatiquement.

Méthode recommandée : registre dans l'interface Unity

1. Ouvrez Edit > Project Settings > Package Manager.
2. Dans Scoped Registries, cliquez sur +.
3. Saisissez les valeurs suivantes, puis cliquez sur Apply.

4. Ouvrez Window > Package Manager.
5. Sélectionnez My Registries, puis Pulse SDK.
6. Installez la version 0.1.3.

Variante : modifier manifest.json

Ajoutez le registre et la dépendance sans supprimer les entrées déjà présentes :

{
  "scopedRegistries": [
    {
      "name": "TKorp",
      "url": "https://npm.cloudsmith.io/tkorp/pulse-sdk/",
      "scopes": ["com.tkorp"]
    }
  ],
  "dependencies": {
    "com.tkorp.pulse.sdk": "0.1.3"
  }
}

Après l'enregistrement, rendez le focus à Unity et laissez la résolution UPM se terminer.

Variante : installer par nom

Une fois le scoped registry déclaré, ouvrez Window > Package Manager, cliquez sur +, puis Install package by name… :

• Name : com.tkorp.pulse.sdk
• Version : 0.1.3

Importer l'exemple officiel

Dans la fiche du package, ouvrez Samples, puis importez Getting Started. Le composant ExampleLampe montre une action et une variable bornée. L'exemple ne crée pas automatiquement la connexion : vous la configurerez dans le tutoriel suivant.

Vérifier l'installation

Créez PulseInstallationCheck.cs dans Assets/Scripts :

using PulseSDK.Attributes;
using PulseSDK.Core;

public sealed class PulseInstallationCheck : PulseBehaviour
{
    [PulseAction("diagnostics.ping")]
    public void Ping()
    {
        UnityEngine.Debug.Log("Pulse SDK is ready");
    }
}

Ajoutez le composant à un GameObject. La Console ne doit afficher aucune erreur de namespace ou de compilation.

Problèmes fréquents

Ce que vous devez avoir à la fin

• com.tkorp.pulse.sdk version 0.1.3 apparaît dans Package Manager.
• Newtonsoft.Json est résolu.
• Le script de vérification compile.
• Un GameObject accepte le composant PulseInstallationCheck.

Étape suivante : créer une intégration Unity complète.