Android XR: Lineamientos de calidad y políticas de las apps para experiencias aumentadas

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Audio y
lentes con pantalla

Los lineamientos de calidad de las apps para lentes inteligentes amplían los estándares básicos de calidad de las apps para dispositivos móviles.

Estos lineamientos y políticas de calidad de las apps se enfocan en interacciones multimodales cruciales que son exclusivas de la plataforma de Android XR en lentes inteligentes, como se describe en las definiciones de niveles de compatibilidad, las listas de tareas y las políticas para experiencias solo de audio. Revisa estas secciones para verificar que tu app proporcione una excelente experiencia del usuario en lentes con pantalla y audio.

Experiencias mejoradas: Definiciones de los niveles de compatibilidad con apps para dispositivos móviles

Revisa las siguientes definiciones de niveles de compatibilidad para comprender el nivel de compatibilidad que proporciona tu app para las experiencias aumentadas en lentes.

Compatible

Una app para dispositivos móviles compatible proporciona una experiencia de realidad aumentada en los lentes sin esfuerzo adicional para el desarrollador. Esto representa una app para dispositivos móviles Android existente que incluye conectividad Bluetooth y que no se modificó para lentes. La plataforma de Android XR admite automáticamente este tipo de app, siempre y cuando no dependa de funciones de hardware no compatibles.

Para lograr esta capacidad, la plataforma extiende sin problemas las plataformas estándar del sistema Android a los lentes. Por ejemplo, las notificaciones se muestran automáticamente en la línea de visión del usuario o se leen en voz alta (en el caso de los lentes con audio), lo que garantiza que el usuario pueda completar tareas importantes y rápidas sin necesidad de sacar el teléfono.

Diferenciación

Una experiencia aumentada diferenciada está diseñada específicamente para lentes, aprovechando todas las capacidades del SDK de Jetpack XR y el hardware único del factor de forma.

Para crear estas experiencias aumentadas transformadoras, usa las siguientes bibliotecas:

  • Jetpack Compose Glimmer: Es un kit de herramientas de IU de Compose para crear interfaces minimalistas y legibles optimizadas para pantallas ópticas transparentes.
  • Jetpack Projected: Administra recursos y une sin problemas la funcionalidad entre el teléfono complementario (host) y los lentes (dispositivo proyectado).
  • ARCore para Jetpack XR: Accede a funciones de percepción avanzadas, como el seguimiento de dispositivos y la API de Geospatial, que permiten la localización y las funciones adaptadas al contexto, como la navegación para peatones.

Experiencias mejoradas: Lista de tareas para verificar la calidad de las apps para dispositivos móviles

Para asegurarte de que tu app brinde una excelente experiencia del usuario en experiencias aumentadas, revisa las siguientes listas de tareas y pruebas de compatibilidad.

Estas listas de tareas y pruebas definen un conjunto integral de requisitos de calidad para la mayoría de los tipos de apps para Android.

Compatible

Las apps compatibles son apps para dispositivos móviles Android existentes que funcionan automáticamente en los lentes aprovechando las plataformas estándar de Android (por ejemplo, las notificaciones estándar y de novedades en tiempo real). No se requiere código específico para lentes en este nivel de compatibilidad.

Tu app debe cumplir con los siguientes requisitos principales:

  • Notificaciones: Asegúrate de que todas las notificaciones que requieren acción y que son urgentes usen las APIs estándar de Android NotificationManager para que la plataforma pueda convertirlas correctamente en lecturas de audio (dispositivos de audio) o superposiciones visuales minimalistas (dispositivos de visualización).
  • Actualizaciones en tiempo real: Si la app tiene una actividad en curso (como tareas relacionadas con el progreso), debe usar el framework de notificaciones de actualizaciones en tiempo real estándar para que la plataforma pueda mostrar esta información de forma rápida y sin usar las manos.
  • Google Play: La app debe cumplir con todas las políticas aplicables de Android y Google Play. La compatibilidad se determina automáticamente según las declaraciones del manifiesto y los requisitos de las funciones.

Diferenciación

Las apps diferenciadas se compilan específicamente con el SDK de Jetpack XR (con bibliotecas como Jetpack Compose Glimmer, Jetpack Projected y ARCore para Jetpack XR) para ofrecer una experiencia del usuario adaptada al entorno y altamente optimizada, o bien usar capacidades aumentadas únicas. Consulta los requisitos adecuados para tu app.

Categoría Área Orientación

Funcionalidad principal

Iniciar la actividad de los lentes Las experiencias deben poder iniciarse y controlarse directamente desde la app para dispositivos móviles, en especial para la configuración inicial o la navegación por información densa antes de pasar a los lentes con pantalla y audio, que tienen un conjunto más pequeño de funciones de UX.
Comando para abrir la app Las experiencias deben configurarse con un estado de inicio cero en los lentes con Gemini para que, cuando un usuario dé un comando "Abrir [app]", la app omita los menús tradicionales y pase de inmediato a una experiencia de audio lista para actuar, como un modo en segundo plano solo de audio, un estado de escucha en vivo o una indicación de audio inmediata.
Iniciación de la cámara El acceso a la cámara se puede iniciar desde un punto de entrada o una actividad para dispositivos móviles, o bien desde una entrada directa con el gesto de acción de la cámara en el dispositivo. Si se inicia el acceso a la cámara desde la plataforma móvil, el usuario debería escuchar una cuenta regresiva antes de que comience la transmisión de la cámara.
Claridad y coherencia (gestos) Los gestos (como la voz, los toques o los deslizamientos) se deben implementar de forma clara y coherente, de acuerdo con las expectativas de los usuarios para las interacciones comunes. Las políticas de gestos principales se describen en las secciones correspondientes que se presentan a continuación.

Rendimiento y estabilidad

Batería Optimiza los procesos en segundo plano siguiendo las restricciones de tareas en segundo plano de Android y minimiza el uso de sensores de alto consumo (como el feed de la cámara) cuando no se usen de forma activa.
Velocidad de fotogramas y resolución de la cámara El acceso al feed de la cámara debe configurarse para usar la configuración más eficiente (la velocidad de fotogramas y la resolución más bajas) para un caso de uso determinado. Para obtener más información sobre los parámetros de configuración recomendados para cada caso de uso, consulta la guía para desarrolladores.
Seguridad Seguridad Las experiencias deben diseñarse en torno a acciones iniciadas por el usuario y minimizar estrictamente las distracciones del entorno inmediato, especialmente durante el movimiento o en espacios públicos.
Privacidad y seguridad Permisos La app debe solicitar permisos específicos de los lentes para acceder al hardware (como la cámara o el micrófono) con la API de solicitud de permisos proyectada y controlar el redireccionamiento al dispositivo host para obtener el consentimiento del usuario.

Política general

Accesibilidad Ten en cuenta a los usuarios con diversas necesidades y asegúrate de que haya métodos de entrada alternativos disponibles (por ejemplo, usar comandos por voz como alternativa a los gestos del panel táctil) cuando corresponda.
Pruebas Prueba exhaustivamente todas las implementaciones visuales y de gestos en varios escenarios de usuario, iluminación y condiciones ambientales concurrida, con el emulador de Android XR y las vistas previas de elementos que admiten composición.
Google Play Políticas Cumple con todas las políticas de Google Play, incluidas las políticas específicas para anteojos que se describen en las secciones siguientes y que ayudan a proteger la privacidad y el bienestar de los usuarios.

Experiencia de audio

Alertas por voz

Las alertas por voz deben ser concisas y proporcionar solo la información más relevante y práctica. Las alertas por voz para condiciones de error deberían funcionar independientemente de la conectividad a Internet.

Se debe esperar explícitamente que se realicen seguimientos y conversaciones más profundas con un agente integrado en la app o Gemini.

Enfoque de audio El foco de audio está estrechamente correlacionado con el foco de entrada. Las apps deben solicitar y abandonar el foco de audio según corresponda y de acuerdo con los lineamientos de Android.
Políticas de audio Los gestos y los comportamientos de los LED deben cumplir con todas las políticas para experiencias solo de audio.

Políticas para las experiencias de solo audio

Todas las apps deben cumplir con los requisitos de las siguientes políticas para promover experiencias de solo audio seguras y respetuosas en lentes inteligentes.

Seguridad de las apps

Te recordamos que todas las apps que se distribuyen a través de Google Play deben cumplir con todas las Políticas para Desarrolladores de Google Play.

Las siguientes actividades están estrictamente prohibidas, y las apps no deben facilitarlas ni promocionarlas:

  • Doxing
  • Reconocimiento facial o identificación biométrica
  • Vigilancia
  • Creación o divulgación de imágenes íntimas no consensuadas (NCII)

Todas las apps deben incluir las siguientes protecciones para terceros:

Seguridad de la cámara

Las apps que acceden a los sensores de la cámara de wearables deben respetar la privacidad de las personas que se encuentran cerca y cumplir con lo siguiente:

Restricción de videos y fotos

Interacciones permitidas

Descripción

Videollamadas

Las apps pueden usar los sensores de la cámara wearable para realizar videollamadas.

Comprensión de escenas y detección de ambientes

Las apps pueden usar sensores de cámaras wearable para la detección de cámaras ambientales o la comprensión de escenas.

Interacciones prohibidas

Descripción

Transmisión en vivo de videos en redes sociales y transmisión pública

Las apps no deben usar sensores de cámaras de wearables para la transmisión de video en vivo en redes sociales, lo que incluye cualquier transmisión en vivo en tiempo real de uno a muchos, transmisión pública o transmisión a feeds públicos y canales abiertos.

Identificación facial en tiempo real y doxing

Las apps no deben usar sensores de la cámara para ejecutar la identificación facial y mostrar información de identificación personal (PII) de terceros. Por ejemplo: nombres, direcciones particulares, números de teléfono o su empleador.

Generación de imágenes íntimas no consensuadas (NCII) o contenido ilegal

Las apps no deben usar sensores de la cámara para facilitar la creación de imágenes íntimas no consensuadas (NCII) ni la generación de contenido ilegal (por ejemplo, CSAM).

Seguridad de audio

Las apps que usen el conjunto de micrófonos deben respetar la privacidad de las personas presentes y cumplir con lo siguiente:

Interacciones prohibidas

Descripción

Intervención persistente

Las apps no deben mantener grabaciones de audio ni transcripciones persistentes en segundo plano cuando el usuario no interactúa de forma activa con la app en una tarea iniciada por el usuario.

Identificación de voz

Las apps no deben usar el conjunto de micrófonos para identificar las voces de personas que no usen el dispositivo o de transeúntes.

Supresión o modificación programática

Las apps no deben cambiar ni inhabilitar los supresores de ruido de audio que aplica el sistema. Las apps tampoco deben alentar ni dirigir a los usuarios a cambiar o inhabilitar los supresores de ruido de audio.

Gestos y entrada

Estas políticas describen los requisitos para implementar eventos de gestos en los lentes durante las experiencias de solo audio. Sigue estos lineamientos para brindar una experiencia del usuario coherente e intuitiva en diferentes apps y dispositivos Android XR. Se espera que todas las entradas funcionen si tu app tiene el foco de audio, independientemente de su estado en primer plano.

1. Gesto de presionar

El gesto de presionar es un toque rápido y único en el área de entrada del panel táctil. Presionar es la forma en que un usuario realiza una acción en los anteojos. Esto puede iniciar la reproducción de audio, por ejemplo, para proporcionar información según el estado del usuario o para repetir el último mensaje audible. Si se está reproduciendo audio, una presión podría pausar o detener la salida de audio.

Ejemplos
Interacciones permitidas Descripción

Reproduce un mensaje relevante

Proporciona al usuario información relevante, como la siguiente:

  • Solicitar permisos del usuario
  • Información basada en el estado actual del usuario. Por ejemplo, decir "A tu derecha, se encuentra el puente Golden Gate".
  • Repetir el último mensaje audible que se proporcionó al usuario

Si presionas la pantalla mientras se reproduce el audio, este se detendrá.

Silenciar o activar el sonido del micrófono

Permite que los usuarios activen o desactiven el sonido de su micrófono con un gesto de toque cuando estén en una experiencia que use la entrada de micrófono.

Se deben proporcionar comentarios de audio cuando se silencia o se activa el sonido del micrófono.

Interacciones prohibidas Descripción

Información o anuncios irrelevantes

No uses el gesto de presionar para publicar anuncios ni proporcionar información que no sea relevante para el estado físico o el contexto actual del usuario.

Entradas de juegos y acciones continuas rápidas

El gesto de presionar está diseñado para acciones rápidas de un solo toque. No se debe reutilizar como un control continuo para juegos interactivos ni tareas de entrada de alta frecuencia que interrumpan los controles estándar del sistema.

Habilitar delitos, violencia o autolesiones

El gesto de presionar nunca debe activar instrucciones prácticas que faciliten actos ilegales o dañinos, como la exploración extremista, la creación de armas o la autolesión.

2. Gesto de acción de la cámara

El gesto de acción de la cámara implica presionar el botón de la cámara dos veces en sucesión rápida. Las apps que acceden a la cámara deben tratar este evento como una acción de la cámara que proporciona datos de sensores directamente a la app.

Ejemplos
Interacciones permitidas Descripción

Activa la cámara para la app

Inicia la transmisión de la cámara en la app. Esto incluye activar la transmisión de la cámara para capturar fotos o videos, o permitir el procesamiento de la cámara ambiental con el feed de la cámara.

El uso de la transmisión de la cámara debe cumplir con todas las políticas de Android relacionadas con las capturas de cámara y micrófono, y con la política de Datos del Usuario del Centro de Políticas para Desarrolladores de Play. Además, la política de Bullying y Hostigamiento no permite apps que hagan doxing o exploten a otras personas de forma pública.

Interacciones prohibidas Descripción

Entradas personalizadas y reasignación

El gesto de presionar dos veces la cámara debe usarse exclusivamente para activar la transmisión de la cámara y proporcionar datos de sensores directamente a la app. No debes reasignar este gesto de hardware a funciones que no sean de la cámara, accesos directos personalizados o experiencias alternativas en la app.

Uso de sensores desacoplados o ficticios

Las apps que interceptan el gesto de presionar dos veces la cámara deben tratarlo como una solicitud genuina de datos de sensores visuales. No puedes registrar el evento de doble presión para apropiarte del botón de hardware mientras ignoras, descartas o suprimes intencionalmente el feed de la cámara.

Falta de divulgación o uso engañoso

Cuando se use el gesto de presionar dos veces la cámara para activarla, debes informar explícitamente al usuario sobre el uso exacto de la cámara de antemano en un flujo de la app para dispositivos móviles durante el otorgamiento de permisos inicial o la configuración de la app. Por ejemplo, algunos casos de uso válidos pueden ser la transmisión en vivo, la toma de fotos o el procesamiento con IA. La transmisión de la cámara nunca se debe usar para una función que el usuario no haya aceptado de forma explícita.

3. Gesto de deslizar un solo dedo hacia atrás

El gesto de deslizar un dedo hacia atrás implica un movimiento continuo hacia atrás en el área de entrada del panel táctil. El sistema admite este gesto incluso durante las experiencias de solo audio llamando a onBack(). Tu app debe controlar este evento saliendo de la experiencia actual o devolviendo al usuario a un estado anterior de la app.

Interacciones prohibidas Descripción

Secuestra el comando de salida

El gesto de deslizar el dedo hacia atrás siempre debe llamar a onBack() para salir de la experiencia o devolver al usuario a un estado anterior de la app. Nunca se debe asignar a acciones personalizadas, lanzamientos de contenido multimedia nuevo ni anuncios.

Salidas falsas (escucha encubierta)

Las apps deben salir o suspender realmente el uso de su sensor principal cuando se invoque este gesto. No simules una salida mientras mantienes en secreto los sensores activos en segundo plano para la vigilancia.

Comportamientos de los LED

Tu app no debe cambiar el comportamiento del sistema de LED en función del acceso al micrófono y la cámara.

Interacciones prohibidas Descripción

Supresión o modificación programática

Las apps no deben cambiar, atenuar ni inhabilitar el comportamiento de los LED orientados al mundo y para el usuario que impone el sistema en función del acceso al micrófono y a la cámara. Las apps tampoco deben alentar ni dirigir a los usuarios a cambiar, atenuar o inhabilitar el comportamiento de los LED.

Anulación de la detección de manipulación y evasión

Las apps no deben omitir ni interferir con los algoritmos de detección de obstrucción del dispositivo, que están diseñados para detener la grabación de forma programática si el LED que apunta al mundo está cubierto o dañado físicamente, ni tampoco deben alentar o dirigir a los usuarios a que lo hagan.