Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo responde a perguntas frequentes sobre como usar APIs de idade do Windows para criar experiências de aplicativo apropriadas para a idade.
Overview
Quais são as APIs de Idade do Windows?
As APIs Windows Age fornecem sinais de idade que preservam a privacidade para o usuário que está executando o processo atual. Em vez de retornar uma idade exata ou data de nascimento, Windows retorna uma faixa etária ou status de verificação de maioridade que um aplicativo pode usar para fornecer uma experiência apropriada à idade.
Essas APIs são métodos do Windows Runtime em Windows.System.User. Eles ajudam os aplicativos a tomar decisões de experiência e de política relacionadas à idade sem receber a data exata de nascimento do usuário.
Se um usuário consentir, um desenvolvedor poderá acessar sinais de idade que os aplicativos podem usar ao projetar experiências apropriadas para a idade. Os desenvolvedores de aplicativos permanecem responsáveis por determinar como as leis e requisitos aplicáveis se aplicam aos seus produtos.
Para quais cenários as APIs de Idade do Windows são destinadas?
Os aplicativos podem usar sinais de idade quando a idade é relevante para a experiência. Por exemplo, um aplicativo poderá usar um sinal de idade se ele:
- Exibe conteúdo gerado pelo usuário, recursos sociais ou comunicações que podem não ser apropriadas para todas as idades.
- Oferece compras no aplicativo ou moedas virtuais para as quais as restrições de idade podem se aplicar.
- Transmite ou reproduz mídia com classificações indicativas.
Em geral, um aplicativo pode usar um sinal de idade para adaptar seu conteúdo, recursos ou controles de acesso sem coletar uma data de nascimento.
Quais APIs de Idade do Windows estão disponíveis?
As seguintes APIs dão suporte a cenários diferentes:
-
GetUserAgeRangeAsyncretorna umUserAgeRangeque contém os limites inferior e superior inclusivos da faixa etária do usuário. Os grupos predefinidos são menores de 10, 10 a 12, 13 a 15, 16 a 17 e 18 anos ou mais. Umnullresultado significa que a faixa etária é desconhecida ou indisponível. -
GetAgeVerificationStatusAsyncretorna umUserAgeVerificationStatusindicando o status de verificação de maioridade do usuário. Ele não verifica uma idade arbitrária ou faixa etária.
A verificação de idade verifica a idade ou a faixa etária de um usuário?
No. A verificação etária fornece status de adulto verificado, não um status verificado para qualquer faixa etária ou faixa etária. Para verificação baseada em conta, um usuário que afirma ser um adulto deve passar por um fluxo que verifica se essa pessoa é adulta. O fluxo verifica a declaração de maioridade; não estabelece uma idade verificada para uma criança ou adolescente.
Para obter informações sobre como verificar sua idade para uma conta Microsoft, consulte Verificar sua idade para uma conta Microsoft.
GetAgeVerificationStatusAsync informa o status de verificação de maioridade. Um Verified resultado indica o status de adulto verificado. Outros resultados não estabelecem que o usuário é menor de idade: o aplicativo deve distinguir um resultado Unverified, um resultado OptedOut e resultados indisponíveis ou indeterminados.
As APIs de Idade do Windows estão em disponibilidade geral?
GetUserAgeRangeAsync e GetAgeVerificationStatusAsync estão disponíveis em geral. Os builds de Windows de varejo com suporte são:
- Windows 11, versão 24H2: build 26100.9550 ou posterior.
- Windows 11, versão 25H2: build 26200.9550 ou posterior.
Windows SDK versão 10.0.26100.9169 ou posterior inclui essas APIs.
Qual API meu aplicativo deve usar?
Uso:
-
GetUserAgeRangeAsyncquando o aplicativo precisa de uma faixa etária e aplica a própria lógica ou lógica de política. -
GetAgeVerificationStatusAsyncquando uma decisão depende de o usuário ter confirmado o status de maioridade.
Um aplicativo pode usar mais de um sinal de idade quando apropriado para seu cenário. Um resultado de faixa etária igual a 18 anos ou mais não estabelece, por si só, o status de adulto verificado.
Privacidade e manipulação de dados
Posso configurar minhas próprias faixas etárias para GetUserAgeRangeAsync?
No. As faixas etárias retornadas por GetUserAgeRangeAsync são predefinidas.
As APIs retornam a idade exata ou a data de nascimento do usuário?
No.
GetUserAgeRangeAsync retorna uma faixa etária, não uma idade exata ou uma data de nascimento. Por exemplo, um resultado com limite inferior e superior de {13, 15} significa que a idade do usuário está na faixa etária de 13 a 15 anos.
GetAgeVerificationStatusAsync relata o status da verificação de maioridade, não uma idade verificada ou uma faixa etária verificada.
Meu aplicativo precisa coletar a data de nascimento de um usuário para usar as APIs de Idade do Windows?
No. Um dos propósitos das APIs é permitir que os aplicativos tomem decisões relacionadas à idade sem receber diretamente a data de nascimento do usuário.
Os aplicativos devem armazenar um sinal de idade?
Os aplicativos devem evitar armazenar desnecessariamente os indicadores de idade. Recupere o sinal quando necessário porque a faixa etária, o status de verificação, o estado da conta ou a política administrativa aplicável de um usuário podem ser alterados.
Comportamento do usuário e da conta
Quais tipos de conta têm suporte?
Os sinais de idade do provedor de identidade estão disponíveis no momento apenas para contas Microsoft. Para outros tipos de conta, quando um padrão administrativo não é configurado, GetUserAgeRangeAsync retorna nulle GetAgeVerificationStatusAsync retorna NotApplicable.
Sobre qual usuário a Age API retorna informações?
As chamadas à API de idade se aplicam ao usuário que está executando o processo atual. Em um dispositivo com vários perfis de Windows, as APIs consultam o perfil do usuário atual para a experiência do aplicativo ativo. As APIs não fornecem um mecanismo para consultar um perfil diferente.
Um aplicativo pode consultar um sinal de idade para outro usuário no dispositivo?
No. As APIs operam no contexto do usuário que executa o processo. Chamar uma API Age com um User objeto que representa um usuário diferente pode resultar em E_ACCESSDENIED.
O que acontece quando um usuário tem vários tipos de conta conectados ao Windows?
As APIs de Idade do Windows operam no contexto do usuário do Windows conectado no momento e usam a conta Microsoft associada à entrada do Windows desse usuário. Os aplicativos não podem selecionar outra conta conectada para a consulta.
E se um sinal de idade não puder ser determinado?
Os aplicativos devem estar preparados para um indicador de idade estar indisponível ou ser indeterminado.
Para GetUserAgeRangeAsync, null significa que a faixa etária é desconhecida ou indisponível. As condições que podem produzir null incluem:
- Não há suporte para o tipo de conta.
- As informações de idade não estão disponíveis para a conta.
- A API está desativada por política administrativa.
Para GetAgeVerificationStatusAsync, NotApplicable ou TemporarilyUnavailable representa um indicador de verificação indisponível ou indeterminado. Esses resultados não estabelecem se o status de adulto do usuário foi verificado.
Os aplicativos devem fornecer uma experiência de fallback apropriada e não devem interpretar um resultado indisponível como uma faixa etária específica ou status de verificação.
Os aplicativos devem assumir que um sinal de idade está sempre disponível?
No. Os aplicativos devem projetar o comportamento de fallback como parte da integração da API Age. Trate um sinal válido, um sinal indisponível ou indeterminado e um erro de acesso negado como estados distintos.
Requisitos e implementação do aplicativo
Qual sistema operacional e SDK são necessários?
A versão mínima de sistema operacional com suporte é o Windows 11.
GetUserAgeRangeAsync e GetAgeVerificationStatusAsync estão disponíveis nos seguintes builds de varejo com suporte:
- Windows 11, versão 24H2: build 26100.9550 ou posterior.
- Windows 11, versão 25H2: build 26200.9550 ou posterior.
Use a versão 10.0.26100.9169 do Windows SDK ou posterior para criar um aplicativo que chame essas APIs.
Como uma API pode estar ausente em um sistema mais antigo ou sem manutenção, verifique a disponibilidade da API antes de chamá-la.
Meu aplicativo precisa declarar uma funcionalidade?
Sim. Um aplicativo UWP deve declarar a capacidade userAccountInformation no manifesto do pacote:
<uap:Capability Name="userAccountInformation" />
Sem o acesso necessário, o aplicativo não pode ler os dados de idade do usuário.
Como obter o objeto User usado para chamar uma Age API?
Use User.GetDefault para obter o usuário que está executando o processo atual.
User.FindAllAsync pode enumerar usuários, mas uma API Age deve ser chamada com a instância User que representa o usuário que executa o processo.
Quanto tempo leva para uma alteração da data de nascimento ou aniversário afetar um indicador de idade?
Se um usuário alterar a data de nascimento associada ao seu conta Microsoft ou tiver um aniversário, a alteração será refletida dentro de 24 horas após a última busca de sinal de idade.
Um aplicativo pode forçar uma atualização do indicador de idade?
No. Não há suporte para uma atualização forçada.
Tratamento de erro e fallback
Como um aplicativo deve lidar com uma faixa etária indisponível?
Trate explicitamente uma faixa etária indisponível em vez de assumir uma idade. Um null resultado de GetUserAgeRangeAsync significa que a faixa etária é desconhecida ou indisponível.
Use uma experiência de fallback deliberadamente projetada. Não interprete null como um determinado grupo etário, excluindo o grupo de 18 anos ou mais.
O que E_ACCESSDENIED significa?
E_ACCESSDENIED pode significar que o chamador não tem acesso às informações da Conta ou que o aplicativo chamou a API com um User objeto para alguém que não seja o usuário que está executando o processo.
Trate esse erro como distinto de um sinal indisponível. Um sinal indisponível é retornado como null, NotApplicableou TemporarilyUnavailable, dependendo da API.
O que um aplicativo deve fazer com um status de verificação desconhecido?
Manipule os estados de verificação indisponíveis ou indeterminados explicitamente e forneça uma experiência de fallback.
NotApplicable e TemporarilyUnavailable não estabelecem se a condição de adulto do usuário foi verificada. Não interprete esses resultados Unverifiedou OptedOut como prova de que o usuário é menor de idade.
Consulte também
Windows developer