Partager via

Autres API Unity

Important

Visual Studio App Center a été mis hors service le 31 mars 2025, à l’exception des fonctionnalités d’analyse et de diagnostic, qui continueront d’être prises en charge jusqu’au 30 juin 2026. En savoir plus.

Ajuster le niveau de journalisation

Vous pouvez contrôler le nombre de messages de journal qui s’affichent à partir d’App Center dans la console. Utilisez l’API LogLevel pour activer la journalisation étendue lors du débogage. Par défaut, il est défini ASSERT pour les environnements App Store et WARN sinon.

Pour obtenir autant de messages de journal que possible, activez LogLevel.Verbose dans les paramètres de l'App Center ou directement dans votre code.

AppCenter.LogLevel = LogLevel.Verbose;

Identifier les installations

Le Kit de développement logiciel (SDK) App Center crée un UUID pour chaque appareil une fois l’application installée. Cet identificateur reste le même pour un appareil lorsque l’application est mise à jour. Un nouvel identificateur est généré uniquement lorsque l’application est réinstallée. L’API suivante est utile à des fins de débogage.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Identifier les utilisateurs

Le Kit de développement logiciel (SDK) App Center prend en charge la définition d’un ID utilisateur utilisé pour augmenter les rapports d’incident. Pour utiliser cette fonctionnalité :

  1. Configurez le Kit de développement logiciel (SDK) App Center comme décrit dans le guide de prise en main du Kit de développement logiciel (SDK) App Center.
  2. Pour définir un userID dans le SDK, utilisez le code suivant :
AppCenter.SetUserId("your-user-id");

Après avoir défini un ID utilisateur, vous pouvez utiliser la fonctionnalité de recherche d’App Center pour rechercher des rapports d’incident spécifiques pour l’ID. En savoir plus dans la documentation de recherche d’App Center.

Remarque

La valeur de l’ID utilisateur est limitée à 256 caractères. Il s’affiche avec vos rapports d’incident, mais n’est pas utilisé pour l’agrégation ou le nombre d’utilisateurs affectés. Si vous définissez l’ID utilisateur plusieurs fois, seul le dernier ID utilisateur sera utilisé. Vous devez définir l’ID utilisateur vous-même avant le lancement de chaque application, car cette valeur n’est pas stockée par le Kit de développement logiciel (SDK) entre les lancements.

Désactiver tous les services au moment de l’exécution

Si vous souhaitez désactiver tous les services App Center à la fois, utilisez la Enabled propriété. Lorsqu’il est désactivé, le Kit de développement logiciel (SDK) ne transfère aucune information à App Center.

AppCenter.SetEnabledAsync(false);

Pour activer à nouveau tous les services, utilisez la même API, mais passez true en tant que paramètre.

AppCenter.SetEnabledAsync(true);

Vous n’avez pas besoin d’attendre cet appel pour effectuer d’autres appels d’API (par IsEnabledAsyncexemple) cohérents.

L’état est conservé dans le stockage de l’appareil dans les lancements d’application.

Modifier l’état du service dans le runtime

Vous pouvez activer ou désactiver le service au moment de l’exécution avec le code suivant :

Analytics.SetEnabledAsync(true);

Interdire les demandes réseau

Dans le Kit de développement logiciel (SDK) App Center, les demandes réseau sont autorisées par défaut. Si vous souhaitez envoyer des données collectées par le SDK App Center par l’utilisateur, vous pouvez interdire l’envoi automatique de données.

AppCenter.IsNetworkRequestsAllowed = false;

Dans ce cas, le Kit de développement logiciel (SDK) App Center continue de collecter des données, mais il ne sera envoyé que lorsque les demandes réseau seront autorisées.

AppCenter.IsNetworkRequestsAllowed = true;

Remarque

Cette valeur est conservée entre les démarrages.

À tout moment, vous pouvez vérifier si l’envoi de données dans le Kit de développement logiciel (SDK) App Center est autorisé ou non.

AppCenter.IsNetworkRequestsAllowed;

Remarque

La valeur SharedPreferences enregistrée précédemment est ignorée jusqu’à ce qu’elle AppCenter soit démarrée sur la plateforme Android. Elle retourne le dernier jeu de valeurs à l’aide AppCenter.IsNetworkRequestsAllowed = allowed ou true si la valeur n’a pas été modifiée avant le début d’AppCenter.

Vérifier si App Center est activé

Vous pouvez également vérifier si App Center est activé ou non.

bool enabled = await AppCenter.IsEnabledAsync();

Vérifier la version du Kit de développement logiciel (SDK) App Center au moment de l’exécution

Vous pouvez obtenir la version du Kit de développement logiciel (SDK) App Center que vous utilisez actuellement.

AppCenter.SdkVersion;

Retarder le démarrage d’App Center

Il peut arriver que vous souhaitiez retarder le démarrage d’App Center jusqu’au démarrage d’AppCenterBehavior . Par exemple, si vous souhaitez demander le consentement de l’utilisateur avant de démarrer les services App Center.
Pour ce faire, ajoutez AppCenterBehaviorAdvanced à l’objet de jeu et cochez les cases à cocher Démarrer le SDK natif à partir d’applications iOS/Android . Cela démarre le Kit de développement logiciel (SDK) à la Start méthode d’AppCenterBehavior et vous permet d’ajouter une boîte de dialogue personnalisée ou une autre logique.

Conseil / Astuce

Si vous générez les paramètres au moment de la compilation, une autre méthode consiste à accéder à Paramètres du Lecteur>Autres Paramètres>Symboles de Définitions de Script et à coller APPCENTER_DONT_USE_NATIVE_STARTER.

API asynchrones dans le Kit de développement logiciel (SDK) Unity

Les API asynchrones retournent un AppCenterTask objet au lieu de retourner directement le résultat et retournent immédiatement au lieu d’attendre la fin de l’action.

Il existe trois façons d’interagir avec ces méthodes.

Méthode 1 : ContinueWith

Pour effectuer une action une fois l’activité AppCenterTaskterminée, ajoutez un rappel à l’aide de la ContinueWith méthode.

Exemple:

AppCenter.IsEnabledAsync().ContinueWith(task =>
{
    // Do something with task.Result
});

Dans les situations où la méthode a une valeur de retour réelle, elle retourne AppCenterTask<{Return Type}> (comme dans l’exemple ci-dessus). Dans ces situations, le paramètre de tâche dans le rappel a une Result propriété que vous pouvez accéder.

Méthode 2 : fonctionnalités de langage intégrées

Si vous écrivez du code qui a accès à la version .NET 4.6 ou ultérieure, AppCenterTask peut être utilisé await dans un contexte asynchrone.

Exemple:

bool isEnabled = await AppCenter.IsEnabledAsync();

Méthode 3 : Coroutines

AppCenterTasks sont également adaptés à l’utilisation dans les coroutines.

Exemple:

void SomeMethod()
{
    StartCoroutine(IsEnabledCoroutine());
}

IEnumerator IsEnabledCoroutine()
{
    var isEnabled = AppCenter.IsEnabledAsync();
    yield return isEnabled;

    // do something with the isEnabled
}