Inne interfejsy API aparatu Unity

Dostosuj poziom logu

Możesz kontrolować liczbę komunikatów dziennika wyświetlanych z App Center w konsoli. Użyj LogLevel-API, aby włączyć dodatkowe rejestrowanie podczas debugowania. Domyślnie ustawione jest na ASSERT dla środowisk App Store, a WARN w przypadku innych.

Aby mieć jak najwięcej komunikatów dziennika, włącz LogLevel.Verbose w ustawieniach centrum aplikacji lub w kodzie.

AppCenter.LogLevel = LogLevel.Verbose;

Identyfikowanie instalacji

SDK App Center tworzy identyfikator UUID dla każdego urządzenia po zainstalowaniu aplikacji. Ten identyfikator pozostaje taki sam dla urządzenia po zaktualizowaniu aplikacji. Nowy identyfikator jest generowany tylko wtedy, gdy aplikacja zostanie ponownie zainstalowana. Poniższy interfejs API jest przydatny do celów debugowania.

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

Identyfikowanie użytkowników

Zestaw SDK centrum aplikacji obsługuje ustawianie identyfikatora użytkownika używanego do rozszerzania raportów o awarie. Aby użyć tej funkcji:

1. Skonfiguruj zestaw SDK centrum aplikacji zgodnie z opisem w przewodniku Wprowadzenie do zestawu SDK centrum aplikacji.
2. Ustaw element userID w zestawie SDK przy użyciu następującego kodu:

AppCenter.SetUserId("your-user-id");

Po ustawieniu identyfikatora użytkownika możesz użyć funkcji wyszukiwania centrum aplikacji, aby wyszukać określone raporty o awarii dla identyfikatora. Dowiedz się więcej w dokumentacji wyszukiwania w usłudze App Center.

Wyłącz wszystkie usługi w czasie wykonywania

Jeśli chcesz jednocześnie wyłączyć wszystkie usługi App Center, użyj Enabled właściwości . Po wyłączeniu zestaw SDK nie będzie przekazywać żadnych informacji do Centrum aplikacji.

AppCenter.SetEnabledAsync(false);

Aby ponownie włączyć wszystkie usługi, użyj tego samego interfejsu API, ale przekaż true jako parametr.

AppCenter.SetEnabledAsync(true);

Nie musisz czekać na to wywołanie, aby inne wywołania interfejsu API (takie jak IsEnabledAsync) były spójne.

Stan jest utrwalany w magazynie urządzenia w ramach uruchamiania aplikacji.

Zmienianie stanu usługi w trakcie działania

Usługę można włączyć lub wyłączyć w czasie wykonywania przy użyciu następującego kodu:

Analytics.SetEnabledAsync(true);

Nie zezwalaj na żądania sieciowe

W zestawie SDK centrum aplikacji żądania sieciowe są domyślnie dozwolone. Jeśli chcesz wysłać dane, które SDK App Center zbiera na podstawie zgody użytkownika, możesz zablokować automatyczne wysyłanie danych.

AppCenter.IsNetworkRequestsAllowed = false;

W takim przypadku zestaw SDK centrum aplikacji będzie nadal zbierać dane, ale będzie wysyłany tylko wtedy, gdy żądania sieciowe będą dozwolone.

AppCenter.IsNetworkRequestsAllowed = true;

W dowolnym momencie możesz sprawdzić, czy wysyłanie danych w zestawie SDK Centrum Aplikacji jest dozwolone, czy nie.

AppCenter.IsNetworkRequestsAllowed;

Sprawdzanie, czy centrum aplikacji jest włączone

Możesz również sprawdzić, czy centrum aplikacji jest włączone, czy nie.

bool enabled = await AppCenter.IsEnabledAsync();

Sprawdzanie wersji zestawu SDK App Center podczas działania

Możesz uzyskać wersję zestawu SDK centrum aplikacji, której obecnie używasz.

AppCenter.SdkVersion;

Opóźnij rozpoczęcie Centrum Aplikacji

Mogą wystąpić przypadki, w których chcesz opóźnić uruchomienie App Center do momentu rozpoczęcia AppCenterBehavior. Jeśli na przykład chcesz zażądać zgody użytkownika przed uruchomieniem jakichkolwiek usług Centrum aplikacji.
W tym celu dodaj element AppCenterBehaviorAdvanced do obiektu gry i zaznacz pola wyboru Uruchom natywny zestaw SDK z aplikacji systemu iOS/Android . Spowoduje to uruchomienie zestawu SDK w Start metodzie AppCenterBehavior i umożliwia dodanie niestandardowego okna dialogowego lub innej logiki.

Asynchroniczne interfejsy API w Unity SDK

Asynchroniczne interfejsy API zwracają obiekt AppCenterTask zamiast wyniku bezpośrednio, i robią to natychmiast, zamiast czekać na zakończenie akcji.

Istnieją trzy sposoby interakcji z tymi metodami.

Metoda 1. ContinueWith

Aby wykonać akcję po zakończeniu działania AppCenterTask, dodaj wywołanie zwrotne metodą ContinueWith.

Przykład:

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

W sytuacjach, gdy metoda ma rzeczywistą wartość zwracaną, zwróci AppCenterTask<{Return Type}> (jak w powyższym przykładzie). W takich sytuacjach parametr zadania w wywołaniu zwrotnym Result będzie miał właściwość, do której można uzyskać dostęp.

Metoda 2. Wbudowane funkcje językowe

Jeśli piszesz kod, który ma dostęp do platformy .NET 4.6 lub nowszej, AppCenterTask można awaitużyć w kontekście asynchronicznym.

Przykład:

bool isEnabled = await AppCenter.IsEnabledAsync();

Metoda 3. Coroutines

AppCenterTasks są również odpowiednie do stosowania w koroutynach.

Przykład:

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

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

    // do something with the isEnabled
}