Windows Yaş API'leri hakkında SSS

Bu makale, yaşa uygun uygulama deneyimleri oluşturmak için Windows Yaş API'lerini kullanma hakkında sık sorulan soruları yanıtlar.

Overview

Windows Age API'leri nelerdir?

Windows Yaş API'leri, geçerli işlemi çalıştıran kullanıcı için gizliliği koruyan yaş sinyalleri sağlar. Windows, tam bir yaş veya doğum tarihi döndürmek yerine, bir uygulamanın yaşa uygun bir deneyim sağlamak için kullanabileceği bir yaş aralığı veya yetişkin doğrulama durumu döndürür.

Bu API'ler, Windows.System.User üzerinde Windows Çalışma Zamanı yöntemleridir. Kullanıcının tam doğum tarihini almadan, uygulamaların yaşla ilgili deneyim ve ilke kararları almasına yardımcı olurlar.

Bir kullanıcı onay verirse, geliştirici uygulamaların yaşa uygun deneyimler tasarlarken kullanabileceği yaş sinyallerine erişebilir. Uygulama geliştiricileri, ilgili yasaların ve gereksinimlerin ürünlerine nasıl uygulanacağını belirlemekle yükümlü olmaya devam eder.

Windows Yaş API'leri hangi senaryolara yöneliktir?

Uygulamalar, yaşın deneyim açısından ilgili olduğu durumlarda yaş sinyallerini kullanabilir. Örneğin, bir uygulama aşağıdaki durumlarda yaş sinyali kullanabilir:

  • Kullanıcı tarafından oluşturulan içeriği, sosyal özellikleri veya her yaş için uygun olmayabilecek iletişimleri görüntüler.
  • Yaş kısıtlamalarının uygulanabileceği uygulama içi satın almalar veya sanal para birimleri sunar.
  • Olgunluk derecelendirmelerine sahip medya akışı gerçekleştirir veya oynatır.

Daha genel olarak, bir uygulama doğum tarihi toplamadan içeriğini, özelliklerini veya erişim denetimlerini uyarlamak için yaş sinyali kullanabilir.

Hangi Windows Age API'leri kullanılabilir?

Aşağıdaki API'ler farklı senaryoları destekler:

  • GetUserAgeRangeAsync kullanıcının yaş grubunun kapsayıcı alt ve üst sınırlarını içeren bir UserAgeRange döndürür. Önceden tanımlanmış gruplar 10 yaş altı, 10–12, 13–15, 16–17 ve 18 yaş ve üzeri gruplardır. null sonucu, yaş aralığının bilinmediğini veya kullanılamadığını gösterir.
  • GetAgeVerificationStatusAsync kullanıcının yetişkin doğrulama durumunu belirten bir UserAgeVerificationStatus döndürür. Rastgele bir yaş veya yaş grubunu doğrulamaz.

Yaş doğrulaması kullanıcının yaşını veya yaş grubunu doğrular mı?

No. Yaş doğrulama, doğrulanmış yetişkin durumu sağlar, herhangi bir yaş veya yaş grubu için doğrulanmış bir durum sağlamaz. Hesap tabanlı doğrulama için, yetişkin olduğunu iddia eden bir kullanıcının bu kişinin yetişkin olup olmadığını denetleyen bir akıştan geçmesi gerekir. Akış, yetişkin beyanını denetler; bir çocuk veya genç için doğrulanmış bir yaş belirlemez.

Microsoft hesabı için yaşınızı doğrulama hakkında bilgi için bkz. Microsoft hesabı için yaşınızı doğrulama.

GetAgeVerificationStatusAsync yetişkin doğrulama durumunu bildirir. Bir Verified sonucu, doğrulanmış yetişkin durumunu bildirir. Diğer sonuçlar kullanıcının küçük olduğunu göstermez: uygulamanız Unverified sonucunu, OptedOut sonucunu ve kullanılamayan veya belirsiz sonuçları ayırt etmelidir.

Windows Age API'leri genel kullanıma sunuldu mu?

GetUserAgeRangeAsync ve GetAgeVerificationStatusAsync genel kullanıma sunulmuştur. Desteklenen perakende Windows derlemeleri şunlardır:

  • Windows 11, sürüm 24H2: derleme 26100.9550 veya üzeri.
  • Windows 11, sürüm 25H2: derleme 26200.9550 veya üzeri.

Windows SDK sürüm 10.0.26100.9169 veya üzeri bu API'leri içerir.

Uygulamam hangi API'i kullanmalıdır?

Şu değeri kullanın:

  • GetUserAgeRangeAsync uygulamanızın bir yaş aralığına ihtiyacı olduğunda ve kendi deneyim mantığını veya ilke mantığını uyguladığında.
  • GetAgeVerificationStatusAsync bir karar kullanıcının yetişkin olduğunun doğrulanıp doğrulanmadığına bağlı olduğunda.

Bir uygulama, senaryosu için uygun olduğunda birden fazla yaş sinyali kullanabilir. 18 veya üzeri yaş aralığı sonucu tek başına doğrulanmış yetişkin durumu oluşturmaz.

Gizlilik ve veri işleme

GetUserAgeRangeAsync için kendi yaş aralıklarımı yapılandırabilir miyim?

No. GetUserAgeRangeAsync tarafından döndürülen yaş grupları önceden tanımlanmıştır.

API'ler kullanıcının tam yaşını veya doğum tarihini döndürür mü?

No. GetUserAgeRangeAsync tam bir yaş veya doğum tarihi değil, bir yaş grubu döndürür. Örneğin, alt ve üst sınırları {13, 15} ile gösterilen bir sonuç, kullanıcının yaşının 13-15 yaş grubunda olduğu anlamına gelir.

GetAgeVerificationStatusAsync doğrulanmış yaş veya doğrulanmış yaş grubu değil yetişkin doğrulama durumunu bildirir.

Uygulamamın Windows Yaş API'lerini kullanmak için kullanıcının doğum tarihini toplaması gerekiyor mu?

No. API'lerin bir amacı, uygulamaların kullanıcının doğum tarihini doğrudan almadan yaşla ilgili kararlar almasına izin vermektir.

Uygulamalar yaş sinyali depolamalı mı?

Uygulamalar yaş sinyallerini gereksiz yere kalıcı olarak saklamaktan kaçınmalıdır. Kullanıcının yaş grubu, doğrulama durumu, hesap durumu veya geçerli yönetim ilkesi değişebileceğinden gerekli olduğunda sinyali alın.

Kullanıcı ve hesap davranışı

Hangi hesap türleri desteklenir?

Kimlik sağlayıcısı yaş sinyalleri şu anda yalnızca Microsoft hesaplarda kullanılabilir. Diğer hesap türleri için, bir yönetici varsayılanı yapılandırılmadığında, GetUserAgeRangeAsync döndürür nullve GetAgeVerificationStatusAsync döndürür NotApplicable.

Yaş API'leri hangi kullanıcı hakkında bilgi döndürür?

Age API'si çağrıları geçerli işlemi çalıştıran kullanıcı için geçerlidir. Birden çok Windows profili olan bir cihazda, API'ler etkin uygulama deneyimi için geçerli kullanıcının profilini sorgular. API'ler farklı bir profili sorgulamak için bir mekanizma sağlamaz.

Uygulama, cihazdaki başka bir kullanıcı için yaş sinyalini sorgulayabilir mi?

No. API'ler, işlemi çalıştıran kullanıcı bağlamında çalışır. Farklı bir kullanıcıyı temsil eden bir User nesneyle Yaş API'si çağrılması ile E_ACCESSDENIEDsonuçlanabilir.

Bir kullanıcının Windows'a bağlı birden çok hesap türü olduğunda ne olur?

Windows Yaş API'leri şu anda oturum açmış olan Windows kullanıcısının bağlamında çalışır ve bu kullanıcının Windows oturum açmasıyla ilişkili Microsoft hesabı kullanır. Uygulamalar sorgu için başka bir bağlı hesap seçemez.

Yaş sinyali belirlenemezse ne olur?

Uygulamaların, yaş sinyalinin kullanılamayabileceği veya belirsiz olabileceği durumlara hazırlıklı olması gerekir.

GetUserAgeRangeAsync için, null yaş aralığının bilinmediğini veya kullanılamadığını gösterir. null üretebilen koşullar şunları içerir:

  • Hesap türü desteklenmiyor.
  • Yaş bilgisi hesap için mevcut değil.
  • API, yönetim politikası tarafından devre dışı bırakıldı.

NotApplicable için, GetAgeVerificationStatusAsync veya TemporarilyUnavailable, kullanılamayan veya belirlenemeyen bir doğrulama sinyalini temsil eder. Bu sonuçlar, kullanıcının reşit olduğunu doğrulayıp doğrulamadığını belirlemez.

Uygulamalar uygun bir geri dönüş deneyimi sağlamalı ve kullanılamayan bir sonucu belirli bir yaş grubu veya doğrulama durumu olarak yorumlamamalıdır.

Uygulamalar bir yaş sinyalinin her zaman kullanılabilir olduğunu varsaymalı mı?

No. Uygulamalar, Yaş API'si tümleştirmesinin bir parçası olarak geri dönüş davranışı tasarlamalıdır. Geçerli bir sinyali, kullanılamayan veya belirsiz bir sinyali ve erişim reddedildi hatasını farklı durumlar olarak değerlendirin.

Uygulama gereksinimleri ve uygulanması

Hangi işletim sistemi ve SDK gereklidir?

Windows 11 desteklenen en düşük işletim sistemidir. GetUserAgeRangeAsync ve GetAgeVerificationStatusAsync aşağıdaki desteklenen perakende derlemelerinde kullanılabilir:

  • Windows 11, sürüm 24H2: derleme 26100.9550 veya üzeri.
  • Windows 11, sürüm 25H2: derleme 26200.9550 veya üzeri.

Bu API'leri çağıran bir uygulama oluşturmak için Windows SDK sürüm 10.0.26100.9169 veya üzerini kullanın.

Bir API eski veya bakımı yapılmamış bir sistemde bulunmayabileceğinden, çağırmadan önce API'nin kullanılabilirliğini denetleyin.

Uygulamamın bir yetenek bildirmesi gerekiyor mu?

Yes. UWP uygulamasının paket bildiriminde userAccountInformation yeteneğini bildirmesi gerekir:

<uap:Capability Name="userAccountInformation" />

Gerekli erişim olmadan uygulama kullanıcının yaş verilerini okuyamaz.

Yaş API'sini çağırmak için kullanılan User nesnesini nasıl edinebilirim?

User.GetDefault kullanarak geçerli işlemi çalıştıran kullanıcıyı alın. User.FindAllAsync kullanıcıları listeleyebilir, ancak bir Yaş API'si, işlemi çalıştıran kullanıcıyı temsil eden User örneğiyle çağrılmalıdır.

Doğum tarihi değişikliğinin veya doğum gününün bir yaş sinyalini etkilemesi ne kadar sürer?

Bir kullanıcı Microsoft hesabıyla ilişkilendirilen doğum tarihini değiştirirse veya doğum günü geldiğinde, değişiklik son yaş sinyali alındıktan sonraki 24 saat içinde yansıtılır.

Bir uygulama yaş sinyali yenilemesi zorlayabilir mi?

No. Zorunlu yenileme desteklenmez.

Hata ve yedek işleme

Bir uygulama mevcut olmayan bir yaş aralığını nasıl işlemelidir?

Bir yaş varsaymak yerine, kullanılamayan bir yaş aralığını açıkça işleyin. null sonucuGetUserAgeRangeAsync, yaş aralığının bilinmediği veya mevcut olmadığı anlamına gelir.

Kasıtlı olarak tasarlanmış bir alternatif deneyim kullanın. null bunu, 18 yaş ve üzeri grup dahil, belirli bir yaş grubu olarak yorumlamayın.

E_ACCESSDENIED ne anlama geliyor?

E_ACCESSDENIED çağıranın Hesap bilgilerine erişimi olmadığı veya uygulamanın işlemi çalıştıran kullanıcı dışında biri için bir User nesneyle API'yi çağırdığı anlamına gelebilir.

Bu hatayı kullanılamayan bir sinyalden farklı olarak değerlendirin. Kullanılamayan bir sinyal, API'ye bağlı olarak NotApplicable, TemporarilyUnavailable veya null olarak döndürülür.

Bir uygulama bilinmeyen doğrulama durumuyla ne yapmalıdır?

Kullanılamayan veya belirsiz doğrulama durumlarını açıkça işleyin ve alternatif bir deneyim sağlayın. NotApplicable ve TemporarilyUnavailable, kullanıcının yetişkin durumunu doğrulayıp doğrulamadığını belirlemez. Bu sonuçları, Unverified veya OptedOut öğelerini, kullanıcının reşit olmadığının kanıtı olarak yorumlamayın.

Ayrıca bkz.

  • Son güncelleştirme: