Visão geral dos sinais de idade

As APIs do Windows Age fornecem sinais que preservam a privacidade e que os aplicativos podem usar para entender a faixa etária e o status de verificação de maioridade do usuário conectado. As APIs retornam sinais grosseiros em vez da idade exata ou data de nascimento do usuário. Os aplicativos podem usar esses sinais para adaptar conteúdo, recursos ou controles de acesso e devem fornecer um comportamento de fallback apropriado quando um sinal não estiver disponível.

O que são sinais de idade?

Sinais de idade são valores que Windows retorna quando um aplicativo chama as APIs age para o usuário atual. O aplicativo decide quando solicitar o status de verificação de maioridade ou grupo etário do usuário a fim de informar a experiência adequada para o usuário final.

Nenhum sinal expõe diretamente a idade exata ou a data de nascimento do usuário. A GetUserAgeRangeAsync API fornece uma faixa etária que o aplicativo pode usar para tomar decisões de conteúdo. Ele oferece as seguintes faixas etárias:

  • Menos de 10
  • 10-12
  • 13-15
  • 16-17
  • 18+

APIs de Idade do Windows

GetUserAgeRangeAsync

O GetUserAgeRangeAsync método retorna a faixa etária do usuário como um UserAgeRange objeto com Lower e Upper propriedades.

Faixa etária Retornar valores
Menos de 10 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Desconhecido null

Quando o resultado é null, a faixa etária é desconhecida ou indisponível. Os aplicativos devem usar sua experiência alternativa e não devem interpretar null como uma faixa etária específica.

GetAgeVerificationStatusAsync

O GetAgeVerificationStatusAsync método retorna um UserAgeVerificationStatus valor que indica o status de verificação de adulto relatado para o usuário. A verificação de idade verifica se um usuário que afirma ser adulto é um adulto. Ele não estabelece uma idade verificada nem verifica outras faixas etárias.

Os valores possíveis são:

  • Verified: o usuário verificou o status de adulto.
  • Unverified: o usuário não tem o status de adulto verificado. Isso não estabelece que o usuário é menor de idade.
  • OptedOut: o usuário recusou a verificação de maioridade.
  • TemporarilyUnavailable: O status não pode ser determinado no momento.
  • NotApplicable: a verificação não se aplica, nenhum sinal de verificação está disponível ou o recurso está indisponível ou desabilitado.

Os aplicativos devem lidar com todos os valores. NotApplicable e TemporarilyUnavailable não estabelecem se a condição de adulto do usuário foi verificada. Um resultado de faixa etária igual a 18 anos ou mais não estabelece, por si só, o status de adulto verificado.

O pacote do aplicativo deve declarar a userAccountInformation funcionalidade. O acesso aos sinais de idade também está sujeito ao consentimento do usuário para que o aplicativo acesse as informações da conta nas configurações de privacidade do Windows. Se o acesso não for concedido, a chamada poderá falhar com E_ACCESSDENIED. O User objeto deve representar o usuário que está executando o processo atual.

Política e disponibilidade

Quando as APIs age estiverem indisponíveis ou desabilitadas, GetUserAgeRangeAsync retornará null e GetAgeVerificationStatusAsync retornará NotApplicable. Os administradores também podem configurar uma faixa etária padrão ou o status de verificação por meio da Política de Grupo ou do MDM; quando configuradas, as APIs retornam o valor definido pela política correspondente. Os aplicativos devem verificar se os métodos estão disponíveis antes de chamá-los e manter o comportamento de fallback para sinais indisponíveis.

Um valor definido por política Verified é um padrão administrativo, não uma evidência de que o usuário concluiu o fluxo de verificação para adultos.

No momento, os sinais de idade do provedor de identidade são recuperados apenas para contas Microsoft. Para outros tipos de conta, quando nenhum padrão administrativo é configurado, GetUserAgeRangeAsync retorna null e GetAgeVerificationStatusAsync retorna NotApplicable.

Quando usar sinais de idade

Use sinais de idade quando seu aplicativo:

  • Exibe conteúdo gerado pelo usuário, recursos sociais ou ferramentas de comunicação que podem não ser apropriados para todas as idades.
  • Oferece compras no aplicativo ou moedas virtuais em que as restrições de idade são relevantes.
  • Transmite ou reproduz conteúdo multimídia com classificações etárias.

Como os sinais de idade funcionam em um alto nível

Diagrama mostrando um aplicativo trocando informações de faixa etária com o serviço local da API de Segurança Digital, que se comunica com as configurações.

Privacidade e manipulação de dados

Os sinais de idade são projetados com privacidade como um princípio central:

  • Nenhuma idade exata ou data de nascimento é retornada. As APIs retornam um bucket de idade e um status de verificação para adultos. A verificação de maioridade não estabelece uma idade verificada nem um grupo etário de menor verificado.
  • As faixas etárias são genéricas. Elas indicam faixas etárias comuns para diversos casos de uso, como jogos ou legislação regional.

Requisitos de plataforma

Requirement Detalhes
Versão mínima do SO Windows 11
Superfície da API métodos do Windows Runtime em Windows.System.User
Contexto do usuário As chamadas se aplicam somente ao usuário que executa o processo atual.
Capacidade do aplicativo O pacote do aplicativo deve declarar userAccountInformation

Consulte também