API Unity Lainnya

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

• Android
• iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

Menyesuaikan tingkat log

Anda dapat mengontrol jumlah pesan log yang muncul dari App Center di konsol. LogLevelGunakan -API untuk mengaktifkan pengelogan tambahan saat penelusuran kesalahan. Secara default, ini diatur ke ASSERT untuk lingkungan App Store dan WARN sebaliknya.

Untuk memiliki pesan log sebanyak mungkin, aktifkan LogLevel.Verbose di pengaturan App Center atau dalam kode Anda.

AppCenter.LogLevel = LogLevel.Verbose;

Mengidentifikasi penginstalan

App Center SDK membuat UUID untuk setiap perangkat setelah aplikasi diinstal. Pengidentifikasi ini tetap sama untuk perangkat saat aplikasi diperbarui. Pengidentifikasi baru hanya dihasilkan saat aplikasi diinstal ulang. API berikut berguna untuk tujuan penelusuran kesalahan.

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

Mengidentifikasi pengguna

App Center SDK mendukung pengaturan ID pengguna yang digunakan untuk menambah laporan crash. Untuk menggunakan kapabilitas ini:

1. Konfigurasikan SDK App Center seperti yang dijelaskan dalam panduan Memulai App Center SDK.
2. Atur userID di SDK menggunakan kode berikut:

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

Setelah mengatur ID pengguna, Anda dapat menggunakan fitur pencarian App Center untuk mencari laporan crash tertentu untuk ID tersebut. Pelajari selengkapnya di dokumentasi pencarian App Center.

Catatan

Nilai untuk ID pengguna dibatasi hingga 256 karakter. Ini akan ditampilkan dengan laporan crash Anda tetapi tidak digunakan untuk agregasi atau jumlah pengguna yang terpengaruh. Jika Anda mengatur ID pengguna beberapa kali, hanya ID pengguna terakhir yang akan digunakan. Anda perlu mengatur ID pengguna sendiri sebelum setiap peluncuran aplikasi, karena nilai ini tidak disimpan oleh SDK di antara peluncuran.

Menonaktifkan semua layanan saat runtime

Jika Anda ingin menonaktifkan semua layanan App Center sekaligus, gunakan Enabled properti . Saat dinonaktifkan, SDK tidak akan meneruskan informasi apa pun ke App Center.

AppCenter.SetEnabledAsync(false);

Untuk mengaktifkan semua layanan sekaligus, gunakan API yang sama tetapi lewati true sebagai parameter.

AppCenter.SetEnabledAsync(true);

Anda tidak perlu menunggu panggilan ini untuk melakukan panggilan API lain (seperti IsEnabledAsync) konsisten.

Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.

Mengubah status layanan dalam runtime

Anda dapat mengaktifkan atau menonaktifkan layanan pada runtime dengan kode berikut:

Analytics.SetEnabledAsync(true);

Melarang permintaan jaringan

Di App Center SDK, permintaan jaringan diizinkan secara default. Jika Anda ingin mengirim data yang dikumpulkan oleh App Center SDK oleh masalah pengguna, Anda dapat melarang pengiriman data otomatis.

AppCenter.IsNetworkRequestsAllowed = false;

Dalam hal ini, App Center SDK terus mengumpulkan data tetapi akan dikirim hanya ketika permintaan jaringan akan diizinkan.

AppCenter.IsNetworkRequestsAllowed = true;

Catatan

Nilai ini dipertahankan di antara awal.

Kapan saja, Anda dapat memeriksa apakah mengirim data di App Center SDK diizinkan atau tidak.

AppCenter.IsNetworkRequestsAllowed;

Catatan

Nilai yang disimpan sebelumnya di SharedPreferences diabaikan hingga AppCenter dimulai di platform Android. Ini akan mengembalikan nilai terakhir yang ditetapkan menggunakan AppCenter.IsNetworkRequestsAllowed = allowed atau true jika nilai tidak diubah sebelum AppCenter dimulai.

Periksa apakah App Center diaktifkan

Anda juga dapat memeriksa apakah App Center diaktifkan atau tidak.

bool enabled = await AppCenter.IsEnabledAsync();

Periksa versi App Center SDK saat runtime

Anda bisa mendapatkan versi App Center SDK yang saat ini Anda gunakan.

AppCenter.SdkVersion;

Menunda dimulainya App Center

Mungkin ada kasus di mana Anda ingin menunda dimulainya App Center hingga setelah AppCenterBehavior dimulai. Misalnya, jika Anda ingin meminta persetujuan pengguna sebelum memulai layanan App Center apa pun.
Untuk melakukan ini, tambahkan AppCenterBehaviorAdvanced ke objek game dan periksa kotak centang Mulai SDK asli dari aplikasi iOS/Android . Ini memulai SDK pada Start metode AppCenterBehavior dan memungkinkan Anda menambahkan dialog kustom atau logika lainnya.

Tip

Jika Anda membuat pengaturan pada waktu build, cara lain adalah membuka Pengaturan> Pemutar Pengaturan SkripLain>Tentukan Simbol dan tempel APPCENTER_DONT_USE_NATIVE_STARTER.

API asinkron di Unity SDK

API asinkron mengembalikan AppCenterTask objek alih-alih mengembalikan hasilnya secara langsung, dan segera kembali alih-alih menunggu tindakan selesai.

Ada tiga cara untuk berinteraksi dengan metode ini.

Metode 1: LanjutkanDengan

Untuk melakukan tindakan setelah AppCenterTaskaktivitas selesai, tambahkan panggilan balik menggunakan ContinueWith metode .

Contoh:

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

Dalam situasi di mana metode memiliki nilai pengembalian aktual, metode akan kembali AppCenterTask<{Return Type}> (seperti pada contoh di atas). Dalam situasi ini, parameter tugas dalam panggilan balik akan memiliki Result properti yang dapat Anda akses.

Metode 2: Fitur bahasa bawaan

Jika Anda menulis kode yang memiliki akses ke .NET 4.6 atau lebih tinggi, maka AppCenterTask dapat awaitdied dalam konteks asinkron.

Contoh:

bool isEnabled = await AppCenter.IsEnabledAsync();

Metode 3: Coroutines

AppCenterTasks juga cocok untuk digunakan dalam coroutines.

Contoh:

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

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

    // do something with the isEnabled
}