Další rozhraní API Unity
Důležité
31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.
Přečtěte si další informace o časových osách a alternativách podpory.
Počet zpráv protokolu, které se zobrazují z App Center v konzole, můžete řídit. K povolení dalšího LogLevel
protokolování při ladění použijte rozhraní -API. Ve výchozím nastavení je nastavená na ASSERT
pro App Store prostředí a WARN
jinak.
Pokud chcete mít co nejvíce zpráv protokolu, povolte LogLevel.Verbose
je v nastavení App Center nebo v kódu.
AppCenter.LogLevel = LogLevel.Verbose;
Sada App Center SDK vytvoří UUID pro každé zařízení po instalaci aplikace. Při aktualizaci aplikace zůstane tento identifikátor pro zařízení stejný. 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();
Sada App Center SDK podporuje nastavení ID uživatele , které se používá k rozšíření zpráv o chybách. Použití této funkce:
- Nakonfigurujte sadu App Center SDK podle pokynů v příručce Začínáme se sadou App Center SDK.
- V sadě SDK nastavte
userID
parametr pomocí následujícího kódu:
AppCenter.SetUserId("your-user-id");
Po nastavení ID uživatele můžete pomocí funkce vyhledávání v App Center vyhledat konkrétní zprávy o chybách pro ID. Další informace najdete v dokumentaci k vyhledávání app center.
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 id uživatele nastavit sami, protože tato hodnota není uložená v sadě SDK mezi spuštěními.
Pokud chcete zakázat všechny služby App Center najednou, použijte vlastnost Enabled
. Pokud je sada SDK zakázaná, nepřesměruje do App Center žádné informace.
AppCenter.SetEnabledAsync(false);
Pokud chcete znovu povolit všechny služby najednou, použijte stejné rozhraní API, ale předejte true
ho jako parametr.
AppCenter.SetEnabledAsync(true);
Na toto volání nemusíte čekat, aby byla další volání rozhraní API (například IsEnabledAsync
) konzistentní.
Stav se v úložišti zařízení během spouštění aplikací udržuje.
Službu můžete povolit nebo zakázat za běhu pomocí následujícího kódu:
Analytics.SetEnabledAsync(true);
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 uživatelem, můžete zakázat automatické odesílání dat.
AppCenter.IsNetworkRequestsAllowed = false;
V tomto případě sada App Center SDK dál shromažďuje data, ale budou odeslána pouze v případě, že budou povolené síťové požadavky.
AppCenter.IsNetworkRequestsAllowed = true;
Poznámka
Tato hodnota se zachová mezi zahájením.
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 AppCenter
se nesstartuje na platformě Android.
Vrátí poslední sadu hodnot pomocí AppCenter.IsNetworkRequestsAllowed = allowed
nebo true
pokud se hodnota nezměnila před spuštěním AppCenter.
Můžete také zkontrolovat, jestli je App Center povolený nebo ne.
bool enabled = await AppCenter.IsEnabledAsync();
Můžete získat verzi sady App Center SDK, kterou právě používáte.
AppCenter.SdkVersion;
Může se stát, že budete chtít odložit spuštění App Center až po spuštění AppCenterBehavior . Například pokud chcete požádat o souhlas uživatele před spuštěním jakékoli služby 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 spustíte sadu SDK metodou Start
AppCenterBehavior a umožníte přidat vlastní dialogové okno nebo jinou logiku.
Tip
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 vrací AppCenterTask
objekt místo přímého vrácení výsledku a okamžitě místo čekání na dokončení akce.
Existují tři způsoby, jak s těmito metodami pracovat.
Pokud chcete provést akci po AppCenterTask
dokonč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 Result
volání vlastnost, ke které máte přístup.
Pokud píšete kód, který má přístup k .NET 4.6 nebo novějším, AppCenterTask
můžete await
ho použít v asynchronním kontextu.
Příklad:
bool isEnabled = await AppCenter.IsEnabledAsync();
AppCenterTask
s jsou také vhodné pro použití v korutech.
Příklad:
void SomeMethod()
{
StartCoroutine(IsEnabledCoroutine());
}
IEnumerator IsEnabledCoroutine()
{
var isEnabled = AppCenter.IsEnabledAsync();
yield return isEnabled;
// do something with the isEnabled
}