Yaş sinyallerine genel bakış

Windows Yaş API'leri, uygulamaların oturum açmış kullanıcının yaş grubunu ve yetişkin doğrulama durumunu anlamak için kullanabileceği gizliliği koruyan sinyaller sağlar. API'ler, kullanıcının tam yaşı veya doğum tarihi yerine kaba sinyaller döndürür. Uygulamalar içeriği, özellikleri veya erişim denetimlerini uyarlamak için bu sinyalleri kullanabilir ve bir sinyal kullanılamadığında uygun geri dönüş davranışını sağlamalıdır.

Yaş sinyalleri nelerdir?

Yaş sinyalleri, bir uygulama mevcut kullanıcı için Yaş API’lerini çağırdığında Windows’un döndürdüğü değerlerdir. Uygulama, uygun son kullanıcı deneyimini sağlamak için kullanıcının yaş grubunun veya yetişkin doğrulama durumunun ne zaman isteneceğine karar verir.

Her iki sinyal de kullanıcının tam yaşını veya doğum tarihini doğrudan ortaya çıkarmaz. API, GetUserAgeRangeAsync uygulamanın içerik kararları almak için kullanabileceği bir yaş aralığı sağlar. Aşağıdaki yaş gruplarını sunar:

  • 10'un altında
  • 10-12
  • 13-15
  • 16-17
  • 18+

Windows Yaş API'leri

GetUserAgeRangeAsync

GetUserAgeRangeAsync yöntemi, kullanıcının yaş aralığını ve Upper özelliklerine sahip Lower bir UserAgeRange nesne olarak döndürür.

Yaş grubu Dönüş değerleri
10'un altında {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Bilinmiyor null

Sonuç null ise, yaş aralığı bilinmiyor veya mevcut değil. Uygulamalar yedek deneyimini kullanmalı ve null öğesini belirli bir yaş grubu olarak yorumlamamalıdır.

GetAgeVerificationStatusAsync

yöntemi, GetAgeVerificationStatusAsync kullanıcı için bildirilen yetişkin doğrulama durumunu gösteren bir UserAgeVerificationStatus değer döndürür. Yaş doğrulaması, yetişkin olduğunu iddia eden bir kullanıcının yetişkin olup olmadığını denetler. Doğrulanmış bir yaş belirlemez veya diğer yaş gruplarını doğrulamaz.

Olası değerler şunlardır:

  • Verified: Kullanıcının reşit olduğu doğrulandı.
  • Unverified: Kullanıcının doğrulanmış yetişkin durumu yok. Bu, kullanıcının reşit olmadığını belirlemez.
  • OptedOut: Kullanıcı yetişkin doğrulamasına katılmamayı seçti.
  • TemporarilyUnavailable: Durum şu anda belirlenemiyor.
  • NotApplicable: Doğrulama geçerli değil, doğrulama sinyali yok veya özellik kullanılamıyor veya devre dışı.

Uygulamaların her değeri işlemesi gerekir. NotApplicable ve TemporarilyUnavailable, kullanıcının yetişkin durumunu doğrulayıp doğrulamadığını belirlemez. 18 veya üzeri bir yaş aralığı sonucu, tek başına doğrulanmış yetişkin durumu oluşturmaz.

Uygulama paketi, userAccountInformation özelliğini bildirmelidir. Yaş sinyallerine erişim, uygulamanın Windows gizlilik ayarlarında hesap bilgilerine erişmesine izin vermek için kullanıcının onayına da tabidir. Erişim verilmezse çağrı, E_ACCESSDENIED ile başarısız olabilir. User nesnesi geçerli işlemi çalıştıran kullanıcıyı temsil etmelidir.

İlke ve kullanılabilirlik

Yaş API'leri kullanılamıyor veya devre dışı bırakıldığında, GetUserAgeRangeAsync döndürür null ve GetAgeVerificationStatusAsync döndürür NotApplicable. Yöneticiler ayrıca Grup İlkesi veya MDM aracılığıyla varsayılan bir yaş grubu veya doğrulama durumu yapılandırabilir; yapılandırıldığında, API'ler ilgili ilke tanımlı değeri döndürür. Uygulamalar, yöntemleri çağırmadan önce kullanılabilir olup olmadığını denetlemeli ve kullanılamayan sinyaller için geri dönüş davranışını korumalıdır.

İlke tanımlı Verified bir değer yönetici varsayılanıdır, kullanıcının yetişkin doğrulama akışını tamamlamış olduğuna dair kanıt değildir.

Kimlik sağlayıcısı yaş sinyalleri şu anda yalnızca Microsoft hesapları için alınıyor. Diğer hesap türleri için, hiçbir yönetici varsayılanı yapılandırılmadığında GetUserAgeRangeAsyncnull döndürür ve GetAgeVerificationStatusAsyncNotApplicable döndürür.

Yaş sinyalleri ne zaman kullanılır?

Uygulamanızda yaş sinyallerini kullanın:

  • Her yaş için uygun olmayabilecek kullanıcı tarafından oluşturulan içeriği, sosyal özellikleri veya iletişim araçlarını görüntüler.
  • Yaş kısıtlamalarının uygun olduğu uygulama içi satın almalar veya sanal para birimleri sunar.
  • Olgunluk derecelendirmesine sahip medya içeriğini akışla sunar veya oynatır.

Yaş sinyalleri yüksek düzeyde nasıl çalışır?

Yapılandırma ayarlarıyla iletişim kuran Dijital Güvenlik API'si yerel hizmetiyle yaş grubu bilgilerini alışveriş eden bir uygulamayı gösteren diyagram.

Gizlilik ve veri işleme

Yaş sinyalleri temel bir ilke olarak gizlilikle tasarlanmıştır:

  • Tam yaş veya doğum tarihi döndürülmez. API'ler bir yaş aralığı ve yetişkin doğrulama durumunu döndürür. Yetişkin doğrulaması doğrulanmış bir yaş veya doğrulanmış reşit olmayan yaş grubu oluşturmaz.
  • Yaş grupları geneldir. Oyun veya bölge hukuku gibi çeşitli kullanım örnekleri için ortak yaş gruplarını iletirler.

Platform gereksinimleri

Requirement Ayrıntılar
En düşük işletim sistemi sürümü Windows 11
API yüzeyi Windows.System.User üzerindeki Windows Çalışma Zamanı yöntemleri
Kullanıcı bağlamı Çağrılar yalnızca geçerli işlemi çalıştıran kullanıcıya uygulanır.
Uygulama özelliği Uygulama paketi userAccountInformation bildirmelidir.

Ayrıca bakınız

  • Son güncelleştirme: