LeAWSKit SDK Mobile pour UnityAWS SDK for .NET. Ce guide fait référence à la version archivée du kit SDK Mobile pour Unity. Pour de plus amples informations, veuillez consulterPrésentation deAWSKit SDK Mobile pour Unity

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du kit SDK AWS Mobile pour Unity

Pour débuter avec le kit SDK AWS Mobile pour Unity, vous pouvez configurer le kit SDK et commencer à créer un nouveau projet, ou bien intégrer le kit SDK à un projet existant. Vous pouvez également cloner et exécuter les exemples pour comprendre comment fonctionne le kit de développement logiciel.

Prérequis

Avant de pouvoir utiliser le kit SDK AWS Mobile pour Unity, vous avez besoin des éléments suivants :

Une fois les conditions requises respectées, vous devez effectuer les opérations suivantes :

Étape 1 : Télécharger le kit SDK AWS Mobile pour Unity

Pour commencer, téléchargez le kit SDK AWS Mobile pour Unity. Chaque package du kit SDK est requis pour pouvoir utiliser le service AWS correspondant (en fonction du nom du package). Par exemple, les recettesaws-unity-sdkLe package -dynamodb-2.1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.package permet d'appeler le service AWS DynamoDB. Vous pouvez importer tous les packages ou seulement ceux dont vous avez besoin.

Étape 2 : Configurer le kit SDK AWS Mobile pour Unity

Créer une scène

Lorsque vous utilisez le kit SDK AWS Mobile pour Unity, vous pouvez commencer en incluant la ligne de code suivante dans la méthode Start ou Awake de votre classe de comportement Mono :

UnityInitializer.AttachToGameObject(this.gameObject);

Créez votre scène en cliquant sur New Scene dans le menu File.

Le kit SDK AWS pour Unity contient des classes client pour chaque service AWS pris en charge. Ces clients sont configurés à l'aide d'un fichier nommé awsconfig.xml. La section suivante décrit les paramètres plus couramment utilisés dans le fichier awsconfig.xml. Pour plus d'informations sur ces paramètres, consultez la section Référence d'API du kit SDK Unity.

Définir la région par défaut des services AWS

Pour configurer la région par défaut pour tous les clients du service :

<aws region="us-west-2" />

Ce paramètre définit la région par défaut pour tous les clients de service figurant dans le kit SDK Unity. Ce paramètre peut être remplacé en spécifiant explicitement la région au moment de la création d'une instance du client de service, comme suit :

IAmazonS3 s3Client = new AmazonS3Client(<credentials>,RegionEndpoint.USEast1);

Définir les informations de journalisation

Les paramètres de journalisation sont spécifiés comme suit :

<logging logTo="UnityLogger"
         logResponses="Always"
         logMetrics="true"
         logMetricsFormat="JSON" />

Ce paramètre est utilisé pour configurer la journalisation dans Unity. Quand vous consignez des données dans UnityLogger, le framework imprime les données de sortie en interne dans les journaux de débogage. Si vous souhaitez consigner des réponses HTTP, définissez l'indicateur logResponses ; les valeurs possibles sont Always, Never et les valeurs possibles sont Always, Never, etOnError. Vous pouvez également consigner des mesures de performance pour les requêtes HTTP à l'aide de la propriété logMetrics ; le format de journalisation peut être spécifié viaLogMetricsFormat, les valeurs possibles sont JSON ou standard.

L'exemple suivant illustre les paramètres les plus couramment utilisés dans le fichier awsconfig.xml. Pour plus d'informations sur certains paramètres de service spécifiques, consultez la section ci-dessous :

<?xml version="1.0" encoding="utf-8"?>
<aws region="us-west-2"
    <logging logTo="UnityLogger"
             logResponses="Always"
             logMetrics="true"
             logMetricsFormat="JSON" />
/>

Utilisation du fichier link.xml

Le kit SDK utilise la réflexion pour les composants spécifiques à chaque plate-forme. Si vous utilisez le backend de script IL2CPP, strip bytecode est toujours activé sous iOS, vous devez donc avoir un fichier link.xml dans votre racine d'assemblage, avec les entrées suivantes :

<linker>
<!-- if you are using AWSConfigs.HttpClient.UnityWebRequest option-->
<assembly fullname="UnityEngine">
    <type fullname="UnityEngine.Networking.UnityWebRequest" preserve="all" />
    <type fullname="UnityEngine.Networking.UploadHandlerRaw" preserve="all" />
    <type fullname="UnityEngine.Networking.UploadHandler" preserve="all" />
    <type fullname="UnityEngine.Networking.DownloadHandler" preserve="all" />
    <type fullname="UnityEngine.Networking.DownloadHandlerBuffer" preserve="all" />
</assembly>
<assembly fullname="mscorlib">
    <namespace fullname="System.Security.Cryptography" preserve="all"/>
</assembly>
<assembly fullname="System">
    <namespace fullname="System.Security.Cryptography" preserve="all"/>
</assembly>
<assembly fullname="AWSSDK.Core" preserve="all"/>
<assembly fullname="AWSSDK.CognitoIdentity" preserve="all"/>
<assembly fullname="AWSSDK.SecurityToken" preserve="all"/>
add more services that you need here...
</linker>

Étape 3 : Obtenir l'ID du groupe d'identités avec Amazon Cognito

Pour utiliser les services AWS dans votre application mobile, vous devez obtenir l'ID du groupe d'identités à l'aide d'Amazon Cognito Identity. L'utilisation d'Amazon Cognito pour connaître l'ID du groupe d'identités permet à votre application d'accéder aux services AWS sans avoir à y intégrer vos informations d'identification privées. Cette approche vous permet également de définir des autorisations pour contrôler les services AWS auxquels vos utilisateurs ont accès.

Pour commencer avec Amazon Cognito, vous devez créer un groupe d'identités. Un groupe d'identités stocke les données d'identité utilisateur spécifiques à votre compte. Chaque groupe d'identités a des rôles IAM configurables que vous pouvez utiliser pour spécifier les services AWS auxquels les utilisateurs de votre application ont accès. En général, les développeurs utilisent un groupe d'identités par application. Pour en savoir plus sur les groupes d'identités, consultez le manuel du développeur Amazon Cognito.

Pour créer un pool d'identités pour votre application :

La page suivante affiche un code qui crée un fournisseur d'informations d'identification, afin que vous puissiez facilement intégrer Cognito Identity à votre application Unity. Transmettez l'objet du fournisseur d'informations d'identification au constructeur du client AWS que vous utilisez. Ce code se présente sous la forme suivante :

CognitoAWSCredentials credentials = new CognitoAWSCredentials (
    "IDENTITY_POOL_ID", // Identity Pool ID
    RegionEndpoint.USEast1 // Region
);

Étapes suivantes