Aracılığıyla paylaş

Diğer Unity API'leri

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

Kayıt düzeyini ayarla

Konsolunda App Center'dan görüntülenen günlük iletilerinin sayısını denetleyebilirsiniz. LogLevel-API'yi kullanarak hata ayıklama sırasında ek kayıtları etkinleştirin. Varsayılan olarak, App Store ortamları için ASSERT ve aksi takdirde WARN olarak ayarlanır.

Olabildiğince fazla günlük iletisine sahip olmak için, App Center ayarlarında veya kodunuzun içinde LogLevel.Verbose etkinleştirin.

AppCenter.LogLevel = LogLevel.Verbose;

Yüklemeleri tanımlama

Uygulama yüklendikten sonra App Center SDK'sı her cihaz için bir UUID oluşturur. Bu tanımlayıcı, uygulama güncelleştirildiğinde cihaz için aynı kalır. Yeni bir tanımlayıcı yalnızca uygulama yeniden yüklendiğinde oluşturulur. Aşağıdaki API hata ayıklama amacıyla kullanışlıdır.

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

Kullanıcıları tanımlama

App Center SDK'sı, kilitlenme raporlarını artırmak için kullanılan bir kullanıcı kimliği ayarlamayı destekler. Bu özelliği kullanmak için:

  1. App Center SDK'sını App Center SDK'sını Kullanmaya başlama kılavuzunda açıklandığı gibi yapılandırın.
  2. Aşağıdaki kodu kullanarak SDK'da bir userID ayarlayın:
AppCenter.SetUserId("your-user-id");

Bir kullanıcı kimliği ayarladıktan sonra, belirli bir kullanıcı kimliği için belirli kilitlenme raporlarını aramak amacıyla App Center'ın arama özelliğini kullanabilirsiniz. App Center'ın arama belgelerinde daha fazla bilgi edinin.

Uyarı

Kullanıcı kimliği değeri 256 karakterle sınırlıdır. Çökme raporlarınızla birlikte gösterilecektir, ancak etkilenen kullanıcıların toplu istatistikleri veya sayıları için kullanılmayacaktır. Kullanıcı kimliğini birden çok kez ayarlarsanız, yalnızca son kullanıcı kimliği kullanılır. Bu değer başlatmalar arasında SDK tarafından depolanmadığından, her uygulama başlatılmadan önce kullanıcı kimliğini kendiniz ayarlamanız gerekir.

Çalışma zamanında tüm hizmetleri devre dışı bırakma

Tüm App Center hizmetlerini aynı anda devre dışı bırakmak istiyorsanız özelliğini kullanın Enabled . Sdk devre dışı bırakıldığında app center'a hiçbir bilgi iletmez.

AppCenter.SetEnabledAsync(false);

Tüm hizmetleri bir kez daha etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin true .

AppCenter.SetEnabledAsync(true);

Diğer API çağrılarını (örneğin IsEnabledAsync) tutarlı hale getirmek için bu çağrıyı beklemeniz gerekmez.

Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı olur.

Çalışma zamanında hizmetin durumunu değiştirme

Aşağıdaki kodla çalışma zamanında hizmeti etkinleştirebilir veya devre dışı bırakabilirsiniz:

Analytics.SetEnabledAsync(true);

Ağ isteklerine izin verme

App Center SDK'sında ağ isteklerine varsayılan olarak izin verilir. App Center SDK'sının kullanıcı onayı ile topladığı verileri göndermek istiyorsanız, otomatik veri gönderimini devre dışı bırakabilirsiniz.

AppCenter.IsNetworkRequestsAllowed = false;

Bu durumda App Center SDK'sı veri toplamaya devam eder ancak yalnızca ağ isteklerine izin verildiğinde gönderilir.

AppCenter.IsNetworkRequestsAllowed = true;

Uyarı

Bu değer, başlangıçlar arasında tutulur.

İstediğiniz zaman App Center SDK'sında veri göndermeye izin verilip verilmeyeceğini de kontrol edebilirsiniz.

AppCenter.IsNetworkRequestsAllowed;

Uyarı

Android platformunda SharedPreferences başlatılana kadar, daha önce AppCenter içinde kaydedilen değer yoksayılır. AppCenter başlamadan önce değer değiştirilmediyse, AppCenter.IsNetworkRequestsAllowed = allowed veya true kullanılarak belirlenen son değeri döndürür.

App Center'ın etkin olup olmadığını denetleyin

App Center'ın etkinleştirilip etkinleştirilmediğini de de de kontrol edebilirsiniz.

bool enabled = await AppCenter.IsEnabledAsync();

Çalışma zamanında App Center SDK sürümünü denetleme

Şu anda kullanmakta olduğunuz App Center SDK sürümünü alabilirsiniz.

AppCenter.SdkVersion;

App Center'ın başlatılmasını geciktirme

App Center'ın başlatılmasını AppCenterBehavior başlayana kadar geciktirmek istediğiniz durumlar olabilir. Örneğin, herhangi bir App Center hizmetini başlatmadan önce kullanıcı onayı istemek istiyorsanız.
Bunu yapmak için, oyun nesnesine AppCenterBehaviorAdvanced ekleyin ve iOS/Android uygulamasından yerel SDK başlat onay kutularını işaretleyin. Bu, SDK'yı StartAppCenterBehavior yönteminde başlatır ve özel bir iletişim kutusu veya başka bir mantık eklemenize olanak tanır.

Tavsiye

Ayarları derleme zamanında oluşturursanız, başka bir yol Player Ayarları>Diğer Ayarlar>Betik Tanımlama Simgeleri gidip yapıştırmanızdır APPCENTER_DONT_USE_NATIVE_STARTER.

Unity SDK'sında zaman uyumsuz API'ler

Zaman uyumsuz API'ler sonucu doğrudan döndürmek yerine bir AppCenterTask nesne döndürür ve eylemin bitmesi için beklemek yerine hemen döndürür.

Bu yöntemlerle etkileşim kurmanın üç yolu vardır.

Yöntem 1: ContinueWith

AppCenterTask etkinliği tamamlandıktan sonra bir eylem gerçekleştirmek için ContinueWith yöntemini kullanarak bir geri çağırma fonksiyonu ekleyin.

Örnek:

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

Yöntemin gerçek bir dönüş değerine sahip olduğu durumlarda döndürülecektir AppCenterTask<{Return Type}> (yukarıdaki örnekte olduğu gibi). Bu gibi durumlarda, geri çağırmadaki görev parametresinin erişebileceğiniz bir Result özelliği olur.

Yöntem 2: Yerleşik dil özellikleri

.NET 4.6 veya üzeri sürümlerine erişimi olan bir kod yazıyorsanız, AppCenterTask zaman uyumsuz bir bağlamda değiştirilebilir await.

Örnek:

bool isEnabled = await AppCenter.IsEnabledAsync();

Yöntem 3: Coroutines

AppCenterTask'ler aynı zamanda korutinlerde kullanım için uygundur.

Örnek:

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

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

    // do something with the isEnabled
}