Windows Age APIs FAQ

Artikel ini menjawab pertanyaan yang sering diajukan tentang menggunakan WINDOWS Age API untuk membangun pengalaman aplikasi yang sesuai usia.

Overview

Apa itu Windows Age APIs?

API usia Windows menyediakan sinyal usia yang mempertahankan privasi bagi pengguna yang menjalankan proses saat ini. Alih-alih mengembalikan usia atau tanggal lahir yang tepat, Windows mengembalikan rentang usia atau status verifikasi dewasa yang dapat digunakan aplikasi untuk memberikan pengalaman yang sesuai usia.

API-API ini adalah metode Windows Runtime pada Windows.System.User. Mereka membantu aplikasi membuat pengalaman pengguna terkait usia dan keputusan kebijakan tanpa menerima tanggal lahir pengguna yang tepat.

Jika pengguna menyetujui, pengembang dapat mengakses sinyal usia yang dapat digunakan aplikasi saat merancang pengalaman yang sesuai usia. Pengembang aplikasi tetap bertanggung jawab untuk menentukan bagaimana hukum dan persyaratan yang berlaku untuk produk mereka diterapkan.

Windows Age API ditujukan untuk skenario apa?

Aplikasi dapat menggunakan sinyal usia saat usia relevan dengan pengalaman. Misalnya, aplikasi mungkin menggunakan sinyal usia jika:

  • Menampilkan konten yang dihasilkan pengguna, fitur sosial, atau komunikasi yang mungkin tidak sesuai untuk semua usia.
  • Menawarkan pembelian dalam aplikasi atau mata uang virtual yang pembatasan usianya mungkin berlaku.
  • Melakukan streaming atau memutar media dengan peringkat kedewasaan.

Secara umum, aplikasi dapat menggunakan sinyal usia untuk menyesuaikan konten, fitur, atau kontrol aksesnya tanpa mengumpulkan tanggal lahir.

API Windows Age mana yang tersedia?

API berikut mendukung skenario yang berbeda:

  • GetUserAgeRangeAsync mengembalikan UserAgeRange yang berisi batas bawah dan atas inklusif dari kelompok usia pengguna. Grup yang telah ditentukan sebelumnya berada di bawah 10, 10–12, 13–15, 16–17, dan 18 atau lebih. Hasilnya null berarti bahwa rentang usia tidak diketahui atau tidak tersedia.
  • GetAgeVerificationStatusAsync mengembalikan UserAgeVerificationStatus yang menunjukkan status verifikasi dewasa pengguna. Ini tidak memverifikasi usia berapa pun atau kelompok usia.

Apakah verifikasi usia memverifikasi usia pengguna atau kelompok usia pengguna?

No. Verifikasi usia memberikan status dewasa terverifikasi, bukan status terverifikasi untuk usia atau kelompok usia apa pun. Untuk verifikasi berbasis akun, pengguna yang mengaku dewasa harus melalui alur yang memeriksa apakah orang tersebut sudah dewasa. Alur memeriksa klaim orang dewasa; itu tidak menetapkan usia terverifikasi untuk anak atau remaja.

Untuk informasi tentang memverifikasi usia Anda untuk akun Microsoft, lihat Memverifikasi usia Anda untuk akun Microsoft.

GetAgeVerificationStatusAsync melaporkan status verifikasi dewasa. Hasil Verified menunjukkan status dewasa terverifikasi. Hasil lain tidak menunjukkan bahwa pengguna adalah anak di bawah umur: aplikasi Anda harus membedakan hasil Unverified, hasil OptedOut, dan hasil yang tidak tersedia atau tidak dapat ditentukan.

Apakah Windows Age APIs sudah tersedia secara umum?

GetUserAgeRangeAsync dan GetAgeVerificationStatusAsync umumnya tersedia. Build Windows ritel yang didukung adalah:

  • Windows 11, versi 24H2: build 26100.9550 atau yang lebih baru.
  • Windows 11, versi 25H2: build 26200.9550 atau yang lebih baru.

Windows SDK versi 10.0.26100.9169 atau yang lebih baru menyertakan API ini.

API mana yang harus digunakan aplikasi saya?

Gunakan:

  • GetUserAgeRangeAsync saat aplikasi Anda memerlukan kelompok usia dan menerapkan pengalaman atau logika kebijakannya sendiri.
  • GetAgeVerificationStatusAsync ketika keputusan tergantung pada apakah pengguna telah memverifikasi status dewasa.

Aplikasi dapat menggunakan lebih dari satu sinyal usia jika sesuai untuk skenarionya. Hasil rentang usia 18 atau lebih tua tidak dengan sendirinya menetapkan status dewasa terverifikasi.

Privasi dan penanganan data

Dapatkah saya mengonfigurasi rentang usia saya sendiri untuk GetUserAgeRangeAsync?

No. Kelompok usia yang dikembalikan oleh GetUserAgeRangeAsync telah ditentukan sebelumnya.

Apakah API mengembalikan usia tepat atau tanggal lahir pengguna?

No. GetUserAgeRangeAsync mengembalikan kelompok usia, bukan usia atau tanggal lahir yang tepat. Misalnya, hasil dengan batas bawah dan atas {13, 15} berarti usia pengguna berada dalam kelompok usia 13–15.

GetAgeVerificationStatusAsync melaporkan status verifikasi usia dewasa, bukan usia terverifikasi atau grup usia terverifikasi.

Apakah aplikasi saya perlu mengumpulkan tanggal lahir pengguna untuk menggunakan WINDOWS Age API?

No. Salah satu tujuan API adalah untuk membiarkan aplikasi membuat keputusan terkait usia tanpa langsung menerima tanggal lahir pengguna.

Haruskah aplikasi menyimpan sinyal usia?

Aplikasi harus menghindari penyimpanan sinyal usia yang tidak perlu. Ambil sinyal saat diperlukan karena grup usia pengguna, status verifikasi, status akun, atau kebijakan administratif yang berlaku dapat berubah.

Perilaku pengguna dan akun

Jenis akun mana yang didukung?

Sinyal usia penyedia identitas saat ini hanya tersedia untuk akun Microsoft. Untuk jenis akun lain, saat default administratif tidak dikonfigurasi, GetUserAgeRangeAsync mengembalikan null, dan GetAgeVerificationStatusAsync mengembalikan NotApplicable.

Age API mengembalikan informasi tentang pengguna yang mana?

Panggilan AGE API berlaku untuk pengguna yang menjalankan proses saat ini. Di perangkat dengan beberapa profil Windows, API mengkueri profil pengguna saat ini untuk pengalaman aplikasi aktif. API tidak menyediakan mekanisme untuk mengkueri profil yang berbeda.

Bisakah aplikasi mengkueri sinyal usia untuk pengguna lain di perangkat?

No. API beroperasi dalam konteks pengguna yang menjalankan proses. Memanggil Age API dengan User objek yang mewakili pengguna lain dapat mengakibatkan E_ACCESSDENIED.

Apa yang terjadi ketika pengguna memiliki beberapa jenis akun yang tersambung ke Windows?

API Windows Age beroperasi dalam konteks pengguna Windows yang saat ini sedang masuk dan menggunakan akun Microsoft yang terkait dengan proses masuk Windows pengguna tersebut. Aplikasi tidak dapat memilih akun lain yang terhubung untuk kueri.

Apa yang terjadi jika sinyal usia tidak dapat ditentukan?

Aplikasi harus disiapkan untuk menangani sinyal usia yang mungkin tidak tersedia atau tidak dapat ditentukan.

Untuk GetUserAgeRangeAsync, null berarti bahwa rentang usia tidak diketahui atau tidak tersedia. Kondisi yang dapat menghasilkan null meliputi:

  • Jenis akun tidak didukung.
  • Informasi usia tidak tersedia untuk akun tersebut.
  • API dinonaktifkan oleh kebijakan administratif.

Untuk GetAgeVerificationStatusAsync, NotApplicable atau TemporarilyUnavailable mewakili sinyal verifikasi yang tidak tersedia atau tidak dapat ditentukan. Hasil ini tidak memastikan apakah pengguna telah memverifikasi status dewasa.

Aplikasi harus memberikan pengalaman fallback yang sesuai dan tidak boleh menafsirkan hasil yang tidak tersedia sebagai grup usia atau status verifikasi tertentu.

Haruskah aplikasi mengasumsikan bahwa sinyal usia selalu tersedia?

No. Aplikasi harus merancang perilaku fallback sebagai bagian dari integrasi Age API mereka. Perlakukan sinyal yang valid, sinyal yang tidak tersedia atau tidak ditentukan, dan kesalahan akses ditolak sebagai status yang berbeda.

Persyaratan dan implementasi aplikasi

Sistem operasi dan SDK apa yang diperlukan?

Windows 11 adalah sistem operasi minimum yang didukung. GetUserAgeRangeAsync dan GetAgeVerificationStatusAsync tersedia dalam build ritel yang didukung berikut:

  • Windows 11, versi 24H2: build 26100.9550 atau yang lebih baru.
  • Windows 11, versi 25H2: build 26200.9550 atau yang lebih baru.

Gunakan SDK Windows versi 10.0.26100.9169 atau yang lebih baru untuk membangun aplikasi yang memanggil API ini.

Karena API dapat tidak ada pada sistem yang lebih lama atau tidak mendapatkan layanan, periksa ketersediaan API sebelum memanggilnya.

Apakah aplikasi saya perlu mendeklarasikan kemampuan?

Yes. Aplikasi UWP harus mendeklarasikan kapabilitas userAccountInformation dalam manifes paketnya:

<uap:Capability Name="userAccountInformation" />

Tanpa akses yang diperlukan, aplikasi tidak dapat membaca data usia pengguna.

Bagaimana cara mendapatkan objek User yang digunakan untuk memanggil Age API?

Gunakan User.GetDefault untuk mendapatkan pengguna yang menjalankan proses saat ini. User.FindAllAsync dapat membuat daftar pengguna, tetapi AGE API harus dipanggil dengan instans User yang mewakili pengguna yang menjalankan proses.

Berapa lama waktu yang dibutuhkan untuk perubahan tanggal lahir atau ulang tahun untuk memengaruhi sinyal usia?

Jika pengguna mengubah tanggal lahir yang terkait dengan akun Microsoft mereka atau memiliki ulang tahun, perubahan tersebut tercermin dalam waktu 24 jam setelah pengambilan sinyal usia terakhir.

Dapatkah aplikasi memaksa refresh sinyal usia?

No. Refresh paksa tidak didukung.

Penanganan kesalahan dan fallback

Bagaimana aplikasi harus menangani rentang usia yang tidak tersedia?

Tangani rentang usia yang tidak tersedia secara eksplisit daripada mengasumsikan usia. null Hasil GetUserAgeRangeAsync berarti bahwa rentang usia tidak diketahui atau tidak tersedia.

Gunakan pengalaman fallback yang sengaja dirancang. Jangan menafsirkan null sebagai kelompok usia tertentu, termasuk grup 18 atau yang lebih tua.

Apa artinya E_ACCESSDENIED?

E_ACCESSDENIED dapat berarti bahwa pemanggil tidak memiliki akses ke info Akun atau bahwa aplikasi memanggil API dengan objek User untuk seseorang selain pengguna yang menjalankan proses.

Perlakukan kesalahan ini sebagai berbeda dari sinyal yang tidak tersedia. Sinyal yang tidak tersedia dikembalikan sebagai null, NotApplicable, atau TemporarilyUnavailable, tergantung pada API.

Apa yang harus dilakukan aplikasi dengan status verifikasi yang tidak diketahui?

Tangani status verifikasi yang tidak tersedia atau tidak dapat ditentukan secara eksplisit dan berikan pengalaman fallback. NotApplicable dan TemporarilyUnavailable tidak menentukan apakah pengguna telah memverifikasi status dewasa. Jangan menginterpretasikan hasil ini, Unverified, atau OptedOut sebagai bukti bahwa pengguna adalah anak di bawah umur.

Baca juga

  • Terakhir diperbarui pada