Visão geral dos sinais de idade

As APIs do Windows Age fornecem sinais que preservam a privacidade que as aplicações podem usar para compreender o grupo etário e o estado de verificação de idade do utilizador iniciado sessão. As APIs devolvem sinais grosseiros em vez da idade exata ou data de nascimento do utilizador. As aplicações podem usar estes sinais para adaptar conteúdos, funcionalidades ou controlos de acesso e devem fornecer um comportamento de recuo adequado quando um sinal não estiver disponível.

O que são sinais de idade?

Os sinais de idade são valores que o Windows devolve quando uma aplicação chama as APIs de Idade para o utilizador atual. A aplicação decide quando solicitar o grupo etário do utilizador ou o estado de verificação de idade para informar a experiência adequada do utilizador final.

Um sinal de idade não expõe diretamente a idade exata ou a data de nascimento do utilizador. Em vez disso, fornece uma faixa etária que a aplicação pode usar para tomar decisões de conteúdo. A GetUserAgeRangeAsync API oferece os seguintes grupos etários:

• Sub-10
• 10-12
• 13-15
• 16-17
• 18+

APIs de idade do Windows

GetUserAgeRangeAsync

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

Grupo etário	Valores de retorno
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 inexistente. As aplicações devem usar a sua experiência alternativa e não devem interpretar null como um grupo etário específico.

GetAgeVerificationStatusAsync

O GetAgeVerificationStatusAsync método devolve um UserAgeVerificationStatus valor que indica o estado de verificação de idade reportado ao utilizador. Os valores possíveis são:

• Verified: A idade do utilizador foi verificada.
• Unverified: A idade do utilizador não foi verificada.
• OptedOut: O utilizador optou por não participar na verificação de idade.
• TemporarilyUnavailable: O estado não pode ser determinado atualmente.
• NotApplicable: A verificação não se aplica, não existe sinal de verificação disponível, ou a funcionalidade está indisponível ou desativada.

As aplicações têm de gerir todos os valores. NotApplicable e TemporarilyUnavailable não estabelecem que o utilizador esteja verificado ou não verificado.

Autorização e consentimento do chamador

O pacote da aplicação deve declarar a capacidade userAccountInformation. O acesso aos sinais de idade também está sujeito ao consentimento do utilizador para permitir que a aplicação aceda à informação da conta nas definições de privacidade do Windows. Se o acesso não for concedido, a chamada pode falhar com E_ACCESSDENIED. O User objeto deve representar o utilizador a executar o processo atual.

Política e disponibilidade

Quando as APIs Age estão indisponíveis ou desativadas, GetUserAgeRangeAsync retorna null e GetAgeVerificationStatusAsync retorna NotApplicable. Os administradores também podem configurar um grupo etário predefinido ou um estado de verificação através de Políticas de Grupo ou MDM; quando configuradas, as APIs retornam o valor definido pela política correspondente. As aplicações devem verificar se os métodos estão disponíveis antes de as chamar e manter o comportamento de recuo para sinais indisponíveis.

Os sinais de idade do fornecedor de identidade são atualmente recuperados apenas para contas Microsoft. Para outros tipos de conta, quando não há configuração de padrão administrativo, GetUserAgeRangeAsync retorna null e GetAgeVerificationStatusAsync retorna NotApplicable.

Quando usar sinais de idade

Utilize indicadores de idade quando a sua aplicação:

• Apresenta conteúdos gerados pelos utilizadores, funcionalidades sociais ou ferramentas de comunicação que podem não ser adequadas para todas as idades.
• Oferece compras dentro da aplicação ou moedas virtuais onde as restrições de idade são relevantes.
• Transmite ou reproduz conteúdos multimédia com classificações de maturidade.

Como funcionam os sinais de idade a um nível geral

Privacidade e tratamento de dados

Os sinais de idade são concebidos com a privacidade como princípio fundamental:

• Não é dada a idade ou data de nascimento exata. As APIs retornam um intervalo etário e um estado da verificação da idade.
• Os grupos etários são genéricos. Indicam faixas etárias comuns para vários casos de uso, como jogos ou legislação regional.

Requisitos de plataforma

Requisito	Detalhes
Versão mínima do SO	Windows 11
Superfície API	Métodos de Windows Runtime em Windows.System.User
Contexto de utilizador	As chamadas aplicam-se apenas ao utilizador que executa o processo atual.
Capacidade de aplicação	O pacote da aplicação deve declarar userAccountInformation

Ver também

• Microsoft Family Safety
• Desenvolvimento de segurança e identidade para aplicações Windows