O SDK do Android XR agora está disponível na prévia para desenvolvedores. Queremos saber sua opinião Acesse nossa página de suporte para entrar em contato.

Esta página foi traduzida pela API Cloud Translation.

Diretrizes de qualidade de apps para Android XR

Definições de nível de compatibilidade

Para garantir que seu app ofereça uma ótima experiência do usuário em dispositivos Android XR, confira as listas de verificação e os testes de compatibilidade a seguir.

As listas de verificação e os testes definem um conjunto abrangente de requisitos de qualidade para a maioria dos tipos de apps Android.

App para dispositivos móveis compatível com o Android XR

Um app móvel compatível com Android XR representa um app móvel que não foi modificado para se adaptar a uma tela grande ou a qualquer outro formato. Esse tipo de app é automaticamente compatível com o Android XR, desde que não exija recursos sem suporte, como telefonia. Os usuários podem concluir fluxos de tarefas críticas, mas com uma experiência do usuário menos ideal do que um app diferenciado do Android XR.

Esse tipo de app é executado em tela cheia em um painel no ambiente do usuário, mas o layout pode não ser ideal em tamanhos maiores. Os apps que especificam tamanhos compactos no manifesto aparecem de acordo com essa especificação. O app não é executado no modo de compatibilidade e, portanto, não tem efeito letterbox. O app tem uma experiência funcional das principais modalidades de entrada fornecidas pelo Android XR (rastreamento ocular + gesto ou mãos de raycast) e suporte básico para dispositivos de entrada externa, incluindo teclado, mouse, trackpad e controles de jogos. Ele pode ou não ser redimensionado.

Os apps para dispositivos móveis compatíveis com Android XR são ativados automaticamente e estão disponíveis na Google Play Store. Um app incompatível devido a requisitos de recursos não aceitos não pode ser instalado pela Play Store.

App para telas grandes compatível com o Android XR

Um app de tela grande compatível com Android XR representa um app de tela grande de nível 1 ou nível 2 que implementou otimizações de layout para todos os tamanhos de tela e configurações de dispositivos (por exemplo, telas grandes além de dispositivos móveis), além de oferecer suporte aprimorado para dispositivos de entrada externa e multitarefa. Os apps de tela grande compatíveis com o Android XR são ativados automaticamente e ficam disponíveis na Play Store.

Um app de tela grande compatível com Android XR é executado em tela cheia em um painel espacial no ambiente do usuário em 1024 dp × 720 dp. Os usuários poderão interagir com o app naturalmente usando os olhos e as mãos, mas ele será muito semelhante ao app de tela grande.

App diferenciado do Android XR

Um app diferenciado para Android XR tem uma experiência do usuário explicitamente projetada para XR e implementa recursos oferecidos apenas nesse tipo de dispositivo. Você pode aproveitar ao máximo os recursos do Android XR e diferenciar as experiências do seu app adicionando recursos de XR (por exemplo, painéis espaciais) e conteúdo de XR (por exemplo, vídeo 3D) aos seus aplicativos desenvolvendo com o SDK do Android Jetpack XR, Unity ou OpenXR.

Você pode usar o SDK Jetpack XR para oferecer recursos específicos de XR, incluindo painéis espaciais, ambientes, modelos 3D, áudio espacial, vídeo / fotos 3D / espaciais, âncoras e outras interfaces espaciais, como orbitadores.

Para ser considerado um app diferenciado para Android XR, ele precisa implementar pelo menos um recurso ou conteúdo específico de XR. Para determinados casos de uso, podem existir mais recursos e requisitos de conteúdo. Confira os detalhes a seguir.

Todos os apps criados com Unity ou OpenXR são considerados diferenciados. Os apps criados com Unity ou OpenXR precisam atender às métricas de qualidade e aos requisitos mínimos para serem considerados um app diferenciado do Android XR. Por exemplo, um app com baixa taxa de frames, falhas ou outras experiências negativas do usuário não se qualificaria.

Lista de verificação de compatibilidade do Android XR

Essas listas de verificação definem critérios para ajudar você a avaliar o nível de suporte que o app oferece para XR. Os níveis de suporte incluem:

App para dispositivos móveis compatível com o Android XR

Seu app precisa atender aos requisitos de qualidade.

O app também precisa obedecer a todas as diretrizes de acessibilidade aplicáveis a outros formatos, como smartphones e tablets (por exemplo, contraste de cores).

App compatível com telas grandes do Android XR

Qualquer app de tela grande nível 1 ou nível 2 é considerado compatível com o Android XR. As diretrizes de qualidade de apps para telas grandes oferecem uma abordagem estruturada para garantir uma ótima experiência no Android XR, mas não exigem considerações sobre o estado do dispositivo, como rotação ou dobragem/desdobragem. Da mesma forma, o Android XR não inclui suporte para stylus.

App diferenciado do Android XR

Como os apps diferenciados do Android XR são altamente diferenciados, alguns dos recursos listados são aplicáveis somente a tipos específicos de apps. Escolha os recursos adequados para seu aplicativo. Os apps Android também precisam obedecer às diretrizes para telas grandes / dispositivos móveis Android. Confira os requisitos adequados para sua inscrição. Alguns deles podem se tornar atualizações de política em potencial.

Tipo de app / caso de uso	Categorias	Área	Orientação
Requisito geral de base (Android e OpenXR)	Privacidade e segurança	Login na conta (UX da primeira vez)	Se o app usa um sistema de login, apresente claramente as credenciais de login do usuário (por exemplo, o nome de usuário) após a autenticação. Isso aumenta a confiança ao confirmar a conta ativa. Além disso, incorpore um menu ou uma página de configurações de fácil acesso que permita aos usuários visualizar e gerenciar as informações da conta a qualquer momento.
	Segurança e conforto	Efeito estroboscópico	Para garantir a segurança e o bem-estar de todos os usuários, é crucial minimizar o risco de efeitos estroboscópicos no seu aplicativo. Evite incorporar intencionalmente elementos de design que possam induzir o efeito estroboscópico. 1. Se o efeito estroboscópico for absolutamente necessário, verifique se a taxa de intermitência é muito baixa (menos de 3 piscadas por segundo) e se a área de intermitência é pequena e sutil. 2. Considere oferecer a opção de desativar o recurso nas configurações ou preferências. 3. Mostrar uma mensagem de aviso clara antes de qualquer efeito estroboscópico.
	Segurança e conforto	Evitar enjoo	Siga estas diretrizes para evitar causar enjoo em usuários: Priorize o conforto visual evitando movimentos bruscos da câmera. Mantenha um quadro de referência consistente para não desorientar o usuário. Não gire a câmera com o tempo. Se a direção da câmera mudar, ela vai se ajustar à nova orientação.
	Input	Tamanho dos destinos de interação	As áreas interativas têm um tamanho mínimo e um tamanho recomendado com base na distância de interação pretendida: Tamanho mínimo: DistanceInM x 0,868 x 48 = M Tamanho recomendado: DistanceInM x 0,868 x 56 = M ou maior Ao usar o SDK XR do Jetpack, recomendamos um tamanho mínimo de 48 x 48 dp, com um tamanho de área de toque recomendado de 56 x 56 dp ou maior.
	Funcionalidade técnica de XR	Entrada com a mão	Seu app oferece suporte à entrada natural com as mãos como um método de interação básico para o Android XR, incluindo requisitos de raycast das mãos e suporte a gestos para primitivos de entrada. O app pode ser jogado ou usado sem controles, mas pode ser aprimorado com o uso deles, se você quiser.
	Funcionalidade técnica de XR	Boundary (antigo Guardian)	Se o app espera que os usuários se movam do ponto de partida (ao iniciar o app) pelo espaço físico, ele solicita a transmissão ou declara `PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED = XR_BOUNDARY_TYPE_LARGE` no manifesto. Se o app usar `XR_BOUNDARY_TYPE_LARGE`, ele poderá ser jogado sem que o limite apareça (em um raio de 2 m; observe que a passagem de limite começa a aparecer em um raio de 1, 5 m).
	Desempenho	Renderização	Seu app renderiza cada frame entre <11,1 ms (90 Hz) e < 13,8 ms (72 Hz).
		Resolução	O app tem uma resolução de pelo menos 1856 x 2160 por olho.
		Tempo de inicialização do app	Os usuários querem interagir com seu app ou jogo o mais rápido possível. A definição de um bom tempo de inicialização ou carregamento varia de acordo com a categoria, mas, como princípio geral, recomendamos minimizar o tempo entre o lançamento e a primeira interação. Confira as durações de destino abaixo: Média de inicialização a frio: menos de 2 segundos Média de inicialização com estado salvo: menos de 1 segundo Para mais detalhes, consulte Tempo de inicialização do app.
		ANRs	O app não falha nem bloqueia a linha de execução de interface, causando erros de ANR ("O Android não está respondendo"). Seu app tem menos de um ANR em 99,5% das sessões diárias. O app usa o relatório de pré-lançamento do Google Play para identificar possíveis problemas de estabilidade. Após a implantação, preste atenção à página "Android vitals" no Google Play Console.
		Taxa de falhas	Não consuma recursos excessivos do sistema, o que afeta o restante do sistema e outros apps, mantendo uma taxa de falhas de aproximadamente 1%.
Base de apps Android (diferenciada para XR)	Visual e experiência do usuário	XR básico	O app implementa pelo menos um recurso ou conteúdo específico de XR para melhorar a experiência do usuário. Isso pode incluir um orbiter, um ou mais painéis espaciais, ambientes ou objetos 3D.
		Painéis espaciais	Ao fazer várias tarefas ao mesmo tempo com painéis, crie painéis espaciais separados. Por exemplo, você pode criar painéis espaciais separados para janelas de chat e listas.
		Ambientes	Ao mostrar um ambiente virtual, o brilho pode ser cansativo e causar distração. O app apresenta uma faixa tonal segura, sem picos de brilho que entrem em conflito com a interface ou causem fadiga ao usuário. A interface é legível em todas as direções, especialmente na faixa horizontal central do olhar do usuário. (Diretrizes detalhadas serão vinculadas no futuro)
		Transição entre Espaço Compacto (HSM) e Espaço Ampliado (FSM)	Ao levar os usuários para o Modo de Espaço Ampliado, o app tem um ponto de entrada para que eles façam a transição rápida entre o Modo de Espaço Compacto e o Modo de Espaço Ampliado. Use um ícone ou marcador e coloque o botão em um local de fácil acesso.
		Painéis espaciais	Coloque menus, recursos e controles em um painel ou orbiter dedicado. Não inclua esses componentes no painel de edição principal.
		Rolagem de menu / lista	O app atualiza as interações de rolagem (principalmente em carrosséis ou listas verticais) para ter física ou impulso. Por exemplo, a rolagem incorpora o impulso, fazendo com que o conteúdo em carrosséis e listas continue se movendo brevemente após uma interação do usuário antes de parar gradualmente (em vez de parar exatamente quando o usuário para de inserir dados).
Funcionalidade de vídeo / mídia	Visual e experiência do usuário	Player espacial (somente Android)	O app permite que os usuários assistam conteúdo no Espaço Ampliado. Remova os controles de reprodução de uma sobreposição na parte de cima do conteúdo e coloque-os em um painel ou orbiter dedicado. Para painéis com reprodução de vídeo, defina a proporção para remover o efeito letterbox.
		Áudio espacial	Considere oferecer suporte ao áudio espacial, incluindo áudio fixado no painel ou som surround.
		Visualização simultânea de vídeos	Se o app for compatível com vários fluxos de vídeo simultâneos, a interface do usuário vai deixar claras as seguintes informações: Quais streams de vídeo estão fornecendo saída de áudio Quais controles de reprodução afetam quais streams de vídeo
		Ambiente	Ao reproduzir conteúdo no Modo de Espaço Ampliado, o app permite que os usuários diminuam a intensidade da transmissão direta ou selecionem ambientes virtuais.

OpenXR™ e o logotipo OpenXR são marcas registradas de propriedade da Khronos Group Inc. e estão registradas como marcas comerciais na China, na União Europeia, no Japão e no Reino Unido.