Gambaran umum sinyal usia

API usia Windows menyediakan sinyal yang mempertahankan privasi yang dapat digunakan aplikasi untuk memahami grup usia dan status verifikasi dewasa dari pengguna yang masuk. API mengembalikan sinyal kasar alih-alih usia atau tanggal lahir pengguna yang tepat. Aplikasi dapat menggunakan sinyal ini untuk menyesuaikan konten, fitur, atau kontrol akses dan harus memberikan perilaku fallback yang sesuai saat sinyal tidak tersedia.

Apa itu sinyal usia?

Sinyal usia adalah nilai yang dikembalikan oleh Windows saat aplikasi memanggil API age untuk pengguna saat ini. Aplikasi memutuskan kapan harus meminta grup usia pengguna atau status verifikasi dewasa untuk menentukan pengalaman pengguna akhir yang sesuai.

Kedua sinyal tersebut tidak secara langsung mengekspos usia atau tanggal lahir pengguna yang tepat. GetUserAgeRangeAsync API menyediakan rentang usia yang dapat digunakan aplikasi untuk membuat keputusan konten. Ini menawarkan kelompok usia berikut:

  • Di bawah 10
  • 10-12
  • 13-15
  • 16-17
  • 18+

API Usia untuk Windows

GetUserAgeRangeAsync

Metode GetUserAgeRangeAsync mengembalikan rentang usia pengguna sebagai objek UserAgeRange dengan properti Lower dan Upper.

Kelompok usia Mengembalikan nilai
Di bawah 10 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Tidak diketahui null

Ketika hasilnya adalah null, rentang usia tidak diketahui atau tidak tersedia. Aplikasi harus menggunakan pengalaman fallback mereka dan tidak boleh menafsirkan null sebagai kelompok usia tertentu.

GetAgeVerificationStatusAsync

GetAgeVerificationStatusAsyncMetode ini mengembalikan UserAgeVerificationStatusnilai yang menunjukkan status verifikasi dewasa yang dilaporkan untuk pengguna. Verifikasi usia memeriksa apakah pengguna yang mengaku dewasa adalah orang dewasa. Ini tidak memverifikasi usia atau memverifikasi grup usia lainnya.

Nilai yang mungkin adalah:

  • Verified: Pengguna telah memverifikasi status dewasa.
  • Unverified: Pengguna tidak memiliki status dewasa terverifikasi. Ini tidak membuktikan bahwa pengguna adalah anak di bawah umur.
  • OptedOut: Pengguna telah tidak ikut verifikasi dewasa.
  • TemporarilyUnavailable: Status saat ini tidak dapat ditentukan.
  • NotApplicable: Verifikasi tidak berlaku, tidak ada sinyal verifikasi yang tersedia, atau fitur tidak tersedia atau dinonaktifkan.

Aplikasi harus menangani setiap nilai. NotApplicable dan TemporarilyUnavailable tidak menentukan apakah pengguna telah memverifikasi status dewasa. Hasil rentang usia 18 atau lebih tua tidak dengan sendirinya menetapkan status dewasa terverifikasi.

Paket aplikasi harus mencantumkan kapabilitas userAccountInformation. Akses ke sinyal usia juga bergantung pada persetujuan pengguna untuk mengizinkan aplikasi mengakses informasi akun dalam pengaturan privasi Windows. Jika akses tidak diberikan, panggilan dapat gagal dengan E_ACCESSDENIED. Objek User harus mewakili pengguna yang menjalankan proses saat ini.

Kebijakan dan ketersediaan

Saat API Usia tidak tersedia atau dinonaktifkan, GetUserAgeRangeAsync mengembalikan null dan GetAgeVerificationStatusAsync mengembalikan NotApplicable. Administrator juga dapat mengonfigurasi grup usia default atau status verifikasi melalui Kebijakan Grup atau MDM; saat dikonfigurasi, API mengembalikan nilai yang ditentukan kebijakan yang sesuai. Aplikasi harus memeriksa apakah metode tersedia sebelum memanggilnya dan mempertahankan perilaku fallback untuk sinyal yang tidak tersedia.

Nilai yang ditentukan oleh kebijakan Verified adalah default administratif, bukan bukti bahwa pengguna menyelesaikan alur verifikasi usia dewasa.

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

Kapan menggunakan sinyal usia

Gunakan sinyal usia ketika aplikasi Anda:

  • Menampilkan konten yang dihasilkan pengguna, fitur sosial, atau alat komunikasi yang mungkin tidak sesuai untuk semua usia.
  • Menawarkan pembelian dalam aplikasi atau mata uang virtual di mana pembatasan usia relevan.
  • Menayangkan secara streaming atau memutar konten media dengan peringkat usia.

Cara kerja sinyal usia pada tingkat tinggi

Diagram memperlihatkan aplikasi yang bertukar informasi grup usia dengan layanan lokal API Keamanan Digital, yang berkomunikasi dengan pengaturan konfigurasi.

Privasi dan penanganan data

Sinyal usia dirancang dengan privasi sebagai prinsip inti:

  • Tidak ada usia atau tanggal lahir yang tepat yang dikembalikan. API mengembalikan kategori usia dan status verifikasi dewasa. Verifikasi usia dewasa tidak membuktikan usia terverifikasi atau kelompok usia di bawah umur terverifikasi.
  • Kelompok usia bersifat generik. Mereka mengomunikasikan kelompok usia umum untuk berbagai kasus penggunaan seperti game atau hukum regional.

Persyaratan platform

Persyaratan Rincian
Versi OS minimum Windows 11
Cakupan API Metode Windows Runtime di Windows.System.User
Konteks pengguna Panggilan hanya berlaku untuk pengguna yang menjalankan proses saat ini.
Kemampuan aplikasi Paket aplikasi harus mendeklarasikan userAccountInformation

Baca juga

  • Terakhir diperbarui pada