Dela via

Andra Unity-API:er

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

Justera loggnivån

Du kan styra antalet loggmeddelanden som visas från App Center i konsolen. LogLevelAnvänd -API för att aktivera ytterligare loggning vid felsökning. Som standard är den inställd på ASSERT för App Store-miljöer och WARN i andra fall.

Om du vill ha så många loggmeddelanden som möjligt aktiverar du LogLevel.Verbose i App Center-inställningarna eller i koden.

AppCenter.LogLevel = LogLevel.Verbose;

Identifiera installationer

App Center SDK skapar ett UUID för varje enhet när appen har installerats. Den här identifieraren förblir densamma för en enhet när appen uppdateras. En ny identifierare genereras endast när appen installeras om. Följande API är användbart för felsökning.

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

Identifiera användare

App Center SDK stöder inställning av ett användar-ID som används för att utöka kraschrapporter. Så här använder du den här funktionen:

  1. Konfigurera App Center SDK enligt beskrivningen i guiden Komma igång med App Center SDK.
  2. Ange en userID i SDK:en med hjälp av följande kod:
AppCenter.SetUserId("your-user-id");

När du har angett ett användar-ID kan du använda App Centers sökfunktion för att söka efter specifika kraschrapporter för ID:t. Läs mer i App Centers sökdokumentation.

Anmärkning

Värdet för användar-ID:t är begränsat till 256 tecken. Den visas med dina kraschrapporter men används inte för aggregering eller antal berörda användare. Om du anger användar-ID flera gånger används endast det senaste användar-ID:t. Du måste ange användar-ID:t själv innan varje program startas, eftersom det här värdet inte lagras av SDK:t mellan lanseringarna.

Inaktivera alla tjänster vid körning

Om du vill inaktivera alla App Center-tjänster samtidigt använder du Enabled egenskapen . När den är inaktiverad vidarebefordrar SDK:t inte någon information till App Center.

AppCenter.SetEnabledAsync(false);

Om du vill aktivera alla tjänster på en gång använder du samma API men skickar true som en parameter.

AppCenter.SetEnabledAsync(true);

Du behöver inte invänta det här anropet för att göra andra API-anrop (till exempel IsEnabledAsync) konsekventa.

Tillståndet sparas i enhetens lagring mellan programstarter.

Ändra tjänsttillstånd under körning

Du kan aktivera eller inaktivera tjänsten vid körningen med följande kod:

Analytics.SetEnabledAsync(true);

Tillåt inte nätverksbegäranden

I App Center SDK tillåts nätverksbegäranden som standard. Om du vill skicka data som App Center SDK samlar in av användaren kan du inte tillåta automatisk sändning av data.

AppCenter.IsNetworkRequestsAllowed = false;

I det här fallet fortsätter App Center SDK att samla in data, men de skickas endast när nätverksbegäranden tillåts.

AppCenter.IsNetworkRequestsAllowed = true;

Anmärkning

Det här värdet behålls mellan starterna.

När som helst kan du kontrollera om det är tillåtet eller inte att skicka data i App Center SDK.

AppCenter.IsNetworkRequestsAllowed;

Anmärkning

Värdet som sparades tidigare i SharedPreferences ignoreras tills det startas AppCenter på Android-plattformen. Den returnerar det senaste värdet som ställts in med antingen AppCenter.IsNetworkRequestsAllowed = allowed eller true om värdet inte ändrades innan AppCenter startade.

Kontrollera om App Center är aktiverat

Du kan också kontrollera om App Center är aktiverat eller inte.

bool enabled = await AppCenter.IsEnabledAsync();

Kontrollera App Center SDK-versionen vid körning

Du kan hämta den version av App Center SDK som du använder för närvarande.

AppCenter.SdkVersion;

Fördröj starten av App Center

Det kan finnas fall där du vill fördröja starten av App Center tills AppCenterBehavior startar. Om du till exempel vill begära användarmedgivande innan du startar några App Center-tjänster.
Det gör du genom att lägga till AppCenterBehaviorAdvanced i spelobjektet och markera kryssrutan Starta inbyggt SDK från iOS/Android-appen . Detta startar SDK:n med Start metoden AppCenterBehavior och gör att du kan lägga till en anpassad dialogruta eller annan logik.

Tips/Råd

Om du genererar inställningarna vid bygget är ett annat sätt att gå till Spelarinställningar>Andra inställningar>, Definiera symboler för skript och klistra in APPCENTER_DONT_USE_NATIVE_STARTER.

Asynkrona API:er i Unity SDK

Asynkrona API:er returnerar ett AppCenterTask objekt i stället för att returnera resultatet direkt och returnerar omedelbart i stället för att vänta på att åtgärden ska slutföras.

Det finns tre sätt att interagera med dessa metoder.

Metod 1: FortsättMed

Om du vill utföra en åtgärd efter att AppCenterTaskaktiviteten har slutförts lägger du till ett återanrop med hjälp av ContinueWith metoden .

Exempel:

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

I situationer där metoden har ett faktiskt returvärde returnerar den AppCenterTask<{Return Type}> (som i exemplet ovan). I dessa situationer har parameterna i callbackfunktionen en Result egenskap som du kan komma åt.

Metod 2: Inbyggda språkfunktioner

Om du skriver kod som har åtkomst till .NET 4.6 eller senare kan AppCenterTaskawaitas i en asynkron kontext.

Exempel:

bool isEnabled = await AppCenter.IsEnabledAsync();

Metod 3: Korpoutines

AppCenterTasks är lämpliga också för användning i korutiner.

Exempel:

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

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

    // do something with the isEnabled
}
  • Last updated on