Autres API Unity
Important
La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.
En savoir plus sur les chronologies et les alternatives de support.
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 une journalisation supplémentaire lors du débogage. Par défaut, elle est définie sur ASSERT
pour les environnements App Store et WARN
sinon.
Pour avoir autant de messages de journal que possible, activez LogLevel.Verbose
dans les paramètres App Center ou dans votre code.
AppCenter.LogLevel = LogLevel.Verbose;
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();
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é :
- 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.
- Définissez un
userID
dans le Kit de développement logiciel (SDK) à l’aide du 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. Pour en savoir plus, consultez la documentation de recherche d’App Center.
Notes
La valeur de l’ID utilisateur est limitée à 256 caractères. Il s’affiche avec vos rapports d’incidents, 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 est utilisé. Vous devez définir vous-même l’ID utilisateur avant chaque lancement de l’application, car cette valeur n’est pas stockée par le SDK entre les lancements.
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 sur, 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 rendre les autres appels d’API (par IsEnabledAsync
exemple) cohérents.
L’état est conservé dans le stockage de l’appareil au cours des lancements d’application.
Vous pouvez activer ou désactiver le service au moment de l’exécution avec le code suivant :
Analytics.SetEnabledAsync(true);
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 que le Kit de développement logiciel (SDK) App Center collecte 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 elles ne sont envoyées que lorsque les demandes réseau seront autorisées.
AppCenter.IsNetworkRequestsAllowed = true;
Notes
Cette valeur est conservée entre les démarrages.
À tout moment, vous pouvez case activée si l’envoi de données dans le Kit de développement logiciel (SDK) App Center est autorisé ou non.
AppCenter.IsNetworkRequestsAllowed;
Notes
La valeur enregistrée précédemment dans SharedPreferences
est ignorée jusqu’au AppCenter
démarrage sur la plateforme Android.
Elle retourne la dernière valeur définie à l’aide AppCenter.IsNetworkRequestsAllowed = allowed
de ou true
si la valeur n’a pas été modifiée avant le démarrage d’AppCenter.
Vous pouvez également case activée si App Center est activé ou non.
bool enabled = await AppCenter.IsEnabledAsync();
Vous pouvez obtenir la version du Kit de développement logiciel (SDK) App Center que vous utilisez actuellement.
AppCenter.SdkVersion;
Dans certains cas, vous souhaitez 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 des services App Center.
Pour ce faire, ajoutez AppCenterBehaviorAdvanced à l’objet de jeu et case activée les cases Démarrer le SDK natif à partir de l’application iOS/Android. Cela démarre le Kit de développement logiciel (SDK) au niveau de la Start
méthode AppCenterBehavior et vous permet d’ajouter une boîte de dialogue personnalisée ou une autre logique.
Conseil
Si vous générez les paramètres au moment de la génération, une autre méthode consiste à accéder à Paramètres >du lecteurAutres paramètres>Scripting Définir des symboles et à coller APPCENTER_DONT_USE_NATIVE_STARTER
.
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.
Pour effectuer une action une fois l’activité AppCenterTask
terminé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é à laquelle vous pouvez accéder.
Si vous écrivez du code qui a accès à .NET 4.6 ou version ultérieure, AppCenterTask
vous pouvez l’utiliser await
dans un contexte asynchrone.
Exemple :
bool isEnabled = await AppCenter.IsEnabledAsync();
AppCenterTask
s peuvent également être utilisés dans les coroutines.
Exemple :
void SomeMethod()
{
StartCoroutine(IsEnabledCoroutine());
}
IEnumerator IsEnabledCoroutine()
{
var isEnabled = AppCenter.IsEnabledAsync();
yield return isEnabled;
// do something with the isEnabled
}