Sdílet prostřednictvím

Další rozhraní API Unity

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Nastavte úroveň protokolu

Můžete řídit počet zpráv protokolu, které se zobrazují z App Center v konzole. LogLevelPomocí rozhraní -API můžete během ladění povolit další protokolování. Ve výchozím nastavení je to nastaveno na ASSERT pro prostředí App Storu a WARN pro ostatní případy.

Pokud chcete mít co nejvíce zpráv protokolu, povolte LogLevel.Verbose v nastavení App Center nebo v kódu.

AppCenter.LogLevel = LogLevel.Verbose;

Identifikace instalací

Sada App Center SDK vytvoří identifikátor UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstane stejný pro zařízení při aktualizaci aplikace. Nový identifikátor se vygeneruje jenom při přeinstalaci aplikace. Následující rozhraní API je užitečné pro účely ladění.

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

Identifikace uživatelů

Sada App Center SDK podporuje nastavení ID uživatele, které se používá k rozšíření hlášení o chybách. Pokud chcete použít tuto funkci:

  1. Nakonfigurujte sadu App Center SDK, jak je popsáno v příručce Začínáme se sadou App Center SDK.
  2. Nastavte userID v sadě SDK pomocí následujícího kódu:
AppCenter.SetUserId("your-user-id");

Po nastavení uživatelského ID můžete pomocí vyhledávací funkce v App Center vyhledat konkrétní zprávy o chybách spojené s tímto ID. Další informace najdete v dokumentaci ke vyhledávání v App Centeru.

Poznámka:

Hodnota ID uživatele je omezená na 256 znaků. Zobrazí se se zprávami o chybách, ale nepoužije se pro agregaci nebo počty ovlivněných uživatelů. Pokud nastavíte ID uživatele vícekrát, použije se pouze poslední ID uživatele. Před spuštěním každé aplikace musíte nastavit ID uživatele, protože tato hodnota není uložená sadou SDK mezi spuštěními.

Zakázat všechny služby během provozu

Pokud chcete zakázat všechny služby App Center najednou, použijte tuto vlastnost Enabled. Pokud je tato možnost zakázaná, sada SDK nepředá žádné informace do App Centeru.

AppCenter.SetEnabledAsync(false);

Pokud chcete znovu povolit všechny služby, použijte stejné rozhraní API, ale předejte true ho jako parametr.

AppCenter.SetEnabledAsync(true);

Toto volání nemusíte čekat, pokud chcete provádět další volání rozhraní API (například IsEnabledAsync) konzistentně.

Stav se zachová v úložišti zařízení napříč spuštěním aplikace.

Změna stavu služby za běhu

Službu můžete povolit nebo zakázat za běhu pomocí následujícího kódu:

Analytics.SetEnabledAsync(true);

Zákaz síťových požadavků

V sadě App Center SDK jsou ve výchozím nastavení povolené síťové požadavky. Pokud chcete odesílat data, která sada App Center SDK shromažďuje se souhlasem uživatele, můžete vypnout automatické odesílání dat.

AppCenter.IsNetworkRequestsAllowed = false;

V tomto případě sada App Center SDK bude dál shromažďovat data, ale bude odeslána pouze v případě, že budou povoleny síťové požadavky.

AppCenter.IsNetworkRequestsAllowed = true;

Poznámka:

Tato hodnota se uchovává mezi starty.

Kdykoli můžete zkontrolovat, jestli je odesílání dat v sadě App Center SDK povolené nebo ne.

AppCenter.IsNetworkRequestsAllowed;

Poznámka:

Hodnota uložená dříve v SharedPreferences se ignoruje, dokud se AppCenter nespustí v systému Android. Vrátí poslední sadu hodnot pomocí AppCenter.IsNetworkRequestsAllowed = allowed nebo true pokud se hodnota před spuštěním AppCenter nezměnila.

Kontrola, jestli je služba App Center povolená

Můžete také zkontrolovat, jestli je App Center povolený nebo ne.

bool enabled = await AppCenter.IsEnabledAsync();

Kontrola verze sady App Center SDK za běhu

Můžete získat verzi sady App Center SDK, kterou aktuálně používáte.

AppCenter.SdkVersion;

Zpoždění spuštění App Center

Může se stát, že budete chtít zpozdit spuštění App Center až po spuštění AppCenterBehavioru . Pokud například chcete požádat o souhlas uživatele před spuštěním služeb App Center.
Uděláte to tak, že do objektu hry přidáte AppCenterBehaviorAdvanced a zaškrtnete políčka Spustit nativní sadu SDK z aplikace pro iOS/Android . Tím se sada SDK spustí metodou StartAppCenterBehavior a umožní vám přidat vlastní dialogové okno nebo jinou logiku.

Návod

Pokud vygenerujete nastavení v době sestavení, dalším způsobem je přejít na Nastavení> přehrávačeDalší nastavení>Skriptování Definovat symboly a vložit APPCENTER_DONT_USE_NATIVE_STARTER.

Asynchronní rozhraní API v sadě Unity SDK

Asynchronní rozhraní API vrací AppCenterTask objekt místo přímého vrácení výsledku a vrací se okamžitě místo čekání na dokončení akce.

Existují tři způsoby interakce s těmito metodami.

Metoda 1: ContinueWith

Chcete-li provést akci po AppCenterTaskdokončení aktivity, přidejte zpětné volání pomocí ContinueWith metody.

Příklad:

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

V situacích, kdy má metoda skutečnou návratovou hodnotu, vrátí AppCenterTask<{Return Type}> (jako v příkladu výše). V těchto situacích bude mít parametr úkolu ve zpětném volání vlastnost Result, ke které máte přístup.

Metoda 2: Integrované jazykové funkce

Pokud píšete kód, který má přístup k .NET 4.6 nebo novějšímu, AppCenterTask lze await použít v asynchronním kontextu.

Příklad:

bool isEnabled = await AppCenter.IsEnabledAsync();

Metoda 3: Koroutiny

AppCenterTask lze také použít v korutinách.

Příklad:

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

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

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