1. Introducción
En este documento, se enumeran los requisitos que se deben cumplir para que los dispositivos sean compatibles con Android 11.
El uso de "DEBE", "NO DEBE", "OBLIGATORIO", "DEBERÁ", "NO DEBERÁ", "DEBERÍA", "NO DEBERÍA", "RECOMENDADO", "PUEDE" y "OPCIONAL" según el estándar IETF definido en RFC2119.
Como se usa en este documento, un “implementador de dispositivos” o “implementador” es una persona u organización que desarrolla una solución de hardware o software con Android 11. Una “implementación de dispositivos” o “implementación” es la solución de hardware/software tan desarrollada.
Para que se consideren compatibles con Android 11, las implementaciones en dispositivos DEBEN cumplir con los requisitos que se presentan en esta definición de compatibilidad, incluidos los documentos que se incorporan como referencia.
Cuando esta definición o las pruebas de software descritas en la sección 10 son silenciosas, ambiguas o incompletas, es responsabilidad del implementador de dispositivos garantizar la compatibilidad con las implementaciones existentes.
Por este motivo, el Proyecto de código abierto de Android es la referencia y la implementación preferida de Android. Se recomienda que los implementadores de dispositivos basen sus implementaciones en la mayor medida posible en el código fuente “ascendente” disponible en el Proyecto de código abierto de Android. Si bien algunos componentes pueden reemplazarse hipotéticamente con implementaciones alternativas, es SEGURO RECOMENDADO no seguir esta práctica, ya que pasar las pruebas de software será mucho más difícil. Es responsabilidad del implementador garantizar la compatibilidad total del comportamiento con la implementación estándar de Android, incluida y más allá del Conjunto de pruebas de compatibilidad. Por último, ten en cuenta que en este documento se prohíben explícitamente algunas sustituciones y modificaciones de componentes.
Muchos de los recursos vinculados en este documento derivan directa o indirectamente del SDK de Android y serán funcionalmente idénticos a la información de la documentación de dicho SDK. En los casos en los que esta definición de compatibilidad o el Conjunto de pruebas de compatibilidad no estén de acuerdo con la documentación del SDK, la documentación del SDK se considera confiable. Cualquier detalle técnico que se proporcione en los recursos vinculados en este documento se considerará por inclusión como parte de esta definición de compatibilidad.
1.1 Estructura del documento
1.1.1. Requisitos por tipo de dispositivo
El Artículo 2 contiene todos los requisitos que se aplican a un tipo de dispositivo específico. Cada subsección de la Sección 2 está dedicada a un tipo de dispositivo específico.
Todos los demás requisitos, que se aplican universalmente a cualquier implementación de dispositivos Android, se enumeran en las secciones posteriores a la Sección 2. Estos requisitos se denominan "Requisitos principales". en este documento.
1.1.2. ID de requisito
El ID de requisito se asignó para los requisitos MUST.
- El ID se asigna solo para los requisitos MUST.
- Los requisitos ESPECIAMENTE RECOMENDADOS se marcan como [SR], pero no se asigna el ID.
- El ID se compone de lo siguiente : Device Type ID - Condition ID - Requirement ID (p.ej., C-0-1).
Cada ID se define de la siguiente manera:
- ID del tipo de dispositivo (obtén más información en 2. Device Types)
- C: Core (requisitos que se aplican a cualquier implementación de dispositivos Android)
- H: Dispositivo de mano Android
- T: dispositivo de televisión Android
- A: Implementación de Android Automotive
- W: Implementación de Android Watch
- Pestaña: Implementación en tablets Android
- ID de condición
- Cuando el requisito es incondicional, este ID se establece en 0.
- Cuando el requisito es condicional, se asigna 1 a la 1a condición, y el número se incrementa en 1 dentro de la misma sección y el mismo tipo de dispositivo.
- ID de requisito
- Este ID comienza desde 1 y aumenta de a 1 dentro de la misma sección y la misma condición.
1.1.3 ID de requisito en la sección 2
El ID de requisito en la Sección 2 comienza con el ID de la sección correspondiente, seguido del ID de requisito descrito anteriormente.
- El ID de la Sección 2 consta de lo siguiente : ID de sección / ID de tipo de dispositivo - ID de condición - ID de requisito (p.ej., 7.4.3/A-0-1).
2. Tipos de dispositivo
Si bien el Proyecto de código abierto de Android proporciona una pila de software que puede usarse para una variedad de tipos de dispositivos y factores de forma, hay algunos tipos de dispositivos que tienen un ecosistema de distribución de aplicaciones establecido relativamente mejor.
En esta sección, se describen esos tipos de dispositivos, así como los requisitos y las recomendaciones adicionales aplicables a cada uno.
Todas las implementaciones de dispositivos Android que no se ajustan a ninguno de los tipos de dispositivos descritos DEBEN cumplir con todos los requisitos de las demás secciones de esta definición de compatibilidad.
2.1 Configuraciones del dispositivo
Para conocer las principales diferencias en la configuración de hardware por tipo de dispositivo, consulta los requisitos específicos de cada dispositivo que se incluyen a continuación en esta sección.
2.2. Requisitos para dispositivos portátiles
Un dispositivo de mano Android hace referencia a una implementación en un dispositivo Android que, por lo general, se usa al sostenerlo en la mano, como un reproductor de mp3, un teléfono o una tablet.
Las implementaciones en dispositivos Android se clasifican como portátiles si cumplen con todos los siguientes criterios:
- Tener una fuente de alimentación que brinde movilidad, como una batería
- Tener un tamaño de pantalla diagonal físico de 3.3 pulgadas (o 2.5 pulgadas para dispositivos que se lanzaron con un nivel de API anterior a Android 11) a 8 pulgadas
Los requisitos adicionales que se incluyen en el resto de esta sección son específicos para las implementaciones de dispositivos de mano Android.
2.2.1. Hardware
Implementaciones en dispositivos de mano:
- [7.1.1.1/H-0-1] DEBE tener al menos una pantalla compatible con Android que cumpla con todos los requisitos descritos en este documento.
- [7.1.1.3/H-SR] SE RECOMIENDA ENERCMENTE para brindarles a los usuarios la posibilidad de cambiar el tamaño de visualización (densidad de pantalla).
Si las implementaciones de dispositivos de mano admiten la rotación de pantalla de software, sucederá lo siguiente:
- [7.1.1.1/H-1-1]* SE DEBE hacer que la pantalla lógica que está disponible para aplicaciones de terceros tenga al menos 2 pulgadas en los bordes cortos y 2.7 pulgadas en los bordes largos. Los dispositivos que se lanzaron en un nivel de API anterior al de este documento están exentos de este requisito.
Si las implementaciones de dispositivos de mano no admiten la rotación de pantalla de software, sucederá lo siguiente:
- [7.1.1.1/H-2-1]* SE DEBE hacer que la pantalla lógica que está disponible para aplicaciones de terceros tenga al menos 2.7 pulgadas en los bordes cortos. Los dispositivos que se lanzaron en un nivel de API anterior al de este documento están exentos de este requisito.
Si las implementaciones de dispositivos de mano declaran la compatibilidad con pantallas de alto rango dinámico a través de Configuration.isScreenHdr()
, sucede lo siguiente:
- [7.1.4.5/H-1-1] SE DEBE anunciar la compatibilidad con las extensiones
EGL_EXT_gl_colorspace_bt2020_pq
,EGL_EXT_surface_SMPTE2086_metadata
,EGL_EXT_surface_CTA861_3_metadata
,VK_EXT_swapchain_colorspace
yVK_EXT_hdr_metadata
.
Implementaciones en dispositivos de mano:
- [7.1.4.6/H-0-1] SE DEBE informar si el dispositivo admite la función de generación de perfiles de la GPU a través de una propiedad del sistema
graphics.gpu.profiler.support
.
Si las implementaciones de dispositivos de mano declaran la compatibilidad a través de una propiedad del sistema graphics.gpu.profiler.support
, sucede lo siguiente:
- [7.1.4.6/H-1-1] SE DEBE informar como resultado un seguimiento de protobuf que cumpla con el esquema para los contadores de GPU y las etapas de renderización de GPU definidas en la documentación de Perfetto.
- [7.1.4.6/H-1-2] DEBE informar los valores compatibles de los contadores de GPU del dispositivo según el proto proto del paquete de seguimiento del contador de GPU.
- [7.1.4.6/H-1-3] DEBE informar los valores compatibles con las RenderStages de la GPU del dispositivo según el proto proto del paquete de seguimiento de la etapa de renderización.
- [7.1.4.6/H-1-4] SE DEBE informar un punto de seguimiento de frecuencia de la GPU, como se especifica en el formato power/gpu_frequency.
Implementaciones en dispositivos de mano:
- [7.1.5/H-0-1] DEBE incluir compatibilidad con el modo de compatibilidad de aplicaciones heredadas, tal como se implementa en el código abierto ascendente de Android. Es decir, las implementaciones en dispositivos NO DEBEN alterar los activadores o umbrales en los que se activa el modo de compatibilidad, ni el comportamiento del modo de compatibilidad en sí.
- [7.2.1/H-0-1] DEBE incluir compatibilidad con aplicaciones de terceros del Editor de método de entrada (IME).
- [7.2.3/H-0-3] DEBE proporcionar la función de inicio en todas las pantallas compatibles con Android que muestran la pantalla principal.
- [7.2.3/H-0-4] DEBE proporcionar la función Atrás en todas las pantallas compatibles con Android y la función Recientes en al menos una de las pantallas compatibles con Android.
- [7.2.3/H-0-2] SE DEBE enviar el evento de mantener presionado y de mantener presionada la función Atrás (
KEYCODE_BACK
) a la aplicación en primer plano. Estos eventos NO DEBEN ser consumidos por el sistema y PUEDEN activarse por fuera del dispositivo Android (p.ej., un teclado de hardware externo conectado al dispositivo Android). - [7.2.4/H-0-1] DEBE ser compatible con la entrada de pantalla táctil.
- [7.2.4/H-SR] SE RECOMIENDA ENERCMENTE iniciar la aplicación de asistencia seleccionada por el usuario; en otras palabras, la aplicación que implementa VoiceInteractionService o una actividad que controla
ACTION_ASSIST
al mantener presionadoKEYCODE_MEDIA_PLAY_PAUSE
oKEYCODE_HEADSETHOOK
si la actividad en primer plano no controla esos eventos de presión prolongada. - [7.3.1/H-SR] SE RECOMIENDA ENcarecidamente incluir un acelerómetro de 3 ejes.
Si las implementaciones de dispositivos de mano incluyen un acelerómetro de 3 ejes, sucederá lo siguiente:
- [7.3.1/H-1-1] SE DEBE poder informar eventos con una frecuencia de al menos 100 Hz.
Si las implementaciones en dispositivos de mano incluyen un receptor de GPS/GNSS e informan la capacidad a las aplicaciones a través de la marca de función android.hardware.location.gps
, sucederá lo siguiente:
- [7.3.3/H-2-1] SE DEBE informar las mediciones de GNSS en cuanto se encuentran, incluso si todavía no se informó una ubicación calculada a partir del GPS o el GNSS.
- [7.3.3/H-2-2] DEBE informar pseudorrangos y pseudorrangos GNSS que, en condiciones a cielo abierto después de determinar la ubicación, mientras se encuentra en un lugar fijo o en movimiento a menos de 0.2 metros por segundo de aceleración, son suficientes para calcular la posición dentro de 20 metros y la velocidad dentro de 0.2 metros por segundo, al menos el 95% del tiempo.
Si las implementaciones de dispositivos de mano incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [7.3.4/H-3-1] SE DEBE poder informar eventos con una frecuencia de al menos 100 Hz.
- [7.3.4/H-3-2] DEBE ser capaz de medir los cambios de orientación de hasta 1,000 grados por segundo.
Implementaciones de dispositivos de mano que pueden realizar una llamada de voz e indicar cualquier valor distinto de PHONE_TYPE_NONE
en getPhoneType
:
- [7.3.8/H] SE DEBE incluir un sensor de proximidad.
Implementaciones en dispositivos de mano:
- [7.3.11/H-SR] RECOMENDADOS para admitir el sensor de postura con 6 grados de libertad.
- [7.4.3/H] SE DEBE incluir compatibilidad con Bluetooth y Bluetooth LE.
Si las implementaciones de dispositivos de mano incluyen una conexión de uso medido, sucederá lo siguiente:
- [7.4.7/H-1-1] DEBE proporcionar el modo de Ahorro de datos.
Si las implementaciones de dispositivos de mano incluyen un dispositivo de cámara lógico que enumera las capacidades mediante CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
, sucederá lo siguiente:
- [7.5.4/H-1-1] DEBE tener un campo visual (FOV) normal de forma predeterminada y debe estar entre 50 y 90 grados.
Implementaciones en dispositivos de mano:
- [7.6.1/H-0-1] DEBE tener al menos 4 GB de almacenamiento no volátil disponible para los datos privados de la aplicación (también conocida como partición “/data”).
- [7.6.1/H-0-2] DEBE mostrar “true” para
ActivityManager.isLowRamDevice()
cuando hay menos de 1 GB de memoria disponible para el kernel y el espacio de usuario.
Si las implementaciones de dispositivos de mano declaran solo la compatibilidad con una ABI de 32 bits:
-
[7.6.1/H-1-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 416 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta qHD (p.ej., FWVGA).
-
[7.6.1/H-2-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 592 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta HD+ (p.ej., HD, WSVGA).
-
[7.6.1/H-3-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 896 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta FHD (p.ej., WSXGA+).
-
[7.6.1/H-4-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,344 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta QHD (p.ej., QWXGA).
Si las implementaciones de dispositivos de mano declaran la compatibilidad con cualquier ABI de 64 bits (con o sin alguna ABI de 32 bits), haz lo siguiente:
-
[7.6.1/H-5-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 816 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta qHD (p.ej., FWVGA).
-
[7.6.1/H-6-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 944 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta HD+ (p.ej., HD, WSVGA).
-
[7.6.1/H-7-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,280 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta FHD (p.ej., WSXGA+).
-
[7.6.1/H-8-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,824 MB si la pantalla predeterminada usa resoluciones de búfer de fotogramas de hasta QHD (p.ej., QWXGA).
Ten en cuenta que la “memoria disponible para el kernel y el espacio del usuario” El ejemplo anterior hace referencia al espacio de memoria proporcionado además de cualquier memoria ya dedicada a componentes de hardware, como radio, video, etc., que no están bajo el control del kernel en las implementaciones de dispositivos.
Si las implementaciones para dispositivos de mano incluyen 1 GB de memoria disponible para el kernel y el espacio del usuario igual o inferior, deben hacer lo siguiente:
- [7.6.1/H-9-1] SE DEBE declarar la marca de función
android.hardware.ram.low
. - [7.6.1/H-9-2] DEBE tener al menos 1.1 GB de almacenamiento no volátil para los datos privados de la aplicación (también conocida como partición "/data").
Si las implementaciones de dispositivos de mano incluyen más de 1 GB de memoria disponible para el kernel y el espacio del usuario, deben hacer lo siguiente:
- [7.6.1/H-10-1] DEBE tener al menos 4 GB de almacenamiento no volátil disponible para los datos privados de la aplicación (también conocido como partición “/data”).
- SE DEBE declarar la marca de función
android.hardware.ram.normal
.
Implementaciones en dispositivos de mano:
- [7.6.2/H-0-1] NO DEBE proporcionar un almacenamiento compartido de la aplicación de menos de 1 GiB.
- [7.7.1/H] SE DEBE incluir un puerto USB que admita el modo periférico.
Si las implementaciones de dispositivos de mano incluyen un puerto USB compatible con el modo periférico, sucederá lo siguiente:
- [7.7.1/H-1-1] SE DEBE implementar la API de Android Open Accessory (AOA).
Si las implementaciones de dispositivos de mano incluyen un puerto USB compatible con el modo de host, sucederá lo siguiente:
- [7.7.2/H-1-1] SE DEBE implementar la clase de audio USB como se indica en la documentación del SDK de Android.
Implementaciones en dispositivos de mano:
- [7.8.1/H-0-1] DEBE incluir un micrófono.
- [7.8.2/H-0-1] DEBE tener una salida de audio y declarar
android.hardware.audio.output
.
Si las implementaciones en dispositivos de mano pueden cumplir con todos los requisitos de rendimiento para admitir el modo de RV e incluirla, deben hacer lo siguiente:
- [7.9.1/H-1-1] SE DEBE declarar la marca de función
android.hardware.vr.high_performance
. - [7.9.1/H-1-2] DEBE incluir una aplicación que implemente
android.service.vr.VrListenerService
que las aplicaciones de RV puedan habilitar a través deandroid.app.Activity#setVrModeEnabled
.
Si las implementaciones de dispositivos de mano incluyen uno o más puertos USB-C en modo de host e implementan (clase de audio USB), además de los requisitos de la sección 7.7.2, hacen lo siguiente:
- [7.8.2.2/H-1-1] DEBE proporcionar la siguiente asignación de software de códigos HID:
Función | Asignaciones | Contexto | Comportamiento |
---|---|---|---|
A |
Página de uso de HID: 0x0C Uso de HID: 0x0CD Clave del kernel: KEY_PLAYPAUSE Clave de Android: KEYCODE_MEDIA_PLAY_PAUSE
|
Reproducción de contenido multimedia |
Entrada: Presionar brevemente Salida: Reproducir o pausar |
Entrada: Mantén presionado Resultado: Inicia el comando por voz Envíos: android.speech.action.VOICE_SEARCH_HANDS_FREE Si el dispositivo está bloqueado o la pantalla está apagada. De lo contrario, envía android.speech.RecognizerIntent.ACTION_WEB_SEARCH
|
|||
Llamada entrante |
Entrada: Presionar brevemente Resultado: Aceptar llamada |
||
Entrada: Mantén presionado Resultado: Rechazar llamada |
|||
Llamada en curso |
Entrada: Presionar brevemente Resultado: Finalizar llamada |
||
Entrada: Mantén presionado Salida: Silenciar o activar el sonido del micrófono |
|||
B |
Página de uso de HID: 0x0C Uso de HID: 0x0E9 Clave del kernel: KEY_VOLUMEUP Clave de Android: VOLUME_UP
|
Reproducción de contenido multimedia, llamada en curso |
Entrada: Mantén presionado Salida: Aumenta el volumen del sistema o de los auriculares. |
C |
Página de uso de HID: 0x0C Uso de HID: 0x0EA Clave del kernel: KEY_VOLUMEDOWN Clave de Android: VOLUME_DOWN
|
Reproducción de contenido multimedia, llamada en curso |
Entrada: Mantén presionado Salida: Baja el volumen del sistema o de los auriculares. |
D |
Página de uso de HID: 0x0C Uso de HID: 0x0CF Clave del kernel: KEY_VOICECOMMAND Clave de Android: KEYCODE_VOICE_ASSIST
|
Todos. Se puede activar en cualquier instancia. |
Entrada: Mantén presionado Resultado: Inicia el comando por voz. |
- [7.8.2.2/H-1-2] DEBE activar ACTION_HEADSET_PLUG en un conector, pero solo después de que se hayan enumerado correctamente las interfaces y los extremos de audio USB para identificar el tipo de terminal conectado.
Cuando se detecta el tipo de terminal de audio USB 0x0302, se realizan las siguientes acciones:
- [7.8.2.2/H-2-1] SE DEBE transmitir el intent ACTION_HEADSET_PLUG con "microphone" extra establecido en 0.
Cuando se detecta el tipo de terminal de audio USB 0x0402, se realizan las siguientes acciones:
- [7.8.2.2/H-3-1] SE DEBE transmitir el intent ACTION_HEADSET_PLUG con "microphone" extra establecido en 1.
Cuando se llama a la API AudioManager.getDevices() mientras el periférico USB está conectado, sucede lo siguiente:
-
[7.8.2.2/H-4-1] SE DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_HEADSET y la función isSink() si el campo de tipo de terminal de audio USB es 0x0302.
-
[7.8.2.2/H-4-2] DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_HEADSET y la función isSink() si el campo de tipo de terminal de audio USB es 0x0402.
-
[7.8.2.2/H-4-3] DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_HEADSET y la función isSource() si el campo de tipo de terminal de audio USB es 0x0402.
-
[7.8.2.2/H-4-4] SE DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_DEVICE y la función isSink() si el campo de tipo de terminal de audio USB es 0x603.
-
[7.8.2.2/H-4-5] DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_DEVICE y la función isSource() si el campo de tipo de terminal de audio USB es 0x604.
-
[7.8.2.2/H-4-6] SE DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_DEVICE y la función isSink() si el campo de tipo de terminal de audio USB es 0x400.
-
[7.8.2.2/H-4-7] DEBE mostrar un dispositivo del tipo AudioDeviceInfo.TYPE_USB_DEVICE y la función isSource() si el campo de tipo de terminal de audio USB es 0x400.
-
[7.8.2.2/H-SR] SE RECOMIENDEN ENERGMENTE cuando se conecta un periférico de audio USB-C para realizar la enumeración de descriptores USB, identificar los tipos de terminal y el intent de transmisión ACTION_HEADSET_PLUG en menos de 1, 000 milisegundos.
Si las implementaciones en dispositivos de mano incluyen al menos un accionador táctil, sucederá lo siguiente:
- [7.10/H-SR]* SE RECOMIENDA ENcarecidamente NO usar un accionador táctil (vibrador) de masa rotativa excéntrica(ERM).
- [7.10/H]* SE DEBE ubicar el accionador cerca de la ubicación donde las manos suelen sostenerlo o tocarlo.
- [7.10/H-SR]* SE RECOMIENDA COMPLETAMENTE implementar todas las constantes públicas para tecnología táctil clara en android.view.HapticFeedbackConstants, es decir (CLOCK_TICK, CONTEXT_CLI, KEYBOARD_PRESS, KEYBOARD_RELEASE, KEYBOARD_LANZA, KEYBOARD_LANZA, LONG_PRELESS, KEYBOARD_CONFIRMREJREJÉKEY, LONG_PRELESS, TEXTE_KEYREKEYRE)).
- [7.10/H-SR]* SE RECOMIENDA EJECUTARMENTE implementar todas las constantes públicas para háptica clara en android.os.VibrationEffect, es decir, (Effect_TICK, MODE_CLI, MODE_HEAVY_CLIC y MODE_DOUBLE_Clic) y todas las constantes públicas para háptica enriquecida en android.os.VibrationEffect.PRITIVE.COMTIVE.
- [7.10/H-SR]* Se RECOMIENDA ENERCMENTE usar estas constantes táctiles vinculadas asignaciones.
- [7.10/H-SR]* SE RECOMIENDA ES IMPORTANTE que sigan la evaluación de calidad para las APIs de createOneShot() y createWaveform().
- [7.10/H-SR]* SE RECOMIENDA EXITOSAMENTE para verificar las capacidades de escalabilidad de amplitud ejecutando android.os.Vibrator.hasAmplitudeControl().
El accionador de resonante lineal (LRA) es un sistema de resorte de masa única con una frecuencia resonante dominante en la que la masa se traduce en la dirección del movimiento deseado.
Si las implementaciones de dispositivos de mano incluyen al menos un accionador de resonante lineal, sucede lo siguiente:
- [7.10/H]* SE DEBE mover el accionador táctil en el eje X de la orientación vertical.
Si las implementaciones de dispositivos de mano tienen un accionador táctil que es un accionador de resonante lineal del eje X (LRA), tienen las siguientes características:
- [7.10/H-SR]* SE RECOMIENDA ENERCMENTE que la frecuencia resonante del LRA del eje X sea inferior a 200 Hz.
Si las implementaciones de dispositivos de mano siguen la asignación de constantes táctiles, harán lo siguiente:
- [7.10/H-SR]* SE RECOMIENDA ENERCMENTE realizar una evaluación de calidad para las constantes táctiles.
2.2.2. Multimedia
Las implementaciones en dispositivos portátiles DEBEN admitir los siguientes formatos de codificación y decodificación de audio, y ponerlos a disposición de aplicaciones de terceros:
- [5.1/H-0-1] AMR-NB
- [5.1/H-0-2] AMR-WB
- [5.1/H-0-3] Perfil MPEG-4 AAC (AAC LC)
- [5.1/H-0-4] Perfil MPEG-4 HE AAC (AAC+)
- [5.1/H-0-5] AAC ELD (AAC mejorado de bajo retraso)
Las implementaciones en dispositivos portátiles DEBEN admitir los siguientes formatos de codificación de video y ponerlos a disposición de aplicaciones de terceros:
Las implementaciones en dispositivos portátiles DEBEN admitir los siguientes formatos de decodificación de video y ponerlos a disposición de aplicaciones de terceros:
2.2.3. Software
Implementaciones en dispositivos de mano:
- [3.2.3.1/H-0-1] DEBE tener una aplicación que controle los intents
ACTION_GET_CONTENT
,ACTION_OPEN_DOCUMENT
,ACTION_OPEN_DOCUMENT_TREE
yACTION_CREATE_DOCUMENT
, como se describe en los documentos del SDK, y que proporcione al usuario la posibilidad de acceder a los datos del proveedor de documentos con la API deDocumentsProvider
. - [3.2.3.1/H-0-2]* SE DEBE precargar una o más aplicaciones o componentes del servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí.
- [3.2.3.1/H-SR] SE RECOMIENDA MUY RECOMENDADAS que precargan una aplicación de correo electrónico que pueda controlar los intents ACTION_SENDTO, ACTION_SEND o ACTION_SEND_MULTIPLE, para enviar un correo electrónico.
- [3.4.1/H-0-1] DEBE proporcionar una implementación completa de la API de
android.webkit.Webview
. - [3.4.2/H-0-1] DEBE incluir una aplicación de navegador independiente para la navegación web de los usuarios en general.
- [3.8.1/H-SR] SE RECOMIENDA COMPLETAMENTE implementar un selector predeterminado que admita la fijación de combinaciones de teclas, widgets y widgetFeatures en la app.
- [3.8.1/H-SR] SE RECOMIENDA COMPLETAMENTE implementar un selector predeterminado que proporcione acceso rápido a las combinaciones de teclas adicionales que proporcionan las apps de terceros a través de la API de shortManager.
- [3.8.1/H-SR] SE RECOMIENDA ENERCMENTE incluir una app de selector predeterminada que muestre insignias para los íconos de las apps.
- [3.8.2/H-SR] SE RECOMIENDA ES IMPORTANTE para admitir widgets de apps de terceros.
- [3.8.3/H-0-1] DEBE permitir que las apps de terceros notifiquen a los usuarios sobre eventos notables a través de las clases de API
Notification
yNotificationManager
. - [3.8.3/H-0-2] DEBE admitir notificaciones enriquecidas.
- [3.8.3/H-0-3] DEBE admitir notificaciones de atención.
- [3.8.3/H-0-4] DEBE incluir un panel de notificaciones que le permita al usuario controlar directamente (p.ej., responder, posponer, descartar o bloquear) las notificaciones a través de la indicación visual del usuario, como botones de acción o el panel de control, como se implementa en el AOSP.
- [3.8.3/H-0-5] SE DEBE mostrar las opciones proporcionadas a través de
RemoteInput.Builder setChoices()
en el panel de notificaciones. - [3.8.3/H-SR] SE RECOMIENDA MUY BIEN mostrar la primera opción proporcionada a través de
RemoteInput.Builder setChoices()
en el panel de notificaciones sin interacción adicional del usuario. - [3.8.3/H-SR] SE RECOMIENDA MUY BIEN mostrar todas las opciones proporcionadas a través de
RemoteInput.Builder setChoices()
en el panel de notificaciones cuando el usuario expande todas las notificaciones en el panel. - [3.8.3.1/H-SR] SE RECOMIENDA MUY BIEN mostrar acciones para las que
Notification.Action.Builder.setContextual
esté configurado comotrue
, en línea con las respuestas que muestraNotification.Remoteinput.Builder.setChoices
. - [3.8.4/H-SR] SE RECOMIENDA ENERCMENTE implementar un asistente en el dispositivo para realizar la acción de asistencia.
Si las implementaciones de dispositivos de mano admiten la acción de asistencia, sucederá lo siguiente:
- [3.8.4/H-SR] SE RECOMIENDA ENcarecidamente mantener presionada la tecla
HOME
como la interacción designada para iniciar la app de asistencia, tal como se describe en la sección 7.2.3. DEBE iniciar la aplicación de asistencia seleccionada por el usuario; en otras palabras, la aplicación que implementaVoiceInteractionService
o una actividad que controle el intentACTION_ASSIST
.
Si las implementaciones de dispositivos de mano admiten conversation notifications
y las agrupan en una sección independiente de las alertas y las notificaciones silenciosas sin conversación, sucederá lo siguiente:
- [3.8.4/H-1-1]* SE DEBE mostrar las notificaciones de conversación antes de las notificaciones que no son de conversación, a excepción de las notificaciones de servicios en primer plano en curso y las notificaciones de importance:high.
Si las implementaciones de dispositivos de mano Android admiten una pantalla de bloqueo, sucederá lo siguiente:
- [3.8.10/H-1-1] SE DEBE mostrar las notificaciones de la pantalla de bloqueo, incluida la plantilla de notificaciones multimedia.
Si las implementaciones de dispositivos de mano admiten una pantalla de bloqueo segura, sucederá lo siguiente:
- [3.9/H-1-1] SE DEBE implementar la gama completa de políticas de administración de dispositivos que se definen en la documentación del SDK de Android.
- [3.9/H-1-2] DEBE declarar la compatibilidad de los perfiles administrados a través de la marca de función
android.software.managed_users
, excepto cuando el dispositivo esté configurado de modo que se informe como un dispositivo con poca memoria RAM o asigne almacenamiento interno (no extraíble) como almacenamiento compartido.
Si las implementaciones de dispositivos de mano incluyen compatibilidad con las APIs de ControlsProviderService
y Control
, y permiten que aplicaciones de terceros publiquen controles de dispositivos, sucederá lo siguiente:
- [3.8.16/H-1-1] SE DEBE declarar la marca de función
android.software.controls
y establecerla entrue
. - [3.8.16/H-1-2] DEBE proporcionar una indicación visual del usuario con la capacidad de agregar, editar, seleccionar y operar los controles de dispositivos favoritos del usuario desde los controles registrados por las aplicaciones de terceros a través de las APIs de
ControlsProviderService
yControl
. - [3.8.16/H-1-3] SE DEBE proporcionar acceso a esta indicación visual del usuario en un plazo de tres interacciones desde un Selector predeterminado.
- [3.8.16/H-1-4] DEBE renderizar con precisión el nombre y el ícono de cada app de terceros que proporcione controles mediante la API de
ControlsProviderService
, así como cualquier campo especificado que proporcionen las APIs deControl
, en esta indicación visual.
Por el contrario, si las implementaciones de dispositivos de mano no implementan esos controles, sucederá lo siguiente:
- [3.8.16/H-2-1] SE DEBE informar
null
para las APIs deControlsProviderService
yControl
. - [3.8.16/H-2-2] SE DEBE declarar la marca de función
android.software.controls
y establecerla enfalse
.
Implementaciones en dispositivos de mano:
- [3.10/H-0-1] DEBE admitir servicios de accesibilidad de terceros.
- [3.10/H-SR] SE RECOMIENDA ENERCMENTE precargar servicios de accesibilidad en el dispositivo que sean comparables con la funcionalidad de Accesibilidad con interruptores y TalkBack (para idiomas compatibles con el motor de texto a voz preinstalado) como se proporciona en el proyecto de código abierto de TalkBack.
- [3.11/H-0-1] DEBE admitir la instalación de motores de TTS de terceros.
- [3.11/H-SR] SE RECOMIENDA COMPLETAMENTE incluir un motor de TTS compatible con los idiomas disponibles en el dispositivo.
- [3.13/H-SR] SE RECOMIENDA INCREÍBLEMENTE que incluyan un componente de IU de Configuración rápida.
Si las implementaciones de dispositivos de mano Android declaran compatibilidad con FEATURE_BLUETOOTH
o FEATURE_WIFI
, harán lo siguiente:
- [3.16/H-1-1] DEBE admitir la función de vinculación de dispositivos complementarios.
Si la función de navegación se proporciona como una acción en pantalla basada en gestos:
- [7.2.3/H] La zona de reconocimiento de gestos para la función de inicio DEBE tener una altura no superior a 32 dp desde la parte inferior de la pantalla.
Si las implementaciones de dispositivos de mano proporcionan una función de navegación como un gesto desde cualquier parte de los bordes izquierdo y derecho de la pantalla:
- [7.2.3/H-0-1] El área de gestos de la función de navegación DEBE tener menos de 40 dp de ancho en cada lado. El área de gestos DEBE ser de 24 dp de ancho de forma predeterminada.
2.2.4. Rendimiento y potencia
- [8.1/H-0-1] Latencia de fotogramas coherente. La latencia de fotogramas no es uniforme o un retraso en la renderización de fotogramas NO DEBE tener una frecuencia superior a 5 fotogramas por segundo, y SE DEBE ser inferior a 1 fotograma en un segundo.
- [8.1/H-0-2] Latencia de la interfaz de usuario. Las implementaciones del dispositivo DEBEN garantizar una experiencia del usuario de baja latencia desplazando una lista de 10,000 entradas de lista según lo define el Conjunto de pruebas de compatibilidad (CTS) de Android en menos de 36 segundos.
- [8.1/H-0-3] Cambio de tareas. Cuando se han iniciado varias aplicaciones, volver a iniciar una aplicación que ya está en ejecución DEBE tardar menos de 1 segundo.
Implementaciones en dispositivos de mano:
- [8.2/H-0-1] DEBE garantizar un rendimiento de escritura secuencial de al menos 5 MB/s.
- [8.2/H-0-2] DEBE garantizar un rendimiento de escritura aleatorio de al menos 0.5 MB/s.
- [8.2/H-0-3] DEBE garantizar un rendimiento de lectura secuencial de al menos 15 MB/s.
- [8.2/H-0-4] DEBE garantizar un rendimiento de lectura aleatoria de al menos 3.5 MB/s.
Si las implementaciones de dispositivos de mano incluyen funciones para mejorar la administración de energía del dispositivo que se incluyen en el AOSP o extender las funciones incluidas en el AOSP, sucederá lo siguiente:
- [8.3/H-1-1] DEBE proporcionar la indicación visual del usuario para habilitar o inhabilitar la función de ahorro de batería.
- [8.3/H-1-2] DEBE proporcionar la indicación visual del usuario para mostrar todas las apps exentas de los modos de ahorro de energía App Standby y Descanso.
Implementaciones en dispositivos de mano:
- [8.4/H-0-1] DEBE proporcionar un perfil de energía por componente que defina el valor de consumo actual de cada componente de hardware y el consumo aproximado de batería causado por los componentes a lo largo del tiempo, como se documenta en el sitio del Proyecto de código abierto de Android.
- [8.4/H-0-2] SE DEBE informar todos los valores de consumo de energía en miliamperios-hora (mAh).
- [8.4/H-0-3] DEBE informar el consumo de energía de la CPU según el UID de cada proceso. El Proyecto de código abierto de Android cumple con los requisitos a través de la implementación del módulo de kernel
uid_cputime
. - [8.4/H-0-4] SE DEBE permitir que el desarrollador de la app acceda a este uso de energía a través del comando de shell
adb shell dumpsys batterystats
. - [8.4/H] SE DEBE atribuir al componente de hardware si no se puede atribuir el uso de energía de un componente de hardware a una aplicación.
Si las implementaciones para dispositivos de mano incluyen una salida de pantalla o de video, sucederá lo siguiente:
- [8.4/H-1-1] DEBE respetar el intent
android.intent.action.POWER_USAGE_SUMMARY
y mostrar un menú de configuración que indique este uso de energía.
2.2.5. Modelo de seguridad
Implementaciones en dispositivos de mano:
- [9.1/H-0-1] DEBE permitir que las apps de terceros accedan a las estadísticas de uso a través del permiso
android.permission.PACKAGE_USAGE_STATS
y proporcionar un mecanismo accesible para el usuario que otorgue o revoque el acceso a esas apps en respuesta al intentandroid.settings.ACTION_USAGE_ACCESS_SETTINGS
.
Implementaciones en dispositivos de mano (* No aplicable para tablets):
- [9.11/H-0-2]* SE DEBE crear una copia de seguridad de la implementación del almacén de claves con un entorno de ejecución aislado.
- [9.11/H-0-3]* DEBE tener implementaciones de algoritmos criptográficos RSA, AES, ECDSA y HMAC y funciones hash de la familia MD5, SHA1 y SHA-2 para admitir correctamente los algoritmos compatibles del sistema Android Keystore en un área aislada de forma segura del código que se ejecuta en el kernel y versiones posteriores. El aislamiento seguro DEBE bloquear todos los posibles mecanismos mediante los cuales el kernel o el código del espacio del usuario podrían acceder al estado interno del entorno aislado, incluida la DMA. El Proyecto de código abierto de Android (AOSP) ascendente cumple este requisito mediante la implementación de Trusty, pero otra solución basada en ARM TrustZone o una implementación segura revisada por terceros de un aislamiento adecuado basado en un hipervisor son opciones alternativas.
- [9.11/H-0-4]* SE DEBE realizar la autenticación de la pantalla de bloqueo en el entorno de ejecución aislado y, solo cuando se realiza correctamente, se debe permitir el uso de claves vinculadas a la autenticación. Las credenciales de la pantalla de bloqueo DEBEN almacenarse de una manera que permita que solo el entorno de ejecución aislado realice la autenticación de la pantalla de bloqueo. El Proyecto de código abierto de Android ascendente ofrece la capa de abstracción de hardware (HAL) de Gatekeeper y Trusty, que se pueden usar para cumplir con este requisito.
- [9.11/H-0-5]* SE DEBE admitir la certificación de claves cuando la clave de firma de certificación está protegida por hardware seguro y la firma se realiza en hardware seguro. Las claves de firma de certificación DEBEN compartirse entre una gran cantidad de dispositivos para evitar que se usen como identificadores de dispositivos. Una forma de cumplir con este requisito es compartir la misma clave de certificación, a menos que se produzcan al menos 100,000 unidades de un SKU determinado. Si se producen más de 100,000 unidades de un SKU, PUEDE usar una clave diferente por cada 100,000 unidades.
Ten en cuenta que, si la implementación de un dispositivo ya se inició en una versión anterior de Android, ese dispositivo estará exento del requisito de tener un almacén de claves respaldado por un entorno de ejecución aislado y admitir la certificación de claves, a menos que declare la función android.hardware.fingerprint
que requiera un almacén de claves respaldado por un entorno de ejecución aislado.
Cuando las implementaciones de dispositivos de mano admiten una pantalla de bloqueo segura, hacen lo siguiente:
- [9.11/H-1-1] DEBE permitir que el usuario elija el tiempo de espera de suspensión más corto, es decir, un tiempo de transición del estado desbloqueado al bloqueado, de 15 segundos o menos.
- [9.11/H-1-2] DEBE proporcionar la indicación visual del usuario para ocultar las notificaciones y también inhabilitar todas las formas de autenticación, excepto la autenticación principal descrita en 9.11.1 Pantalla de bloqueo segura. AOSP cumple con el requisito como modo de bloqueo.
Si las implementaciones de dispositivos de mano incluyen varios usuarios y no declaran la marca de función android.hardware.telephony
, deben hacer lo siguiente:
- [9.5/H-2-1] DEBE admitir perfiles restringidos, una función que permite a los propietarios de dispositivos administrar usuarios adicionales y sus capacidades en el dispositivo. Con los perfiles restringidos, los propietarios de dispositivos pueden configurar rápidamente entornos separados para que los usuarios adicionales trabajen en ellos, con la capacidad de administrar restricciones más detalladas en las apps que están disponibles en esos entornos.
Si las implementaciones de dispositivos de mano incluyen varios usuarios y declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/H-3-1] NO DEBE admitir perfiles restringidos, pero DEBE alinearse con la implementación de controles de AOSP para permitir o inhabilitar el acceso de otros usuarios a las llamadas de voz y los SMS.
2.2.6. Compatibilidad de las Herramientas y opciones para desarrolladores
Implementaciones en dispositivos de mano (* No aplicable para tablets):
- [6.1/H-0-1]* DEBE admitir el comando de shell
cmd testharness
.
Implementaciones en dispositivos de mano (* No aplicable para tablets):
-
Perfetto
- .
- [6.1/H-0-2]* SE DEBE exponer un objeto binario
/system/bin/perfetto
al usuario de shell, ya que cmdline cumple con la documentación de perfetto. - [6.1/H-0-3]* El objeto binario de perfetto DEBE aceptar como entrada una configuración de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/H-0-4]* El objeto binario de perfetto DEBE escribir como salida un seguimiento de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/H-0-5]* SE DEBE proporcionar, al menos, a través del objeto binario perfetto, al menos las fuentes de datos descritas en la documentación de perfetto.
- [6.1/H-0-6]* El daemon rastreado por perfetto DEBE estar habilitado de forma predeterminada (propiedad del sistema
persist.traced.enable
).
- [6.1/H-0-2]* SE DEBE exponer un objeto binario
2.2.7 Clase de rendimiento del contenido multimedia portátil
Consulta la sección 7.11 para conocer la definición de clase de rendimiento del medio.
2.2.7.1. Contenido multimedia
Si las implementaciones de dispositivos de mano devuelven android.os.Build.VERSION_CODES.R
durante
android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
, luego:
- [5.1/H-1-1] SE DEBE anunciar la cantidad máxima de decodificadores de video de hardware.
sesiones que se pueden ejecutar simultáneamente en cualquier combinación de códecs a través del
CodecCapabilities.getMaxSupportedInstances()
yVideoCapabilities.getSupportedPerformancePoints()
. . - [5.1/H-1-2] DEBE admitir 6 instancias de sesiones de decodificador de video de hardware. (AVC o HEVC) en cualquier combinación de códecs que se ejecuten simultáneamente a 720p de resolución a 30 fps.
- [5.1/H-1-3] SE DEBE anunciar la cantidad máxima de codificadores de video de hardware.
sesiones que se pueden ejecutar simultáneamente en cualquier combinación de códecs a través del
CodecCapabilities.getMaxSupportedInstances()
yVideoCapabilities.getSupportedPerformancePoints()
. - [5.1/H-1-4] DEBE admitir 6 instancias de sesiones de codificador de video de hardware. (AVC o HEVC) en cualquier combinación de códecs que se ejecuten simultáneamente a 720p de resolución a 30 fps.
- [5.1/H-1-5] SE DEBE anunciar la cantidad máxima de codificadores de video de hardware.
sesiones de codificador y decodificador que se pueden ejecutar simultáneamente en cualquier combinación de códecs
por el
CodecCapabilities.getMaxSupportedInstances()
yVideoCapabilities.getSupportedPerformancePoints()
. - [5.1/H-1-6] DEBE admitir 6 instancias de hardware, decodificador de video y hardware. sesiones de codificador de video (AVC o HEVC) en cualquier combinación de códecs que se ejecute al mismo tiempo con una resolución de 720p a 30 fps.
- [5.1/H-1-7] DEBE tener una latencia de inicialización de códec de 65 ms o menos para un Sesión de codificación de video de 1080p o más pequeña para todos los codificadores de video de hardware (excepto el códec de Dolby Vision) cuando se esté cargando. La carga aquí se define como un sesión simultánea de transcodificación solo de video de 1080p a 720p con video de hardware junto con la inicialización de grabación de audio y video en 1080p.
- [5.1/H-1-8] DEBE tener una latencia de inicialización de códec de 50 ms o menos para un Sesión de codificación de audio de 128 Kbps o menor para todos los codificadores de audio cuando en carga.La carga se define como una resolución simultánea de 1080p a 720p de transcodificación con códecs de video de hardware y la resolución de 1080p inicialización de la grabación de audio y video.
- [5.3/H-1-1] NO DEBES perder más de 1 fotograma en 10 segundos (es decir, menos del 0.333% de caída de fotogramas) para una sesión de video en 1080p a 30 fps bajo carga. La carga se define como un video simultáneo de 1080p a 720p solo sesión de transcodificación con códecs de video de hardware, así como un Reproducción de audio en AAC de 128 Kbps
- [5.3/H-1-2] NO DEBE reducir más de 1 fotograma en 10 segundos durante un video. Cambio de resolución en una sesión de video de 30 FPS bajo carga. La carga se define como un sesión simultánea de transcodificación solo de video de 1080p a 720p con video de hardware y una reproducción de audio AAC de 128 Kbps.
- [5.6/H-1-1] DEBE tener una latencia de toque a tono de menos de 100 milisegundos. con la prueba de toque a tono de OboeTester o la prueba de toque a tono del verificador de CTS.
2.2.7.2. Cámara
Si las implementaciones de dispositivos de mano devuelven android.os.Build.VERSION_CODES.R
durante
android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
, luego:
- [7.5/H-1-1] DEBE tener una cámara posterior principal con una resolución de un mínimo de 12 megapíxeles que admita la captura de video a 4K a 30 fps. El principal La cámara posterior es la que tiene el ID de cámara más bajo.
- [7.5/H-1-2] DEBE tener una cámara frontal principal con una resolución de un mínimo de 4 megapíxeles que admitan captura de video a 1080p a 30 fps. El principal La cámara frontal es la cámara frontal con el ID de cámara más bajo.
- [7.5/H-1-3] DEBE ser compatible con la propiedad android.info.supportedHardwareLevel como COMPLETO o mejor para la principal inversa y LIMITADA o mejor para la primaria principal cámara.
- [7.5/H-1-4] DEBE admitir CameraMetadata.SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME para ambas cámaras principales.
- [7.5/H-1-5] DEBE tener una latencia de captura JPEG de Camera2 < 1,000 ms para Resolución de 1080p según la medición de la PerformanceTest de la cámara CTS en Condiciones de iluminación del ITS (3,000 K) para ambas cámaras principales
- [7.5/H-1-6] DEBE tener latencia de inicio de camera2 (abre la cámara para obtener la primera vista previa) fotograma) < 600 ms medido por la PerformanceTest de la cámara del CTS según el ITS condiciones de iluminación (3,000 K) para ambas cámaras principales.
2.2.7.3 Hardware
Si las implementaciones de dispositivos de mano muestran android.os.Build.VERSION_CODES.R
.
para android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
, luego:
- [7.1.1.1/H-1-1] DEBE tener una resolución de pantalla de al menos 1080p.
- [7.1.1.3/H-1-1] DEBE tener una densidad de pantalla de al menos 400 dpi.
- [7.6.1/H-1-1] DEBE tener al menos 6 GB de memoria física.
2.2.7.4. Rendimiento
Si las implementaciones de dispositivos de mano muestran android.os.Build.VERSION_CODES.R
.
para android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
, luego:
- [8.2/H-1-1] SE DEBE garantizar un rendimiento de escritura secuencial de al menos 100 MB/s.
- [8.2/H-1-2] SE DEBE garantizar un rendimiento de escritura aleatorio de al menos 10 MB/s.
- [8.2/H-1-3] DEBE garantizar un rendimiento de lectura secuencial de al menos 200 MB/s.
- [8.2/H-1-4] DEBE garantizar un rendimiento de lectura aleatoria de al menos 25 MB/s.
2.3. Requisitos de televisión
Un dispositivo de televisión Android hace referencia a una implementación de dispositivo Android que es una interfaz de entretenimiento que permite consumir contenido multimedia digital, películas, juegos, apps y TV en vivo para usuarios que están sentados a unos tres metros de distancia (una “interfaz de usuario inclinada” o “interfaz de usuario de 10 pies”).
Las implementaciones en dispositivos Android se clasifican como televisión si cumplen con todos los siguientes criterios:
- Proporcionaron un mecanismo para controlar de forma remota la interfaz de usuario renderizada en la pantalla, que podría ubicarse a 3 metros del usuario.
- Tener una pantalla integrada con una longitud diagonal superior a 24 pulgadas O incluir un puerto de salida de video, como VGA, HDMI, DisplayPort o un puerto inalámbrico para la pantalla
Los requisitos adicionales que se incluyen en el resto de esta sección son específicos para las implementaciones en dispositivos de Android Television.
2.3.1. Hardware
Implementaciones de dispositivos de televisión:
- [7.2.2/T-0-1] DEBE ser compatible con el pad direccional.
- [7.2.3/T-0-1] DEBE proporcionar las funciones Home y Back.
- [7.2.3/T-0-2] SE DEBE enviar el evento de mantener presionado y de mantener presionado de la función Atrás (
KEYCODE_BACK
) a la aplicación en primer plano. - [7.2.6.1/T-0-1] DEBE incluir compatibilidad con controles de juegos y declarar la marca de función
android.hardware.gamepad
. - [7.2.7/T] SE DEBE proporcionar un control remoto desde el cual los usuarios puedan acceder a la navegación no táctil y a las entradas de las teclas de navegación principales.
Si las implementaciones de dispositivos de televisión incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [7.3.4/T-1-1] SE DEBE poder informar eventos con una frecuencia de al menos 100 Hz.
- [7.3.4/T-1-2] DEBE ser capaz de medir los cambios de orientación de hasta 1,000 grados por segundo.
Implementaciones de dispositivos de televisión:
- [7.4.3/T-0-1] DEBE ser compatible con Bluetooth y Bluetooth LE.
- [7.6.1/T-0-1] DEBE tener al menos 4 GB de almacenamiento no volátil disponible para los datos privados de la aplicación (también conocido como partición “/data”).
Si las implementaciones de dispositivos de televisión incluyen un puerto USB compatible con el modo host, sucederá lo siguiente:
- [7.5.3/T-1-1] DEBE incluir compatibilidad con una cámara externa que se conecte a través de este puerto USB, pero no necesariamente está conectada siempre.
Si las implementaciones de dispositivos de TV son de 32 bits:
-
[7.6.1/T-1-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 896 MB si se usa alguna de las siguientes densidades:
- 400 dpi o más en pantallas pequeñas o normales
- xhdpi o superior en pantallas grandes
- tvdpi o superior en pantallas extragrandes
Si las implementaciones de dispositivos de TV son de 64 bits:
-
[7.6.1/T-2-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,280 MB si se usa alguna de las siguientes densidades:
- 400 dpi o más en pantallas pequeñas o normales
- xhdpi o superior en pantallas grandes
- tvdpi o superior en pantallas extragrandes
Ten en cuenta que la “memoria disponible para el kernel y el espacio del usuario” El ejemplo anterior hace referencia al espacio de memoria proporcionado además de cualquier memoria ya dedicada a componentes de hardware, como radio, video, etc., que no están bajo el control del kernel en las implementaciones de dispositivos.
Implementaciones de dispositivos de televisión:
- [7.8.1/T] SE DEBE incluir un micrófono.
- [7.8.2/T-0-1] DEBE tener una salida de audio y declarar
android.hardware.audio.output
.
2.3.2. Multimedia
Las implementaciones de dispositivos de televisión DEBEN admitir los siguientes formatos de codificación y decodificación de audio, y ponerlos a disposición de aplicaciones de terceros:
- [5.1/T-0-1] Perfil MPEG-4 AAC (AAC LC)
- [5.1/T-0-2] Perfil MPEG-4 HE AAC (AAC+)
- [5.1/T-0-3] AAC ELD (AAC mejorado de bajo retraso)
Las implementaciones de dispositivos de televisión DEBEN admitir los siguientes formatos de codificación de video y ponerlos a disposición de aplicaciones de terceros:
Implementaciones de dispositivos de televisión:
- [5.2.2/T-SR] SE RECOMIENDA ENERCMENTE que admitan la codificación H.264 de videos con resoluciones de 720p y 1080p a 30 fotogramas por segundo.
Las implementaciones de dispositivos de televisión DEBEN admitir los siguientes formatos de decodificación de video y ponerlos a disposición de aplicaciones de terceros:
- [5.3.3/T-0-1] MPEG-4 SP
- [5.3.4/T-0-2] AVC H.264
- [5.3.5/T-0-3] H.265 HEVC
- [5.3.6/T-0-4] VP8
- [5.3.7/T-0-5] VP9
- [5.3.1/T-0-6] MPEG-2
Las implementaciones de dispositivos de televisión DEBEN admitir la decodificación de MPEG-2, como se detalla en la sección 5.3.1, a resoluciones y velocidades de fotogramas de video estándar que incluyan lo siguiente:
- [5.3.1/T-1-1] HD 1080p a 29.97 fotogramas por segundo con perfil principal de alto nivel.
- [5.3.1/T-1-2] HD 1080i a 59.94 fotogramas por segundo con perfil principal de alto nivel. DEBE desentrelazar el video MPEG-2 y ponerlo a disposición de aplicaciones de terceros.
Las implementaciones de dispositivos de televisión DEBEN admitir la decodificación H.264, como se detalla en la Sección 5.3.4, con resoluciones y velocidades de fotogramas de video estándar que incluyan lo siguiente:
- [5.3.4/T-1-1] HD 1080p a 60 fotogramas por segundo con el perfil de Baseline
- [5.3.4/T-1-2] HD 1080p a 60 fotogramas por segundo con perfil principal
- [5.3.4/T-1-3] HD 1080p a 60 fotogramas por segundo con alto nivel de perfil 4.2
Las implementaciones de dispositivos de televisión con decodificadores de hardware H.265 DEBEN admitir la decodificación H.265, como se detalla en la Sección 5.3.5, con velocidades y resoluciones de fotogramas de video estándar que incluyan lo siguiente:
- [5.3.5/T-1-1] HD 1080p a 60 fotogramas por segundo con perfil principal nivel 4.1
Si las implementaciones de dispositivos de televisión con decodificadores de hardware H.265 admiten la decodificación H.265 y el perfil de decodificación UHD, sucederá lo siguiente:
- [5.3.5/T-2-1] DEBE admitir el perfil de decodificación en UHD a 60 fotogramas por segundo con el perfil de nivel principal de Main10 nivel 5.
Las implementaciones de dispositivos de televisión DEBEN admitir la decodificación de VP8, como se detalla en la sección 5.3.6, con resoluciones y velocidades de fotogramas de video estándar que incluyan lo siguiente:
- [5.3.6/T-1-1] HD 1080p a 60 fotogramas por segundo de decodificación
Las implementaciones de dispositivos de televisión con decodificadores de hardware VP9 DEBEN admitir la decodificación de VP9, como se detalla en la sección 5.3.7, con velocidades y resoluciones de fotogramas de video estándar hasta e incluyen:
- [5.3.7/T-1-1] HD 1080p a 60 fotogramas por segundo con perfil 0 (profundidad de color de 8 bits)
Si las implementaciones de dispositivos de televisión con decodificadores de hardware VP9 admiten la decodificación de VP9 y el perfil de decodificación en UHD, sucederá lo siguiente:
- [5.3.7/T-2-1] DEBE admitir el perfil de decodificación en UHD a 60 fotogramas por segundo con el perfil 0 (profundidad de color de 8 bits).
- [5.3.7/T-2-1] SE RECOMIENDA COMPLETAMENTE admitir el perfil de decodificación UHD a 60 fotogramas por segundo con el perfil 2 (profundidad de color de 10 bits).
Implementaciones de dispositivos de televisión:
- [5.5/T-0-1] DEBE incluir compatibilidad con el volumen principal del sistema y la atenuación del volumen de salida de audio digital en salidas compatibles, excepto la salida de transferencia de audio comprimido (en la que no se realiza una decodificación de audio en el dispositivo).
Si las implementaciones de dispositivos de televisión no tienen una pantalla integrada, pero admiten una pantalla externa conectada a través de HDMI, sucederá lo siguiente:
- [5.8/T-0-1] SE DEBE configurar el modo de salida HDMI para seleccionar la resolución máxima compatible con una frecuencia de actualización de 50 Hz o 60 Hz.
- [5.8/T-SR] SE RECOMIENDA ENERGENTE para proporcionar un selector de frecuencia de actualización HDMI configurable por el usuario.
- [5.8] SE DEBE configurar la frecuencia de actualización del modo de salida HDMI en 50 Hz o 60 Hz, según la frecuencia de actualización de video de la región en la que se vende el dispositivo.
Si las implementaciones de dispositivos de televisión no tienen una pantalla integrada, pero admiten una pantalla externa conectada a través de HDMI, sucederá lo siguiente:
- [5.8/T-1-1] DEBE ser compatible con HDCP 2.2.
Si las implementaciones de dispositivos de televisión no admiten la decodificación UHD, pero sí admiten una pantalla externa conectada a través de HDMI, sucederá lo siguiente:
- [5.8/T-2-1] DEBE ser compatible con HDCP 1.4.
2.3.3. Software
Implementaciones de dispositivos de televisión:
- [3/T-0-1] DEBE declarar las funciones
android.software.leanback
yandroid.hardware.type.television
. - [3.2.3.1/T-0-1] DEBE precargar una o más aplicaciones o componentes del servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí.
- [3.4.1/T-0-1] DEBE proporcionar una implementación completa de la API de
android.webkit.Webview
.
Si las implementaciones de dispositivos de Android Television admiten una pantalla de bloqueo,sucederá lo siguiente:
- [3.8.10/T-1-1] SE DEBE mostrar las notificaciones de la pantalla de bloqueo, incluida la plantilla de notificaciones multimedia.
Implementaciones de dispositivos de televisión:
- [3.8.14/T-SR] SE RECOMIENDA COMPLEMENTE que admitan el modo de pantalla en pantalla (PIP) multiventana.
- [3.10/T-0-1] DEBE admitir servicios de accesibilidad de terceros.
- [3.10/T-SR] SE RECOMIENDA ENERCMENTE precargar servicios de accesibilidad en el dispositivo que sean comparables con la funcionalidad de Accesibilidad con interruptores y TalkBack (para idiomas compatibles con el motor de texto a voz preinstalado) como se proporciona en el proyecto de código abierto de TalkBack.
Si las implementaciones de dispositivos de televisión informan la función android.hardware.audio.output
, sucederá lo siguiente:
- [3.11/T-SR] SE RECOMIENDA COMPLETAMENTE incluir un motor de TTS compatible con los idiomas disponibles en el dispositivo.
- [3.11/T-1-1] DEBE admitir la instalación de motores de TTS de terceros.
Implementaciones de dispositivos de televisión:
- [3.12/T-0-1] DEBE ser compatible con el marco de trabajo de entrada de TV.
2.3.4. Rendimiento y potencia
- [8.1/T-0-1] Latencia de fotogramas coherente. La latencia de fotogramas no es uniforme o un retraso en la renderización de fotogramas NO DEBE tener una frecuencia superior a 5 fotogramas por segundo, y SE DEBE ser inferior a 1 fotograma en un segundo.
- [8.2/T-0-1] DEBE garantizar un rendimiento de escritura secuencial de al menos 5 MB/s.
- [8.2/T-0-2] DEBE garantizar un rendimiento de escritura aleatorio de al menos 0.5 MB/s.
- [8.2/T-0-3] DEBE garantizar un rendimiento de lectura secuencial de al menos 15 MB/s.
- [8.2/T-0-4] DEBE garantizar un rendimiento de lectura aleatoria de al menos 3.5 MB/s.
Si las implementaciones de dispositivos de televisión incluyen funciones para mejorar la administración de energía del dispositivo que se incluyen en el AOSP o extender las funciones que se incluyen en el AOSP, sucederá lo siguiente:
- [8.3/T-1-1] DEBE proporcionar la indicación visual del usuario para habilitar o inhabilitar la función de ahorro de batería.
Si las implementaciones de dispositivos de televisión no tienen batería, deben hacer lo siguiente:
- [8.3/T-1-2] SE DEBE registrar el dispositivo como uno sin batería, tal como se describe en Cómo brindar compatibilidad con dispositivos sin batería.
Si las implementaciones de dispositivos de televisión tienen una batería, sucederá lo siguiente:
- [8.3/T-1-3] DEBE proporcionar la indicación visual del usuario para mostrar todas las apps exentas de los modos de ahorro de energía App Standby y Descanso.
Implementaciones de dispositivos de televisión:
- [8.4/T-0-1] DEBE proporcionar un perfil de energía por componente que defina el valor de consumo actual de cada componente de hardware y el consumo aproximado de batería causado por los componentes a lo largo del tiempo, como se documenta en el sitio del Proyecto de código abierto de Android.
- [8.4/T-0-2] SE DEBE informar todos los valores de consumo de energía en miliamperios-hora (mAh).
- [8.4/T-0-3] DEBE informar el consumo de energía de la CPU según el UID de cada proceso. El Proyecto de código abierto de Android cumple con los requisitos a través de la implementación del módulo de kernel
uid_cputime
. - [8.4/T] SE DEBE atribuir al componente de hardware si no se puede atribuir el uso de energía de un componente de hardware a una aplicación.
- [8.4/T-0-4] DEBE hacer que este uso de energía esté disponible para el desarrollador de la app a través del comando de shell
adb shell dumpsys batterystats
.
2.3.5. Modelo de seguridad
Implementaciones de dispositivos de televisión:
- [9.11/T-0-1] SE DEBE crear una copia de seguridad de la implementación del almacén de claves con un entorno de ejecución aislado.
- [9.11/T-0-2] DEBE tener implementaciones de algoritmos criptográficos RSA, AES, ECDSA y HMAC y funciones de hash de la familia MD5, SHA1 y SHA-2 para admitir adecuadamente los algoritmos compatibles del sistema Android Keystore en un área aislada de forma segura del código que se ejecuta en el kernel y superior. El aislamiento seguro DEBE bloquear todos los posibles mecanismos mediante los cuales el kernel o el código del espacio del usuario podrían acceder al estado interno del entorno aislado, incluida la DMA. El Proyecto de código abierto de Android (AOSP) ascendente cumple este requisito mediante la implementación de Trusty, pero otra solución basada en ARM TrustZone o una implementación segura revisada por terceros de un aislamiento adecuado basado en un hipervisor son opciones alternativas.
- [9.11/T-0-3] DEBE realizar la autenticación de la pantalla de bloqueo en el entorno de ejecución aislado y, solo cuando se realice de forma correcta, permitir el uso de claves vinculadas a la autenticación. Las credenciales de la pantalla de bloqueo DEBEN almacenarse de una manera que permita que solo el entorno de ejecución aislado realice la autenticación de la pantalla de bloqueo. El Proyecto de código abierto de Android ascendente ofrece la capa de abstracción de hardware (HAL) de Gatekeeper y Trusty, que se pueden usar para cumplir con este requisito.
- [9.11/T-0-4] DEBE admitir la certificación de claves cuando la clave de firma de certificación está protegida por hardware seguro y la firma se realiza en hardware seguro. Las claves de firma de certificación DEBEN compartirse entre una gran cantidad de dispositivos para evitar que se usen como identificadores de dispositivos. Una forma de cumplir con este requisito es compartir la misma clave de certificación, a menos que se produzcan al menos 100,000 unidades de un SKU determinado. Si se producen más de 100,000 unidades de un SKU, PUEDE usar una clave diferente por cada 100,000 unidades.
Ten en cuenta que, si la implementación de un dispositivo ya se inició en una versión anterior de Android, ese dispositivo estará exento del requisito de tener un almacén de claves respaldado por un entorno de ejecución aislado y admitir la certificación de claves, a menos que declare la función android.hardware.fingerprint
que requiera un almacén de claves respaldado por un entorno de ejecución aislado.
Si las implementaciones de dispositivos de televisión admiten una pantalla de bloqueo segura, sucederá lo siguiente:
- [9.11/T-1-1] DEBE permitir que el usuario elija el tiempo de espera de suspensión para la transición del estado desbloqueado al bloqueado, con un tiempo de espera mínimo permitido de hasta 15 segundos o menos.
Si las implementaciones de dispositivos de televisión incluyen varios usuarios y no declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/T-2-1] DEBE admitir perfiles restringidos, una función que permite a los propietarios de dispositivos administrar usuarios adicionales y sus capacidades en el dispositivo. Con los perfiles restringidos, los propietarios de dispositivos pueden configurar rápidamente entornos separados para que los usuarios adicionales trabajen en ellos, con la capacidad de administrar restricciones más detalladas en las apps que están disponibles en esos entornos.
Si las implementaciones de dispositivos de televisión incluyen varios usuarios y declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/T-3-1] NO DEBE admitir perfiles restringidos, pero DEBE alinearse con la implementación de controles de AOSP para permitir o inhabilitar el acceso de otros usuarios a las llamadas de voz y los SMS.
2.3.6. Compatibilidad de las Herramientas y opciones para desarrolladores
Implementaciones de dispositivos de televisión:
-
Perfetto
- .
- [6.1/T-0-1] DEBE exponer un objeto binario
/system/bin/perfetto
al usuario de shell que cmdline cumple con la documentación de perfetto. - [6.1/T-0-2] El objeto binario de perfetto DEBE aceptar como entrada una configuración de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/T-0-3] El objeto binario de perfetto DEBE escribir como resultado un seguimiento de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/T-0-4] DEBE proporcionar, al menos, a través del objeto binario perfetto, al menos las fuentes de datos descritas en la documentación de perfetto.
- [6.1/T-0-1] DEBE exponer un objeto binario
2.4. Requisitos para el reloj
El término dispositivo Android Watch hace referencia a la implementación de dispositivos Android para llevar en el cuerpo, por ejemplo, en la muñeca.
Las implementaciones en dispositivos Android se clasifican como un reloj si cumplen con todos los siguientes criterios:
- Asegúrate de tener una pantalla con una longitud diagonal física de entre 1.1 y 2.5 pulgadas.
- Tienen un mecanismo proporcionado para su uso en el cuerpo.
Los requisitos adicionales en el resto de esta sección son específicos para las implementaciones en dispositivos de Android Watch.
2.4.1. Hardware
Implementaciones de dispositivos de reloj:
-
[7.1.1.1/W-0-1] DEBE tener una pantalla con un tamaño diagonal físico de entre 1.1 y 2.5 pulgadas.
-
[7.2.3/W-0-1] DEBE tener la función de inicio disponible para el usuario y la función de retroceso, excepto cuando se encuentran en
UI_MODE_TYPE_WATCH
. -
[7.2.4/W-0-1] DEBE ser compatible con la entrada de pantalla táctil.
-
[7.3.1/W-SR] SE RECOMIENDA ENcarecidamente incluir un acelerómetro de 3 ejes.
Si las implementaciones en dispositivos de reloj incluyen un receptor GPS/GNSS y, además, informan la capacidad a las aplicaciones a través de la marca de función android.hardware.location.gps
, sucederá lo siguiente:
- [7.3.3/W-1-1] SE DEBE informar las mediciones de GNSS apenas se encuentran, incluso si aún no se informa una ubicación calculada a partir del GPS o GNSS.
- [7.3.3/W-1-2] DEBE informar pseudorrangos y pseudorrangos GNSS que, en condiciones a cielo abierto después de determinar la ubicación, mientras se encuentra en un lugar fijo o en movimiento a menos de 0.2 metros por segundo de aceleración, son suficientes para calcular la posición dentro de 20 metros y la velocidad dentro de 0.2 metros por segundo, al menos el 95% del tiempo.
Si las implementaciones en dispositivos de reloj incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [7.3.4/W-2-1] DEBE ser capaz de medir los cambios de orientación de hasta 1,000 grados por segundo.
Implementaciones de dispositivos de reloj:
-
[7.4.3/W-0-1] DEBE ser compatible con Bluetooth.
-
[7.6.1/W-0-1] DEBE tener al menos 1 GB de almacenamiento no volátil disponible para los datos privados de la aplicación (también conocido como partición “/data”).
-
[7.6.1/W-0-2] DEBE tener al menos 416 MB de memoria disponible para el kernel y el espacio de usuario.
-
[7.8.1/W-0-1] DEBE incluir un micrófono.
-
[7.8.2/W] PUEDE tener salida de audio.
2.4.2. Multimedia
Sin requisitos adicionales.
2.4.3. Software
Implementaciones de dispositivos de reloj:
- [3/W-0-1] SE DEBE declarar la función
android.hardware.type.watch
. - [3/W-0-2] DEBE admitir uiMode = UI_MODE_TYPE_WATCH.
- [3.2.3.1/W-0-1] DEBE precargar una o más aplicaciones o componentes de servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí.
Implementaciones de dispositivos de reloj:
- [3.8.4/W-SR] SE RECOMIENDA ENERCMENTE implementar un asistente en el dispositivo para realizar la acción de asistencia.
Implementaciones de dispositivos de reloj que declaran la marca de función android.hardware.audio.output
:
- [3.10/W-1-1] DEBE admitir servicios de accesibilidad de terceros.
- [3.10/W-SR] SE RECOMIENDA ENERCMENTE precargar servicios de accesibilidad en el dispositivo que sean comparables con la funcionalidad de Accesibilidad con interruptores y TalkBack (para idiomas compatibles con el motor de texto a voz preinstalado) como se proporciona en el proyecto de código abierto de TalkBack.
Si las implementaciones de dispositivos de reloj informan la función android.hardware.audio.output, hacen lo siguiente:
-
[3.11/W-SR] SE RECOMIENDA COMPLETAMENTE incluir un motor de TTS compatible con los idiomas disponibles en el dispositivo.
-
[3.11/W-0-1] DEBE admitir la instalación de motores de TTS de terceros.
2.4.4. Rendimiento y potencia
Si las implementaciones de dispositivos de reloj incluyen funciones para mejorar la administración de energía del dispositivo que se incluyen en el AOSP o extender las funciones que se incluyen en el AOSP, sucederá lo siguiente:
- [8.3/W-SR] SE RECOMIENDA ENERGENTE para proporcionar al usuario la posibilidad de mostrar todas las apps exentas de los modos de ahorro de energía App Standby y Descanso.
- [8.3/W-SR] SE RECOMIENDA MUY BIEN proporcionarles al usuario la posibilidad de habilitar o inhabilitar la función de ahorro de batería.
Implementaciones de dispositivos de reloj:
- [8.4/W-0-1] DEBE proporcionar un perfil de energía por componente que defina el valor de consumo actual de cada componente de hardware y el consumo aproximado de batería causado por los componentes con el tiempo, como se documenta en el sitio del Proyecto de código abierto de Android.
- [8.4/W-0-2] SE DEBE informar todos los valores de consumo de energía en miliamperios-hora (mAh).
- [8.4/W-0-3] SE DEBE informar el consumo de energía de la CPU según el UID de cada proceso. El Proyecto de código abierto de Android cumple con los requisitos a través de la implementación del módulo de kernel
uid_cputime
. - [8.4/W-0-4] DEBE hacer que este uso de energía esté disponible para el desarrollador de la app a través del comando de shell
adb shell dumpsys batterystats
. - [8.4/W] SE DEBE atribuir al componente de hardware si no se puede atribuir el uso de energía de un componente de hardware a una aplicación.
2.4.5. Modelo de seguridad
Si las implementaciones en dispositivos de reloj incluyen varios usuarios y no declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/W-1-1] DEBE admitir perfiles restringidos, una función que permite a los propietarios de dispositivos administrar usuarios adicionales y sus capacidades en el dispositivo. Con los perfiles restringidos, los propietarios de dispositivos pueden configurar rápidamente entornos separados para que los usuarios adicionales trabajen en ellos, con la capacidad de administrar restricciones más detalladas en las apps que están disponibles en esos entornos.
Si las implementaciones en dispositivos de reloj incluyen varios usuarios y declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/W-2-1] NO DEBE admitir perfiles restringidos, pero DEBE alinearse con la implementación de controles de AOSP para permitir o inhabilitar el acceso de otros usuarios a las llamadas de voz y los SMS.
2.5 Requisitos de la industria automotriz
La implementación de Android Automotive hace referencia a la consola central de un vehículo que ejecuta Android como sistema operativo para una parte o la totalidad del sistema o la funcionalidad de infoentretenimiento.
Las implementaciones en dispositivos Android se clasifican como Automotive si declaran la función android.hardware.type.automotive
o cumplen con todos los siguientes criterios.
- Estén incorporados en un vehículo automotor o se puedan conectar a él
- Usan una pantalla en la fila del asiento del conductor como pantalla principal.
Los requisitos adicionales en el resto de esta sección son específicos para las implementaciones en dispositivos de Android Automotive.
2.5.1. Hardware
Implementaciones en dispositivos de Automotive:
- [7.1.1.1/A-0-1] DEBE tener una pantalla de al menos 6 pulgadas de tamaño diagonal físico.
-
[7.1.1.1/A-0-2] DEBE tener un tamaño de pantalla de al menos 750 dp x 480 dp.
-
[7.2.3/A-0-1] DEBE proporcionar la función Inicio y PUEDE proporcionar las funciones Atrás y Recientes.
- [7.2.3/A-0-2] SE DEBE enviar el evento de mantener presionado y de mantener presionada la función Atrás (
KEYCODE_BACK
) a la aplicación en primer plano. - [7.3/A-0-1] DEBE implementar y, luego, informar
GEAR_SELECTION
,NIGHT_MODE
,PERF_VEHICLE_SPEED
yPARKING_BRAKE_ON
. - [7.3/A-0-2] El valor de la marca
NIGHT_MODE
DEBE ser coherente con el modo diurno/nocturno del panel y SE DEBE basarse en la entrada del sensor de luz ambiente. Es posible que el sensor de luz ambiente subyacente sea el mismo que el Fotómetro. - [7.3/A-0-3] SE DEBE proporcionar el campo de información adicional del sensor
TYPE_SENSOR_PLACEMENT
como parte de SensorAdditionalInfo para cada sensor proporcionado. - [7.3/A-0-1] MAYÚSCULA Ubicación combinando GPS/GNSS con sensores adicionales. Si no se considera la Ubicación, se RECOMIENDA RESPONDER e informar los tipos de sensores o los IDs de propiedad del vehículo correspondientes que se usen.
- [7.3/A-0-2] La Ubicación solicitada a través de LocationManager#requestLocationUpdates() NO DEBE coincidir con el mapa.
Si las implementaciones de dispositivos de Automotive incluyen un acelerómetro de 3 ejes, sucederá lo siguiente:
- [7.3.1/A-1-1] SE DEBE poder informar eventos con una frecuencia de al menos 100 Hz.
- [7.3.1/A-1-2] DEBE cumplir con el sistema de coordenadas del sensor de vehículos de Android.
Si las implementaciones en dispositivos de Automotive incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [7.3.4/A-2-1] SE DEBE poder informar eventos con una frecuencia de al menos 100 Hz.
- [7.3.4/A-2-2] también DEBE implementar el sensor
TYPE_GYROSCOPE_UNCALIBRATED
. - [7.3.4/A-2-3] DEBE ser capaz de medir los cambios de orientación de hasta 250 grados por segundo.
- [7.3.4/A-SR] SE RECOMIENDA ENERGENTEMENTE configurar el rango de medición del giroscopio en +/-250 dp para maximizar la resolución posible.
Si las implementaciones en dispositivos de Automotive incluyen un receptor de GPS/GNSS, pero no incluyen la conectividad de datos basada en la red móvil, sucederá lo siguiente:
- [7.3.3/A-3-1] DEBE determinar la ubicación la primera vez que se enciende el receptor de GPS/GNSS o después de 4 días o más en un plazo de 60 segundos.
- [7.3.3/A-3-2] DEBE cumplir con los criterios de tiempo para la primera corrección que se describen en 7.3.3/C-1-2 y 7.3.3/C-1-6 para todas las demás solicitudes de ubicación (es decir, solicitudes que no sean la primera vez o que transcurran más de 4 días). Por lo general, el requisito 7.3.3/C-1-2 se cumple en vehículos sin conectividad de datos basada en la red móvil, ya sea usando predicciones de órbita GNSS calculadas en el receptor o usando la última ubicación conocida del vehículo junto con la capacidad de reconocimiento muerto durante al menos 60 segundos con una precisión de posición que cumpla con 7.3.3/C-1-3, o una combinación de ambas.
Implementaciones en dispositivos de Automotive:
- [7.4.3/A-0-1] DEBE ser compatible con Bluetooth y DEBE ser compatible con Bluetooth LE.
- [7.4.3/A-0-2] Las implementaciones de Android Automotive DEBEN admitir los siguientes perfiles de Bluetooth:
- Llamadas telefónicas a través del perfil de manos libres (HFP)
- Reproducción de contenido multimedia a través del perfil de distribución de audio (A2DP)
- Control de reproducción de contenido multimedia a través del perfil de control remoto (AVRCP).
- Uso compartido de contactos mediante el perfil de acceso a la agenda telefónica (PBAP)
-
[7.4.3/A-SR] SE RECOMIENDA ES IMPORTANTE que sean compatibles con el perfil de acceso a los mensajes (MAP).
-
[7.4.5/A] SE DEBE incluir compatibilidad con la conectividad de datos basada en redes móviles.
- [7.4.5/A] PUEDE usar la constante
NetworkCapabilities#NET_CAPABILITY_OEM_PAID
de la API del sistema para las redes que deben estar disponibles para las apps del sistema.
Una cámara de visión exterior es una cámara que genera imágenes fuera de la implementación del dispositivo, como una dashcam.
Implementaciones en dispositivos de Automotive:
- SE DEBE incluir una o más cámaras de vista exterior.
Si las implementaciones en dispositivos de Automotive incluyen una cámara de vista exterior para una cámara de este tipo, sucederá lo siguiente:
- [7.5/A-1-1] NO DEBE tener cámaras de visión exterior a las que se pueda acceder a través de las APIs de Android Camera, a menos que cumplan con los requisitos principales de la cámara.
- [7.5/A-SR] SE RECOMIENDA ELECTRÓNICO no rotar ni duplicar de forma horizontal la vista previa de la cámara.
- [7.5.5/A-SR] SE RECOMIENDA ENRENDER que se orienten para que la dimensión larga de la cámara se alinee con el horizonte.
- [7.5/A-SR] SE RECOMIENDA ENcarecidamente tener una resolución de al menos 1.3 megapíxeles.
- SE DEBE tener hardware de enfoque fijo o EDOF (profundidad de campo extendida).
- SE RECOMIENDA admitir el framework de sincronización de Android.
- PUEDE tener implementado un enfoque automático de hardware o de software en el controlador de la cámara.
Implementaciones en dispositivos de Automotive:
-
[7.6.1/A-0-1] DEBE tener al menos 4 GB de almacenamiento no volátil disponible para los datos privados de la aplicación (también conocido como partición “/data”).
-
[7.6.1/A] SE DEBE formatear la partición de datos para ofrecer un rendimiento y una longevidad mejorados en el almacenamiento flash, por ejemplo, con el sistema de archivos
f2fs
.
Si las implementaciones en dispositivos de Automotive proporcionan almacenamiento externo compartido a través de una parte del almacenamiento interno no extraíble, sucederá lo siguiente:
- [7.6.1/A-SR] SE RECOMIENDEN ENERGENTEmente para reducir la sobrecarga de E/S en las operaciones realizadas en el almacenamiento externo, por ejemplo, mediante
SDCardFS
.
Si las implementaciones en dispositivos de Automotive son de 32 bits, sucede lo siguiente:
-
[7.6.1/A-1-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 512 MB si se usa alguna de las siguientes densidades:
- 280 dpi o menos en pantallas pequeñas o normales
- ldpi o inferior en pantallas extragrandes
- mdpi o inferior en pantallas grandes
-
[7.6.1/A-1-2] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 608 MB si se usa alguna de las siguientes densidades:
- xhdpi o superior en pantallas pequeñas o normales
- hdpi o más alta en pantallas grandes
- mdpi o superior en pantallas extragrandes
-
[7.6.1/A-1-3] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 896 MB si se usa alguna de las siguientes densidades:
- 400 dpi o más en pantallas pequeñas o normales
- xhdpi o superior en pantallas grandes
- tvdpi o superior en pantallas extragrandes
-
[7.6.1/A-1-4] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,344 MB si se usa alguna de las siguientes densidades:
- 560 dpi o más en pantallas pequeñas o normales
- 400 dpi o más en pantallas grandes
- xhdpi o superior en pantallas extragrandes
Si las implementaciones en dispositivos de Automotive son de 64 bits, sucede lo siguiente:
-
[7.6.1/A-2-1] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 816 MB si se usa alguna de las siguientes densidades:
- 280 dpi o menos en pantallas pequeñas o normales
- ldpi o inferior en pantallas extragrandes
- mdpi o inferior en pantallas grandes
-
[7.6.1/A-2-2] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 944 MB si se usa alguna de las siguientes densidades:
- xhdpi o superior en pantallas pequeñas o normales
- hdpi o más alta en pantallas grandes
- mdpi o superior en pantallas extragrandes
-
[7.6.1/A-2-3] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,280 MB si se usa alguna de las siguientes densidades:
- 400 dpi o más en pantallas pequeñas o normales
- xhdpi o superior en pantallas grandes
- tvdpi o superior en pantallas extragrandes
-
[7.6.1/A-2-4] La memoria disponible para el kernel y el espacio de usuario DEBE ser de al menos 1,824 MB si se usa alguna de las siguientes densidades:
- 560 dpi o más en pantallas pequeñas o normales
- 400 dpi o más en pantallas grandes
- xhdpi o superior en pantallas extragrandes
Ten en cuenta que la “memoria disponible para el kernel y el espacio del usuario” El ejemplo anterior hace referencia al espacio de memoria proporcionado además de cualquier memoria ya dedicada a componentes de hardware, como radio, video, etc., que no están bajo el control del kernel en las implementaciones de dispositivos.
Implementaciones en dispositivos de Automotive:
- [7.7.1/A] SE DEBE incluir un puerto USB que admita el modo periférico.
Implementaciones en dispositivos de Automotive:
- [7.8.1/A-0-1] DEBE incluir un micrófono.
Implementaciones en dispositivos de Automotive:
- [7.8.2/A-0-1] DEBE tener una salida de audio y declarar
android.hardware.audio.output
.
2.5.2. Multimedia
Las implementaciones en dispositivos de Automotive DEBEN admitir los siguientes formatos de codificación y decodificación de audio, y ponerlos a disposición de aplicaciones de terceros:
- [5.1/A-0-1] Perfil MPEG-4 AAC (AAC LC)
- [5.1/A-0-2] Perfil MPEG-4 HE AAC (AAC+)
- [5.1/A-0-3] AAC ELD (AAC mejorado de bajo retraso)
Las implementaciones en dispositivos de Automotive DEBEN admitir los siguientes formatos de codificación de video y ponerlos a disposición de aplicaciones de terceros:
Las implementaciones en dispositivos de Automotive DEBEN admitir los siguientes formatos de decodificación de video y ponerlos a disposición de aplicaciones de terceros:
Se RECOMIENDA ELEGIR las implementaciones en dispositivos de Automotive para admitir la siguiente decodificación de video:
- [5.3/A-SR] H.265 HEVC
2.5.3. Software
Implementaciones en dispositivos de Automotive:
-
[3/A-0-1] SE DEBE declarar la función
android.hardware.type.automotive
. -
[3/A-0-2] DEBE admitir uiMode =
UI_MODE_TYPE_CAR
. -
[3/A-0-3] DEBE admitir todas las APIs públicas en el espacio de nombres
android.car.*
.
Si las implementaciones en dispositivos de Automotive proporcionan una API de su propiedad usando android.car.CarPropertyManager
con android.car.VehiclePropertyIds
, sucederá lo siguiente:
- [3/A-1-1] NO DEBE adjuntar privilegios especiales al uso de estas propiedades por parte de la aplicación del sistema ni impedir que aplicaciones de terceros las usen.
- [3/A-1-2] NO DEBE replicar una propiedad del vehículo que ya existe en el SDK.
Implementaciones en dispositivos de Automotive:
-
[3.2.1/A-0-1] SE DEBE admitir y aplicar todas las constantes de permisos según lo documentado en la página de referencia sobre permisos de Automotive.
-
[3.2.3.1/A-0-1] DEBE precargar una o más aplicaciones o componentes del servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí.
-
[3.4.1/A-0-1] DEBE proporcionar una implementación completa de la API de
android.webkit.Webview
. -
[3.8.3/A-0-1] SE DEBE mostrar notificaciones que usen la API de
Notification.CarExtender
cuando lo soliciten aplicaciones de terceros. -
[3.8.4/A-SR] Se recomienda implementar un asistente en el dispositivo para realizar la acción de asistencia.
Si las implementaciones en dispositivos de Automotive incluyen un botón de presionar para hablar, hacen lo siguiente:
- [3.8.4/A-1-1] SE DEBE presionar brevemente el botón de presionar para hablar como la interacción designada para iniciar la aplicación de asistencia seleccionada por el usuario; en otras palabras, la aplicación que implementa
VoiceInteractionService
.
Implementaciones en dispositivos de Automotive:
- [3.8.3.1/A-0-1] DEBE renderizar correctamente los recursos, como se describe en la documentación del SDK de
Notifications on Automotive OS
. - [3.8.3.1/A-0-2] SE DEBE mostrar REPRODUCIR y SILENCIAR para las acciones de notificación en lugar de las opciones proporcionadas a través de
Notification.Builder.addAction()
- [3.8.3.1/A] SE DEBE restringir el uso de tareas de administración enriquecidas, como los controles por canal de notificaciones. PUEDE usar la opción de IU por aplicación para reducir los controles.
Implementaciones en dispositivos de Automotive:
- [3.14/A-0-1] DEBE incluir un framework de IU para admitir apps de terceros con las APIs de contenido multimedia, como se describe en la sección 3.14.
- [3.14/A-0-2] DEBE permitir que el usuario interactúe de manera segura con aplicaciones multimedia mientras conduce.
- [3.14/A-0-3] DEBE admitir la acción de intent implícita
CAR_INTENT_ACTION_MEDIA_TEMPLATE
con el extraCAR_EXTRA_MEDIA_PACKAGE
. - [3.14/A-0-4] DEBE proporcionar una indicación visual para navegar a la actividad de preferencia de una Aplicación de música, pero DEBE habilitarla solo cuando las Restricciones de UX del vehículo no estén vigentes.
- [3.14/A-0-5] SE DEBE mostrar los mensajes de error establecidos por las aplicaciones de contenido multimedia y DEBE admitir los extras opcionales
ERROR_RESOLUTION_ACTION_LABEL
yERROR_RESOLUTION_ACTION_INTENT
. - [3.14/A-0-6] DEBE admitir una indicación visual de búsqueda dentro de la app para apps que admiten esa función.
- [3.14/A-0-7] DEBE respetar las definiciones de
CONTENT_STYLE_BROWSABLE_HINT
yCONTENT_STYLE_PLAYABLE_HINT
cuando se muestra la jerarquía de MediaBrowser.
Si las implementaciones de dispositivos de Automotive incluyen una app de selector predeterminada, harán lo siguiente:
- [3.14/A-1-1] DEBE incluir servicios multimedia y abrirlos con el intent
CAR_INTENT_ACTION_MEDIA_TEMPLATE
.
Implementaciones en dispositivos de Automotive:
- [3.8/A] PUEDE restringir las solicitudes de la aplicación para ingresar a un modo de pantalla completa, como se describe en
immersive documentation
. - [3.8/A] PUEDE mantener la barra de estado y la barra de navegación visibles en todo momento.
- [3.8/A] PUEDE restringir las solicitudes de la aplicación para cambiar los colores detrás de los elementos de la IU del sistema, a fin de garantizar que esos elementos sean claramente visibles en todo momento.
2.5.4. Rendimiento y potencia
Implementaciones en dispositivos de Automotive:
- [8.2/A-0-1] SE DEBE informar la cantidad de bytes leídos y escritos en el almacenamiento no volátil según el UID de cada proceso, de modo que las estadísticas estén disponibles para los desarrolladores a través de la API del sistema
android.car.storagemonitoring.CarStorageMonitoringManager
. El Proyecto de código abierto de Android cumple con los requisitos a través del módulo de kerneluid_sys_stats
. - [8.3/A-1-3] DEBE admitir el modo garaje.
- [8.3/A] SE DEBE estar en modo garaje durante al menos 15 minutos después de cada viaje, a menos que ocurra lo siguiente:
- Se agotó la batería.
- No se programaron trabajos inactivos.
- El conductor sale del modo garaje.
- [8.4/A-0-1] DEBE proporcionar un perfil de energía por componente que defina el valor de consumo actual de cada componente de hardware y el consumo aproximado de batería causado por los componentes a lo largo del tiempo, como se documenta en el sitio del Proyecto de código abierto de Android.
- [8.4/A-0-2] SE DEBE informar todos los valores de consumo de energía en miliamperios-hora (mAh).
- [8.4/A-0-3] DEBE informar el consumo de energía de la CPU según el UID de cada proceso. El Proyecto de código abierto de Android cumple con los requisitos a través de la implementación del módulo de kernel
uid_cputime
. - [8.4/A] SE DEBE atribuir al componente de hardware si no se puede atribuir el uso de energía de un componente de hardware a una aplicación.
- [8.4/A-0-4] DEBE hacer que este uso de energía esté disponible para el desarrollador de la app a través del comando de shell
adb shell dumpsys batterystats
.
2.5.5. Modelo de seguridad
Si las implementaciones en dispositivos de Automotive admiten varios usuarios, sucederán lo siguiente:
- [9.5/A-1-1] NO DEBE permitir que los usuarios interactúen con el usuario del sistema sin interfaz gráfica ni cambien de uno a este, excepto por el aprovisionamiento de dispositivos.
- [9.5/A-1-2] DEBE cambiar a un usuario secundario antes del
BOOT_COMPLETED
. - [9.5/A-1-3] DEBE admitir la capacidad de crear un usuario invitado incluso cuando se haya alcanzado la cantidad máxima de usuarios en un dispositivo.
Implementaciones en dispositivos de Automotive:
- [9.11/A-0-1] SE DEBE crear una copia de seguridad de la implementación del almacén de claves con un entorno de ejecución aislado.
- [9.11/A-0-2] DEBE tener implementaciones de algoritmos criptográficos RSA, AES, ECDSA y HMAC y funciones de hash de la familia MD5, SHA1 y SHA-2 para admitir adecuadamente los algoritmos compatibles del sistema Android Keystore en un área aislada de forma segura del código que se ejecuta en el kernel y superior. El aislamiento seguro DEBE bloquear todos los posibles mecanismos mediante los cuales el kernel o el código del espacio del usuario podrían acceder al estado interno del entorno aislado, incluida la DMA. El Proyecto de código abierto de Android (AOSP) ascendente cumple este requisito mediante la implementación de Trusty, pero otra solución basada en ARM TrustZone o una implementación segura revisada por terceros de un aislamiento adecuado basado en un hipervisor son opciones alternativas.
- [9.11/A-0-3] DEBE realizar la autenticación de la pantalla de bloqueo en el entorno de ejecución aislado y, solo cuando se realice de forma correcta, permitir el uso de claves vinculadas a la autenticación. Las credenciales de la pantalla de bloqueo DEBEN almacenarse de una manera que permita que solo el entorno de ejecución aislado realice la autenticación de la pantalla de bloqueo. El Proyecto de código abierto de Android ascendente ofrece la capa de abstracción de hardware (HAL) de Gatekeeper y Trusty, que se pueden usar para cumplir con este requisito.
- [9.11/A-0-4] SE DEBE admitir la certificación de claves cuando la clave de firma de certificación está protegida por hardware seguro y la firma se realiza en hardware seguro. Las claves de firma de certificación DEBEN compartirse entre una gran cantidad de dispositivos para evitar que se usen como identificadores de dispositivos. Una forma de cumplir con este requisito es compartir la misma clave de certificación, a menos que se produzcan al menos 100,000 unidades de un SKU determinado. Si se producen más de 100,000 unidades de un SKU, PUEDE usar una clave diferente por cada 100,000 unidades.
Ten en cuenta que, si la implementación de un dispositivo ya se inició en una versión anterior de Android, ese dispositivo estará exento del requisito de tener un almacén de claves respaldado por un entorno de ejecución aislado y admitir la certificación de claves, a menos que declare la función android.hardware.fingerprint
que requiera un almacén de claves respaldado por un entorno de ejecución aislado.
Implementaciones en dispositivos de Automotive:
- [9.14/A-0-1] DEBE mantener los mensajes de los subsistemas del vehículo del framework de Android, p.ej., agregar tipos de mensajes permitidos y fuentes de mensajes a una lista de entidades permitidas.
- [9.14/A-0-2] DEBE Supervisar los ataques de denegación del servicio del framework de Android o las apps de terceros. Esto brinda protección contra software malicioso que inunda de tráfico la red del vehículo, lo que puede provocar el mal funcionamiento de los subsistemas del vehículo.
2.5.6. Compatibilidad de las Herramientas y opciones para desarrolladores
Implementaciones en dispositivos de Automotive:
-
Perfetto
- .
- [6.1/A-0-1] DEBE exponer un objeto binario
/system/bin/perfetto
al usuario de shell que cmdline cumple con la documentación de perfetto. - [6.1/A-0-2] El objeto binario de perfetto DEBE aceptar como entrada una configuración de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/A-0-3] El objeto binario de perfetto DEBE escribir como resultado un seguimiento de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [6.1/A-0-4] DEBE proporcionar, al menos, a través del objeto binario perfetto, al menos las fuentes de datos descritas en la documentación de perfetto.
- [6.1/A-0-1] DEBE exponer un objeto binario
2.6. Requisitos de las tabletas
Un dispositivo tablet Android hace referencia a una implementación de dispositivo Android que normalmente cumple con todos los siguientes criterios:
- Se usa con ambas manos.
- No tiene una configuración convertible ni convencional.
- Implementaciones de teclado físico que se usan con el dispositivo se conecta a través de una conexión estándar (p.ej., USB o Bluetooth).
- Tenga una fuente de alimentación que proporcione movilidad, como una batería.
- Tiene un tamaño de pantalla diagonal físico de entre 7 y 18 pulgadas.
Las implementaciones en dispositivos de tablets tienen requisitos similares a las implementaciones en dispositivos de mano. Las excepciones se indican con un * en esa sección y se indican como referencia en esta sección.
2.6.1. Hardware
Tamaño de pantalla
- [7.1.1.1/Tab-0-1] DEBE tener una pantalla de entre 7 y 18 pulgadas.
Giroscopio
Si las implementaciones en dispositivos de tablets incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [7.3.4/Tab-1-1] DEBE ser capaz de medir los cambios de orientación hasta 1,000 grados por segundo.
Memoria y almacenamiento mínimos (sección 7.6.1)
Las densidades de pantalla que se indican para las pantallas pequeñas/normales en los requisitos para dispositivos portátiles no se aplican a las tablets.
Modo periférico USB (sección 7.7.1)
Si las implementaciones de dispositivos tablet incluyen un puerto USB compatible con el modo periférico, sucederá lo siguiente:
- [7.7.1/Tab] PUEDE implementar la API de Open Accessory (AOA) de Android.
Modo de realidad virtual (sección 7.9.1)
Realidad virtual con alto rendimiento (Artículo 7.9.2)
Los requisitos de realidad virtual no se aplican a las tablets.
2.6.2. Modelo de seguridad
Claves y credenciales (Sección 9.11)
Consulta la sección [9.11].
Si las implementaciones en dispositivos tablet incluyen varios usuarios y no declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/T-1-1] DEBE admitir perfiles restringidos, una función que permite a los propietarios de dispositivos administrar usuarios adicionales y sus capacidades en el dispositivo. Con los perfiles restringidos, los propietarios de dispositivos pueden configurar rápidamente entornos separados para que los usuarios adicionales trabajen en ellos, con la capacidad de administrar restricciones más detalladas en las apps que están disponibles en esos entornos.
Si las implementaciones en dispositivos tablet incluyen varios usuarios y declaran la marca de función android.hardware.telephony
, sucederá lo siguiente:
- [9.5/T-2-1] NO DEBE admitir perfiles restringidos, pero DEBE alinearse con la implementación de controles de AOSP para permitir o inhabilitar el acceso de otros usuarios a las llamadas de voz y los SMS.
2.6.2. Software
- [3.2.3.1/Tab-0-1] DEBE precargar una o más aplicaciones o componentes de servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí.
3. Software
3.1. Compatibilidad con APIs administradas
El entorno de ejecución de código de bytes administrado de Dalvik es el vehículo principal para las aplicaciones para Android. La interfaz de programación de aplicaciones (API) de Android es el conjunto de interfaces de la plataforma de Android expuestas a las aplicaciones que se ejecutan en el entorno de ejecución administrado.
Implementaciones en dispositivos:
-
[C-0-1] DEBE proporcionar implementaciones completas, incluidos todos los comportamientos documentados, de cualquier API documentada expuesta por el SDK de Android o cualquier API decorada con el marcador “@SystemApi” en el código fuente ascendente de Android.
-
[C-0-2] DEBE admitir o preservar todas las clases, métodos y elementos asociados marcados por la anotación TestApi (@TestApi).
-
[C-0-3] NO DEBE omitir ninguna API administrada, alterar las interfaces o firmas de las APIs, desviarse del comportamiento documentado ni incluir no-ops, excepto cuando esta definición de compatibilidad lo permita específicamente.
-
[C-0-4] DE todas maneras DEBE mantener las APIs presentes y comportarse de manera razonable, aun cuando se omitan algunas funciones de hardware para las cuales Android incluye APIs. Consulta la sección 7 para conocer los requisitos específicos para esta situación.
-
[C-0-5] NO DEBE permitir que apps de terceros usen interfaces que no pertenezcan al SDK, las cuales están definidas como métodos y campos en los paquetes de lenguaje Java que se encuentran en la ruta de clase de inicio en AOSP y que no forman parte del SDK público. Esto incluye las APIs decoradas con la anotación
@hide
, pero no con un@SystemAPI
, como se describe en los documentos del SDK y en los miembros de las clases privadas y de paquetes privados. -
[C-0-6] SE DEBE enviar con todas y cada una de las interfaces que no pertenecen al SDK en las mismas listas restringidas que se proporcionan en las marcas provisionales y de la lista de bloqueo en la ruta
prebuilts/runtime/appcompat/hiddenapi-flags.csv
para la rama de nivel de API correspondiente en el AOSP. -
[C-0-7] DEBE admitir el mecanismo de actualización dinámica de configuración firmada para quitar interfaces que no pertenecen al SDK de una lista restringida. Para ello, debe incorporar la configuración firmada en cualquier APK con las claves públicas existentes presentes en el AOSP.
Sin embargo, lograron lo siguiente:
- MAYOR, si una API oculta está ausente o se implementa de manera diferente en la implementación del dispositivo, mover la API oculta a la lista de bloqueo u omitirla de todas las listas restringidas (es decir, gris claro, gris oscuro o negro).
- MAYOR, si una API oculta aún no existe en el AOSP, agrégala a cualquiera de las listas restringidas (es decir, gris claro, gris oscuro o negro).
3.1.1. Extensiones de Android
Android admite la extensión de la superficie de API administrada de un nivel de API determinado actualizando la versión de la extensión para ese nivel. La API de android.os.ext.SdkExtensions.getExtensionVersion(int apiLevel)
muestra la versión de la extensión del apiLevel
proporcionado si hay extensiones para ese nivel de API.
Implementaciones en dispositivos Android:
-
[C-0-1] DEBE precargar la implementación de AOSP de la biblioteca compartida
ExtShared
y los serviciosExtServices
con versiones superiores o iguales a las versiones mínimas permitidas por cada nivel de API. Por ejemplo, las implementaciones en dispositivos con Android 7.0 y el nivel de API 24 DEBEN incluir, al menos, la versión 1. -
[C-0-2] Solo DEBE mostrar el número de versión de extensión válido definido por el AOSP.
-
[C-0-3] DEBE admitir todas las APIs definidas por las versiones de extensión que muestra
android.os.ext.SdkExtensions.getExtensionVersion(int apiLevel)
de la misma manera que se admiten otras APIs administradas, de acuerdo con los requisitos de la sección 3.1.
3.1.2. Biblioteca de Android
Debido a la baja del cliente HTTP de Apache, las implementaciones en dispositivos tienen las siguientes características:
- [C-0-1] NO DEBE colocar la biblioteca
org.apache.http.legacy
en la ruta de arranque. - [C-0-2] DEBE agregar la biblioteca
org.apache.http.legacy
a la ruta de clase de la aplicación solo si esta cumple con una de las siguientes condiciones:- Se orienta al nivel de API 28 o versiones anteriores.
- Establece el atributo
android:name
de<uses-library>
enorg.apache.http.legacy
para declarar en su manifiesto que necesita la biblioteca.
La implementación de AOSP cumple con estos requisitos.
3.2. Compatibilidad con la API de Soft
Además de las APIs administradas de la sección 3.1, Android también incluye una API “secundaria” significativa de solo tiempo de ejecución, en forma de intents, permisos y aspectos similares de aplicaciones para Android que no se pueden aplicar en el tiempo de compilación de la aplicación.
3.2.1. Permisos
- [C-0-1] Los implementadores de dispositivos DEBEN admitir y aplicar todas las constantes de permisos según lo documentado en la página de referencia de permisos. Ten en cuenta que en la sección 9 se indican requisitos adicionales relacionados con el modelo de seguridad de Android.
3.2.2. Parámetros de compilación
Las APIs de Android incluyen una serie de constantes en la clase android.os.Build que están pensadas para describir el dispositivo actual.
- [C-0-1] Para proporcionar valores coherentes y significativos en todas las implementaciones de dispositivos, la siguiente tabla incluye restricciones adicionales sobre los formatos de estos valores que DEBEN cumplir las implementaciones de dispositivos.
Parámetro | Detalles |
---|---|
VERSION.LANZAMIENTO | Es la versión del sistema Android en ejecución actualmente, en formato legible por humanos. Este campo DEBE tener uno de los valores de cadena definidos en el archivo 11. |
VERSION.SDK | Es la versión del sistema Android en ejecución actualmente, en un formato accesible para el código de la aplicación de terceros. Para Android 11, este campo DEBE tener el valor entero 11_INT. |
VERSION.SDK_INT | Es la versión del sistema Android en ejecución actualmente, en un formato accesible para el código de la aplicación de terceros. Para Android 11, este campo DEBE tener el valor entero 11_INT. |
VERSION.INCREMENTAL | Es un valor que elige el implementador de dispositivos que designa la compilación específica del sistema Android en ejecución actualmente, en un formato legible por humanos. Este valor NO SE DEBE volver a usar en diferentes compilaciones que se ponen a disposición de los usuarios finales. Un uso típico de este campo es indicar qué número de compilación o identificador de cambio de control de origen se usó para generar la compilación. El valor de este campo SE DEBE codificar como ASCII imprimible de 7 bits y coincidir con la expresión regular “^[^ :\/~]+$”. |
JUEGOS DE MESA | Es un valor que elige el implementador del dispositivo para identificar el hardware interno específico que utiliza el dispositivo, en un formato legible por humanos. Este campo puede usarse para indicar la revisión específica de la placa que alimenta el dispositivo. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9_-]+$”. |
SEGURIDAD | Un valor que refleja el nombre de la marca asociada con el dispositivo, como lo conocen los usuarios finales. DEBE tener un formato legible por humanos y DEBERÍA representar al fabricante del dispositivo o a la marca de la empresa con la que se comercializa el dispositivo. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9_-]+$”. |
ABIS_COMPATIBLES | Es el nombre del conjunto de instrucciones (tipo de CPU + convención de ABI) del código nativo. Consulta la sección 3.3. Compatibilidad de API nativa. |
ABIS_COMPATIBLES_32_BIT | Es el nombre del conjunto de instrucciones (tipo de CPU + convención de ABI) del código nativo. Consulta la sección 3.3. Compatibilidad de API nativa. |
ABIS_COMPATIBLES_64_BIT | Es el nombre del segundo conjunto de instrucciones (tipo de CPU + convención de ABI) del código nativo. Consulta la sección 3.3. Compatibilidad de API nativa. |
ABI_de_CPU | Es el nombre del conjunto de instrucciones (tipo de CPU + convención de ABI) del código nativo. Consulta la sección 3.3. Compatibilidad de API nativa. |
ABI2 de CPU | Es el nombre del segundo conjunto de instrucciones (tipo de CPU + convención de ABI) del código nativo. Consulta la sección 3.3. Compatibilidad de API nativa. |
DISPOSITIVO | Es un valor elegido por el implementador de dispositivos que contiene el nombre de desarrollo o el nombre interno que identifica la configuración de las características del hardware y el diseño industrial del dispositivo. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9_-]+$”. El nombre de este dispositivo NO DEBE cambiar durante la vida útil del producto. |
IMPRESIÓN DE DEDOS |
Es una cadena que identifica esta compilación de forma única. DEBE ser razonablemente legible por humanos. DEBE seguir esta plantilla:
$(BRAND)/$(PRODUCT)/ Por ejemplo:
acme/miproducto/ La huella digital NO DEBE incluir caracteres de espacio en blanco. El valor de este campo SE DEBE codificar como ASCII de 7 bits. |
HARDWARE | Es el nombre del hardware (de la línea de comandos del kernel o /proc). DEBE ser razonablemente legible por humanos. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9_-]+$”. |
ORGANIZADOR | Es una cadena que identifica de forma única el host en el que se compiló la compilación, en un formato legible. No existen requisitos para el formato específico de este campo, excepto que NO DEBE ser nulo ni la cadena vacía (""). |
ID | Es un identificador que elige el implementador de dispositivos para hacer referencia a una versión específica, en formato legible por humanos. Este campo puede ser igual a android.os.Build.VERSION.INCREMENTAL, pero DEBERÍA ser un valor lo suficientemente significativo para que los usuarios finales distingan entre compilaciones de software. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9._-]+$”. |
FABRICANTE | Es el nombre comercial del fabricante del equipo original (OEM) del producto. No existen requisitos para el formato específico de este campo, excepto que NO DEBE ser nulo ni la cadena vacía (""). Este campo NO DEBE cambiar durante la vida útil del producto. |
MODELO. | Es un valor elegido por el implementador de dispositivos que contiene el nombre del dispositivo como lo conoce el usuario final. Debe ser el mismo nombre con el que el dispositivo se comercializa y vende a usuarios finales. No existen requisitos para el formato específico de este campo, excepto que NO DEBE ser nulo ni la cadena vacía (""). Este campo NO DEBE cambiar durante la vida útil del producto. |
PRODUCTO | Es un valor elegido por el implementador de dispositivos que contiene el nombre de desarrollo o el nombre interno del producto específico (SKU) que DEBE ser único dentro de la misma marca. DEBE ser legible por humanos, pero no necesariamente para que lo vean los usuarios finales. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9_-]+$”. El nombre de este producto NO DEBE cambiar durante la vida útil del producto. |
SERIE | SE DEBE mostrar "UNKNOWN". |
ETIQUETAS | Una lista de etiquetas separadas por comas que elige el implementador de dispositivos que distingue aún más la compilación. Las etiquetas DEBEN poder codificarse como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9._-]+” y DEBEN tener uno de los valores correspondientes a las tres configuraciones de firma típicas de la plataforma de Android: claves de lanzamiento, claves de desarrollo y claves de prueba. |
TIEMPO | Un valor que representa la marca de tiempo del momento en que se produjo la compilación. |
TIPO | Es un valor que elige el implementador de dispositivos que especifica la configuración del tiempo de ejecución de la compilación. Este campo DEBE tener uno de los valores correspondientes a las tres configuraciones típicas de tiempo de ejecución de Android: user, userdebug o eng. |
USUARIO | Un nombre o ID de usuario del usuario (o usuario automatizado) que generó la compilación. No existen requisitos para el formato específico de este campo, excepto que NO DEBE ser nulo ni la cadena vacía (""). |
VERSION.SECURITY_PATCH | Es un valor que indica el nivel de parche de seguridad de una compilación. DEBE indicar que la compilación no es vulnerable de ninguna manera a ninguno de los problemas descritos en el Boletín de seguridad pública de Android designado. DEBE tener el formato [YYYY-MM-DD], que coincida con una cadena definida documentada en el Boletín de seguridad pública de Android o en el Aviso de seguridad de Android, por ejemplo, "2015-11-01". |
VERSION.BASE_OS | Un valor que representa el parámetro FINGERPRINT de la compilación que es idéntico a esta compilación, excepto por los parches proporcionados en el Boletín de seguridad pública de Android. DEBE informar el valor correcto y, si tal compilación no existe, informar una cadena vacía (""). |
CARGADOR DE ARRANQUE | Es un valor que elige el implementador del dispositivo para identificar la versión específica del bootloader interno que se usa en el dispositivo, en un formato legible por humanos. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9._-]+$”. |
getRadioVersion(), | DEBE (ser o mostrar) un valor elegido por el implementador del dispositivo que identifique la versión interna de radio/módem específica utilizada en el dispositivo, en un formato legible por humanos. Si un dispositivo no tiene radio/módem interno, DEBE mostrar NULL. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9._-,]+$”. |
getSerial(). | DEBE (ser o devolver) un número de serie de hardware, que DEBE estar disponible y ser único en todos los dispositivos con el mismo MODELO y FABRICANTE. El valor de este campo SE DEBE codificar como ASCII de 7 bits y coincidir con la expresión regular “^[a-zA-Z0-9._-,]+$”. |
3.2.3. Compatibilidad con intents
3.2.3.1. Intents de aplicaciones comunes
Los intents de Android permiten que los componentes de la aplicación soliciten funcionalidades a otros componentes de Android. El proyecto upstream de Android incluye una lista de aplicaciones que implementan varios patrones de intents para realizar acciones comunes.
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENERGARSE que precargan una o más aplicaciones o componentes de servicio con un controlador de intents para todos los patrones de filtro de intents públicos definidos por los siguientes intents de aplicación enumerados aquí y proporcionar entregas, es decir, que cumplan con las expectativas del desarrollador para estos intents de aplicación comunes, como se describe en el SDK.
Consulta la Sección 2 para conocer los intents de aplicación obligatorios para cada tipo de dispositivo.
3.2.3.2. Resolución de intents
-
[C-0-1] Como Android es una plataforma extensible, las implementaciones en dispositivos DEBEN permitir que cada patrón de intent al que se hace referencia en la sección 3.2.3.1 , excepto en el caso de la configuración, anule a las aplicaciones de terceros. La implementación ascendente de código abierto de Android lo permite de forma predeterminada.
-
[C-0-2] Los implementadores de dispositivos NO DEBEN adjuntar privilegios especiales a las aplicaciones del sistema el uso de estos patrones de intenciones o evitar que las aplicaciones de terceros se vinculen con estos patrones y asuman el control de ellos. Esta prohibición incluye, entre otros aspectos, la inhabilitación de la interfaz de usuario del "Selector", que permite al usuario elegir entre varias aplicaciones que manejan el mismo patrón de intents.
-
[C-0-3] Las implementaciones en dispositivos DEBEN proporcionar una interfaz de usuario para que los usuarios modifiquen la actividad predeterminada para intents.
-
Sin embargo, PODRÍAN proporcionar actividades predeterminadas para patrones de URI específicos (por ejemplo, http://play.google.com) en las implementaciones de dispositivos cuando la actividad predeterminada proporcione un atributo más específico para el URI de datos. Por ejemplo, un patrón de filtro de intents que especifica el URI de datos "http://www.android.com" es más específico que el patrón de intent principal del navegador para "http://".
Android también incluye un mecanismo para que las apps de terceros declaren un comportamiento de vinculación de apps predeterminado para ciertos tipos de intents de URI web. Cuando se definen dichas declaraciones autorizadas en los patrones de filtro de intents de una app, las implementaciones de dispositivos hacen lo siguiente:
- [C-0-4] SE DEBE intentar validar cualquier filtro de intents. Para ello, se deben realizar los pasos de validación definidos en la especificación de Vínculos de recursos digitales, tal como la implementó el Administrador de paquetes en el Proyecto de código abierto de Android ascendente.
- [C-0-5] DEBE intentar la validación de los filtros de intents durante la instalación de la aplicación y establecer todos los filtros de intents de URI validados correctamente como controladores de app predeterminados para sus URI.
- PUEDE establecer filtros de intents de URI específicos como controladores de app predeterminados para sus URI si se verifican correctamente, pero los demás filtros de URI candidatos no aprueban la verificación. Si la implementación de un dispositivo hace esto, DEBE proporcionar al usuario anulaciones de patrones por URI apropiadas en el menú de configuración.
- DEBE proporcionar al usuario controles de App Links por app en Configuración de la siguiente manera:
- [C-0-6] El usuario DEBE ser capaz de anular de forma integral el comportamiento predeterminado de los vínculos de aplicaciones para que una aplicación sea siempre abierta, siempre preguntar o nunca abierta, lo que debe aplicarse a todos los filtros de intents de URI candidatos por igual.
- [C-0-7] El usuario DEBE poder ver una lista de los filtros de intents de URI candidatos.
- La implementación del dispositivo PUEDE brindar al usuario la capacidad de anular filtros de intents de URI candidatos específicos que se verificaron correctamente, en función del filtro de intents.
- [C-0-8] La implementación del dispositivo DEBE permitir que los usuarios vean y anulen filtros de intents de URI candidatos específicos si la implementación del dispositivo permite que algunos filtros candidatos de intents de URI tengan éxito en la verificación, mientras que otros pueden fallar.
3.2.3.3 Espacios de nombres de intents
- [C-0-1] Las implementaciones del dispositivo NO DEBEN incluir ningún componente de Android que respete un intent nuevo o patrón de intent de transmisión mediante ACTION, CATEGORY, o bien otra cadena de claves en Android. or com.android..
- [C-0-2] Los implementadores de dispositivos NO DEBEN incluir ningún componente de Android que respete un intent nuevo o patrón de intent de transmisión mediante ACTION, CATEGORY, o bien otra cadena de claves en un espacio de paquete que pertenezca a otra organización.
- [C-0-3] Los implementadores de dispositivos NO DEBEN alterar ni extender ninguno de los patrones de intents que se enumeran en la sección 3.2.3.1.
- Las implementaciones de dispositivos PUEDEN incluir patrones de intents que usen espacios de nombres asociados de forma clara y evidente con su propia organización. Esta prohibición es análoga a la especificada para las clases de lenguaje Java en la sección 3.6.
3.2.3.4. Intents de transmisión
Las aplicaciones de terceros dependen de la plataforma para transmitir ciertos intents con el fin de notificarles cambios en el entorno de hardware o software.
Implementaciones en dispositivos:
- [C-0-1] DEBE transmitir los intents de transmisión pública enumerados aquí en respuesta a los eventos del sistema adecuados, como se describe en la documentación del SDK. Ten en cuenta que este requisito no entra en conflicto con la sección 3.5, ya que las limitaciones para las aplicaciones en segundo plano también se describen en la documentación del SDK. Además, ciertos intents de transmisión son condicionales a la compatibilidad de hardware. Si el dispositivo admite el hardware necesario, DEBEN transmitir los intents y proporcionar el comportamiento de acuerdo con la documentación del SDK.
3.2.3.5 Intents de aplicaciones condicionales
Android incluye parámetros de configuración que les permiten a los usuarios seleccionar fácilmente sus aplicaciones predeterminadas, por ejemplo, para la pantalla principal o los SMS.
Cuando tenga sentido, las implementaciones de dispositivos DEBEN proporcionar un menú de configuración similar y ser compatibles con el patrón de filtro de intents y los métodos de la API descritos en la documentación del SDK, como se muestra a continuación.
Si las implementaciones de dispositivos informan android.software.home_screen
, sucederá lo siguiente:
- [C-1-1] DEBE respetar el intent
android.settings.HOME_SETTINGS
para mostrar un menú de configuración predeterminado de la app para la pantalla principal.
Si las implementaciones de dispositivos informan android.hardware.telephony
, sucederá lo siguiente:
-
[C-2-1] DEBE proporcionar un menú de configuración que llame al intent
android.provider.Telephony.ACTION_CHANGE_DEFAULT
para mostrar un diálogo que cambie la aplicación de SMS predeterminada. -
[C-2-2] DEBE respetar el intent
android.telecom.action.CHANGE_DEFAULT_DIALER
para mostrar un diálogo que permita al usuario cambiar la aplicación de teléfono predeterminada.- DEBE usar la IU de la app de Teléfono predeterminada seleccionada por el usuario para llamadas entrantes y salientes, excepto para llamadas de emergencia, que usarían la app de Teléfono preinstalada.
-
[C-2-3] DEBE respetar el intent android.telecom.action.CHANGE_PHONE_ACCOUNTS para proporcionar al usuario la opción de configurar la
ConnectionServices
asociada conPhoneAccounts
, así como una PhoneAccount predeterminada que el proveedor de servicios de telecomunicaciones usará para realizar llamadas salientes. La implementación de AOSP cumple con este requisito, ya que incluye la opción "Llamar a cuentas" dentro de la sección "Llamadas" desde el menú de configuración. -
[C-2-4] DEBE permitir
android.telecom.CallRedirectionService
para una app que contiene el rolandroid.app.role.CALL_REDIRECTION
. - [C-2-5] DEBE proporcionar al usuario la posibilidad de elegir una app que contenga el rol de
android.app.role.CALL_REDIRECTION
. - [C-2-6] DEBE respetar los intents android.intent.action.SENDTO y android.intent.action.VIEW y proporcionar una actividad para enviar o mostrar mensajes SMS.
- [C-SR] Se recomienda especialmente para respetar android.intent.action.ANSWER, android.intent.action.CALL, android.intent.action.CALL_BUTTON, android.intent.action.VIEW y intents android.intent.action.DIAL con una aplicación de teléfono precargada que puede controlar estos intents y proporcionar entregas como se describe en el SDK.
Si las implementaciones de dispositivos informan android.hardware.nfc.hce
, sucederá lo siguiente:
- [C-3-1] DEBE respetar el intent android.settings.NFC_PAYMENT_CONFIGURACIÓN de mostrar un menú de configuración predeterminado de la app para pagos sin contacto.
- [C-3-2] DEBE respetar el intent android.nfc.cardemulation.action.ACTION_CHANGE_DEFAULT para mostrar una actividad que abra un diálogo en el que se le pida al usuario que cambie el servicio de emulación de tarjeta predeterminado para una categoría determinada, tal como se describe en el SDK.
Si las implementaciones de dispositivos informan android.hardware.nfc
, sucederá lo siguiente:
- [C-4-1] DEBE respetar estos intents android.nfc.action.NDEF_DISCOVERED, android.nfc.action.TAG_DISCOVERED y android.nfc.action.TECH_DISCOVERED, para mostrar una actividad que cumpla con las expectativas de los desarrolladores en relación con estos intents, como se describe en el SDK.
Si las implementaciones de dispositivos admiten VoiceInteractionService
y tienen más de una aplicación que usa esta API instalada a la vez, sucederá lo siguiente:
- [C-4-1] DEBE respetar el intent
android.settings.ACTION_VOICE_INPUT_SETTINGS
para mostrar un menú de configuración predeterminado de la app para la entrada de voz y la asistencia.
Si las implementaciones de dispositivos informan android.hardware.bluetooth
, sucederá lo siguiente:
- [C-5-1] DEBE respetar el intent 'android.bluetooth.adapter.action.REQUEST_ENABLE' y mostrar una actividad del sistema para permitir que el usuario active el Bluetooth.
- [C-5-2] DEBE respetar el intent "android.bluetooth.adapter.action.REQUEST_DISCOVERABLE" y mostrar una actividad del sistema que solicite el modo detectable.
Si las implementaciones de dispositivos admiten la función de No interrumpir, sucederá lo siguiente:
- [C-6-1] DEBE implementar una actividad que responda al intent
ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS
, que, para las implementaciones con UI_MODE_TYPE_NORMAL, DEBE ser una actividad en la que el usuario pueda otorgar o denegar a la app el acceso a configuraciones de políticas de DND.
Si las implementaciones en dispositivos permiten que los usuarios usen métodos de entrada de terceros en el dispositivo, sucederá lo siguiente:
- [C-7-1] DEBE proporcionar un mecanismo accesible para el usuario a fin de agregar y configurar métodos de entrada de terceros en respuesta al intent
android.settings.INPUT_METHOD_SETTINGS
.
Si las implementaciones de dispositivos admiten servicios de accesibilidad de terceros, sucederá lo siguiente:
- El [C-8-1] DEBE respetar el intent
android.settings.ACCESSIBILITY_SETTINGS
para proporcionar un mecanismo accesible para el usuario que permita habilitar o inhabilitar los servicios de accesibilidad de terceros junto con los servicios de accesibilidad precargados.
Si las implementaciones de dispositivos incluyen compatibilidad con Wi-Fi Easy Connect y exponen la funcionalidad a apps de terceros, harán lo siguiente:
- [C-9-1] DEBE implementar las APIs de intent Settings#ACTION_PROCESS_WIFI_EASY_CONNECT_URI, como se describe en la documentación del SDK.
Si las implementaciones de dispositivos proporcionan el modo de Ahorro de datos, estas: * [C-10-1] DEBEN proporcionar una interfaz de usuario en la configuración que maneje el intent Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS
y permita a los usuarios agregar aplicaciones a la lista de entidades permitidas o quitarlas de ella.
Si las implementaciones de dispositivos no proporcionan el modo de Ahorro de datos, sucederá lo siguiente:
- [C-11-1] DEBE tener una actividad que controle el intent
Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS
, pero PUEDE implementarla como una no-op.
Si las implementaciones de dispositivos declaran la compatibilidad con la cámara a través de android.hardware.camera.any
, harán lo siguiente:
- [C-12-1] DEBE respetar los intents
android.media.action.STILL_IMAGE_CAMERA
yandroid.media.action.STILL_IMAGE_CAMERA_SECURE
, e iniciar la cámara en modo de imagen estática como se describe en el SDK. - [C-12-2] DEBE respetar el intent
android.media.action.VIDEO_CAMERA
para iniciar la cámara en modo de video, como se describe en el SDK. - [C-12-3] DEBE respetar solo la posibilidad de que las aplicaciones para Android preinstaladas controlen los siguientes intents:
MediaStore.ACTION_IMAGE_CAPTURE
,MediaStore.ACTION_IMAGE_CAPTURE_SECURE
yMediaStore.ACTION_VIDEO_CAPTURE
, como se describe en el documento SDK.
Si las implementaciones de dispositivos informan android.software.device_admin
, sucederá lo siguiente:
-
[C-13-1] DEBE respetar el intent
android.app.action.ADD_DEVICE_ADMIN
de invocar una IU para que el usuario agregue al administrador del dispositivo al sistema (o le permita rechazarlo). -
[C-13-2] DEBE respetar los intents android.app.action.ADMIN_POLICY_COMPLIANCE, android.app.action.GET_PROVISIONING_MODE, android.app.action.PROVISIONING_SUCCESSFUL, android.app.action.PROVISION_MANAGED_DEVICE, android.app.action.PROVISION_MANAGED_PROFILE}.NEW_app.action.PROVISION_MANAGED_PROFILE}{NEW_app.profile. android.app.action.START_ENCRYPTION y tienen una actividad que proporcione entregas para estos intents, como se describe en el SDK aquí.
Si las implementaciones de dispositivos declaran la marca de función android.software.autofill
, sucederá lo siguiente:
- [C-14-1] DEBE implementar por completo las APIs de
AutofillService
yAutofillManager
, y respetar el intent android.settings.REQUEST_SET_AUTOFILL_SERVICE de mostrar un menú de configuración predeterminado de la app para habilitar e inhabilitar la función Autocompletar y cambiar el servicio de autocompletado predeterminado para el usuario.
Si las implementaciones de dispositivos incluyen una app preinstalada o desean permitir que apps de terceros accedan a las estadísticas de uso, deben hacer lo siguiente:
- [C-SR] SE RECOMIENDA ESTAR EN FUNDAMENTO, que proporcionan un mecanismo accesible para el usuario que otorgue o revoque el acceso a las estadísticas de uso en respuesta al intent android.settings.ACTION_USAGE_ACCESS_CONFIGURACIÓN para las apps que declaran el permiso
android.permission.PACKAGE_USAGE_STATS
.
Si las implementaciones de dispositivos impiden que alguna app, incluidas las preinstaladas, acceda a las estadísticas de uso, hará lo siguiente:
- [C-15-1] DEBE tener una actividad que controle el patrón de intent android.settings.ACTION_USAGE_ACCESS_CONFIGURACIÓN, pero DEBE implementarla como una no-op, de modo que tenga un comportamiento equivalente a cuando el usuario rechaza el acceso.
Si las implementaciones de dispositivos informan la función android.hardware.audio.output
, sucederá lo siguiente:
- [C-SR] Se recomienda especialmente para respetar android.intent.action.TTS_SERVICE, android.speech.tts.engine.INSTALL_TTS_DATA y Los intents android.speech.tts.engine.GET_SAMPLE_TEXT tienen una actividad para proporcionar entregas a estos intents, como se describe en el SDK aquí.
Android admite protectores de pantalla interactivos, conocidos anteriormente como Sueños. Los protectores de pantalla permiten a los usuarios interactuar con aplicaciones cuando un dispositivo conectado a una fuente de alimentación está inactivo o en un conector para escritorio. Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con protectores de pantalla y proporcionar una opción de configuración para que los usuarios los configuren en respuesta al intent
android.settings.DREAM_SETTINGS
.
3.2.4. Actividades en pantallas secundarias o múltiples
Si las implementaciones en dispositivos permiten iniciar actividades de Android normales en más de una pantalla, sucederá lo siguiente:
- [C-1-1] SE DEBE establecer la marca de función
android.software.activities_on_secondary_displays
. - [C-1-2] DEBE garantizar la compatibilidad de la API de manera similar a una actividad que se ejecuta en la pantalla principal.
- [C-1-3] DEBE colocar la actividad nueva en la misma pantalla que la actividad que la inició, cuando la actividad nueva se lanza sin especificar una pantalla de destino a través de la API de
ActivityOptions.setLaunchDisplayId()
. - [C-1-4] SE DEBE destruir todas las actividades cuando se quita una pantalla con la marca
Display.FLAG_PRIVATE
. - [C-1-5] DEBE ocultar de manera segura el contenido en todas las pantallas cuando el dispositivo está bloqueado con una pantalla de bloqueo segura, a menos que la app acepte aparecer en la parte superior de la pantalla de bloqueo con la API de
Activity#setShowWhenLocked()
. - SE RECOMIENDA tener
android.content.res.Configuration
, que corresponda a esa pantalla, para que se muestre, funcione correctamente y mantenga la compatibilidad si se inicia una actividad en una pantalla secundaria.
Si las implementaciones de dispositivos permiten iniciar actividades de Android normales en pantallas secundarias y una pantalla secundaria tiene la marca android.view.Display.FLAG_PRIVATE:
- [C-3-1] Solo el propietario de esa pantalla, sistema y actividades que ya están en esa pantalla DEBE poder iniciarlos. Todos pueden abrir una pantalla que tenga la marca android.view.Display.FLAG_PUBLIC.
3.3. Compatibilidad con APIs nativas
La compatibilidad de código nativo es un desafío. Por este motivo, los implementadores de dispositivos son los siguientes:
- [SR] SE RECOMIENDA ENERGMENTE usar las implementaciones de las bibliotecas que se indican a continuación del proyecto ascendente de código abierto de Android.
3.3.1. Interfaces binarias de la aplicación
El código de bytes Dalvik administrado puede llamar al código nativo proporcionado en el archivo .apk
de la aplicación como un archivo .so
ELF compilado para la arquitectura de hardware del dispositivo correspondiente. Como el código nativo depende en gran medida de la tecnología de procesador subyacente, Android define varias interfaces binarias de la aplicación (ABI) en el NDK de Android.
Implementaciones en dispositivos:
- [C-0-1] DEBE ser compatible con una o más ABI del NDK de Android definidas.
- [C-0-2] DEBE incluir compatibilidad con código que se ejecuta en el entorno administrado para llamar al código nativo, a través de la semántica estándar de la interfaz nativa de Java (JNI).
- [C-0-3] DEBE ser compatible con la fuente (es decir, con el encabezado) y con el formato binario (para la ABI) con cada biblioteca obligatoria de la siguiente lista.
- [C-0-5] DEBE informar con precisión la interfaz binaria de la aplicación (ABI) nativa compatible con el dispositivo, a través de los parámetros
android.os.Build.SUPPORTED_ABIS
,android.os.Build.SUPPORTED_32_BIT_ABIS
yandroid.os.Build.SUPPORTED_64_BIT_ABIS
, cada uno de los cuales es una lista separada por comas de ABI ordenadas de la más a la menos preferida. -
[C-0-6] DEBE informar, a través de los parámetros anteriores, un subconjunto de la siguiente lista de ABI y NO DEBE informar ninguna ABI que no esté en la lista.
-
armeabi
(ya no se admite como destino en el NDK) -
armeabi-v7a
-
arm64-v8a
-
x86
-
x86-64
-
-
[C-0-7] DEBE hacer que todas las siguientes bibliotecas, que proporcionan APIs nativas, estén disponibles para las apps que incluyen código nativo:
- libaaudio.so (compatibilidad con audio nativo de AAudio)
- libamidi.so (compatibilidad nativa con MIDI, si se reclama la función
android.software.midi
según se describe en la sección 5.9) - libandroid.so (compatibilidad con actividades nativas de Android)
- libc (biblioteca C)
- libcamera2ndk.so
- libdl (vinculador dinámico)
- libEGL.so (administración de superficie nativa de OpenGL)
- libGLESv1_CM.so (OpenGL ES 1.x)
- libGLESv2.so (OpenGL ES 2.0)
- libGLESv3.so (OpenGL ES 3.x)
- libicui18n.so
- libicuuc.so
- libjnigraphics.so
- liblog (registro de Android)
- libmediandk.so (compatibilidad con APIs de medios nativos)
- libm (biblioteca de matemáticas)
- libneuralnetworks.so (API de redes neuronales)
- libOpenMAXAL.so (compatibilidad con OpenMAX AL 1.0.1)
- libOpenSLES.so (compatibilidad con audio de OpenSL ES 1.0.1)
- libRS.so
- libstdc++ (compatibilidad mínima con C++)
- libvulkan.so (Vulkan)
- libz (compresión Zlib)
- Interfaz JNI
-
[C-0-8] NO DEBE agregar ni quitar las funciones públicas para las bibliotecas nativas enumeradas anteriormente.
- [C-0-9] DEBE enumerar otras bibliotecas que no sean del AOSP expuestas directamente a apps de terceros en
/vendor/etc/public.libraries.txt
. - [C-0-10] NO DEBE exponer ninguna otra biblioteca nativa, implementada y proporcionada en AOSP como bibliotecas del sistema, a apps de terceros que se orienten al nivel de API 24 o versiones posteriores, ya que están reservadas.
- [C-0-11] SE DEBE exportar todos los símbolos de función OpenGL ES 3.1 y Android Extension Pack, como se define en el NDK, a través de la biblioteca
libGLESv3.so
. Ten en cuenta que, si bien todos los símbolos DEBEN estar presentes, en la sección 7.1.4.1 se describen en más detalle los requisitos para cuando se espere la implementación completa de las funciones correspondientes. - [C-0-12] SE DEBE exportar símbolos de funciones para los símbolos principales de la función Vulkan 1.0, así como las extensiones
VK_KHR_surface
,VK_KHR_android_surface
,VK_KHR_swapchain
,VK_KHR_maintenance1
yVK_KHR_get_physical_device_properties2
a través de la bibliotecalibvulkan.so
. Ten en cuenta que, si bien todos los símbolos DEBEN estar presentes, en la sección 7.1.4.2 se describen en más detalle los requisitos para cuando se espere la implementación completa de las funciones correspondientes. - SE DEBE compilar con el código fuente y los archivos de encabezado disponibles en el Proyecto de código abierto de Android ascendente.
Ten en cuenta que las versiones futuras de Android podrían incorporar compatibilidad con ABI adicionales.
3.3.2. Compatibilidad con código nativo ARM de 32 bits
Si las implementaciones de dispositivos informan la compatibilidad de la ABI armeabi
, harán lo siguiente:
- [C-3-1] también DEBE admitir
armeabi-v7a
e informar su compatibilidad, ya quearmeabi
solo es compatible con versiones anteriores de apps más antiguas.
Si las implementaciones de dispositivos informan la compatibilidad de la ABI armeabi-v7a
, en el caso de las apps que usan esta ABI, sucederá lo siguiente:
-
[C-2-1] DEBE incluir las siguientes líneas en
/proc/cpuinfo
, y NO DEBERÍA alterar los valores en el mismo dispositivo, incluso cuando los leen otras ABI.-
Features:
, seguido de una lista de las funciones opcionales de CPU ARMv7 compatibles con el dispositivo. -
CPU architecture:
, seguido de un valor entero que describe la arquitectura ARM compatible más alta del dispositivo (p.ej., “8” para dispositivos ARMv8).
-
-
[C-2-2] siempre DEBE tener las siguientes operaciones disponibles, incluso en el caso de que la ABI se implemente en una arquitectura ARMv8, ya sea a través de la compatibilidad de CPU nativa o de emulación de software:
- Instrucciones SWP y SWPB
- SETEND.
- operaciones de barrera CP15ISB, CP15DSB y CP15DMB.
-
[C-2-3] DEBE incluir compatibilidad con la extensión Advanced SIMD (también conocida como NEON).
3.4. Compatibilidad con la Web
3.4.1. Compatibilidad con WebView
Si las implementaciones en dispositivos proporcionan una implementación completa de la API de android.webkit.Webview
, harán lo siguiente:
- [C-1-1] DEBE informar
android.software.webview
. - [C-1-2] DEBE usar la compilación del proyecto Chromium del Proyecto de código abierto de Android ascendente en la rama de Android 11 para implementar la API de
android.webkit.WebView
. -
[C-1-3] La cadena de usuario-agente informada por WebView DEBE tener el siguiente formato:
Mozilla/5.0 (Linux; Android $(VERSION); [$(MODEL)] [Build/$(BUILD)]; wv) AppleWebKit/537.36 (KHTML, como Gecko) Versión/4.0 $(CHROMIUM_VER) Mobile Safari/537.36
- El valor de la cadena $(VERSION) DEBE ser el mismo que el de android.os.Build.VERSION.release.
- La cadena $(MODEL) PUEDE estar vacía, pero, de lo contrario, DEBE tener el mismo valor que android.os.Build.MODEL.
- "Compilación/$(CREACIÓN)" PUEDE omitirse, pero si está presente, la cadena $(BUILD) DEBE ser el mismo que el valor de android.os.Build.ID.
- El valor de la cadena $(CHROMIUM_VER) DEBE ser la versión de Chromium en el proyecto de código abierto de Android ascendente.
- Las implementaciones de dispositivos PUEDEN omitir a dispositivos móviles en la string del usuario-agente.
-
El componente de WebView DEBE incluir compatibilidad con la mayor cantidad posible de funciones HTML5. Si es compatible, DEBE cumplir con la especificación de HTML5.
-
[C-1-3] DEBE representar el contenido proporcionado o el contenido URL remoto en un proceso distinto de la aplicación que crea una instancia de WebView. Específicamente, el proceso del renderizador independiente DEBE tener un privilegio inferior, ejecutarse como un ID de usuario independiente, no tener acceso al directorio de datos de la app, no tener acceso directo a la red y solo tener acceso a los servicios del sistema mínimos requeridos a través de Binder. La implementación de WebView del AOSP cumple con este requisito.
Ten en cuenta que, si las implementaciones en dispositivos son de 32 bits o declaran la marca de función android.hardware.ram.low
, estarán exentas de C-1-3.
3.4.2. Compatibilidad del navegador
Si las implementaciones en dispositivos incluyen una aplicación de navegador independiente para la navegación web general, sucederá lo siguiente:
- [C-1-1] DEBE ser compatible con cada una de estas APIs asociadas con HTML5:
- [C-1-2] DEBE admitir la API de Webstorage HTML5/W3C, y DEBE admitir la API de IndexedDB de HTML5/W3C. Ten en cuenta que, a medida que los organismos de estándares de desarrollo web hacen la transición para favorecer a IndexedDB sobre el almacenamiento web, se espera que IndexedDB se convierta en un componente obligatorio en una versión futura de Android.
- PUEDE enviar una cadena de usuario-agente personalizada a la aplicación independiente del navegador.
- SE DEBE implementar la compatibilidad con la mayor cantidad de archivos HTML5 posible en la aplicación de navegador independiente (ya sea basada en la aplicación ascendente del navegador WebKit o en un reemplazo de terceros).
Sin embargo, si las implementaciones en dispositivos no incluyen una aplicación de navegador independiente, sucederá lo siguiente:
- [C-2-1] DEBE admitir los patrones de intents públicos, como se describe en la sección 3.2.3.1.
3.5 Compatibilidad de comportamiento de las APIs
Implementaciones en dispositivos:
- [C-0-9] DEBE garantizar que se aplique la compatibilidad del comportamiento de la API para todas las apps instaladas, a menos que estén restringidas como se describe en la Sección 3.5.1.
- [C-0-10] NO DEBE implementar el enfoque de lista de entidades permitidas que garantiza la compatibilidad del comportamiento de la API solo para las apps seleccionadas por implementadores de dispositivos.
Los comportamientos de cada uno de los tipos de API (administradas, de software, nativas y web) deben ser coherentes con la implementación preferida del Proyecto de código abierto de Android ascendente. Estas son algunas áreas específicas de compatibilidad:
- [C-0-1] Los dispositivos NO DEBEN cambiar el comportamiento ni la semántica de un intent estándar.
- [C-0-2] Los dispositivos NO DEBEN alterar el ciclo de vida ni la semántica del ciclo de vida de un tipo particular de componente del sistema (como Service, Activity, ContentProvider, etcétera).
- [C-0-3] Los dispositivos NO DEBEN cambiar la semántica de un permiso estándar.
- Los dispositivos NO DEBEN alterar las limitaciones que se aplican a las aplicaciones en segundo plano. Más específicamente, para las aplicaciones en segundo plano:
- [C-0-4] DEBEN dejar de ejecutar devoluciones de llamada registradas por la app para recibir resultados de
GnssMeasurement
yGnssNavigationMessage
. - [C-0-5] DEBEN limitar la frecuencia de las actualizaciones que se proporcionan a la app a través de la clase de API
LocationManager
o el métodoWifiManager.startScan()
. - [C-0-6] Si la app tiene como objetivo un nivel de API 25 o superior, NO DEBEN permitir el registro de receptores de emisión para las transmisiones implícitas de intents estándar de Android en el manifiesto de la app, a menos que el intent de transmisión requiera un permiso
"signature"
o"signatureOrSystem"
protectionLevel
o estén incluidos en la lista de exenciones. - [C-0-7] Si la app se orienta al nivel de API 25 o superior, DEBEN detener los servicios en segundo plano, como si esta hubiera llamado al método
stopSelf()
de los servicios, a menos que se encuentre en una lista de entidades permitidas temporal para controlar una tarea que el usuario pueda ver. - [C-0-8] si la app tiene como objetivo un nivel de API 25 o superior, se DEBEN liberar los bloqueos de activación que contiene.
- [C-0-4] DEBEN dejar de ejecutar devoluciones de llamada registradas por la app para recibir resultados de
- [C-0-9] Los dispositivos DEBEN mostrar los siguientes proveedores de seguridad como los primeros siete valores de array del método
Security.getProviders()
, en el orden indicado y con los nombres (como los devuelveProvider.getName()
) y las clases, a menos que la app haya modificado la lista a través deinsertProviderAt()
oremoveProvider()
. ES POSIBLE que los dispositivos devuelvan proveedores adicionales después de la lista de proveedores especificada a continuación.-
AndroidNSSP:
android.security.net.config.NetworkSecurityConfigProvider
-
AndroidOpenSSL:
com.android.org.conscrypt.OpenSSLProvider
-
CertPathProvider:
sun.security.provider.CertPathProvider
-
AndroidKeyStoreBCMétodo alternativo:
android.security.keystore.AndroidKeyStoreBCWorkaroundProvider
-
BC:
com.android.org.bouncycastle.jce.provider.BouncyCastleProvider
-
HarmonyJSSE:
com.android.org.conscrypt.JSSEProvider
-
AndroidKeyStore:
android.security.keystore.AndroidKeyStoreProvider
-
AndroidNSSP:
La lista anterior no es exhaustiva. El Conjunto de pruebas de compatibilidad (CTS) prueba la compatibilidad de comportamiento en partes significativas de la plataforma, pero no en todas. El implementador es responsable de garantizar la compatibilidad del comportamiento con el Proyecto de código abierto de Android. Por este motivo, los implementadores de dispositivos DEBEN usar el código fuente disponible a través del Proyecto de código abierto de Android siempre que sea posible, en lugar de volver a implementar partes significativas del sistema.
3.5.1. Restricción de aplicaciones
Si las implementaciones de dispositivos implementan un mecanismo de propiedad exclusiva para restringir apps y ese mecanismo es más restrictivo que el intervalo de App Standby poco frecuente, sucederá lo siguiente:
- [C-1-1] DEBE proporcionar la indicación visual del usuario en la que este pueda ver la lista de apps restringidas.
- [C-1-2] DEBE proporcionar al usuario la posibilidad de activar o desactivar las restricciones en cada app.
- [C-1-3] no DEBE aplicar restricciones automáticamente sin evidencia de un comportamiento deficiente en el estado del sistema, pero PUEDE aplicar las restricciones en las apps al detectar un comportamiento deficiente en el estado del sistema, como bloqueos de activación sostenidos, servicios de larga duración y otros criterios. Los implementadores de dispositivos PUEDEN determinar los criterios, pero DEBEN estar relacionados con el impacto de la app en el estado del sistema. Otros criterios que no están puramente relacionados con el estado del sistema, como la falta de popularidad de la aplicación en el mercado, NO DEBEN usarse como criterios.
- [C-1-4] NO DEBE aplicar automáticamente restricciones de apps para las apps cuando un usuario las desactivó manualmente, y PUEDE sugerirle que las aplique.
- [C-1-5] DEBE informar a los usuarios si se aplican restricciones de apps a una app automáticamente. Dicha información DEBE proporcionarse en un plazo de 24 horas a partir del momento en que se aplican las restricciones.
- [C-1-6] DEBE mostrar
true
paraActivityManager.isBackgroundRestricted()
cuando la app restringida llame a esta API. - [C-1-7] NO DEBE restringir la aplicación en primer plano superior que el usuario utiliza explícitamente.
- [C-1-8] SE DEBE suspender las restricciones de una aplicación que se convierte en la aplicación principal en primer plano cuando el usuario comienza a utilizar explícitamente la aplicación que solía estar restringida.
3.6 Espacios de nombres de API
Android sigue las convenciones de espacio de nombres de paquetes y clases definidas por el lenguaje de programación Java. Para garantizar la compatibilidad con aplicaciones de terceros, los implementadores de dispositivos NO DEBEN realizar modificaciones prohibidas (consulta a continuación) a estos espacios de nombres de paquetes:
-
java.*
-
javax.*
-
sun.*
-
android.*
-
androidx.*
-
com.android.*
Es decir, ellos hacen lo siguiente:
- [C-0-1] NO DEBE modificar las APIs expuestas públicamente en la plataforma de Android cambiando ningún método o firma de clases, o quitando clases o campos de clases.
- [C-0-2] NO DEBE agregar ningún elemento expuesto públicamente (como clases o interfaces, o campos o métodos a clases o interfaces existentes) ni APIs de prueba o del sistema a las APIs en los espacios de nombres anteriores. Un "elemento expuesto públicamente" es cualquier construcción que no esté decorada con el marcador "@hide" como se utiliza en el código fuente ascendente de Android.
Los implementadores de dispositivos PUEDEN modificar la implementación subyacente de las APIs, pero estas modificaciones:
- [C-0-3] NO DEBE afectar el comportamiento indicado y la firma en lenguaje Java de ninguna API expuesta públicamente.
- [C-0-4] NO DEBE anunciarse ni exponerse de ninguna otra manera a los desarrolladores.
Sin embargo, los implementadores de dispositivos PUEDEN agregar APIs personalizadas fuera del espacio de nombres estándar de Android, pero las APIs personalizadas:
- [C-0-5] NO DEBE estar en un espacio de nombres que pertenezca a otra organización o haga referencia a otra. Por ejemplo, los implementadores de dispositivos NO DEBEN agregar APIs al espacio de nombres
com.google.*
o uno similar: solo Google puede hacerlo. Del mismo modo, Google NO DEBE agregar APIs a las aplicaciones los espacios de nombres. - [C-0-6] SE DEBE empaquetar en una biblioteca compartida de Android para que solo las apps que los usan explícitamente (a través del mecanismo <uses-library>) se vean afectadas por el aumento en el uso de memoria de esas APIs.
Si un implementador de dispositivos propone mejorar uno de los espacios de nombres de paquetes anteriores (por ejemplo, agregando funciones nuevas útiles a una API existente o agregando una API nueva), el implementador DEBE visitar source.android.com y comenzar el proceso para contribuir con cambios y código, según la información de ese sitio.
Ten en cuenta que las restricciones anteriores corresponden a las convenciones estándar para asignar nombres a APIs en el lenguaje de programación Java. el objetivo de esta sección simplemente es reforzar esas convenciones y hacerlas vinculantes a través de la inclusión en esta definición de compatibilidad.
3.7 Compatibilidad del entorno de ejecución
Implementaciones en dispositivos:
-
[C-0-1] DEBE admitir el formato Dalvik Executable (DEX) completo y la especificación y semántica del código de bytes Dalvik.
-
[C-0-2] SE DEBE configurar los tiempos de ejecución de Dalvik para asignar memoria de acuerdo con la plataforma Android ascendente, y como se especifica en la siguiente tabla. (Consulta la sección 7.1.1 para conocer las definiciones de tamaño y densidad de pantalla).
-
SE DEBE usar Android RunTime (ART), la implementación ascendente de referencia del formato ejecutable Dalvik, y el sistema de administración de paquetes de la implementación de referencia.
-
SE RECOMIENDA realizar pruebas de Fuzz en varios modos de ejecución y arquitecturas de destino para garantizar la estabilidad del tiempo de ejecución. Consulta JFuzz y DexFuzz en el sitio web del Proyecto de código abierto de Android.
Ten en cuenta que los valores de memoria especificados a continuación se consideran valores mínimos y las implementaciones en dispositivos PUEDEN asignar más memoria por aplicación.
Diseño de pantalla | Densidad de la pantalla | Memoria mínima de la aplicación |
---|---|---|
Reloj Android | 120 DPI (ldpi) | 32MB |
140 dpi (140dpi) | ||
160 dpi (mdpi) | ||
180 dpi (180dpi) | ||
200 dpi (200dpi) | ||
213 dpi (tvdpi) | ||
220 dpi (220dpi) | 36MB | |
240 dpi (hdpi) | ||
280 DPI (280 DPI) | ||
320 dpi (xhdpi) | 48MB | |
360 dpi (360dpi) | ||
400 dpi (400dpi) | 56MB | |
420 DPI (420 DPI) | 64MB | |
480 dpi (xxhdpi) | 88MB | |
560 dpi (560dpi) | 112MB | |
640 dpi (xxxhdpi) | 154MB | |
pequeño/normal | 120 DPI (ldpi) | 32MB |
140 dpi (140dpi) | ||
160 dpi (mdpi) | ||
180 dpi (180dpi) | 48MB | |
200 dpi (200dpi) | ||
213 dpi (tvdpi) | ||
220 dpi (220dpi) | ||
240 dpi (hdpi) | ||
280 DPI (280 DPI) | ||
320 dpi (xhdpi) | 80MB | |
360 dpi (360dpi) | ||
400 dpi (400dpi) | 96MB | |
420 DPI (420 DPI) | 112MB | |
480 dpi (xxhdpi) | 128MB | |
560 dpi (560dpi) | 192MB | |
640 dpi (xxxhdpi) | 256MB | |
Grande | 120 DPI (ldpi) | 32MB |
140 dpi (140dpi) | 48MB | |
160 dpi (mdpi) | ||
180 dpi (180dpi) | 80MB | |
200 dpi (200dpi) | ||
213 dpi (tvdpi) | ||
220 dpi (220dpi) | ||
240 dpi (hdpi) | ||
280 DPI (280 DPI) | 96MB | |
320 dpi (xhdpi) | 128MB | |
360 dpi (360dpi) | 160MB | |
400 dpi (400dpi) | 192MB | |
420 DPI (420 DPI) | 228MB | |
480 dpi (xxhdpi) | 256MB | |
560 dpi (560dpi) | 384MB | |
640 dpi (xxxhdpi) | 512 MB | |
Extragrande | 120 DPI (ldpi) | 48MB |
140 dpi (140dpi) | 80MB | |
160 dpi (mdpi) | ||
180 dpi (180dpi) | 96MB | |
200 dpi (200dpi) | ||
213 dpi (tvdpi) | ||
220 dpi (220dpi) | ||
240 dpi (hdpi) | ||
280 DPI (280 DPI) | 144MB | |
320 dpi (xhdpi) | 192MB | |
360 dpi (360dpi) | 240MB | |
400 dpi (400dpi) | 288MB | |
420 DPI (420 DPI) | 336MB | |
480 dpi (xxhdpi) | 384MB | |
560 dpi (560dpi) | 576MB | |
640 dpi (xxxhdpi) | 768MB |
3.8. Compatibilidad con la interfaz de usuario
3.8.1. Selector (pantalla principal)
Android incluye una aplicación de selector (pantalla de inicio) y compatibilidad con aplicaciones de terceros para reemplazar el selector de dispositivos (pantalla de inicio).
Si las implementaciones de dispositivos permiten que aplicaciones de terceros reemplacen su pantalla principal:
- [C-1-1] SE DEBE declarar la función
android.software.home_screen
de la plataforma. - [C-1-2] DEBE mostrar el objeto
AdaptiveIconDrawable
cuando la aplicación de terceros usa la etiqueta<adaptive-icon>
para proporcionar su ícono y se llama a los métodosPackageManager
para recuperar íconos.
Si las implementaciones de dispositivos incluyen un selector predeterminado que admite la fijación de accesos directos en la app, sucederá lo siguiente:
- [C-2-1] DEBE informar
true
paraShortcutManager.isRequestPinShortcutSupported()
. - [C-2-2] DEBE tener la indicación visual del usuario antes de agregar un atajo solicitado por las apps a través del método de la API
ShortcutManager.requestPinShortcut()
. - [C-2-3] DEBE admitir accesos directos fijos y dinámicos y estáticos, como se documenta en la página Accesos directos a aplicaciones.
Por el contrario, si las implementaciones en dispositivos no admiten la fijación de accesos directos en la app, sucederá lo siguiente:
- [C-3-1] DEBE informar
false
paraShortcutManager.isRequestPinShortcutSupported()
.
Si las implementaciones de dispositivos implementan un selector predeterminado que proporciona acceso rápido a las combinaciones de teclas adicionales que proporcionan las apps de terceros a través de la API de shortManager, sucede lo siguiente:
- [C-4-1] DEBE admitir todas las funciones de atajos documentadas (p.ej., atajos estáticos y dinámicos, fijación de atajos) y de implementar completamente las APIs de la clase de API
ShortcutManager
.
Si las implementaciones de dispositivos incluyen una app de selector predeterminada que muestra insignias para los íconos de las apps, sucederá lo siguiente:
- [C-5-1] DEBE respetar el método de la API
NotificationChannel.setShowBadge()
. En otras palabras, muestra una indicación visual asociada con el ícono de la app si el valor se estableció comotrue
y no muestres ningún esquema de insignias del ícono de la app cuando todos los canales de notificaciones de la app tengan configurado el valor comofalse
. - PUEDE anular las insignias de los íconos de la app con su esquema de insignias propio cuando las aplicaciones de terceros indiquen compatibilidad con este esquema mediante el uso de APIs propias, pero DEBERÍA usar los recursos y valores proporcionados a través de las APIs de insignias de notificación descritas en el SDK , como
Notification.Builder.setNumber()
y la API deNotification.Builder.setBadgeIconType()
.
3.8.2. Widgets
Android admite widgets de apps de terceros definiendo un tipo de componente y la API y el ciclo de vida correspondientes que permiten que las aplicaciones expongan un "AppWidget" al usuario final.
Si las implementaciones de dispositivos admiten widgets de apps de terceros, sucederán lo siguiente:
- [C-1-1] DEBE declarar compatibilidad con la función
android.software.app_widgets
de la plataforma. - [C-1-2] DEBE incluir compatibilidad integrada con AppWidgets y exponer las posibilidades de la interfaz de usuario para agregar, configurar, ver y quitar AppWidgets directamente en el Selector.
- [C-1-3] DEBE ser capaz de renderizar widgets de 4 x 4 en el tamaño de cuadrícula estándar. Para obtener más información, consulta los Lineamientos de diseño de widgets de apps en la documentación del SDK de Android.
- PUEDE admitir widgets de apps en la pantalla de bloqueo.
Si las implementaciones de dispositivos admiten widgets de apps de terceros y la fijación de accesos directos en la app, sucederá lo siguiente:
- [C-2-1] DEBE informar
true
paraAppWidgetManager.html.isRequestPinAppWidgetSupported()
. - [C-2-2] DEBE tener la indicación visual del usuario antes de agregar un atajo solicitado por las apps a través del método de la API
AppWidgetManager.requestPinAppWidget()
.
3.8.3. Notificaciones
Android incluye APIs de Notification
y NotificationManager
que permiten a los desarrolladores de apps externos notificar a los usuarios sobre eventos notables y atraer a los usuarios atención mediante componentes de hardware (p.ej., sonido, vibración y luz) y funciones de software (p.ej., panel de notificaciones, barra del sistema) del dispositivo.
3.8.3.1. Presentación de notificaciones
Si las implementaciones en dispositivos permiten que apps de terceros notifiquen a los usuarios sobre eventos importantes, sucederá lo siguiente:
- [C-1-1] DEBE admitir notificaciones que usan funciones de hardware, como se describe en la documentación del SDK, y en la medida de lo posible con el hardware de implementación del dispositivo. Por ejemplo, si la implementación de un dispositivo incluye un vibrador, DEBE implementar correctamente las APIs de vibración. Si la implementación de un dispositivo no tiene hardware, las APIs correspondientes DEBEN implementarse como modalidad no-ops. Este comportamiento se detalla con más detalle en la sección 7.
- [C-1-2] DEBE procesar correctamente todos los recursos (íconos, archivos de animación, etc.) proporcionados en las APIs o en la guía de estilo de íconos de la barra de estado/sistema, aunque PUEDEN proporcionar una experiencia del usuario alternativa para las notificaciones que la que proporciona la implementación de código abierto de Android de referencia.
- [C-1-3] DEBE respetar e implementar correctamente los comportamientos descritos para las APIs para actualizar, quitar y agrupar las notificaciones.
- [C-1-4] DEBE proporcionar el comportamiento completo de la API de NotificationChannel documentado en el SDK.
- [C-1-5] DEBE proporcionar una indicación visual del usuario para bloquear y modificar la notificación de una app de terceros en cada canal y nivel de paquete de app.
- [C-1-6] también DEBE proporcionar una indicación visual del usuario para mostrar los canales de notificaciones borrados.
- [C-1-7] DEBE renderizar correctamente todos los recursos (imágenes, calcomanías, íconos, etc.) proporcionados a través de Notification.MessagingStyle junto con el texto de la notificación, sin interacción adicional del usuario. Por ejemplo, DEBE mostrar todos los recursos, incluidos los íconos proporcionados a través de android.app.Person en una conversación grupal que se configura a través de setGroupConversation.
- [C-SR] SE RECOMIENDA EXITOSAMENTE para mostrar automáticamente una indicación visual del usuario para bloquear la notificación de una app de terceros determinada por cada canal y nivel de paquete de app después de que el usuario descarta esa notificación varias veces.
- DEBE admitir notificaciones enriquecidas.
- Se DEBEN presentar algunas notificaciones de prioridad más alta como notificaciones de atención.
- SE RECOMIENDA tener una indicación visual del usuario para posponer las notificaciones.
- ES POSIBLE que solo administre la visibilidad y los horarios de las apps de terceros que notifiquen a los usuarios sobre eventos notables para mitigar problemas de seguridad, como la distracción del conductor.
Android 11 incorpora compatibilidad con notificaciones de conversación, que son notificaciones que usan MessagingStyle y proporcionan un ID de atajo de Personas publicado.
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENcarecidamente agrupar y mostrar
conversation notifications
antes de las notificaciones que no son de conversación, a excepción de las notificaciones continuas de servicio en primer plano y las notificaciones deimportance:high
.
Si las implementaciones de dispositivos admiten conversation notifications
y la app proporciona los datos necesarios para bubbles
, hará lo siguiente:
- [C-SR] SE RECOMIENDA ENcarecidamente mostrar esta conversación como una burbuja. La implementación del AOSP cumple estos requisitos con la IU del sistema, la configuración y el Selector predeterminados.
Si las implementaciones de dispositivos admiten notificaciones enriquecidas, sucederá lo siguiente:
- [C-2-1] SE DEBE usar los recursos exactos tal como se proporcionan a través de la clase de API
Notification.Style
y sus subclases para los elementos de recursos presentados. - SE DEBE presentar todos los elementos de recursos (p.ej., íconos, títulos y textos de resumen) definidos en la clase de API
Notification.Style
y sus subclases.
Si las implementaciones de dispositivos admiten notificaciones de atención:
- [C-3-1] DEBE usar la vista de notificaciones de atención y los recursos descritos en la clase de API de
Notification.Builder
cuando se presentan notificaciones de atención. - [C-3-2] DEBE mostrar las acciones proporcionadas a través de
Notification.Builder.addAction()
junto con el contenido de la notificación sin interacción adicional del usuario, como se describe en el SDK.
3.8.3.2. Servicio de escucha de notificaciones
Android incluye las APIs de NotificationListenerService
que permiten que las apps (una vez habilitadas de forma explícita por el usuario) reciban una copia de todas las notificaciones a medida que se publican o actualizan.
Implementaciones en dispositivos:
- [C-0-1] DEBE actualizar de manera correcta y oportuna las notificaciones en su totalidad para todos los servicios de escucha instalados y habilitados por el usuario, incluidos todos y cada uno de los metadatos adjuntos al objeto de notificación.
- [C-0-2] DEBE respetar la llamada a la API de
snoozeNotification()
, descartar la notificación y realizar una devolución de llamada después de la duración de la posposición establecida en la llamada a la API.
Si las implementaciones de dispositivos cuentan con la posibilidad de posponer notificaciones por parte del usuario, sucederá lo siguiente:
- [C-1-1] DEBE reflejar correctamente el estado de las notificaciones pospuestas mediante las APIs estándar, como
NotificationListenerService.getSnoozedNotifications()
. - [C-1-2] DEBE hacer que esta indicación visual del usuario esté disponible para posponer notificaciones de cada app de terceros instalada, a menos que sean de servicios persistentes o en primer plano.
3.8.3.3 No interrumpir (No interrumpir)
Si las implementaciones de dispositivos admiten la función de No interrumpir, sucederá lo siguiente:
- [C-1-1] DEBE, cuando la implementación del dispositivo haya proporcionado un medio para que el usuario otorgue o rechace que apps de terceros accedan a la configuración de la política de No interrumpir, se deben mostrar Reglas automáticas de No interrumpir creadas por las aplicaciones junto con las reglas creadas por el usuario y predefinidas.
- [C-1-3] DEBE respetar los valores de
suppressedVisualEffects
pasados enNotificationManager.Policy
y, si una app estableció alguna de las marcas SUPPRESSED_Effect_SCREEN_OFF o SUPPRESSED_Effect_SCREEN_ON, DEBE indicar al usuario que los efectos visuales se suprimen en el menú de configuración de No interrumpir.
3.8.4. Buscar
Android incluye API que permiten a los desarrolladores incorporar la búsqueda en sus aplicaciones y exponer los datos de estas en la búsqueda global del sistema. En términos generales, esta funcionalidad consiste en una única interfaz de usuario para todo el sistema que permite que los usuarios ingresen consultas, muestre sugerencias a medida que los usuarios escriban y muestre los resultados. Las API de Android permiten a los desarrolladores reutilizar esta interfaz para proporcionar búsquedas dentro de sus propias apps y proporcionar resultados a la interfaz de usuario de búsqueda global común.
- Las implementaciones en dispositivos Android DEBEN incluir búsqueda global, una interfaz de usuario de búsqueda única y compartida en todo el sistema que pueda realizar sugerencias en tiempo real en respuesta a las entradas del usuario.
Si las implementaciones en dispositivos implementan la interfaz de búsqueda global, sucederá lo siguiente:
- [C-1-1] SE DEBE implementar las APIs que permiten a las aplicaciones de terceros agregar sugerencias al cuadro de búsqueda cuando se ejecuta en modo de búsqueda global.
Si no hay aplicaciones de terceros instaladas que usen la búsqueda global:
- El comportamiento predeterminado DEBE mostrar resultados y sugerencias del motor de búsqueda web.
Android también incluye las APIs de Assist para permitir que las aplicaciones elijan cuánta información del contexto actual se comparte con el Asistente en el dispositivo.
Si las implementaciones de dispositivos admiten la acción de asistencia, harán lo siguiente:
- [C-2-1] DEBE indicar claramente al usuario final cuando se comparte el contexto de alguna de las siguientes maneras:
- Cada vez que la aplicación de asistencia accede al contexto, muestra una luz blanca alrededor de los bordes de la pantalla que alcanza o supera la duración y el brillo de la implementación del Proyecto de código abierto de Android.
- En el caso de la app de asistencia preinstalada, proporcionar una indicación visual del usuario a menos de dos navegaciones del menú de configuración de la app de Asistente y entrada de voz predeterminada, y compartir el contexto solo cuando el usuario invoca explícitamente la app de asistencia a través de una entrada de palabra clave o tecla de navegación de asistencia.
- [C-2-2] La interacción designada para iniciar la aplicación de asistencia, tal como se describe en la sección 7.2.3, DEBE iniciar la aplicación de asistencia seleccionada por el usuario; en otras palabras, la aplicación que implementa
VoiceInteractionService
o una actividad que controla el intentACTION_ASSIST
.
3.8.5. Alertas y avisos
Las aplicaciones pueden usar la API de Toast
para mostrar al usuario final cadenas no modales cortas que desaparecen después de un período breve, y usar la API de tipo de ventana TYPE_APPLICATION_OVERLAY
para mostrar ventanas de alerta como una superposición sobre otras apps.
Si las implementaciones en dispositivos incluyen una salida de pantalla o de video, sucederá lo siguiente:
-
[C-1-1] DEBE proporcionar una indicación visual del usuario para bloquear una app de modo que no muestre ventanas de alerta que usen
TYPE_APPLICATION_OVERLAY
. La implementación del AOSP cumple con este requisito, ya que tiene controles en el panel de notificaciones. -
[C-1-2] DEBE respetar la API de avisos y mostrar avisos de las aplicaciones a los usuarios finales de una manera muy visible.
3.8.6. Temas
Android proporciona "temas" como un mecanismo para que las aplicaciones apliquen estilos en toda una actividad o aplicación.
Android incluye "Holo" y "Material" como un conjunto de estilos definidos para que los desarrolladores de aplicaciones los usen si quieren que coincidan con el diseño del tema Holo según lo define el SDK de Android.
Si las implementaciones en dispositivos incluyen una salida de pantalla o de video, sucederá lo siguiente:
- [C-1-1] NO DEBE alterar ninguno de los atributos del tema Holo expuestos a las aplicaciones.
- [C-1-2] DEBE admitir la familia de temas “Material” y NO DEBER alterar ninguno de los atributos de los temas de Material ni sus recursos expuestos a las aplicaciones.
- [C-1-3] DEBE establecer la configuración “sans-serif” familia de fuentes a Roboto versión 2.x para los idiomas que admite Roboto, o bien proporciona una indicación visual del usuario para cambiar la fuente utilizada para "sans-serif" familia de fuentes a Roboto versión 2.x para los idiomas que admite Roboto.
Android también incluye una familia de temas "Device Default" como un conjunto de estilos definidos para que los desarrolladores de aplicaciones los usen si quieren que coincidan con el aspecto del tema del dispositivo según lo definido por el implementador de dispositivos.
- Las implementaciones de dispositivos PUEDEN modificar los atributos del tema predeterminado del dispositivo expuestos a las aplicaciones.
Android admite un tema de variante con barras de sistema translúcidas, lo que permite a los desarrolladores de aplicaciones llenar el área detrás de la barra de estado y navegación con el contenido de su app. Para permitir que el desarrollador tenga una experiencia coherente en esta configuración, es importante que se mantenga el estilo del ícono de la barra de estado en diferentes implementaciones de dispositivos.
Si las implementaciones de dispositivos incluyen una barra de estado del sistema, sucederá lo siguiente:
- [C-2-1] DEBE usar blanco para los íconos de estado del sistema (como la intensidad de la señal y el nivel de batería) y las notificaciones que emite el sistema, a menos que el ícono indique un estado problemático o una app solicite una barra de estado luminosa con el indicador SYSTEM_UI_FLAG_LIGHT_STATUS_BAR.
- [C-2-2] Las implementaciones en dispositivos Android DEBEN cambiar el color de los íconos de estado del sistema a negro (para obtener más información, consulta R.style) cuando una app solicita una barra de estado de luz.
3.8.7. Fondos de pantalla animados
Android define un tipo de componente y la API y el ciclo de vida correspondientes que permiten que las aplicaciones expongan uno o varios "fondos de pantalla animados" al usuario final. Los fondos de pantalla animados son animaciones, patrones o imágenes similares con capacidades de entrada limitadas que se muestran como fondo de pantalla detrás de otras aplicaciones.
Se considera que un hardware es capaz de ejecutar fondos de pantalla animados de manera confiable si puede ejecutar todos los fondos de pantalla animados, sin limitaciones de funcionalidad, a una velocidad de fotogramas razonable y sin efectos adversos en otras aplicaciones. Si las limitaciones del hardware hacen que los fondos de pantalla o las aplicaciones fallen, fallen, consuman demasiada energía de la CPU o la batería, o se ejecuten a velocidades de fotogramas inaceptables, se considera que el hardware no puede ejecutar fondos de pantalla animados. Por ejemplo, algunos fondos de pantalla animados pueden usar un contexto OpenGL 2.0 o 3.x para renderizar su contenido. El fondo animado no se ejecutará de manera confiable en hardware que no admite varios contextos OpenGL, ya que el uso del fondo animado de un contexto de OpenGL puede entrar en conflicto con otras aplicaciones que también usan un contexto OpenGL.
- Las implementaciones en dispositivos capaces de ejecutar fondos de pantalla animados de manera confiable, como se describió anteriormente, DEBEN implementar fondos de pantalla animados.
Si las implementaciones en dispositivos implementan fondos de pantalla animados, sucederá lo siguiente:
- [C-1-1] SE DEBE informar la marca de función de la plataforma android.software.live_wallpaper.
3.8.8. Cambio de actividad
El código fuente upstream de Android incluye la pantalla de información general, una interfaz de usuario a nivel del sistema que permite cambiar tareas y mostrar las actividades y tareas a las que se accedió recientemente mediante una imagen en miniatura del estado gráfico de la aplicación en el momento en que el usuario abandonó la aplicación por última vez.
Las implementaciones del dispositivo, incluida la tecla de navegación de la función Recientes, como se detalla en la sección 7.2.3, PUEDEN alterar la interfaz.
Si las implementaciones en dispositivos, incluida la tecla de navegación de la función Recientes, como se detalla en la sección 7.2.3, modifican la interfaz, sucede lo siguiente:
- [C-1-1] DEBE admitir al menos un máximo de 7 actividades mostradas.
- SE RECOMIENDA mostrar, al menos, el título de 4 actividades a la vez.
- [C-1-2] DEBE implementar el comportamiento de fijación de pantalla y proporcionarle al usuario un menú de configuración para activar o desactivar la función.
- SE DEBE mostrar el color de resaltado, el ícono, el título de la pantalla en recientes.
- SE DEBE mostrar una indicación visual de cierre ("x"), pero PUEDE retrasarla hasta que el usuario interactúe con las pantallas.
- SE DEBE implementar una combinación de teclas para cambiar fácilmente a la actividad anterior.
- SE DEBE activar la acción de cambio rápido entre las dos apps usadas más recientemente cuando se presione dos veces la tecla de función Recientes.
- SE DEBE activar el modo multiventana de pantalla dividida, si es compatible, cuando se mantiene presionada la tecla de funciones recientes.
- PUEDE mostrar los recientes afiliados como un grupo que se mueve de forma conjunta.
- [SR] SE RECOMIENDA EXITOSAMENTE usar la interfaz de usuario upstream de Android (o una interfaz similar basada en miniaturas) para la pantalla de información general.
3.8.9. Administración de entradas
Android incluye compatibilidad con la Administración de entradas y compatibilidad con editores de métodos de entrada de terceros.
Si las implementaciones en dispositivos permiten que los usuarios usen métodos de entrada de terceros en el dispositivo, sucederá lo siguiente:
- [C-1-1] SE DEBE declarar la función de la plataforma android.software.input_methods y admitir API de IME, como se define en la documentación del SDK de Android.
3.8.10. Control multimedia de la pantalla de bloqueo
La API de cliente de control remoto dejó de estar disponible en Android 5.0 y se reemplazó por la Plantilla de notificación multimedia, que permite a las aplicaciones multimedia integrarse con los controles de reproducción que se muestran en la pantalla de bloqueo.
3.8.11. Protectores de pantalla (anteriormente, Sueños)
Consulta la sección 3.2.3.5 para conocer el intent de configuración para configurar los protectores de pantalla.
3.8.12. Ubicación
Si las implementaciones de dispositivos incluyen un sensor de hardware (p.ej., GPS) capaz de proporcionar las coordenadas de ubicación, deben
- [C-1-2] DEBE mostrar el estado actual de la ubicación en el menú Ubicación en Configuración.
- [C-1-3] NO DEBE mostrar los modos de ubicación en el menú Ubicación en Configuración.
3.8.13. Unicode y fuentes
Android admite los caracteres de emojis que se definen en Unicode 10.0.
Si las implementaciones en dispositivos incluyen una salida de pantalla o de video, sucederá lo siguiente:
- [C-1-1] DEBE ser capaz de renderizar estos caracteres de emojis con glifos de color.
- [C-1-2] DEBE incluir compatibilidad con lo siguiente:
- Fuente Roboto 2 con diferentes grosores: sans-serif-thin, sans-serif-light, sans-serif-medium, sans-serif-black, sans-serif-condensed, sans-serif-condensed-light para los idiomas disponibles en el dispositivo.
- Cobertura completa de Unicode 7.0 en latín, griego y cirílico, incluidos los rangos latinos A, B, C y D extendidos, y todos los glifos en el bloque de símbolos monetarios de Unicode 7.0.
- SE DEBE admitir el tono de piel y los diversos emojis familiares, como se especifica en el Informe técnico de Unicode n.o 51.
Si las implementaciones en dispositivos incluyen un IME, sucede lo siguiente:
- SE DEBE proporcionarle al usuario un método de entrada para estos caracteres emoji.
Android admite la renderización de fuentes birmanas. Birmania tiene varias fuentes que no son compatibles con Unicode, comúnmente conocidas como "Zawgyi", para renderizar idiomas birmanos.
Si las implementaciones en dispositivos incluyen compatibilidad con birmano, sucederá lo siguiente:
* [C-2-1] MUST render text with Unicode compliant font as default;
non-Unicode compliant font MUST NOT be set as default font unless the user
chooses it in the language picker.
* [C-2-2] MUST support a Unicode font and a non-Unicode compliant font if a
non-Unicode compliant font is supported on the device. Non-Unicode
compliant font MUST NOT remove or overwrite the Unicode font.
* [C-2-3] MUST render text with non-Unicode compliant font ONLY IF a
language code with [script code Qaag](
http://unicode.org/reports/tr35/#unicode_script_subtag_validity) is
specified (e.g. my-Qaag). No other ISO language or region codes (whether
assigned, unassigned, or reserved) can be used to refer to non-Unicode
compliant font for Myanmar. App developers and web page authors can
specify my-Qaag as the designated language code as they would for any
other language.
3.8.14. Multiventana
Si las implementaciones en dispositivos tienen la capacidad de mostrar varias actividades al mismo tiempo, sucederá lo siguiente:
- [C-1-1] DEBE implementar dichos modos multiventana de acuerdo con los comportamientos de la aplicación y las APIs que se describen en la documentación de compatibilidad del modo multiventana del SDK de Android y cumplir con los siguientes requisitos:
- [C-1-2] DEBE respetar el
android:resizeableActivity
establecido por una app en el archivoAndroidManifest.xml
, como se describe en este SDK. - [C-1-3] NO DEBE ofrecer el modo de pantalla dividida ni forma libre si la altura de la pantalla es inferior a 440 dp y el ancho de la pantalla es inferior a 440 dp.
- [C-1-4] NO DEBE cambiar el tamaño de una actividad a un tamaño inferior a 220 dp en los modos multiventana que no sean pantalla en pantalla.
- Las implementaciones en dispositivos con tamaño de pantalla
xlarge
DEBEN admitir el modo de forma libre.
Si las implementaciones de dispositivos admiten modos multiventana y el modo de pantalla dividida, harán lo siguiente:
- [C-2-1] DEBE precargar un selector redimensionable como predeterminado.
- [C-2-2] SE DEBE recortar la actividad anclada de un multiventana de pantalla dividida, pero SE DEBE mostrar algo de contenido si la app Launcher es la ventana enfocada.
- [C-2-3] DEBE respetar los valores declarados de
AndroidManifestLayout_minWidth
yAndroidManifestLayout_minHeight
de la aplicación de selector de terceros y no de anular estos valores mientras se muestra parte del contenido de la actividad acoplada.
Si las implementaciones de dispositivos admiten los modos multiventana y el modo multiventana:
- [C-3-1] DEBE iniciar actividades en el modo multiventana de pantalla en pantalla cuando la aplicación: * Se orienta al nivel de API 26 o superior y declara
android:supportsPictureInPicture
. * Se orienta al nivel de API 25 o anterior, y declaraandroid:resizeableActivity
yandroid:supportsPictureInPicture
. - [C-3-2] DEBE exponer las acciones en su SystemUI como se especifica en la actividad de PIP actual a través de la API de
setActions()
. - [C-3-3] DEBE admitir relaciones de aspecto superiores o iguales a 1:2.39, e inferiores o iguales a 2.39:1, según se especifica en la actividad de PIP a través de la API de
setAspectRatio()
. - [C-3-4] DEBE usar
KeyEvent.KEYCODE_WINDOW
para controlar la ventana de PIP. si no se implementa el modo de PIP, la clave DEBE estar disponible para la actividad en primer plano. - [C-3-5] DEBE proporcionar una indicación visual del usuario para bloquear la visualización de una aplicación en modo PIP. la implementación del AOSP cumple con este requisito, ya que tiene controles en el panel de notificaciones.
-
[C-3-6] DEBE asignar el siguiente ancho y alto mínimos para la ventana de PIP cuando una aplicación no declara ningún valor para
AndroidManifestLayout_minWidth
yAndroidManifestLayout_minHeight
:- Los dispositivos con el Configuration.uiMode configurado en un valor distinto de
UI_MODE_TYPE_TELEVISION
DEBEN asignar un ancho y una altura mínimos de 108 dp. - Los dispositivos con Configuration.uiMode configurado como
UI_MODE_TYPE_TELEVISION
DEBEN asignar un ancho mínimo de 240 dp y una altura mínima de 135 dp.
- Los dispositivos con el Configuration.uiMode configurado en un valor distinto de
3.8.15. Recorte de pantalla
Android admite un corte de pantalla, como se describe en el documento del SDK. La API de DisplayCutout
define un área en el borde de la pantalla que podría no ser funcional para una aplicación debido a un corte de pantalla o una pantalla curva en los bordes.
Si las implementaciones de dispositivos incluyen cortes de pantalla, sucederá lo siguiente:
- [C-1-5] NO DEBE tener cortes si la relación de aspecto del dispositivo es 1.0 (1:1).
- [C-1-2] NO DEBE tener más de un corte por borde.
- [C-1-3] DEBE respetar las marcas de corte de pantalla establecidas por la app a través de la API de
WindowManager.LayoutParams
, como se describe en el SDK. - [C-1-4] DEBE informar los valores correctos para todas las métricas de corte definidas en la API de
DisplayCutout
.
3.8.16. Controles de dispositivos
Android incluye las APIs de ControlsProviderService
y Control
para permitir que aplicaciones de terceros publiquen controles de dispositivos para agilizar el estado y la acción de los usuarios.
Consulta la sección 2_2_3 para conocer los requisitos específicos de cada dispositivo.
3.9 Administración del dispositivo
Android incluye funciones que permiten que las aplicaciones conscientes de la seguridad lleven a cabo funciones de administración de dispositivos a nivel del sistema, como la aplicación de políticas de contraseñas o la limpieza remota, a través de la API de administración de dispositivos Android.
Si las implementaciones de dispositivos implementan la gama completa de políticas de administración de dispositivos definidas en la documentación del SDK de Android, harán lo siguiente:
- [C-1-1] DEBE declarar
android.software.device_admin
. - El [C-1-2] DEBE admitir el aprovisionamiento del propietario del dispositivo, como se describe en las secciones 3.9.1 y 3.9.1.1.
3.9.1 Aprovisionamiento de dispositivos
3.9.1.1 Aprovisionamiento del propietario del dispositivo
Si las implementaciones de dispositivos declaran android.software.device_admin
, hará lo siguiente:
- [C-1-1] DEBE admitir la inscripción de un Cliente de política de dispositivo (DPC) como una aplicación del propietario del dispositivo, como se describe a continuación:
- Cuando la implementación del dispositivo aún no tiene datos del usuario, hace lo siguiente:
- [C-1-3] DEBE informar
true
paraDevicePolicyManager.isProvisioningAllowed(ACTION_PROVISION_MANAGED_DEVICE)
. - [C-1-4] SE DEBE inscribir la aplicación de DPC como la app del propietario del dispositivo en respuesta a la acción de intent
android.app.action.PROVISION_MANAGED_DEVICE
. - [C-1-5] DEBE inscribir la aplicación de DPC como la aplicación del propietario del dispositivo si el dispositivo declara la compatibilidad con las Comunicaciones de campo cercano (NFC) a través de la marca de función
android.hardware.nfc
y recibe un mensaje NFC que contenga un registro con el tipo MIMEMIME_TYPE_PROVISIONING_NFC
.
- [C-1-3] DEBE informar
- Cuando la implementación del dispositivo tiene datos del usuario, hace lo siguiente:
- [C-1-6] DEBE informar
false
para elDevicePolicyManager.isProvisioningAllowed(ACTION_PROVISION_MANAGED_DEVICE)
. - [C-1-7] Ya no DEBES inscribir ninguna aplicación de DPC como la aplicación del propietario del dispositivo.
- [C-1-6] DEBE informar
- Cuando la implementación del dispositivo aún no tiene datos del usuario, hace lo siguiente:
- [C-1-2] DEBE requerir alguna acción afirmativa antes del proceso de aprovisionamiento o durante este para dar su consentimiento para que la app se configure como Propietario del dispositivo. El consentimiento puede realizarse mediante una acción del usuario o de algún modo programático, pero DEBE mostrar un aviso de divulgación adecuado (como se hace referencia en el AOSP) antes de que se inicie el aprovisionamiento del propietario del dispositivo. Además, el mecanismo de consentimiento programático que usan las empresas para aprovisionarlos NO DEBE interferir en la experiencia lista para usar en el caso de uso no empresarial.
- [C-1-3] NO DEBE codificar el consentimiento ni impedir el uso de otras apps del propietario del dispositivo.
Si las implementaciones de dispositivos declaran android.software.device_admin
, pero también incluyen una solución de administración del propietario del dispositivo y proporcionan un mecanismo para promover una aplicación configurada en su solución como "equivalente al propietario del dispositivo" con la opción estándar “Propietario del dispositivo” Como reconocen las APIs estándar de DevicePolicyManager de Android, hacen lo siguiente:
- [C-2-1] DEBE tener un proceso para verificar que la aplicación específica que se promociona pertenezca a una solución legítima de administración de dispositivos empresariales y que ya se configuró en la solución de propiedad para tener los derechos equivalentes a "Propietario del dispositivo".
- [C-2-2] DEBE mostrar la misma divulgación de consentimiento del propietario del dispositivo del AOSP que el flujo que inició
android.app.action.PROVISION_MANAGED_DEVICE
antes de inscribir la aplicación del DPC como "Propietario del dispositivo". - PUEDE tener datos del usuario en el dispositivo antes de inscribir la aplicación de DPC como "Propietario del dispositivo".
3.9.1.2 Aprovisionamiento de perfiles administrados
Si las implementaciones de dispositivos declaran android.software.managed_users
, hará lo siguiente:
-
[C-1-1] DEBE implementar las APIs que permiten que una aplicación de controlador de política de dispositivo (DPC) se convierta en la propietaria de un nuevo perfil administrado.
-
[C-1-2] La experiencia de los usuarios del proceso de aprovisionamiento de perfiles administrados (el flujo que inicia android.app.action.PROVISION_MANAGED_PROFILE) DEBE alinearse con la implementación de AOSP.
-
[C-1-3] DEBE proporcionar las siguientes posibilidades de usuario dentro de la Configuración para indicarle al usuario que el controlador de política de dispositivo (DPC) inhabilitó una función del sistema en particular:
- Un ícono coherente u otra indicación visual del usuario (por ejemplo, el ícono de información ascendente de AOSP) para representar cuando un administrador de dispositivos restringe una configuración específica
- Un mensaje de explicación breve, proporcionado por el administrador de dispositivos a través de
setShortSupportMessage
. - Ícono de la aplicación de DPC
3.9.2 Asistencia para perfiles administrados
Si las implementaciones de dispositivos declaran android.software.managed_users
, hará lo siguiente:
- [C-1-1] DEBE admitir perfiles administrados a través de las APIs de
android.app.admin.DevicePolicyManager
. - [C-1-2] DEBE permitir que se cree un solo perfil administrado.
- [C-1-3] SE DEBE usar una insignia de ícono (similar a la insignia de trabajo ascendente de AOSP) para representar las aplicaciones y los widgets administrados, y otros elementos de la IU con insignias, como Recientes y Notificaciones.
- [C-1-4] DEBE mostrar un ícono de notificación (similar a la insignia de trabajo upstream de AOSP) para indicar cuando el usuario se encuentra dentro de una aplicación de perfil administrado.
- [C-1-5] DEBE mostrar un aviso que indique que el usuario está en el perfil administrado si se activa el dispositivo (ACTION_USER_PRESENT) y la aplicación en primer plano está dentro del perfil administrado.
- [C-1-6] Cuando existe un perfil administrado, DEBE mostrar una indicación visual en el "Selector de intents" de la intención. para permitir que el usuario reenvíe el intent del perfil administrado al usuario principal o viceversa, si el controlador de política de dispositivo lo habilita.
- [C-1-7] Cuando existe un perfil administrado, DEBE exponer las siguientes condiciones del usuario tanto para el usuario principal como para el perfil administrado:
- Contabilización independiente de la batería, la ubicación, los datos móviles y el uso del almacenamiento del usuario principal y el perfil administrado
- Administración independiente de aplicaciones de VPN instaladas dentro del usuario principal o perfil administrado
- Administración independiente de aplicaciones instaladas dentro del usuario principal o perfil administrado
- Administración independiente de cuentas dentro del usuario principal o el perfil administrado
- [C-1-8] DEBE asegurarse de que el marcador preinstalado, los contactos y las aplicaciones de mensajería puedan buscar y obtener la información del emisor desde el perfil administrado (si existe uno) junto con los del perfil principal, si el controlador de política de dispositivo lo permite.
- [C-1-9] DEBE asegurarse de que cumpla con todos los requisitos de seguridad aplicables a un dispositivo que tenga habilitados varios usuarios (consulta la sección 9.5), aunque el perfil administrado no se cuente como otro usuario además del usuario principal.
Si las implementaciones de dispositivos declaran android.software.managed_users
y android.software.secure_lock_screen
, hará lo siguiente:
- [C-2-1] DEBE admitir la posibilidad de especificar una pantalla de bloqueo independiente que cumpla con los siguientes requisitos para otorgar acceso solo a las apps que se ejecutan en un perfil administrado.
- Las implementaciones de dispositivos DEBEN respetar el intent
DevicePolicyManager.ACTION_SET_NEW_PASSWORD
y mostrar una interfaz para configurar una credencial de pantalla de bloqueo separada para el perfil administrado. - Las credenciales de la pantalla de bloqueo del perfil administrado DEBEN usar los mismos mecanismos de administración y almacenamiento de credenciales que el perfil superior, tal como se documenta en el sitio del Proyecto de código abierto de Android.
- Las políticas de contraseñas del DPC DEBEN aplicarse solo a las credenciales de la pantalla de bloqueo del perfil administrado, a menos que se llame a la instancia de
DevicePolicyManager
que muestra getParentProfileInstance.
- Las implementaciones de dispositivos DEBEN respetar el intent
- Cuando los contactos del perfil administrado se muestran en el registro de llamadas preinstalado, la IU durante la llamada, las notificaciones de llamadas perdidas y en curso, los contactos y las aplicaciones de mensajería, SE DEBE mostrar la misma insignia que se utiliza para indicar las aplicaciones del perfil administrado.
3.9.3 Asistencia para usuarios administrados
Si las implementaciones de dispositivos declaran android.software.managed_users
, hará lo siguiente:
- [C-1-1] DEBE proporcionar una indicación visual para salir del usuario actual y volver al usuario principal en una sesión de varios usuarios cuando
isLogoutEnabled
devuelvatrue
. Se DEBE acceder a la opción del usuario desde la pantalla de bloqueo sin desbloquear el dispositivo.
3.10. Accesibilidad
Android proporciona una capa de accesibilidad que ayuda a los usuarios con discapacidades a navegar por sus dispositivos con mayor facilidad. Además, Android proporciona APIs de plataforma que permiten que las implementaciones de servicios de accesibilidad reciban devoluciones de llamada para eventos del usuario y del sistema, y generen mecanismos alternativos de respuesta, como texto a voz, respuesta táctil y navegación con bola de seguimiento o pad direccional.
Si las implementaciones de dispositivos admiten servicios de accesibilidad de terceros, sucederá lo siguiente:
- [C-1-1] DEBE implementar una implementación del framework de accesibilidad de Android como se describe en la documentación del SDK de las APIs de accesibilidad.
- [C-1-2] DEBE generar eventos de accesibilidad y entregar el
AccessibilityEvent
adecuado a todas las implementaciones deAccessibilityService
registradas, tal como se documenta en el SDK. - [C-1-4] DEBE agregar un botón en la barra de navegación del sistema que le permita al usuario controlar el servicio de accesibilidad cuando los servicios de accesibilidad habilitados declaren la
AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON
. Ten en cuenta que este requisito no es aplicable para las implementaciones en dispositivos sin barra de navegación del sistema, pero DEBEN proporcionar al usuario la indicación visual de controlar estos servicios de accesibilidad.
Si las implementaciones de dispositivos incluyen servicios de accesibilidad preinstalados, sucederá lo siguiente:
- [C-2-1] DEBE implementar estos servicios de accesibilidad preinstalados como apps con conocimiento de inicio directo cuando el almacenamiento de datos está encriptado con encriptación basada en archivos (FBE).
- SE DEBE proporcionar un mecanismo en el flujo de configuración listo para usar a fin de que los usuarios habiliten los servicios de accesibilidad relevantes, así como opciones para ajustar el tamaño de la fuente, el tamaño de la pantalla y los gestos de ampliación.
3.11. Text-to-Speech
Android incluye API que permiten a las aplicaciones utilizar servicios de texto a voz (TTS) y permite a los proveedores de servicios implementar implementaciones de servicios de TTS.
Si las implementaciones de dispositivos informan la función android.hardware.audio.output, hacen lo siguiente:
- [C-1-1] DEBE ser compatible con las APIs del framework de TTS de Android.
Si las implementaciones de dispositivos admiten la instalación de motores de TTS de terceros, sucederá lo siguiente:
- [C-2-1] DEBE proporcionar la indicación visual del usuario para permitirle seleccionar un motor de TTS para usar a nivel del sistema.
3.12. Framework de entrada de TV
El marco de trabajo de entrada de televisión (TIF) de Android simplifica la entrega de contenido en vivo a los dispositivos de televisión Android. El TIF proporciona una API estándar para crear módulos de entrada que controlan los dispositivos de Android Television.
Si las implementaciones en dispositivos son compatibles con el TIF, tienen las siguientes características:
- [C-1-1] SE DEBE declarar la función
android.software.live_tv
de la plataforma. - [C-1-2] DEBE admitir todas las APIs del TIF de modo que una aplicación que use estas APIs y el servicio de entradas basadas en el TIF de terceros puedan instalarse y usarse en el dispositivo.
3.13. Configuración rápida
Android proporciona un componente de IU de Configuración rápida que permite acceder rápidamente a acciones que se usan con frecuencia o que se necesitan con urgencia.
Si las implementaciones de dispositivos incluyen un componente de IU de Configuración rápida y admiten esa opción de configuración rápida de terceros, sucederá lo siguiente:
- [C-1-1] DEBE permitir que el usuario agregue o quite los mosaicos proporcionados a través de las APIs de
quicksettings
desde una app de terceros. - [C-1-2] NO DEBE agregar automáticamente una tarjeta de una app de terceros directamente a la Configuración rápida.
- [C-1-3] DEBE mostrar todos los mosaicos agregados por el usuario desde apps de terceros junto con los mosaicos de configuración rápida proporcionados por el sistema.
3.14. IU multimedia
Si las implementaciones de dispositivos incluyen aplicaciones que no se activan por voz (las Aplicaciones) que interactúan con aplicaciones de terceros a través de MediaBrowser
o MediaSession
, las Aplicaciones:
-
[C-1-2] DEBE mostrar claramente los íconos obtenidos a través de getIconBitmap() o getIconUri() y los títulos obtenidos con getTitle(), como se describe en
MediaDescription
. Los títulos pueden acortarse para cumplir con las reglamentaciones de seguridad (p.ej., distracción del conductor). -
[C-1-3] DEBE mostrar el ícono de la aplicación de terceros siempre que muestre contenido proporcionado por esta aplicación de terceros.
-
[C-1-4] DEBE permitir que el usuario interactúe con toda la jerarquía de
MediaBrowser
. PUEDE restringir el acceso a una parte de la jerarquía para cumplir con las reglamentaciones de seguridad (p.ej., distracción del conductor), pero NO DEBE dar un trato preferencial según el contenido o el proveedor de contenido. -
[C-1-5] DEBES considerar presionar dos veces
KEYCODE_HEADSETHOOK
oKEYCODE_MEDIA_PLAY_PAUSE
comoKEYCODE_MEDIA_NEXT
paraMediaSession.Callback#onMediaButtonEvent
.
3.15. Apps instantáneas
Las implementaciones en dispositivos DEBEN cumplir con los siguientes requisitos:
- [C-0-1] A las Apps instantáneas solo DEBEN tener permisos con
android:protectionLevel
establecido en"instant"
. - [C-0-2] Las Apps instantáneas NO DEBEN interactuar con las apps instaladas a través de intents implícitos, a menos que se cumpla una de las siguientes condiciones:
- El filtro de patrón de intents del componente está expuesto y tiene CATEGORY_BROWSABLE
- La acción es una de las siguientes: ACTION_SEND, ACTION_SENDTO, ACTION_SEND_MULTIPLE.
- El destino se expone de forma explícita con android:visibleToInstantApps.
- [C-0-3] Las Apps instantáneas NO DEBEN interactuar explícitamente con las apps instaladas, a menos que el componente se exponga a través de android:visibleToInstantApps.
- [C-0-4] Las Apps instaladas NO DEBEN ver los detalles de las Apps instantáneas en el dispositivo, a menos que estas se conecten explícitamente a la aplicación instalada.
Si las implementaciones de dispositivos admiten apps instantáneas, sucederá lo siguiente:
- [C-1-1] DEBE proporcionar las siguientes condiciones de usuario para interactuar con Apps instantáneas. AOSP cumple con los requisitos con la IU del sistema, la configuración y el Selector predeterminados.
- [C-1-2] DEBE proporcionar una indicación visual de usuario para ver y borrar Apps instantáneas localmente en caché para cada paquete de app individual.
- [C-1-3] DEBE proporcionar una notificación persistente para el usuario que se pueda contraer mientras se ejecuta una app instantánea en primer plano. Esta notificación para el usuario DEBE incluir que las Apps instantáneas no requieren instalación y deben proporcionar una indicación visual que dirija al usuario a la pantalla de información de la aplicación en Configuración. Para las apps instantáneas iniciadas a través de intents web, como se define mediante el uso de un intent con una acción configurada en Intent.ACTION_VIEW y con un esquema de "http" o "https", una indicación adicional de usuario DEBE permitir que el usuario no inicie la app instantánea e inicie el vínculo asociado con el navegador web configurado, si hay un navegador disponible en el dispositivo.
- [C-1-4] DEBE permitir el acceso a Apps instantáneas en ejecución desde la función Recientes si esta función está disponible en el dispositivo.
- [C-1-5] DEBE precargar una o más aplicaciones o componentes de servicio con un controlador de intents para los intents enumerados en el SDK aquí y hacer que los intents sean visibles para Apps instantáneas.
3.16. Sincronización de dispositivos complementarios
Android admite la vinculación de dispositivos complementarios para administrar de manera más eficaz la asociación con estos dispositivos y proporciona la API de CompanionDeviceManager
para que las apps accedan a esta función.
Si las implementaciones de dispositivos admiten la función de vinculación de dispositivos complementarios, sucederá lo siguiente:
- [C-1-1] SE DEBE declarar la marca de función
FEATURE_COMPANION_DEVICE_SETUP
. - [C-1-2] DEBE asegurarse de que las APIs del paquete
android.companion
estén completamente implementadas. - [C-1-3] DEBE proporcionar las condiciones del usuario para que este seleccione o confirme que un dispositivo complementario está presente y en funcionamiento.
3.17. Aplicaciones pesadas
Si las implementaciones de dispositivos declaran la función FEATURE_CANT_SAVE_STATE
, hará lo siguiente:
- [C-1-1] SE DEBE tener solo una app instalada que especifique
cantSaveState
que se ejecuta en el sistema a la vez. Si el usuario abandona esa app sin salir de ella explícitamente (por ejemplo, presiona el botón de inicio mientras deja una actividad activa en el sistema, en lugar de presionar el botón Atrás sin actividades activas restantes en el sistema), las implementaciones del dispositivo DEBEN priorizar esa app en la memoria RAM, como lo hacen para otras tareas que se espera que permanezcan en ejecución, como los servicios en primer plano. Mientras una app de este tipo se encuentra en segundo plano, el sistema aún puede aplicarle funciones de administración de energía, como limitar el acceso a la CPU y a la red. - [C-1-2] DEBE proporcionar una indicación visual de IU para elegir la app que no participará en el mecanismo de guardado/restablecimiento de estado normal una vez que el usuario inicie una segunda app declarada con el atributo
cantSaveState
. - [C-1-3] NO DEBE aplicar otros cambios en la política a las apps que especifican
cantSaveState
, como cambiar el rendimiento de la CPU o la priorización de la programación.
Si las implementaciones de dispositivos no declaran la función FEATURE_CANT_SAVE_STATE
, hará lo siguiente:
- [C-1-1] DEBE ignorar el atributo
cantSaveState
establecido por las apps y NO DEBE cambiar el comportamiento de la app según ese atributo.
3.18. Contactos
Android incluye APIs de Contacts Provider
para permitir que las aplicaciones administren la información de contacto almacenada en el dispositivo. Los datos de contacto que se ingresan directamente en el dispositivo generalmente se sincronizan con un servicio web, pero también PUEDEN residir solo localmente en el dispositivo. Los contactos que solo se almacenan en el dispositivo se conocen como contactos locales.
Los RawContacts están "asociados a" o "almacenados en" Una Cuenta cuando las columnas ACCOUNT_NAME
y ACCOUNT_TYPE
de los contactos sin procesar coincidan con los campos Account.name y Account.type correspondientes de la cuenta.
Cuenta local predeterminada: Es una cuenta para contactos sin procesar que solo se almacenan en el dispositivo y no están asociados con una cuenta en AccountManager, que se crea con valores null para las columnas ACCOUNT_NAME
y ACCOUNT_TYPE
.
Cuenta local personalizada: Es una cuenta para contactos sin procesar que solo se almacenan en el dispositivo y no se asocian con una cuenta en AccountManager, que se crean con al menos un valor no nulo para las columnas ACCOUNT_NAME
y ACCOUNT_TYPE
.
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENcarecidamente no crear cuentas locales personalizadas.
Si las implementaciones de dispositivos usan una cuenta local personalizada:
- [C-1-1] El
ACCOUNT_NAME
de la cuenta local personalizada DEBE devolverse antes delContactsContract.RawContacts.getLocalAccountName
. - [C-1-2] El
ACCOUNT_TYPE
de la cuenta local personalizada DEBE devolverse antes delContactsContract.RawContacts.getLocalAccountType
. - [C-1-3] Los contactos sin procesar que insertan aplicaciones de terceros con la cuenta local predeterminada (es decir, mediante la configuración de valores nulos para
ACCOUNT_NAME
yACCOUNT_TYPE
) DEBEN insertarse en la cuenta local personalizada. - [C-1-4] Los contactos sin procesar insertados en la cuenta local personalizada no DEBEN quitarse cuando se agregan o quitan cuentas.
- [C-1-5] Las operaciones de eliminación realizadas en la cuenta local personalizada DEBEN borrar de forma inmediata los contactos sin procesar (como si el parámetro
CALLER_IS_SYNCADAPTER
se hubiera establecido en verdadero), incluso si el parámetroCALLER\_IS\_SYNCADAPTER
se estableció en falso o no se especificó.
4. Compatibilidad de empaquetado de aplicaciones
Implementaciones en dispositivos:
- [C-0-1] DEBE ser capaz de instalar y ejecutar archivos ".apk" de Android generados por la herramienta "aapt" incluida en el SDK oficial de Android.
- Como el requisito anterior puede ser desafiante, se RECOMIENDA las implementaciones en dispositivos que usen el sistema de administración de paquetes de la implementación de referencia de AOSP.
Implementaciones en dispositivos:
- [C-0-2] DEBE admitir la verificación de archivos ".apk" con el esquema de firma de APK v3 , el esquema de firma de APK v2 y la firma JAR.
- [C-0-3] NO DEBE extender los formatos de código de byte .apk, Android Manifest, Dalvik bytecode ni RenderScript de manera que eviten que esos archivos se instalen y ejecuten correctamente en otros dispositivos compatibles.
-
[C-0-4] NO DEBE permitir aplicaciones que no sean el "instalador de registro" actual. para que el paquete desinstale la app de forma silenciosa sin ninguna confirmación del usuario, como se documenta en el SDK para el permiso
DELETE_PACKAGE
. Las únicas excepciones son la app del verificador de paquetes del sistema que maneja el intent PACKAGE_NEEDS_VERIFICATION y la app del administrador de almacenamiento que controla el intent ACTION_MANAGE_STORAGE. -
[C-0-5] DEBE tener una actividad que controle el intent
android.settings.MANAGE_UNKNOWN_APP_SOURCES
. -
[C-0-6] NO DEBE instalar paquetes de aplicaciones de fuentes desconocidas, a menos que la aplicación que solicita la instalación cumpla con todos los requisitos que se indican a continuación:
- DEBE declarar el permiso
REQUEST_INSTALL_PACKAGES
o tener elandroid:targetSdkVersion
establecido en 24 o menos. - DEBE tener el permiso del usuario para instalar apps de fuentes desconocidas.
- DEBE declarar el permiso
-
SE DEBE ofrecerles una indicación al usuario para otorgar o revocar el permiso para instalar apps de fuentes desconocidas por cada aplicación, pero PUEDE optar por implementar esto como una no-op y mostrar
RESULT_CANCELED
parastartActivityForResult()
si la implementación del dispositivo no quiere permitir que los usuarios tengan esta opción. Sin embargo, incluso en tales casos, DEBEN indicar al usuario por qué no se presenta tal opción. -
[C-0-7] DEBE mostrar un diálogo de advertencia con la cadena de advertencia que se proporciona al usuario a través de la API
PackageManager.setHarmfulAppWarning
del sistema antes de iniciar una actividad en una aplicación que la misma APIPackageManager.setHarmfulAppWarning
del sistema marcó como potencialmente dañina. -
SE DEBE brindar al usuario una indicación visual para desinstalar o iniciar la aplicación en el cuadro de diálogo de advertencia.
-
[C-0-8] SE DEBE implementar la compatibilidad con el sistema de archivos incrementales, como se documenta aquí.
-
[C-0-9] DEBE admitir la verificación de archivos .apk con el Esquema de firma de APK v4.
-
Si las implementaciones de dispositivos ya se lanzaron en una versión anterior de Android y no cumplen con los requisitos [C-0-8] y [C-0-9] a través de una actualización de software del sistema, PUEDEN estar exentas de estos requisitos.
5. Compatibilidad multimedia
Implementaciones en dispositivos:
- [C-0-1] DEBE admitir los formatos multimedia, los codificadores, los decodificadores, los tipos de archivo y los formatos de contenedor definidos en la sección 5.1 para cada códec declarado por
MediaCodecList
. - [C-0-2] DEBE declarar e informar la compatibilidad de los codificadores y decodificadores disponibles para aplicaciones de terceros a través de
MediaCodecList
. - [C-0-3] DEBE poder decodificarse correctamente y poner a disposición de las apps de terceros todos los formatos que pueda codificar. Esto incluye todos los flujos de bits que generan sus codificadores y los perfiles informados en su
CamcorderProfile
.
Implementaciones en dispositivos:
- DEBERÍAN lograr una latencia de códec mínima; es decir,
- NO DEBEN consumir ni almacenar búferes de entrada ni devolver búferes de entrada solo una vez procesados.
- NO SE DEBEN retener los búferes decodificados durante más tiempo del que se especifica en el estándar (p.ej., SPS).
- NO DEBERÍAS retener los búferes codificados más tiempo que el requerido por la estructura del GOP.
Todos los códecs que se indican en la siguiente sección se proporcionan como implementaciones de software en la implementación de Android preferida del Proyecto de código abierto de Android.
Ten en cuenta que ni Google ni Open Handset Alliance declaran que estos códecs no tienen patentes de terceros. Quienes deseen utilizar este código fuente en productos de hardware o software deben considerar que las implementaciones de este código, incluso en software de código abierto o shareware, pueden requerir licencias de patentes de los titulares de patentes pertinentes.
5.1. Códecs de contenido multimedia
5.1.1 Codificación de audio
Puedes obtener más detalles en la sección 5.1.3. Detalles de los códecs de audio.
Si las implementaciones de dispositivos declaran android.hardware.microphone
, DEBEN admitir la codificación de los siguientes formatos de audio y permitir que estén disponibles para apps de terceros:
- [C-1-1] PCM/WAVE
- [C-1-2] FLAC
- [C-1-3] Opus
Todos los codificadores de audio DEBEN admitir lo siguiente:
- [C-3-1] Tramas de audio PCM de 16 bits con orden de bytes nativo a través de la API de
android.media.MediaCodec
.
5.1.2. Decodificación de audio
Puedes obtener más detalles en la sección 5.1.3. Detalles de los códecs de audio.
Si las implementaciones de dispositivos declaran compatibilidad con la función android.hardware.audio.output
, deben admitir la decodificación de los siguientes formatos de audio:
- [C-1-1] Perfil MPEG-4 AAC (AAC LC)
- [C-1-2] Perfil MPEG-4 HE AAC (AAC+)
- [C-1-3] Perfil MPEG-4 HE AACv2 (AAC+ mejorado)
- [C-1-4] AAC ELD (AAC mejorado de bajo retraso)
- [C-1-11] xHE-AAC (perfil HE AAC extendido de ISO/IEC 23003-3, que incluye el perfil de Baseline de la USAC y el perfil de control de rango dinámico ISO/IEC 23003-4)
- [C-1-5] FLAC
- [C-1-6] MP3
- [C-1-7] MIDI
- [C-1-8] Vorbis
- [C-1-9] PCM/WAVE que incluye formatos de audio de alta resolución de hasta 24 bits, tasa de muestreo de 192 kHz y 8 canales. Ten en cuenta que este requisito solo se aplica a la decodificación, y que el dispositivo puede reducir el muestreo y reducir la mezcla durante la fase de reproducción.
- [C-1-10] Opus
Si las implementaciones de dispositivos admiten la decodificación de búferes de entrada AAC de transmisiones multicanal (es decir, más de dos canales) a PCM a través del decodificador de audio AAC predeterminado en la API de android.media.MediaCodec
, SE DEBE admitir lo siguiente:
- [C-2-1] La decodificación DEBE realizarse sin mezclar (p.ej., una transmisión 5.0 AAC se debe decodificar en cinco canales de PCM, y una transmisión 5.1 AAC se debe decodificar en seis canales de PCM).
- [C-2-2] Los metadatos de rango dinámico DEBEN ser los definidos en “Control de rango dinámico (RDC)” en ISO/IEC 14496-3 y las claves
android.media.MediaFormat
del DRC para configurar los comportamientos relacionados con el rango dinámico del decodificador de audio. Las claves de DRC de AAC se introdujeron en el nivel de API 21 y son:KEY_AAC_DRC_ATTENUATION_FACTOR
,KEY_AAC_DRC_BOOST_FACTOR
,KEY_AAC_DRC_HEAVY_COMPRESSION
,KEY_AAC_DRC_TARGET_REFERENCE_LEVEL
yKEY_AAC_ENCODED_TARGET_LEVEL
. - [SR] SE RECOMIENDA ENERCMENTE que todos los decodificadores de audio AAC cumplan con los requisitos C-2-1 y C-2-2 mencionados anteriormente.
Cuando se decodifica audio de la USAC, MPEG-D (ISO/IEC 23003-4):
- [C-3-1] Los metadatos de volumen y DRC DEBEN interpretarse y aplicarse de acuerdo con el nivel 1 del perfil de control de rango dinámico del DRC de MPEG-D.
- [C-3-2] El decodificador DEBE comportarse de acuerdo con la configuración establecida con las siguientes claves
android.media.MediaFormat
:KEY_AAC_DRC_TARGET_REFERENCE_LEVEL
yKEY_AAC_DRC_EFFECT_TYPE
.
Decodificadores de perfiles MPEG-4 AAC, HE AAC y HE AACv2:
- PUEDE admitir el control de volumen y rango dinámico con el perfil de control de rango dinámico ISO/IEC 23003-4.
Si se admite ISO/IEC 23003-4 y si los metadatos ISO/IEC 23003-4 e ISO/IEC 14496-3 están presentes en un flujo de bits decodificado, entonces:
- Los metadatos ISO/IEC 23003-4 TIENEN prioridad.
Todos los decodificadores de audio DEBEN admitir la salida:
- [C-6-1] Tramas de audio PCM de 16 bits con orden de bytes nativo a través de la API de
android.media.MediaCodec
.
5.1.3 Detalles de los códecs de audio
Formato/códec | Detalles | Tipos de archivos/formatos de contenedor que se admitirán |
---|---|---|
Perfil MPEG-4 AAC (AAC LC) |
Compatibilidad con contenido mono/estéreo/5.0/5.1 con tasas de muestreo estándar de 8 kHz a 48 kHz. |
|
Perfil MPEG-4 HE AAC (AAC+) | Compatibilidad con contenido mono/estéreo/5.0/5.1 con tasas de muestreo estándar de 16 kHz a 48 kHz. |
|
MPEG-4 HE AACv2 Perfil (AAC+ mejorado) |
Compatibilidad con contenido mono/estéreo/5.0/5.1 con tasas de muestreo estándar de 16 kHz a 48 kHz. |
|
AAC ELD (AAC mejorado de bajo retraso) | Compatibilidad con contenido mono/estéreo con tasas de muestreo estándar de 16 kHz a 48 kHz. |
|
USAC | Compatibilidad con contenido mono/estéreo con tasas de muestreo estándar de 7.35 a 48 kHz. | MPEG-4 (.mp4, .m4a) |
AMR-NB | 4.75 a 12.2 Kbps con muestreo a 8 kHz | 3GPP (.3gp) |
AMR-WB | 9 tasas de 6.60 kbit/s a 23.85 kbit/s de muestra a 16 kHz, como se define en AMR-WB, Adaptive Multi-Rate - Wideband Speech Codec | 3GPP (.3gp) |
FLAC | Tanto para el codificador como el decodificador, se DEBEN admitir, al menos, los modos Mono y estéreo. DEBEN ser compatibles las tasas de muestreo de hasta 192 kHz. DEBE ser compatible con las resoluciones de 16 y 24 bits. El manejo de datos de audio FLAC de 24 bits DEBE estar disponible con la configuración de audio de punto flotante. |
|
MP3 | Tasa de bits constante (CBR) o variable (VBR) mono/estéreo de 8 a 320 Kbps |
|
MIDI | MIDI tipo 0 y 1. Versión 1 y 2 de DLS. XMF y Mobile XMF. Compatibilidad con los formatos de tono RTTTL/RTX, OTA y iMelody. |
|
Vorbis |
|
|
PCM/WAVE | El códec PCM DEBE admitir PCM lineal de 16 bits y número de punto flotante de 16 bits. El extractor WAVE debe admitir PCM lineal de 16 bits, 24 bits y 32 bits, y un número de punto flotante de 32 bits (las tasas llegan hasta el límite del hardware). Las tasas de muestreo DEBEN ser compatibles entre 8 kHz y 192 kHz. | WAVE (.wav) |
Opus |
Decodificación: Compatibilidad con contenido mono, estéreo, 5.0 y 5.1 con tasas de muestreo de 8,000, 12,000, 16,000, 24,000 y 48,000 Hz Codificación: Compatibilidad con contenido mono y estéreo con tasas de muestreo de 8,000, 12,000, 16,000, 24,000 y 48,000 Hz. |
|
5.1.4. Codificación de imágenes
Obtén más detalles en la sección 5.1.6. Detalles de los códecs de imagen.
Las implementaciones del dispositivo DEBEN admitir la codificación de la siguiente imagen:
- [C-0-1] JPEG
- [C-0-2] PNG
- [C-0-3] WebP
Si las implementaciones de dispositivos admiten la codificación HEIC a través de android.media.MediaCodec
para el tipo de medio MIMETYPE_IMAGE_ANDROID_HEIC
, sucederá lo siguiente:
- [C-1-1] DEBE proporcionar un códec de codificador HEVC acelerado por hardware que admita el modo de control de tasa de bits
BITRATE_MODE_CQ
, perfilHEVCProfileMainStill
y un tamaño de fotograma de 512 x 512 px.
5.1.5 Decodificación de imágenes
Obtén más detalles en la sección 5.1.6. Detalles de los códecs de imagen.
Las implementaciones del dispositivo DEBEN admitir la decodificación de la siguiente codificación de imágenes:
- [C-0-1] JPEG
- [C-0-2] GIF
- [C-0-3] PNG
- [C-0-4] BMP
- [C-0-5] WebP
- [C-0-6] Sin procesar
Si las implementaciones de dispositivos admiten la decodificación de video HEVC, las siguientes: * [C-1-1] DEBEN admitir la decodificación de imágenes HEIF (HEIC).
Decodificadores de imágenes que admiten un formato de profundidad de bits alta (más de 9 bits por canal):
- [C-2-1] DEBE admitir la salida en un formato equivalente de 8 bits si la aplicación lo solicita, por ejemplo, a través de la configuración
ARGB_8888
deandroid.graphics.Bitmap
.
5.1.6. Detalles de los códecs de imagen
Formato/códec | Detalles | Tipos de archivos/formatos de contenedor admitidos |
---|---|---|
JPEG | Básica + progresiva | JPEG (.jpg) |
GIF | GIF (.gif) | |
PNG | PNG (.png) | |
BMP | BMP (.bmp) | |
WebP | WebP (.webp) | |
Sin procesar | ARW (.arw), CR2 (.cr2), DNG (.dng), NEF (.nef), NRW (.nrw), ORF (.orf), PEF (.pef), RAF (.raf), RW2 (.rw2), SRW (.srw) | |
HEIF | Imagen, colección de imágenes, secuencia de imágenes | HEIF (.heif) y HEIC (.heic) |
Codificadores y decodificadores de imágenes expuestos a través de la API de MediaCodec
-
[C-1-1] DEBE admitir el formato de color flexible YUV420 8:8:8 (
COLOR_FormatYUV420Flexible
) hastaCodecCapabilities
. -
[SR] SE RECOMIENDA EJECUTIVO para admitir el formato de color RGB888 para el modo de superficie de entrada.
-
[C-1-3] DEBE admitir al menos uno de los formatos de color YUV420 planos o semiplanares 8:8:8:
COLOR_FormatYUV420PackedPlanar
(equivalente aCOLOR_FormatYUV420Planar
) oCOLOR_FormatYUV420PackedSemiPlanar
(equivalente aCOLOR_FormatYUV420SemiPlanar
). SE RECOMIENDA ENERGMENTE para respaldar ambos.
5.1.7 Códecs de video
- Para garantizar una calidad aceptable de transmisión de video web y servicios de videoconferencia, las implementaciones en dispositivos DEBEN usar un códec de hardware VP8 que cumpla con los requisitos.
Si las implementaciones en dispositivos incluyen un decodificador o codificador de video:
-
[C-1-1] Los códecs de video DEBEN admitir tamaños de búfer de bytes de entrada y salida que se adapten al mayor fotograma comprimido y sin comprimir posible según lo determine el estándar y la configuración, pero tampoco de manera general.
-
[C-1-2] Los codificadores y decodificadores de video DEBEN ser compatibles con los formatos de color flexibles YUV420 8:8:8 (
COLOR_FormatYUV420Flexible
) aCodecCapabilities
. -
[C-1-3] Los codificadores y decodificadores de video DEBEN admitir al menos uno de los formatos de color YUV420 planos o semiplanar 8:8:8:
COLOR_FormatYUV420PackedPlanar
(equivalente aCOLOR_FormatYUV420Planar
) oCOLOR_FormatYUV420PackedSemiPlanar
(equivalente aCOLOR_FormatYUV420SemiPlanar
). SE RECOMIENDA ENERGMENTE para respaldar ambos. -
[SR] Se RECOMIENDA que los codificadores y decodificadores de video sean compatibles con al menos uno de los formatos de color plano o semiplanar YUV420 8:8:8 (YV12, NV12, NV21 o equivalente optimizado por el proveedor) optimizado por hardware.
-
[C-1-5] Los decodificadores de video que admiten un formato de profundidad de bits alta (más de 9 bits por canal) DEBEN admitir la salida de un formato equivalente de 8 bits si la aplicación lo solicita. Esto DEBE reflejarse mediante la compatibilidad con un formato de color YUV420 8:8:8 a través de
android.media.MediaCodecInfo
.
Si las implementaciones de dispositivos anuncian la compatibilidad con perfiles HDR a través de Display.HdrCapabilities
, sucederá lo siguiente:
- [C-2-1] DEBE ser compatible con el análisis y la administración de metadatos estáticos de HDR.
Si las implementaciones de dispositivos anuncian la compatibilidad con actualizaciones internas a través de FEATURE_IntraRefresh
en la clase MediaCodecInfo.CodecCapabilities
, harán lo siguiente:
- [C-3-1] DEBE admitir períodos de actualización en el rango de 10 a 60 fotogramas y operar con precisión dentro del 20% del período de actualización configurado.
A menos que la aplicación especifique lo contrario con la clave de formato KEY_COLOR_FORMAT
, las implementaciones del decodificador de video hacen lo siguiente:
- [C-4-1] DEBE utilizar de forma predeterminada el formato de color optimizado para la pantalla de hardware si se configura con la salida de Surface.
- [C-4-2] DEBE utilizar de forma predeterminada un formato de color YUV420 8:8:8 optimizado para la lectura de CPU si está configurado para no usar resultados de Surface.
5.1.8. Lista de códecs de video
Formato/códec | Detalles | Tipos de archivos/formatos de contenedor que se admitirán |
---|---|---|
H.263 |
|
|
H.264 AVC | Consulta los artículos 5.2 y 5.3 para obtener más información. |
|
H.265 HEVC | Consulta la sección 5.3 para obtener más información. |
|
MPEG-2 | Perfil principal |
|
MPEG-4 SP |
|
|
VP8 | Consulta los artículos 5.2 y 5.3 para obtener más información. |
|
VP9 | Consulta la sección 5.3 para obtener más información. |
|
5.1.9 Seguridad de códecs multimedia
Las implementaciones del dispositivo DEBEN garantizar el cumplimiento de las funciones de seguridad de códecs multimedia, tal como se describe a continuación.
Android incluye compatibilidad con OMX, una API de aceleración multimedia multiplataforma, así como Codec 2.0, una API de aceleración multimedia de baja sobrecarga.
Si las implementaciones de dispositivos admiten archivos multimedia, sucederá lo siguiente:
- [C-1-1] DEBE admitir códecs multimedia a través de las APIs de OMX o Codec 2.0 (o de ambas), como en el Proyecto de código abierto de Android, y no inhabilitar ni eludir las protecciones de seguridad. Específicamente, esto no significa que todos los códecs DEBEN usar la API de OMX o Codec 2.0, solo que la compatibilidad con al menos una de estas APIs DEBE estar disponible, y la compatibilidad con las APIs disponibles DEBE incluir las protecciones de seguridad presentes.
- [C-SR] SE RECOMIENDA INCREÍBLEMENTE incluir compatibilidad con la API de Codec 2.0.
Si las implementaciones de dispositivos no son compatibles con la API de Codec 2.0, sucederá lo siguiente:
- [C-2-1] DEBE incluir el códec de software OMX correspondiente del Proyecto de código abierto de Android (si está disponible) para cada formato y tipo de medio (codificador o decodificador) compatible con el dispositivo.
- [C-2-2] Códecs cuyos nombres comienzan con "OMX.google". DEBE basarse en el código fuente de su Proyecto de código abierto de Android.
- [C-SR] SE RECOMIENDA ENERCMENTE que los códecs de software OMX se ejecuten en un proceso de códec que no tenga acceso a controladores de hardware que no sean asignadores de memoria.
Si las implementaciones de dispositivos admiten la API de Codec 2.0, sucederá lo siguiente:
- [C-3-1] DEBE incluir el códec de software 2.0 correspondiente del Proyecto de código abierto de Android (si está disponible) para cada formato y tipo de medios (codificador o decodificador) compatible con el dispositivo.
- [C-3-2] DEBE alojar los códecs de software 2.0 en el proceso de códecs de software, tal como se proporciona en el Proyecto de código abierto de Android, para que sea posible otorgar un acceso más limitado a los códecs de software.
- [C-3-3] Códecs cuyos nombres comienzan con "c2.android". DEBE basarse en el código fuente de su Proyecto de código abierto de Android.
5.1.10. Caracterización de códecs de medios
Si las implementaciones de dispositivos admiten códecs multimedia, sucederá lo siguiente:
- [C-1-1] DEBE mostrar los valores correctos de la caracterización de códecs multimedia a través de la API de
MediaCodecInfo
.
En particular:
- [C-1-2] Códecs cuyos nombres comienzan con "OMX". DEBEN usar las APIs de OMX y tener nombres que cumplan con los lineamientos de nombres de OMX IL.
- [C-1-3] Códecs cuyos nombres comienzan con "c2". DEBE usar la API de Codec 2.0 y tener nombres que cumplan con las pautas de denominación de Codec 2.0 para Android.
- [C-1-4] Códecs cuyos nombres comienzan con "OMX.google". o "c2.android". NO DEBE estar caracterizada como proveedor o acelerada por hardware.
- [C-1-5] Los códecs que se ejecutan en un proceso de códecs (proveedor o sistema) y que tienen acceso a controladores de hardware distintos de los asignadores o mapeadores de memoria NO DEBEN caracterizarse como exclusivos de software.
- [C-1-6] Los códecs que no están presentes en el Proyecto de código abierto de Android o que no se basan en el código fuente de ese proyecto DEBEN caracterizarse como proveedores.
- [C-1-7] Los códecs que usan aceleración de hardware DEBEN caracterizarse como acelerados por hardware.
- [C-1-8] Los nombres de códecs NO DEBEN ser engañosos. Por ejemplo, los códecs llamados "decodificadores" DEBE admitir la decodificación, y los denominados “codificadores” DEBE admitir la codificación. Los códecs con nombres que contienen formatos de medios DEBEN admitir esos formatos.
Si las implementaciones de dispositivos admiten códecs de video:
- [C-2-1] Todos los códecs de video DEBEN publicar datos de velocidad de fotogramas alcanzables para los siguientes tamaños si son compatibles con el códec:
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | UHD | |
---|---|---|---|---|---|
Resolución de video |
|
|
|
1,920 x 1,080 px (diferente a MPEG4) | 3840 × 2160 px (HEVC, VP9) |
- [C-2-2] Los códecs de video que se caracterizan como acelerados por hardware DEBEN publicar información de puntos de rendimiento. Cada uno DEBE enumerar todos los puntos de rendimiento estándar admitidos (mencionados en la API de
PerformancePoint
), a menos que estén cubiertos por otro punto de rendimiento estándar admitido. - Además, DEBEN publicar puntos de rendimiento extendidos si admiten un rendimiento de video sostenido que no sea uno de los estándares de la lista.
5.2 Codificación de videos
Si las implementaciones de dispositivos admiten cualquier codificador de video y permiten que estén disponibles para apps de terceros, sucederá lo siguiente:
- En dos ventanas variables, NO SE DEBE superar más del 15% de la tasa de bits entre los intervalos intramarco (I-frame).
- NO DEBERÍA superar el 100% sobre la tasa de bits en una ventana variable de 1 segundo.
Si las implementaciones de dispositivos incluyen una pantalla de pantalla incorporada con una longitud diagonal de al menos 2.5 pulgadas o incluyen un puerto de salida de video o declaran la compatibilidad de una cámara a través de la marca de función android.hardware.camera.any
, hacen lo siguiente:
- [C-1-1] DEBE incluir compatibilidad con al menos uno de los codificadores de video VP8 o H.264 y ponerlo a disposición de aplicaciones de terceros.
- SE RECOMIENDA ser compatible con los codificadores de video VP8 y H.264, y debe estar disponible para aplicaciones de terceros.
Si las implementaciones de dispositivos admiten cualquiera de los codificadores de video H.264, VP8, VP9 o HEVC y hacen que estén disponibles para aplicaciones de terceros, deben hacer lo siguiente:
- [C-2-1] DEBE admitir tasas de bits configurables dinámicamente.
- DEBE admitir velocidades de fotogramas variables, en las que el codificador de video DEBE determinar la duración instantánea de los fotogramas según las marcas de tiempo de los búferes de entrada y asignar su intervalo de bits en función de esa duración de fotogramas.
Si las implementaciones de dispositivos admiten el codificador de video MPEG-4 SP y lo ponen a disposición de apps de terceros, deben hacer lo siguiente:
- DEBE admitir tasas de bits configurables de forma dinámica para el codificador compatible.
Si las implementaciones de dispositivos proporcionan codificadores de imagen o video acelerados por hardware y admiten una o más cámaras de hardware conectadas o conectables que se exponen a través de las APIs de android.camera
:
- [C-4-1] Todos los codificadores de imagen y video acelerados por hardware DEBEN admitir fotogramas de codificación de las cámaras de hardware.
- SE RECOMIENDA admitir fotogramas de codificación de las cámaras de hardware a través de todos los codificadores de imagen o video.
5.2.1 H.263
Si las implementaciones de dispositivos admiten codificadores H.263 y permiten que estén disponibles para apps de terceros, deben hacer lo siguiente:
- [C-1-1] DEBE admitir el perfil de Baseline nivel 45.
- DEBE admitir tasas de bits configurables de forma dinámica para el codificador compatible.
5.2.2. H.264
Si las implementaciones de dispositivos admiten el códec H.264, sucederá lo siguiente:
- [C-1-1] DEBE admitir el perfil de Baseline de nivel 3. Sin embargo, la compatibilidad con ASO (ordenamiento arbitrario de porciones), FMO (pedido de macrobloqueo flexible) y RS (porciones redundantes) es OPCIONAL. Además, para mantener la compatibilidad con otros dispositivos Android, se RECOMIENDA que los codificadores no usen ASO, FMO ni RS para el perfil de Baseline.
- [C-1-2] SE DEBE admitir los perfiles de codificación de video SD (definición estándar) que se indican en la siguiente tabla.
- SE DEBE admitir el perfil principal de nivel 4.
- SE RECOMIENDA admitir los perfiles de codificación de video HD (alta definición) como se indica en la siguiente tabla.
Si las implementaciones de dispositivos informan la compatibilidad con la codificación H.264 para videos de resolución 720p o 1080p a través de las APIs multimedia, sucede lo siguiente:
- [C-2-1] DEBE admitir los perfiles de codificación de la siguiente tabla.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | |
---|---|---|---|---|
Resolución de video | 320 × 240 px | 720 × 480 px | 1280 x 720 px | 1920 x 1080 px |
Velocidad de fotogramas del video | 20 fps | 30 fps | 30 fps | 30 fps |
Tasa de bits del video | 384 Kbps | 2 Mbps | 4 Mbps | 10 Mbps |
5.2.3 VP8
Si las implementaciones de dispositivos admiten el códec VP8, harán lo siguiente:
- [C-1-1] DEBE admitir los perfiles de codificación de video SD.
- SE RECOMIENDA admitir los siguientes perfiles de codificación de video HD (alta definición).
- [C-1-2] DEBE admitir la escritura de archivos Matroska WebM.
- SE DEBE proporcionar un códec de hardware VP8 que cumpla con los requisitos de codificación de hardware RTC del proyecto WebM para garantizar una calidad aceptable de los servicios de transmisión de video por Internet y videoconferencia web.
Si las implementaciones de dispositivos informan compatibilidad con la codificación VP8 para videos de resolución 720p o 1080p a través de las APIs multimedia, sucederá lo siguiente:
- [C-2-1] DEBE admitir los perfiles de codificación de la siguiente tabla.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | |
---|---|---|---|---|
Resolución de video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 fps | 30 fps |
Tasa de bits del video | 800 Kbps | 2 Mbps | 4 Mbps | 10 Mbps |
5.2.4. VP9
Si las implementaciones de dispositivos admiten el códec VP9, harán lo siguiente:
- [C-1-2] DEBE admitir el perfil 0 de nivel 3.
- [C-1-1] DEBE admitir la escritura de archivos Matroska WebM.
- [C-1-3] DEBE generar datos de CodecPrivate.
- SE RECOMIENDA admitir los perfiles de decodificación HD como se indica en la siguiente tabla.
- Se RECOMIENDA [SR] claramente admitir los perfiles de decodificación HD, como se indica en la siguiente tabla, si hay un codificador de hardware.
SD | HD: 720p | HD: 1080 p | UHD | |
---|---|---|---|---|
Resolución de video | 720 × 480 px | 1280 x 720 px | 1920 x 1080 px | 3840 × 2160 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 fps | 30 fps |
Tasa de bits del video | 1.6 Mbps | 4 Mbps | 5 Mbps | 20 Mbps |
Si las implementaciones en dispositivos afirman admitir el perfil 2 o el perfil 3 a través de las APIs de medios:
- La compatibilidad con el formato de 12 bits es OPCIONAL.
5.2.5 H.265
Si las implementaciones de dispositivos admiten el códec H.265, sucederá lo siguiente:
- [C-1-1] DEBE admitir el perfil principal de nivel 3.
- SE RECOMIENDA admitir los perfiles de codificación HD como se indica en la siguiente tabla.
- Se RECOMIENDA [SR] claramente admitir los perfiles de codificación HD, como se indica en la siguiente tabla, si hay un codificador de hardware.
SD | HD: 720p | HD: 1080 p | UHD | |
---|---|---|---|---|
Resolución de video | 720 × 480 px | 1280 x 720 px | 1920 x 1080 px | 3840 × 2160 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 fps | 30 fps |
Tasa de bits del video | 1.6 Mbps | 4 Mbps | 5 Mbps | 20 Mbps |
5.3 Decodificación de video
Si las implementaciones de dispositivos admiten códecs VP8, VP9, H.264 o H.265, entonces:
- [C-1-1] DEBE admitir la resolución de video dinámica y el cambio de velocidad de fotogramas a través de las APIs de Android estándar dentro de la misma transmisión para todos los códecs VP8, VP9, H.264 y H.265 en tiempo real y hasta la resolución máxima admitida por cada códec en el dispositivo.
5.3.1 MPEG-2
Si las implementaciones de dispositivos admiten decodificadores MPEG-2, sucederá lo siguiente:
- [C-1-1] DEBE admitir el perfil principal de alto nivel.
5.3.2. H.263
Si las implementaciones de dispositivos admiten decodificadores H.263, sucederá lo siguiente:
- [C-1-1] DEBE admitir el perfil de Baseline nivel 30 y nivel 45.
5.3.3. MPEG-4
Si se implementan en dispositivos con decodificadores MPEG-4, sucederá lo siguiente:
- [C-1-1] DEBE admitir un perfil simple de nivel 3.
5.3.4. H.264
Si las implementaciones de dispositivos admiten decodificadores H.264, sucederá lo siguiente:
- [C-1-1] DEBE admitir el perfil principal nivel 3.1 y el perfil de Baseline. La compatibilidad con ASO (orden de porciones arbitrarias), FMO (orden de macrobloques flexible) y RS (porciones redundantes) es OPCIONAL.
- [C-1-2] SE DEBE poder decodificar videos con los perfiles SD (definición estándar) que se indican en la siguiente tabla y codificados con el perfil de Baseline y el perfil principal nivel 3.1 (incluida la resolución 720p30).
- SE DEBE poder decodificar videos con los perfiles HD (alta definición) como se indica en la siguiente tabla.
Si la altura que informa el método Display.getSupportedModes()
es igual o mayor que la resolución de video, las implementaciones en dispositivos hacen lo siguiente:
- [C-2-1] DEBE admitir los perfiles de decodificación de video HD 720p que se indican en la siguiente tabla.
- [C-2-2] DEBE admitir los perfiles de decodificación de video HD 1080p que se indican en la siguiente tabla.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | |
---|---|---|---|---|
Resolución de video | 320 × 240 px | 720 × 480 px | 1280 x 720 px | 1920 x 1080 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 60 fps | 30 FPS (60 FPS Televisión) |
Tasa de bits del video | 800 Kbps | 2 Mbps | 8 Mbps | 20 Mbps |
5.3.5 H.265 (HEVC)
Si las implementaciones de dispositivos admiten el códec H.265, sucederá lo siguiente:
- [C-1-1] DEBE admitir el nivel principal de perfil principal nivel 3 y los perfiles de decodificación de video SD como se indica en la siguiente tabla.
- SE RECOMIENDA admitir los perfiles de decodificación HD como se indica en la siguiente tabla.
- [C-1-2] DEBE admitir los perfiles de decodificación HD como se indica en la siguiente tabla si hay un decodificador de hardware.
Si la altura que informa el método Display.getSupportedModes()
es igual o mayor que la resolución del video, entonces:
- [C-2-1] Las implementaciones en dispositivos DEBEN admitir al menos una decodificación H.265 o VP9 de perfiles 720, 1080 y UHD.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | UHD | |
---|---|---|---|---|---|
Resolución de video | 352 × 288 px | 720 × 480 px | 1280 x 720 px | 1920 x 1080 px | 3840 × 2160 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 fps | 30/60 FPS (60 FPS Televisión con decodificación por hardware H.265) | 60 fps |
Tasa de bits del video | 600 Kbps | 1.6 Mbps | 4 Mbps | 5 Mbps | 20 Mbps |
Si las implementaciones del dispositivo afirman admitir un perfil HDR a través de las APIs de contenido multimedia, haz lo siguiente:
- [C-3-1] Las implementaciones del dispositivo DEBEN aceptar los metadatos de HDR requeridos de la aplicación, así como admitir la extracción y la salida de los metadatos HDR necesarios del flujo de bits o del contenedor.
- [C-3-2] Las implementaciones del dispositivo DEBEN mostrar correctamente el contenido HDR en la pantalla del dispositivo o en un puerto de salida de video estándar (p.ej., HDMI).
5.3.6. VP8
Si las implementaciones de dispositivos admiten el códec VP8, harán lo siguiente:
- [C-1-1] DEBE admitir los perfiles de decodificación SD en la siguiente tabla.
- SE DEBE usar un códec de hardware VP8 que cumpla con los requisitos.
- SE RECOMIENDA admitir los perfiles de decodificación HD que se indican en la siguiente tabla.
Si la altura que informa el método Display.getSupportedModes()
es igual o mayor que la resolución del video, entonces:
- [C-2-1] Las implementaciones en dispositivos DEBEN admitir perfiles de 720p en la siguiente tabla.
- [C-2-2] Las implementaciones en dispositivos DEBEN admitir perfiles de 1080p en la siguiente tabla.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | |
---|---|---|---|---|
Resolución de video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 FPS (60 FPS Televisión) | 30 (60 FPS Televisión) |
Tasa de bits del video | 800 Kbps | 2 Mbps | 8 Mbps | 20 Mbps |
5.3.7. VP9
Si las implementaciones de dispositivos admiten el códec VP9, harán lo siguiente:
- [C-1-1] DEBE admitir los perfiles de decodificación de video SD como se indica en la siguiente tabla.
- SE RECOMIENDA admitir los perfiles de decodificación HD como se indica en la siguiente tabla.
Si las implementaciones de dispositivos admiten el códec VP9 y un decodificador de hardware:
- [C-2-1] DEBE admitir los perfiles de decodificación HD como se indica en la siguiente tabla.
Si la altura que informa el método Display.getSupportedModes()
es igual o mayor que la resolución del video, entonces:
- [C-3-1] Las implementaciones en dispositivos DEBEN admitir al menos una decodificación VP9 o H.265 de los perfiles 720, 1080 y UHD.
SD (baja calidad) | SD (alta calidad) | HD: 720p | HD: 1080 p | UHD | |
---|---|---|---|---|---|
Resolución de video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px | 3840 × 2160 px |
Velocidad de fotogramas del video | 30 fps | 30 fps | 30 fps | 30 FPS (60 FPS Televisión con decodificación por hardware de VP9) | 60 fps |
Tasa de bits del video | 600 Kbps | 1.6 Mbps | 4 Mbps | 5 Mbps | 20 Mbps |
Si las implementaciones en dispositivos afirman admitir VP9Profile2
o VP9Profile3
a través de las APIs de contenido multimedia "CodecProfileLevel":
- La compatibilidad con el formato de 12 bits es OPCIONAL.
Si las implementaciones en dispositivos afirman admitir un perfil HDR (VP9Profile2HDR
, VP9Profile2HDR10Plus
, VP9Profile3HDR
, VP9Profile3HDR10Plus
) a través de las APIs de contenido multimedia, haz lo siguiente:
- [C-4-1] Las implementaciones del dispositivo DEBEN aceptar los metadatos de HDR requeridos (
KEY_HDR_STATIC_INFO
para todos los perfiles HDR, así como "KEY_HDR10_PLUS_INFO" para los perfiles HDR10Plus) de la aplicación. También DEBEN admitir la extracción y la salida de los metadatos HDR necesarios del flujo de bits o del contenedor. - [C-4-2] Las implementaciones en dispositivos DEBEN mostrar correctamente el contenido HDR en la pantalla del dispositivo o en un puerto de salida de video estándar (p.ej., HDMI).
5.3.8. Dolby Vision
Si las implementaciones de dispositivos declaran compatibilidad con el decodificador Dolby Vision a través de HDR_TYPE_DOLBY_VISION
, sucede lo siguiente:
- [C-1-1] DEBE incluir un extractor compatible con Dolby Vision.
- [C-1-2] DEBE mostrar correctamente el contenido de Dolby Vision en la pantalla del dispositivo o en un puerto de salida de video estándar (p.ej., HDMI).
- [C-1-3] SE DEBE configurar el índice de seguimiento de las capas base retrocompatibles (si están presentes) para que sea el mismo que el índice de seguimiento de la capa combinada de Dolby Vision.
5.3.9. AV1
Si las implementaciones de dispositivos admiten el códec AV1, sucederán lo siguiente:
- [C-1-1] DEBE admitir el perfil 0, incluido el contenido de 10 bits.
5.4. Grabación de audio
Si bien algunos de los requisitos descritos en esta sección se enumeran como DEBEN a partir de Android 4.3, se planea cambiar la definición de compatibilidad para versiones futuras a DEBE. Se RECOMIENDA ENRENDER que los dispositivos Android existentes y nuevos cumplan con los requisitos que se indican como DEBEN. De lo contrario, no serán compatibles con Android cuando se actualicen a la versión futura.
5.4.1 Captura de audio sin procesar e información del micrófono
Si las implementaciones de dispositivos declaran android.hardware.microphone
, hará lo siguiente:
-
[C-1-1] DEBE permitir la captura de contenido de audio sin procesar con las siguientes características:
- Formato: PCM lineal, 16 bits
- Tasas de muestreo: 8,000, 11,025, 16,000, 44,100, 48,000 Hz
- Canales: Mono
-
SE RECOMIENDA permitir la captura de contenido de audio sin procesar con las siguientes características:
- Formato: PCM lineal, 16 bits y 24 bits
- Tasas de muestreo: 8,000, 11,025, 16,000, 22,050, 24,000, 32,000, 44,100 y 48,000 Hz
- Canales: tantos canales como la cantidad de micrófonos en el dispositivo
-
[C-1-2] DEBE capturar con tasas de muestreo superiores sin sobremuestreo.
- [C-1-3] DEBE incluir un filtro de suavizado de contorno adecuado cuando las tasas de muestreo proporcionadas anteriormente se capturan con submuestreo.
-
SE DEBE permitir la captura de contenido de audio sin procesar en calidad de radio AM y DVD, lo que implica las siguientes características:
- Formato: PCM lineal, 16 bits
- Tasas de muestreo: 22,050, 48,000 Hz
- Canales: estéreo
- [C-1-4] DEBE cumplir con la API de
MicrophoneInfo
y completar correctamente la información de los micrófonos disponibles en el dispositivo a los que pueden acceder las aplicaciones de terceros a través de la API deAudioManager.getMicrophones()
, así como de los micrófonos activos actualmente a los que pueden acceder las aplicaciones de terceros a través de las APIs deAudioRecord.getActiveMicrophones()
yMediaRecorder.getActiveMicrophones()
. Si las implementaciones de dispositivos permiten la captura con calidad de radio AM y DVD de contenido de audio sin procesar, sucederá lo siguiente:
-
[C-2-1] SE DEBE capturar sin sobremuestreo en cualquier proporción superior a 16000:22050 o 44100:48000.
- [C-2-2] DEBE incluir un filtro de suavizado de contorno adecuado para cualquier aumento o reducción de muestreo.
5.4.2. Capturar para el reconocimiento de voz
Si las implementaciones de dispositivos declaran android.hardware.microphone
, hará lo siguiente:
- [C-1-1] DEBE capturar la fuente de audio
android.media.MediaRecorder.AudioSource.VOICE_RECOGNITION
con una de las tasas de muestreo, 44,100 y 48,000. - [C-1-2] DEBE inhabilitar de forma predeterminada el procesamiento de audio con reducción de ruido cuando se graba una transmisión de audio desde la fuente de audio
AudioSource.VOICE_RECOGNITION
. - [C-1-3] DEBE inhabilitar de forma predeterminada cualquier control de ganancia automático cuando se graba una transmisión de audio desde la fuente de audio
AudioSource.VOICE_RECOGNITION
. - SE DEBE grabar la transmisión de audio mediante reconocimiento de voz con una amplitud aproximadamente plana en comparación con las características de la frecuencia: específicamente, ±3 dB, de 100 Hz a 4000 Hz.
- SE DEBE grabar la transmisión de audio mediante reconocimiento de voz con la sensibilidad de entrada configurada de modo que una fuente de nivel de potencia de sonido (SPL) de 90 dB a 1000 Hz produzca un RMS de 2500 para muestras de 16 bits.
- SE DEBE grabar la transmisión de audio de reconocimiento de voz para que los niveles de amplitud de PCM monitoreen linealmente los cambios de SPL de entrada en un rango de al menos 30 dB, entre -18 dB y +12 dB y 90 dB de SPL en el micrófono.
- SE DEBE grabar la transmisión de audio mediante reconocimiento de voz con una distorsión armónica total (THD) inferior al 1% para 1 kHz a un nivel de entrada de SPL de 90 dB con el micrófono.
Si las implementaciones de dispositivos declaran android.hardware.microphone
y las tecnologías de supresión (reducción) de ruido se ajustan para el reconocimiento de voz, suceden lo siguiente:
- [C-2-1] DEBE permitir que este efecto de audio se pueda controlar con la API de
android.media.audiofx.NoiseSuppressor
. - [C-2-2] DEBE identificar de manera única cada implementación de tecnología de reducción de ruido a través del campo
AudioEffect.Descriptor.uuid
.
5.4.3. Captura para el redireccionamiento de la reproducción
La clase android.media.MediaRecorder.AudioSource
incluye la fuente de audio REMOTE_SUBMIX
.
Si las implementaciones de dispositivos declaran tanto android.hardware.audio.output
como android.hardware.microphone
, harán lo siguiente:
-
[C-1-1] DEBE implementar correctamente la fuente de audio
REMOTE_SUBMIX
de modo que cuando una aplicación use la API deandroid.media.AudioRecord
para grabar desde esta fuente de audio, capture una mezcla de todas las transmisiones de audio, excepto las siguientes:-
AudioManager.STREAM_RING
-
AudioManager.STREAM_ALARM
-
AudioManager.STREAM_NOTIFICATION
-
5.4.4. Cancelador de eco acústico
Si las implementaciones de dispositivos declaran android.hardware.microphone
, hará lo siguiente:
- SE DEBE implementar una tecnología de cancelador de eco acústico (AEC) ajustada para la comunicación por voz y aplicada a la ruta de captura cuando se hace una captura con
AudioSource.VOICE_COMMUNICATION
.
Si las implementaciones en dispositivos proporcionan un cancelador de eco acústico que se inserta en la ruta de acceso de la captura de audio cuando se selecciona AudioSource.VOICE_COMMUNICATION
, sucede lo siguiente:
- [C-SR] están STRONGLY_RECOMMENDED para declarar esto a través del método de API AcousticEchoCanceler AcousticEchoCanceler.isAvailable()
- Los [C-SR] son STRONGLY_RECOMMENDED para permitir que este efecto de audio se pueda controlar con la API de AcousticEchoCanceler.
- [C-SR] están FUERTELY_RECOMMENDED para identificar de manera única cada implementación de tecnología AEC a través del campo AudioEffect.Descriptor.uuid.
5.4.5. Captura simultánea
Si las implementaciones de dispositivos declaran android.hardware.microphone
, DEBEN implementar la captura simultánea, como se describe en este documento. Más precisamente:
- [C-1-1] DEBE permitir el acceso simultáneo al micrófono a través de un servicio de accesibilidad que captura con
AudioSource.VOICE_RECOGNITION
y al menos una captura de aplicación con cualquierAudioSource
. - [C-1-2] DEBE permitir el acceso simultáneo al micrófono por parte de una aplicación preinstalada que tenga un rol de Asistente y al menos una captura de aplicaciones con cualquier
AudioSource
, exceptoAudioSource.VOICE_COMMUNICATION
oAudioSource.CAMCORDER
. - [C-1-3] DEBE silenciar la captura de audio para cualquier otra aplicación, excepto para un servicio de accesibilidad, mientras una aplicación está capturando con
AudioSource.VOICE_COMMUNICATION
oAudioSource.CAMCORDER
. Sin embargo, cuando una app realiza una captura a través deAudioSource.VOICE_COMMUNICATION
, otra app puede capturar la llamada de voz si es una app privilegiada (preinstalada) con el permisoCAPTURE_AUDIO_OUTPUT
. - [C-1-4] Si dos o más aplicaciones capturan al mismo tiempo y ninguna tiene una IU en la parte superior, la que comenzó a capturar más recientemente recibe audio.
5.4.6. Niveles de ganancia del micrófono
Si las implementaciones de dispositivos declaran android.hardware.microphone
, hará lo siguiente:
- DEBERÍA exhibir características aproximadas de amplitud frente a frecuencia en el rango de frecuencia media: específicamente ±3 dB, de 100 Hz a 4000 Hz para cada micrófono utilizado para grabar la fuente de audio de reconocimiento de voz.
- SE DEBE establecer la sensibilidad de entrada de audio de forma que una fuente de tono sinusoidal de 1,000 Hz que se reproduzca a un nivel de presión sonora (SPL) de 90 dB produzca una respuesta con una RMS de 2500 para muestras de 16 bits (o de -22.35 dB en escala completa para muestras de punto flotante o de precisión doble) para cada uno de los micrófonos utilizados para grabar la fuente de audio de reconocimiento de voz.
- Se recomienda [C-SR] para mostrar niveles de amplitud en el rango de frecuencia baja: específicamente de ±20 dB, de 5 Hz a 100 Hz, en comparación con el rango de frecuencia media de cada micrófono utilizado para grabar la fuente de audio de reconocimiento de voz.
- Se recomienda [C-SR] para mostrar niveles de amplitud en el rango de alta frecuencia: específicamente de ±30 dB, de 4,000 Hz a 22 KHz, en comparación con el rango de frecuencia media de cada micrófono utilizado para grabar la fuente de audio de reconocimiento de voz.
5.5 Reproducción de audio
Android incluye compatibilidad para permitir que las apps reproduzcan audio a través del periférico de salida de audio, como se define en la sección 7.8.2.
5.5.1 Reproducción de audio sin procesar
Si las implementaciones de dispositivos declaran android.hardware.audio.output
, hará lo siguiente:
-
[C-1-1] DEBE permitir la reproducción de contenido de audio sin procesar con las siguientes características:
- Formatos de origen: PCM lineal, 16 bits, 8 bits, flotante
- Canales: Mono, estéreo, configuraciones multicanal válidas con hasta 8 canales
-
Tasas de muestreo (en Hz):
- 8000, 11025, 16000, 22050, 32000, 44100 y 48000 en los parámetros de configuración de canales mencionados anteriormente
- 96,000 en mono y estéreo
-
SE DEBE permitir la reproducción de contenido de audio sin procesar con las siguientes características:
- Tasas de muestreo: 24,000, 48,000
5.5.2. Efectos de audio
Android proporciona una API de efectos de audio para implementaciones en dispositivos.
Si las implementaciones de dispositivos declaran la función android.hardware.audio.output
, sucederá lo siguiente:
- [C-1-1] DEBE admitir las implementaciones
EFFECT_TYPE_EQUALIZER
yEFFECT_TYPE_LOUDNESS_ENHANCER
que se pueden controlar a través de las subclases de AudioEffectEqualizer
yLoudnessEnhancer
. - [C-1-2] DEBE admitir la implementación de la API del visualizador, que se puede controlar a través de la clase
Visualizer
. - [C-1-3] DEBE admitir la implementación de
EFFECT_TYPE_DYNAMICS_PROCESSING
que se puede controlar a través de la subclase de AudioEffectDynamicsProcessing
. - SE DEBE admitir las implementaciones
EFFECT_TYPE_BASS_BOOST
,EFFECT_TYPE_ENV_REVERB
,EFFECT_TYPE_PRESET_REVERB
yEFFECT_TYPE_VIRTUALIZER
controlables a través de las subclases deAudioEffect
BassBoost
,EnvironmentalReverb
,PresetReverb
yVirtualizer
. - [C-SR] SE RECOMIENDA COMPLETAMENTE para admitir efectos en punto flotante y multicanal.
5.5.3. Volumen de audio saliente
Implementaciones en dispositivos de Automotive:
- SE DEBE permitir ajustar el volumen del audio de forma independiente en cada transmisión de audio con el tipo de contenido o uso, como se define en AudioAttributes, y el uso del audio del vehículo, como se define públicamente en
android.car.CarAudioManager
.
5.6. Latencia de audio
La latencia de audio es el retraso de tiempo cuando una señal de audio pasa a través de un sistema. Muchas clases de aplicaciones dependen de latencias cortas para lograr efectos de sonido en tiempo real.
Para los fines de esta sección, usa las siguientes definiciones:
- latencia de salida. El intervalo entre el momento en que una aplicación escribe una trama de datos codificados en PCM y el momento en que el sonido correspondiente se presenta al entorno en un transductor o una señal integrados en el dispositivo sale del dispositivo a través de un puerto y se puede observar externamente.
- latencia de salida en frío. La latencia de salida del primer fotograma, cuando el sistema de salida de audio estuvo inactivo y apagado antes de la solicitud.
- latencia de salida continua. La latencia de salida para los fotogramas posteriores, después de que el dispositivo reproduce audio.
- latencia de entrada. El intervalo entre el momento en que el entorno presenta un sonido al dispositivo cuando un transductor o la señal del dispositivo ingresa al dispositivo a través de un puerto y cuando una aplicación lee la trama correspondiente de datos codificados en PCM.
- entrada perdida. La parte inicial de una señal de entrada que no se puede usar o no está disponible.
- latencia de entrada en frío. La suma del tiempo de entrada perdido y la latencia de entrada de la primera trama cuando el sistema de entrada de audio estuvo inactivo y apagado antes de la solicitud.
- latencia de entrada continua. La latencia de entrada para los fotogramas posteriores, mientras el dispositivo está capturando audio.
- Jitter de salida en frío. La variabilidad entre mediciones independientes de valores de latencia de salida en frío.
- Jitter de entrada en frío. La variabilidad entre mediciones independientes de valores de latencia de entrada en frío.
- latencia de ida y vuelta continua. Es la suma de la latencia de entrada continua más la latencia de salida continua más un período de búfer. El período de búfer permite que la app procese la señal y que mitigue la diferencia de fase entre las transmisiones de entrada y salida.
- API de cola de búfer PCM de OpenSL ES. Conjunto de APIs de OpenSL ES relacionadas con PCM dentro del NDK de Android.
- API de audio nativo de AAudio. Conjunto de APIs de AAudio dentro del NDK de Android.
- Marca de tiempo: Un par que se compone de la posición relativa de un fotograma dentro de una transmisión y el tiempo estimado en el que esa trama ingresa o sale de la canalización de procesamiento de audio en el extremo asociado. Consulta también AudioTimestamp.
- falla. Una interrupción temporal o un valor de muestra incorrecto en la señal de audio, por lo general, se debe a un desbordamiento del búfer para la salida, al búfer de entrada para la entrada o a cualquier otra fuente de ruido digital o analógico.
Si las implementaciones de dispositivos declaran android.hardware.audio.output
, DEBEN cumplir o superar los siguientes requisitos:
- [C-1-1] La marca de tiempo de salida que muestra AudioTrack.getTimestamp y
AAudioStream_getTimestamp
es precisa en +/- 2 ms. - [C-1-2] Latencia de salida en frío de 500 milisegundos o menos.
Si las implementaciones de dispositivos declaran android.hardware.audio.output
, SE RECOMIENDA ENcarecidamente cumplir o superar los siguientes requisitos:
- [C-SR] Latencia de salida en frío de 100 milisegundos o menos. SE RECOMIENDA MUY EN CUENTA que los dispositivos existentes y nuevos que ejecutan esta versión de Android cumplan con estos requisitos ahora. En un lanzamiento futuro de la plataforma en 2021, requerimos una latencia de salida en frío de 200 ms o menos como DEBE.
- [C-SR] Latencia de salida continua de 45 milisegundos o menos.
- [C-SR] Minimiza el jitter de salida en frío.
- [C-SR] La marca de tiempo de salida que devuelve AudioTrack.getTimestamp y
AAudioStream_getTimestamp
es precisa en +/- 1 ms.
Si las implementaciones del dispositivo cumplen con los requisitos anteriores, después de cualquier calibración inicial, cuando se usan tanto la cola de búfer PCM de OpenSL ES como las APIs de audio nativas de AAudio, para latencia de salida continua y latencia de salida en frío en al menos un dispositivo de salida de audio compatible, se cumplen las siguientes condiciones:
- [C-SR] SE RECOMIENDA ENRENDER informar de audio de baja latencia declarando la marca de función
android.hardware.audio.low_latency
. - [C-SR] SE RECOMIENDA ENRENDIDAMENTE para cumplir con los requisitos de audio de baja latencia a través de la API de AAudio.
- [C-SR] SE RECOMIENDA ENRENDER para garantizar que, en las transmisiones que muestren
AAUDIO_PERFORMANCE_MODE_LOW_LATENCY
deAAudioStream_getPerformanceMode()
, el valor que muestraAAudioStream_getFramesPerBurst()
sea menor o igual que el que muestraandroid.media.AudioManager.getProperty(String)
para la clave de propiedadAudioManager.PROPERTY_OUTPUT_FRAMES_PER_BUFFER
.
Si las implementaciones del dispositivo no cumplen con los requisitos para audio de baja latencia a través de la cola de búfer PCM de OpenSL ES y las APIs de audio nativas de AAudio, sucederá lo siguiente:
- [C-2-1] NO DEBE informar compatibilidad con audio de baja latencia.
Si las implementaciones de dispositivos incluyen android.hardware.microphone
, DEBEN cumplir con estos requisitos de audio de entrada:
- [C-3-1] Limita el error en las marcas de tiempo de entrada, como lo muestra AudioRecord.getTimestamp o
AAudioStream_getTimestamp
, a +/- 2 ms. “Error” aquí representa la desviación del valor correcto. - [C-3-2] Latencia de entrada en frío de 500 milisegundos o menos.
Si las implementaciones de dispositivos incluyen android.hardware.microphone
, SE RECOMIENDA ENcarecidamente que cumplan con estos requisitos de audio de entrada:
- [C-SR] Latencia de entrada en frío de 100 milisegundos o menos. SE RECOMIENDA MUY EN CUENTA que los dispositivos existentes y nuevos que ejecutan esta versión de Android cumplan con estos requisitos ahora. En un lanzamiento futuro de la plataforma en 2021, se requiere una latencia de entrada en frío de 200 ms o menos como DEBE.
- [C-SR] Latencia de entrada continua de 30 milisegundos o menos.
- [C-SR] Latencia continua de ida y vuelta de 50 milisegundos o menos.
- [C-SR] Minimiza el jitter de entrada en frío.
- [C-SR] Limita el error en las marcas de tiempo de entrada, como lo muestra AudioRecord.getTimestamp o
AAudioStream_getTimestamp
, a +/- 1 ms.
5.7. Protocolos de red
Las implementaciones en dispositivos DEBEN admitir los protocolos de red multimedia para la reproducción de audio y video, tal como se especifica en la documentación del SDK de Android.
Si las implementaciones de dispositivos incluyen un decodificador de audio o video, sucederá lo siguiente:
-
[C-1-1] DEBE admitir todos los códecs y formatos de contenedor requeridos en la sección 5.1 a través de HTTP(S).
-
[C-1-2] DEBE admitir los formatos de segmentos de medios que se muestran en la tabla de formatos de segmentos de medios a continuación en el protocolo HTTP de borrador de transmisión en vivo, versión 7.
-
[C-1-3] DEBE admitir el siguiente perfil de audio de video de RTP y los códecs relacionados en la tabla RTSP que aparece a continuación. Para conocer las excepciones, consulte las notas al pie de la tabla de la sección 5.1.
Formatos de segmentos de medios
Formatos de segmentos | Referencias | Compatibilidad con códecs requeridos |
---|---|---|
MPEG-2 Transport Stream | ISO 13818 |
Códecs de video:
y MPEG-2. Códecs de audio:
|
AAC con enmarcado ADTS y etiquetas ID3 | ISO 13818‐7 | Consulta la sección 5.1.1 para obtener detalles sobre AAC y sus variantes |
WebVTT | WebVTT |
RTSP (RTP, SDP)
Nombre del perfil | Referencias | Compatibilidad con códecs requeridos |
---|---|---|
H264 AVC | RFC 6184 | Consulta la sección 5.1.3 para obtener información detallada acerca de H264 AVC. |
MP4A-LATM | RFC 6416 | Consulta la sección 5.1.1 para obtener detalles sobre AAC y sus variantes |
H263-1998 |
RFC 3551 RFC 4629 RFC 2190 |
Consulta la sección 5.1.3 para obtener detalles sobre H263. |
H263-2000 | RFC 4629 | Consulta la sección 5.1.3 para obtener detalles sobre H263. |
AMR | RFC 4867 | Consulta la sección 5.1.1 para obtener detalles sobre AMR-NB |
AMR-WB | RFC 4867 | Consulta la sección 5.1.1 para obtener detalles sobre AMR-WB. |
MP4V‐ES | RFC 6416 | Consulta la sección 5.1.3 para obtener información detallada acerca de MPEG-4 SP |
MPEG-4-genérico | RFC 3640 | Consulta la sección 5.1.1 para obtener detalles sobre AAC y sus variantes |
MP2T | RFC 2250 | Consulta MPEG-2 Transport Stream debajo de HTTP Live Streaming para obtener más detalles. |
5.8. Contenido multimedia seguro
Si las implementaciones de dispositivos admiten salida de video segura y pueden admitir plataformas seguras, sucederá lo siguiente:
- [C-1-1] DEBE declarar compatibilidad con
Display.FLAG_SECURE
.
Si las implementaciones de dispositivos declaran compatibilidad con Display.FLAG_SECURE
y admiten el protocolo de pantalla inalámbrica, sucederá lo siguiente:
- [C-2-1] SE DEBE asegurar el enlace con un mecanismo criptográfico seguro, como HDCP 2.x o superior, para las pantallas conectadas a través de protocolos inalámbricos como Miracast.
Si las implementaciones de dispositivos declaran compatibilidad con Display.FLAG_SECURE
y admiten pantallas externas con cable, harán lo siguiente:
- [C-3-1] DEBE ser compatible con HDCP 1.2 o superior para todas las pantallas externas conectadas a través de un puerto con cable accesible para el usuario.
5.9 Interfaz digital para instrumentos musicales (MIDI)
Si las implementaciones de dispositivos informan compatibilidad con la función android.software.midi
a través de la clase android.content.pm.PackageManager
, harán lo siguiente:
-
[C-1-1] DEBE admitir MIDI en todos los transportes de hardware compatibles con MIDI para los que proporcionan conectividad genérica que no es MIDI, en los casos en que dichos transportes son:
- Modo de host USB, sección 7.7
- Funcionamiento central de MIDI por Bluetooth de bajo consumo (sección 7.4.3)
-
[C-1-2] DEBE admitir el transporte de software MIDI entre apps (dispositivos MIDI virtuales)
-
[C-1-3] DEBE incluir libamidi.so (compatibilidad nativa con MIDI)
-
SE RECOMIENDA admitir el modo periférico MIDI mediante USB (sección 7.7)
5.10. Audio profesional
Si las implementaciones de dispositivos informan compatibilidad con la función android.hardware.audio.pro
a través de la clase android.content.pm.PackageManager, sucede lo siguiente:
- [C-1-1] DEBE informar la compatibilidad con la función
android.hardware.audio.low_latency
. - [C-1-2] DEBE tener la latencia de audio de ida y vuelta continua, tal como se define en la sección 5.6 Latencia de audio, DEBE ser de 20 milisegundos o menos y DEBE ser de 10 milisegundos o menos en al menos una ruta admitida.
- [C-1-3] DEBE incluir uno o más puertos USB que admitan el modo de host USB y el modo periférico USB.
- [C-1-4] DEBE informar la compatibilidad con la función
android.software.midi
. - [C-1-5] DEBE cumplir con los requisitos de latencia y audio USB tanto con la API de cola de búfer PCM de OpenSL ES como con al menos una ruta de acceso de la API de audio nativo de AAudio.
- [SR] SE RECOMIENDA ENERCMENTE cumplir con los requisitos de latencia y audio USB con la API de audio nativo de AAudio en la ruta de acceso MMAP.
- [C-1-6] DEBE tener una latencia de salida en frío de 200 milisegundos o menos.
- [C-1-7] DEBE tener una latencia de entrada en frío de 200 milisegundos o menos.
- [SR] SE RECOMIENDEN EXITOSAMENTE para proporcionar un nivel coherente de rendimiento de CPU mientras el audio está activo y la carga de la CPU varía. Esto se debe probar con la versión de la app para Android de la ID de confirmación de SynthMark 09b13c6f49ea089f8c31e5d035f912cc405b7ab8. SynthMark usa un sintetizador de software que se ejecuta en un framework de audio simulado que mide el rendimiento del sistema. La aplicación de SynthMark debe ejecutarse con la opción “Prueba automatizada” y lograr los siguientes resultados:
- voicemark.90 >= 32 voces
- latenciamark.fixed.little <= 15 ms
- latemark.dynamic.little <= 50 ms
Consulta la documentación de SynthMark para obtener una explicación de las comparativas.
- SE DEBE minimizar la imprecisión y la desviación del reloj de audio en relación con la hora estándar.
- SE DEBE minimizar el desvío del reloj de audio en relación con el
CLOCK_MONOTONIC
de la CPU cuando ambos están activos. - SE DEBE minimizar la latencia de audio en los transductores integrados en el dispositivo.
- SE DEBE minimizar la latencia de audio mediante audio digital USB.
- SE RECOMIENDA documentar las mediciones de latencia de audio en todas las rutas de acceso.
- SE DEBE minimizar el jitter en los tiempos de entrada de devolución de llamada de finalización del búfer de audio, ya que esto afecta el porcentaje utilizable del ancho de banda total de la CPU por parte de la devolución de llamada.
- SE DEBE proporcionar cero fallas de audio en condiciones de uso normal con la latencia informada.
- SE DEBE proporcionar una diferencia de latencia entre canales de cero.
- DEBES minimizar la latencia media de MIDI en todos los transportes.
- SE RECOMIENDA minimizar la variabilidad de la latencia MIDI bajo carga (jitter) en todos los transportes.
- DEBERÍAS proporcionar marcas de tiempo MIDI precisas en todos los transportes.
- SE DEBE minimizar el ruido de la señal de audio en los transductores del dispositivo, incluido el período inmediatamente posterior al inicio en frío.
- SE DEBE proporcionar una diferencia de reloj de audio cero entre los lados de entrada y salida de los puntos finales correspondientes, cuando ambos están activos. Algunos ejemplos de los extremos correspondientes incluyen el micrófono y la bocina integrados en el dispositivo o la entrada y salida del conector de audio.
- DEBES administrar las devoluciones de llamada de finalización del búfer de audio para los extremos de entrada y salida de los extremos correspondientes en el mismo subproceso cuando ambos estén activos. Luego, se debe ingresar la devolución de llamada de salida inmediatamente después del retorno de la devolución de llamada de entrada. O, si no es posible manejar las devoluciones de llamada en el mismo subproceso, ingresa la devolución de llamada de salida poco después de ingresar la devolución de llamada de entrada para permitir que la aplicación tenga una sincronización coherente de los lados de entrada y salida.
- Se recomienda minimizar la diferencia de fase entre el almacenamiento en búfer de audio HAL para los lados de entrada y salida de los puntos finales correspondientes.
- SE DEBE minimizar la latencia táctil.
- SE DEBE minimizar la variabilidad de la latencia táctil bajo carga (jitter).
- SE DEBE tener una latencia de la entrada táctil a la salida de audio de 40 ms o menos.
Si las implementaciones de dispositivos cumplen con todos los requisitos anteriores, sucederá lo siguiente:
- [SR] RECOMIENDA QUE informes la compatibilidad con la función
android.hardware.audio.pro
a través de la claseandroid.content.pm.PackageManager
.
Si las implementaciones de los dispositivos incluyen un conector de audio de 4 conductores de 3.5 mm, sucede lo siguiente:
- [C-2-1] DEBE tener una latencia de audio de ida y vuelta continua de 20 milisegundos o menos en la ruta del conector de audio.
- [SR] SE RECOMIENDA ENRENDER que cumpla con la sección Especificaciones de dispositivo móvil (conector) de la Especificación de auriculares de audio con cable (v1.1).
- La latencia de audio de ida y vuelta continua DEBE ser de 10 milisegundos o menos en la ruta del conector de audio.
Si las implementaciones de dispositivos omiten un conector de audio de 3.5 mm de 4 conductores e incluyen un puerto USB que admite el modo de host USB, sucederá lo siguiente:
- [C-3-1] SE DEBE implementar la clase de audio USB.
- [C-3-2] DEBE tener una latencia de audio de ida y vuelta continua de 20 milisegundos o menos en el puerto del modo de host USB mediante la clase de audio USB.
- La latencia de audio de ida y vuelta continua DEBE ser de 10 milisegundos o menos en el puerto del modo de host USB mediante la clase de audio USB.
- Los [C-SR] SE RECOMIENDEN ENERMEMENTE para admitir una E/S simultánea de hasta 8 canales en cada dirección, una tasa de muestreo de 96 kHz y una profundidad de 24 bits o 32 bits cuando se usan con periféricos de audio USB que también admiten estos requisitos.
Si las implementaciones de dispositivos incluyen un puerto HDMI, sucederá lo siguiente:
- SE DEBE admitir la salida en estéreo y en ocho canales a una profundidad de 20 bits o 24 bits y a 192 kHz sin pérdida de profundidad de bits ni remuestreo, en al menos una configuración.
5.11. Captura para contenido sin procesar
Android admite la grabación de audio sin procesar a través de la fuente de audio android.media.MediaRecorder.AudioSource.UNPROCESSED
. En OpenSL ES, se puede acceder a él con el ajuste predeterminado de grabación SL_ANDROID_RECORDING_PRESET_UNPROCESSED
.
Si las implementaciones de dispositivos intentan admitir fuentes de audio sin procesar y hacer que estén disponibles para apps de terceros, deben hacer lo siguiente:
-
[C-1-1] DEBE informar la compatibilidad a través de la propiedad
android.media.AudioManager
PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED. -
[C-1-2] DEBE mostrar características aproximadamente planas de amplitud frente a frecuencia en el rango de frecuencia media: específicamente ±10 dB de 100 Hz a 7,000 Hz para cada micrófono utilizado para grabar la fuente de audio no procesada.
-
[C-1-3] DEBE mostrar niveles de amplitud en el rango de frecuencia baja: específicamente de ±20 dB, de 5 Hz a 100 Hz, en comparación con el rango de frecuencia media de cada uno de los micrófonos utilizados para grabar la fuente de audio no procesada.
-
[C-1-4] DEBE mostrar niveles de amplitud en el rango de frecuencia alta: específicamente de ±30 dB, de 7,000 Hz a 22 KHz, en comparación con el rango de frecuencia media de cada uno de los micrófonos utilizados para grabar la fuente de audio no procesada.
-
[C-1-5] SE DEBE establecer la sensibilidad de entrada de audio de modo que una fuente de tono sinusoidal de 1,000 Hz que se reproduzca a un nivel de presión sonora (SPL) de 94 dB produzca una respuesta con un RMS de 520 para muestras de 16 bits (o -36 dB de escala completa para muestras de punto flotante o de precisión doble) para cada fuente de audio usada para grabar el micrófono sin procesar.
-
El [C-1-6] DEBE tener una relación señal/ruido (SNR) de 60 dB o más para todos y cada uno de los micrófonos utilizados para grabar la fuente de audio no procesada. (mientras que la SNR se mide como la diferencia entre 94 dB del SPL y el SPL equivalente del propio ruido, ponderado A).
-
El [C-1-7] DEBE tener una distorsión armónica total inferior al 1% para 1 kHZ a un nivel de entrada de SPL de 90 dB en cada micrófono utilizado para grabar la fuente de audio no procesada.
-
NO DEBE tener ningún otro procesamiento de señal (p.ej., control automático de ganancia, filtro de paso alto o cancelación de eco) en la ruta que no sea un multiplicador de nivel para llevar el nivel al rango deseado. En otras palabras:
- [C-1-8] Si hay procesamiento de señal presente en la arquitectura por algún motivo, se DEBE inhabilitar y, de manera efectiva, introducir cero retraso o latencia adicional en la ruta de acceso de la señal.
- [C-1-9] Si bien el multiplicador de nivel puede estar en la ruta, NO DEBE generar demora ni latencia en la ruta de acceso de la señal.
Todas las mediciones del SPL se realizan directamente junto al micrófono que se está probando. Para varias configuraciones de micrófono, estos requisitos se aplican a cada micrófono.
Si las implementaciones de dispositivos declaran android.hardware.microphone
, pero no admiten fuentes de audio sin procesar, sucederá lo siguiente:
- [C-2-1] DEBE mostrar
null
para el método de la APIAudioManager.getProperty(PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED)
, a fin de indicar correctamente la falta de compatibilidad. - Aún se RECOMIENDA [SR] a fin de cumplir con la mayor cantidad de requisitos de la ruta de acceso de la señal para la fuente de registro no procesada.
6. Compatibilidad de las Herramientas y opciones para desarrolladores
6.1. Herramientas para desarrolladores
Implementaciones en dispositivos:
- [C-0-1] DEBE ser compatible con las herramientas para desarrolladores de Android que se proporcionan en el SDK de Android.
-
- [C-0-2] DEBE admitir adb como se documenta en el SDK de Android y los comandos de shell proporcionados en AOSP, que pueden usar los desarrolladores de apps, incluido
dumpsys
cmd stats
- [C-0-11] DEBE admitir el comando de shell
cmd testharness
. La actualización de implementaciones de dispositivos desde una versión anterior de Android sin un bloque de datos persistente PUEDE estar exenta de C-0-11. - [C-0-3] NO DEBE alterar el formato ni el contenido de los eventos del sistema del dispositivo (batterystats , disquete, huella digital, graphicsstats, netstats, notification, procstats) registrados con el comando dumpsys.
- [C-0-10] DEBE registrar, sin omisiones, y hacer que los siguientes eventos sean accesibles y estén disponibles para el comando de shell
cmd stats
y la clase de API del sistemaStatsManager
.- ActivityForegroundStateChanged
- Anomalía detectada
- Informado por rutas de navegación de aplicaciones
- Falla de la app
- Inicio de la aplicación
- Nivel de batería cambiado
- BatterySaverModeStateChanged
- BleScanResultReceived
- BleScanStateChanged
- Cambio de estado de carga
- ModificaciónDeEstadoDeModoIddeDispositivos.
- ForegroundServiceStateChanged
- Modificación del estado del objeto GPSScan
- Cambio de estado del trabajo
- PluggedStateChanged
- ScheduledJobStateChanged
- Cambio de estado de pantalla
- Estado de sincronización cambiado
- SystemElapsedRealtime
- UidProcessStateChanged
- Modificación del estado de bloqueo de activación
- Se produjo la alarma de despertador
- Modificación del estado de bloqueo de Wi-Fi
- Wi-FiMulticastLockStateChanged
- Wi-FiScanStateChanged
- [C-0-4] DEBE tener el daemon adb del dispositivo inactivo de forma predeterminada y DEBE haber un mecanismo accesible para el usuario para activar Android Debug Bridge.
- [C-0-5] DEBE admitir adb seguro. Android admite adb seguro. adb seguro habilita adb en hosts autenticados conocidos.
- [C-0-6] DEBE proporcionar un mecanismo que permita conectar adb desde una máquina anfitrión. Más precisamente:
Si las implementaciones de dispositivos sin un puerto USB admiten el modo periférico, sucederá lo siguiente:
- [C-3-1] DEBE implementar adb a través de una red de área local (como Ethernet o Wi-Fi).
- [C-3-2] DEBE proporcionar controladores para Windows 7, 8 y 10, de modo que los desarrolladores puedan conectarse al dispositivo usando el protocolo adb.
Si las implementaciones de dispositivos admiten conexiones adb a una máquina anfitrión a través de Wi-Fi, harán lo siguiente:
- [C-4-1] DEBE hacer que el método
AdbManager#isAdbWifiSupported()
devuelvatrue
.
Si las implementaciones de dispositivos admiten conexiones adb a una máquina anfitrión a través de Wi-Fi e incluyen al menos una cámara, sucederá lo siguiente:
- [C-5-1] DEBE hacer que el método
AdbManager#isAdbWifiQrSupported()
devuelvatrue
.
- [C-0-2] DEBE admitir adb como se documenta en el SDK de Android y los comandos de shell proporcionados en AOSP, que pueden usar los desarrolladores de apps, incluido
-
Servicio Dalvik Debug Monitor (ddms)
- [C-0-7] DEBE admitir todas las funciones de DDMS, tal como se documenta en el SDK de Android. Dado que ddms usa adb, su compatibilidad DEBE estar inactiva de forma predeterminada, pero DEBE ser compatible cada vez que el usuario activa Android Debug Bridge, como se indicó anteriormente.
-
Mono
- .
- [C-0-8] DEBE incluir el framework Monkey y ponerlo a disposición de las aplicaciones.
-
SysTrace
- .
- [C-0-9] DEBE admitir la herramienta systrace tal como se documenta en el SDK de Android. Systrace debe estar inactivo de forma predeterminada y DEBE haber un mecanismo accesible para el usuario para activarlo.
-
Perfetto
- .
- [C-SR] SE RECOMIENDA ENRENDER que expongas un objeto binario
/system/bin/perfetto
al usuario de shell y que cmdline cumpla con la documentación de perfetto. - [C-SR] Se recomienda que el objeto binario de perfetto acepte como entrada una configuración de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [C-SR] Se recomienda que el objeto binario perfetto escriba como salida un seguimiento de protobuf que cumpla con el esquema definido en la documentación de perfetto.
- [C-SR] SE RECOMIENDA COMPLETAMENTE proporcionar, mediante el objeto binario perfetto, al menos las fuentes de datos descritas en la documentación de perfetto.
- [C-SR] SE RECOMIENDA ENRENDER que expongas un objeto binario
-
Optimizador de memoria baja
- .
- [C-0-10] SE DEBE escribir un Atom
LMK_KILL_OCCURRED_FIELD_NUMBER
en el registro insightsd cuando el optimizador de poca memoria finaliza una app.
- [C-0-10] SE DEBE escribir un Atom
-
Modo de aprovechamiento de prueba Si las implementaciones del dispositivo admiten el comando de shell
cmd testharness
y ejecutancmd testharness enable
, sucederán lo siguiente:- [C-2-1] DEBE devolver
true
porActivityManager.isRunningInUserTestHarness()
. - [C-2-2] SE DEBE implementar el modo de agente de prueba como se describe en la documentación del modo de agente de prueba.
- [C-2-1] DEBE devolver
Si las implementaciones de dispositivos informan la compatibilidad con Vulkan 1.0 o versiones posteriores a través de las marcas de función android.hardware.vulkan.version
, sucede lo siguiente:
- [C-1-1] DEBE proporcionar una indicación visual para que el desarrollador de la app habilite/inhabilite las capas de depuración de GPU.
- [C-1-2] DEBE, cuando las capas de depuración de GPU están habilitadas, enumerar las capas en bibliotecas proporcionadas por herramientas externas (es decir, que no forman parte de la plataforma o el paquete de la aplicación) que se encuentran en las aplicaciones depurables. directorio base para admitir los métodos de API vkEnumerateInstanceLayerProperties() y vkCreateInstance().
6.2. Opciones para desarrolladores
Android incluye asistencia para que los desarrolladores configuren la configuración relacionada con el desarrollo de aplicaciones.
Las implementaciones en dispositivos DEBEN proporcionar una experiencia coherente para las Opciones para desarrolladores, deben cumplir con lo siguiente:
- [C-0-1] DEBE respetar el intent android.settings.APPLICATION_DEVELOPMENT_CONFIGURACIÓN para mostrar la configuración relacionada con el desarrollo de la aplicación. La implementación ascendente de Android oculta el menú Opciones para desarrolladores de forma predeterminada y permite a los usuarios iniciar Opciones para desarrolladores después de presionar siete (7) veces en Configuración > Acerca del dispositivo > Elemento de menú Número de compilación.
- [C-0-2] DEBE ocultar las Opciones para desarrolladores de forma predeterminada.
- [C-0-3] DEBE proporcionar un mecanismo claro que no brinde un trato preferencial a una app de terceros en lugar de otra para habilitar las Opciones para desarrolladores. DEBE proporcionar un documento o sitio web visible público en el que se describa cómo habilitar las Opciones para desarrolladores. Se DEBE vincular este documento o sitio web desde los documentos del SDK de Android.
- SE DEBE tener una notificación visual continua para el usuario cuando las Opciones para desarrolladores están habilitadas y la seguridad del usuario es de interés.
- PUEDE limitar temporalmente el acceso al menú Opciones para desarrolladores, con la opción de ocultar o inhabilitar visualmente el menú, para evitar distracciones en situaciones en las que la seguridad del usuario sea de preocupación.
7. Compatibilidad de hardware
Si un dispositivo incluye un componente de hardware en particular que tiene una API correspondiente para desarrolladores externos:
- [C-0-1] La implementación del dispositivo DEBE implementar esa API como se describe en la documentación del SDK de Android.
Si una API del SDK interactúa con un componente de hardware que se indica como opcional y la implementación del dispositivo no posee ese componente:
- [C-0-2] Se DEBEN presentar las definiciones completas de la clase (como se documentan en el SDK) para las APIs de componentes.
- [C-0-3] Los comportamientos de la API DEBEN implementarse como no-ops de una manera razonable.
- [C-0-4] Los métodos de API DEBEN mostrar valores nulos cuando la documentación del SDK lo permita.
- Los métodos de API [C-0-5] DEBEN mostrar implementaciones no-op de clases donde la documentación del SDK no permite valores nulos.
- [C-0-6] Los métodos de la API NO DEBEN generar excepciones no documentadas en la documentación del SDK.
- [C-0-7] Las implementaciones de dispositivos DEBEN informar de manera coherente información precisa sobre la configuración del hardware a través de los métodos
getSystemAvailableFeatures()
yhasSystemFeature(String)
en la clase android.content.pm.PackageManager para la misma huella digital de compilación.
Un ejemplo típico de una situación en la que se aplican estos requisitos es la API de telefonía: incluso en dispositivos que no sean teléfonos, estas APIs deben implementarse como no-ops razonables.
7.1. Pantalla y gráficos
Android incluye funciones que ajustan automáticamente los recursos de aplicaciones y los diseños de la IU de manera adecuada para el dispositivo a fin de garantizar que las aplicaciones de terceros se ejecuten bien en una variedad de configuraciones de hardware. En las pantallas compatibles con Android, donde se pueden ejecutar todas las aplicaciones de terceros compatibles con Android, las implementaciones de dispositivos DEBEN implementar correctamente estas APIs y comportamientos, como se detalla en esta sección.
Las unidades a las que se hace referencia en los requisitos de esta sección se definen de la siguiente manera:
- tamaño diagonal físico. Es la distancia en pulgadas entre dos esquinas opuestas de la parte iluminada de la pantalla.
- puntos por pulgada (DPI). Es la cantidad de píxeles incluidos en un intervalo horizontal o vertical lineal de 1". En los casos en que se enumeran los valores de DPI, los DPI horizontales y verticales deben estar dentro del rango.
- relación de aspecto. Es la proporción entre los píxeles de la dimensión más larga y la más corta de la pantalla. Por ejemplo, una pantalla de 480 x 854 píxeles sería 854/480 = 1.779 o aproximadamente “16:9”.
- píxel independiente de la densidad (dp). La unidad de píxeles virtuales normalizada en una pantalla de 160 dpi, calculada de la siguiente manera: píxeles = dps * (densidad/160).
7.1.1 Configuración de pantalla
7.1.1.1. Tamaño y forma de la pantalla
El framework de la IU de Android admite varios tamaños lógicos de diseño de pantalla y permite que las aplicaciones consulten el tamaño de diseño de pantalla de la configuración actual a través de Configuration.screenLayout
con SCREENLAYOUT_SIZE_MASK
y Configuration.smallestScreenWidthDp
.
Implementaciones en dispositivos:
-
[C-0-1] DEBE informar el tamaño de diseño correcto para
Configuration.screenLayout
según se define en la documentación del SDK de Android. Específicamente, las implementaciones en dispositivos DEBEN informar las dimensiones de pantalla correctas de píxeles independientes de la densidad (dp) lógica como se muestra a continuación:- Los dispositivos con
Configuration.uiMode
configurado como cualquier valor distinto de UI_MODE_TYPE_WATCH y que informan un tamaño desmall
paraConfiguration.screenLayout
DEBEN tener al menos 426 dp x 320 dp. - Los dispositivos que informan un tamaño de
normal
paraConfiguration.screenLayout
DEBEN tener, al menos, 480 dp x 320 dp. - Los dispositivos que informan un tamaño de
large
para elConfiguration.screenLayout
DEBEN tener, al menos, 640 dp x 480 dp. - Los dispositivos que informan un tamaño de
xlarge
paraConfiguration.screenLayout
DEBEN tener, al menos, 960 dp x 720 dp.
- Los dispositivos con
-
[C-0-2] DEBE respetar correctamente las aplicaciones indicó la compatibilidad con tamaños de pantalla mediante el atributo <
supports-screens
> en el AndroidManifest.xml, como se describe en la documentación del SDK de Android. -
PUEDE tener pantallas compatibles con Android con esquinas redondeadas.
Si las implementaciones de dispositivos admiten UI_MODE_TYPE_NORMAL
e incluyen pantallas compatibles con Android con esquinas redondeadas, sucederán lo siguiente:
- [C-1-1] DEBE asegurarse de que se cumpla al menos uno de los siguientes requisitos:
- El radio de las esquinas redondeadas es menor o igual que 38 dp.
-
Cuando se ancla un cuadro de 15 dp por 15 dp en cada esquina de la pantalla lógica, se puede ver al menos un píxel de cada cuadro en la pantalla.
-
SE RECOMIENDA incluir la indicación visual del usuario para cambiar al modo de visualización con las esquinas rectangulares.
Si las implementaciones en dispositivos incluyen pantallas plegables o compatibles con Android, o que incluyen una bisagra plegable entre varios paneles de pantallas y ponen esas pantallas a disposición para renderizar apps de terceros, deben hacer lo siguiente:
- [C-2-1] DEBE implementar la última versión estable disponible de la API de Extensions o la versión estable de la API de sidecar para que la use la biblioteca de Window Manager Jetpack.
Si las implementaciones de dispositivos incluyen pantallas plegables compatibles con Android o incluyen una bisagra plegable entre varios paneles de pantallas, y si la bisagra o el pliegue cruzan una ventana de aplicación en pantalla completa, sucede lo siguiente:
- [C-3-1] SE DEBE informar la posición, los límites y el estado de la bisagra o el pliegue a través de extensiones o APIs de sidecar a la aplicación.
Para obtener detalles sobre la implementación correcta de las APIs de sidecar o extensión, consulta la documentación pública de Window Manager Jetpack.
7.1.1.2. Relación de aspecto de la pantalla
Si bien no hay restricciones para la relación de aspecto de la pantalla física para las pantallas compatibles con Android, la relación de aspecto de la pantalla lógica donde se renderizan las apps de terceros, que puede derivar de los valores de altura y ancho informados a través de las APIs de view.Display
y las APIs de configuración, DEBE cumplir con los siguientes requisitos:
-
[C-0-1] Las implementaciones en dispositivos con
Configuration.uiMode
establecido enUI_MODE_TYPE_NORMAL
DEBEN tener un valor de relación de aspecto inferior o igual a 1.86 (aproximadamente 16:9), a menos que la app cumpla una de las siguientes condiciones:- La app declaró que admite una relación de aspecto de pantalla más grande mediante el valor de metadatos
android.max_aspect
. - La app declara que se puede cambiar su tamaño a través del atributo android:resizeableActivity.
- La app tiene como objetivo el nivel de API 24 o uno superior, y no declara un
android:maxAspectRatio
que pueda restringir la relación de aspecto permitida.
- La app declaró que admite una relación de aspecto de pantalla más grande mediante el valor de metadatos
-
[C-0-2] Las implementaciones en dispositivos con
Configuration.uiMode
establecido enUI_MODE_TYPE_NORMAL
DEBEN tener un valor de relación de aspecto igual o superior a 1.3333 (4:3), a menos que la app pueda ampliarse cuando se cumpla una de las siguientes condiciones:- La app declara que se puede cambiar su tamaño a través del atributo android:resizeableActivity.
- La app declara un
android:minAspectRatio
que restringiría la relación de aspecto permitida.
-
[C-0-3] Las implementaciones en dispositivos con
Configuration.uiMode
configurado comoUI_MODE_TYPE_WATCH
DEBEN tener un valor de relación de aspecto establecido en 1.0 (1:1).
7.1.1.3. Densidad de la pantalla
El framework de la IU de Android define un conjunto de densidades lógicas estándar para ayudar a los desarrolladores de aplicaciones a orientarse a los recursos de la aplicación.
-
[C-0-1] De forma predeterminada, las implementaciones del dispositivo DEBEN informar solo una de las densidades del framework de Android que se indican en
DisplayMetrics
a través de la API deDENSITY_DEVICE_STABLE
y este valor NO DEBE cambiar en ningún momento. Sin embargo, PUEDE informar una densidad arbitraria diferente de acuerdo con los cambios en la configuración de la pantalla que realiza el usuario (por ejemplo, el tamaño de la pantalla) que se establecieron después del inicio inicial. -
Las implementaciones en dispositivos DEBEN definir la densidad estándar del framework de Android que es numéricamente más cercana a la densidad física de la pantalla, a menos que esa densidad lógica desplace el tamaño de pantalla informado por debajo del mínimo admitido. Si la densidad del framework estándar de Android que es numéricamente más cercana a la densidad física da como resultado un tamaño de pantalla menor que el tamaño de pantalla más pequeño compatible y compatible (320 dp de ancho), las implementaciones de dispositivos DEBEN informar la siguiente densidad del framework estándar de Android más baja.
Si hay una indicación para cambiar el tamaño de visualización del dispositivo, haz lo siguiente:
- [C-1-1] El tamaño de pantalla NO DEBE ajustarse a más de 1.5 veces la densidad nativa ni producir una dimensión de pantalla mínima efectiva inferior a 320 dp (equivalente al sw320 dp del calificador de recursos), lo que ocurra primero.
- [C-1-2] El tamaño de la pantalla NO se DEBE ajustar a una escala inferior a 0.85 veces la densidad nativa.
- Para garantizar una buena usabilidad y tamaños de fuente coherentes, se RECOMIENDA proporcionar la siguiente escala de opciones de anuncios gráficos nativos (siempre y cuando se cumplan los límites especificados anteriormente):
- Pequeño: 0.85x
- Predeterminado: 1x (escala de visualización nativa)
- Grande: 1.15x
- Más grande: 1.3 veces
- Mayor 1.45 veces
7.1.2. Métricas de Display
Si las implementaciones de dispositivos incluyen pantallas o salidas de video compatibles con Android, deben hacer lo siguiente:
- [C-1-1] DEBE informar los valores correctos para todas las métricas de pantalla compatibles con Android definidas en la API de
android.util.DisplayMetrics
.
Si las implementaciones en dispositivos no incluyen una pantalla incorporada o una salida de video, sucederá lo siguiente:
- [C-2-1] DEBE informar los valores correctos de la pantalla compatible con Android, como se define en la API de
android.util.DisplayMetrics
para elview.Display
predeterminado emulado.
7.1.3 Orientación de pantalla
Implementaciones en dispositivos:
- [C-0-1] DEBE informar qué orientaciones de pantalla admiten (
android.hardware.screen.portrait
oandroid.hardware.screen.landscape
) y DEBE informar, al menos, una orientación compatible. Por ejemplo, un dispositivo con una pantalla horizontal con orientación fija, como una televisión o una laptop, solo DEBE informarandroid.hardware.screen.landscape
. - [C-0-2] SE DEBE informar el valor correcto para la orientación actual del dispositivo, siempre que se realice una consulta a través de
android.content.res.Configuration.orientation
,android.view.Display.getOrientation()
o alguna otra API.
Si las implementaciones de dispositivos admiten ambas orientaciones de pantalla, sucederá lo siguiente:
- [C-1-1] DEBE admitir la orientación dinámica de las aplicaciones a la orientación de pantalla vertical u horizontal. Es decir, el dispositivo debe respetar la solicitud de la aplicación respecto de una orientación de pantalla específica.
- [C-1-2] NO DEBE cambiar la densidad o el tamaño de pantalla informados cuando se cambia la orientación.
- PUEDES seleccionar la orientación vertical u horizontal como opción predeterminada.
7.1.4. Aceleración de gráficos 2D y 3D
7.1.4.1 OpenGL ES
Implementaciones en dispositivos:
- [C-0-1] DEBE identificar correctamente las versiones de OpenGL ES compatibles (1.1, 2.0, 3.0, 3.1, 3.2) a través de las APIs administradas (por ejemplo, a través del método
GLES10.getString()
) y las APIs nativas. - [C-0-2] SE DEBE incluir compatibilidad con todas las APIs nativas y las APIs administradas correspondientes para cada versión de OpenGL ES que identificó como compatible.
Si las implementaciones en dispositivos incluyen una salida de pantalla o de video, sucederá lo siguiente:
- [C-1-1] DEBE admitir OpenGL ES 1.1 y 2.0, tal como se detalla en la documentación del SDK de Android.
- [C-SR] SE RECOMIENDA COMPLETAMENTE ser compatible con OpenGL ES 3.1.
- SE DEBE admitir OpenGL ES 3.2.
Si las implementaciones de dispositivos admiten alguna de las versiones de OpenGL ES, sucederá lo siguiente:
- [C-2-1] SE DEBE informar a través de las APIs nativas y las APIs administradas de OpenGL ES sobre cualquier otra extensión de OpenGL ES que hayan implementado. Por el contrario, NO DEBE informar las cadenas de extensión que no admiten.
- [C-2-2] DEBE admitir las extensiones
EGL_KHR_image
,EGL_KHR_image_base
,EGL_ANDROID_image_native_buffer
,EGL_ANDROID_get_native_client_buffer
,EGL_KHR_wait_sync
,EGL_KHR_get_all_proc_addresses
,EGL_ANDROID_presentation_time
,EGL_KHR_swap_buffers_with_damage
,EGL_ANDROID_recordable
yEGL_ANDROID_GLES_layers
. - [C-SR] SE RECOMIENDA COMPLETAMENTE ser compatible con las extensiones
EGL_KHR_partial_update
yOES_EGL_image_external
. - SE DEBEN informar con precisión a través del método
getString()
, cualquier formato de compresión de texturas que admitan, que suele ser específico del proveedor.
Si las implementaciones de dispositivos declaran compatibilidad con OpenGL ES 3.0, 3.1 o 3.2, suceden lo siguiente:
- [C-3-1] DEBE exportar los símbolos de función correspondientes a estas versiones, además de los símbolos de función OpenGL ES 2.0 en la biblioteca libGLESv2.so.
- [SR] SE RECOMIENDA COMPLETAMENTE ser compatible con la extensión
OES_EGL_image_external_essl3
.
Si las implementaciones de dispositivos admiten OpenGL ES 3.2, sucederán lo siguiente:
- [C-4-1] DEBE admitir el paquete de extensiones de Android para OpenGL ES en su totalidad.
Si las implementaciones de dispositivos admiten el Android Extension Pack de OpenGL ES en su totalidad, sucederá lo siguiente:
- [C-5-1] SE DEBE identificar la compatibilidad a través de la marca de función
android.hardware.opengles.aep
.
Si las implementaciones de dispositivos exponen la compatibilidad con la extensión EGL_KHR_mutable_render_buffer
, harán lo siguiente:
- [C-6-1] también DEBE admitir la extensión
EGL_ANDROID_front_buffer_auto_refresh
.
7.1.4.2 Vulkan
Android admite Vulkan, una API multiplataforma de baja sobrecarga para gráficos 3D de alto rendimiento.
Si las implementaciones de dispositivos admiten OpenGL ES 3.1, sucederán lo siguiente:
- [SR] SE RECOMIENDA COMPLETAMENTE incluir compatibilidad con Vulkan 1.1.
Si las implementaciones en dispositivos incluyen una salida de pantalla o de video, sucederá lo siguiente:
- SE RECOMIENDA incluir compatibilidad con Vulkan 1.1.
Las pruebas de dEQP de Vulkan se dividen en varias listas de prueba, cada una con una fecha o versión asociada. Se encuentran en el árbol de fuentes de Android en external/deqp/android/cts/main/vk-master-YYYY-MM-DD.txt
. Un dispositivo que admite Vulkan en un nivel autoinformado indica que puede pasar las pruebas dEQP en todas las listas de prueba de este nivel y anteriores.
Si las implementaciones en dispositivos incluyen compatibilidad con Vulkan 1.0 o versiones posteriores, sucederá lo siguiente:
- [C-1-1] DEBE informar el valor de número entero correcto con las marcas de función
android.hardware.vulkan.level
yandroid.hardware.vulkan.version
. - [C-1-2] SE DEBE enumerar, al menos, un
VkPhysicalDevice
para la API nativa de VulkanvkEnumeratePhysicalDevices()
. - [C-1-3] SE DEBE implementar por completo las APIs de Vulkan 1.0 para cada
VkPhysicalDevice
enumerado. - [C-1-4] SE DEBE enumerar las capas, contenidas en bibliotecas nativas denominadas
libVkLayer*.so
en el directorio de bibliotecas nativas del paquete de la aplicación, a través de las APIs nativas de VulkanvkEnumerateInstanceLayerProperties()
yvkEnumerateDeviceLayerProperties()
. - [C-1-5] NO DEBE enumerar las capas proporcionadas por bibliotecas fuera del paquete de aplicación ni proporcionar otras formas de hacer un seguimiento o interceptar la API de Vulkan, a menos que la aplicación tenga el atributo
android:debuggable
establecido comotrue
. - [C-1-6] DEBE informar todas las cadenas de extensión que sí admiten a través de las APIs nativas de Vulkan. Por el contrario , NO DEBE informar cadenas de extensión que no admiten correctamente.
- [C-1-7] DEBE admitir las extensiones VK_KHR_surface, VK_KHR_android_surface, VK_KHR_swapchain y VK_KHR_incremental_present.
- [C-1-8] SE DEBE informar la versión máxima de las pruebas dEQP de Vulkan compatibles con la marca de función
android.software.vulkan.deqp.level
. - [C-1-9] DEBE al menos admitir la versión
132317953
(a partir del 1 de marzo de 2019), como se indica en la marca de funciónandroid.software.vulkan.deqp.level
. - [C-1-10] DEBE superar todas las pruebas de dEQP de Vulkan en las listas de prueba entre la versión
132317953
y la versión especificada en la marca de funciónandroid.software.vulkan.deqp.level
. - [C-SR] SE RECOMIENDA ENERGENTEMENTE ser compatible con las extensiones VK_KHR_driver_properties y VK_GOOGLE_display_timing.
Si las implementaciones en dispositivos no incluyen compatibilidad con Vulkan 1.0, sucederá lo siguiente:
- [C-2-1] NO DEBE declarar ninguna de las marcas de función de Vulkan (p.ej.,
android.hardware.vulkan.level
,android.hardware.vulkan.version
). - [C-2-2] NO DEBE enumerar ningún
VkPhysicalDevice
para la API nativa de VulkanvkEnumeratePhysicalDevices()
.
Si las implementaciones de dispositivos incluyen compatibilidad con Vulkan 1.1 y declaran alguna de las marcas de función de Vulkan, sucederá lo siguiente:
- [C-3-1] DEBE exponer la compatibilidad con el semáforo externo y los tipos de controlador
SYNC_FD
y la extensiónVK_ANDROID_external_memory_android_hardware_buffer
.
7.1.4.3 RenderScript
- [C-0-1] Las implementaciones en dispositivos DEBEN ser compatibles con Android RenderScript, como se detalla en la documentación del SDK de Android.
7.1.4.4 Aceleración de gráficos 2D
Android incluye un mecanismo para que las aplicaciones declaren que desean habilitar la aceleración de hardware para gráficos 2D a nivel de aplicación, actividad, ventana o vista mediante el uso de una etiqueta de manifiesto android:hardwareAccelerated o llamadas directas a la API.
Implementaciones en dispositivos:
- [C-0-1] DEBE habilitar la aceleración de hardware de forma predeterminada y DEBE inhabilitarla si el desarrollador lo solicita configurando android:hardwareAccelerated="false” o inhabilitando la aceleración de hardware directamente a través de las API de Android View.
- [C-0-2] DEBE mostrar un comportamiento coherente con la documentación del SDK de Android sobre aceleración de hardware.
Android incluye un objeto TextureView que permite a los desarrolladores integrar directamente texturas de OpenGL ES con aceleración de hardware como objetivos de renderización en una jerarquía de IU.
Implementaciones en dispositivos:
- [C-0-3] DEBE ser compatible con la API de TextureView y DEBE mostrar un comportamiento coherente con la implementación ascendente de Android.
7.1.4.5 Pantallas de amplia gama
Si las implementaciones de dispositivos afirman ser compatibles con pantallas de amplia gama a través de Configuration.isScreenWideColorGamut()
, sucede lo siguiente:
- [C-1-1] DEBE tener una pantalla con calibración de color.
- [C-1-2] DEBE tener una pantalla cuyo gamut cubra el gamut de colores sRGB por completo en el espacio CIE 1931 xyY.
- [C-1-3] DEBE tener una pantalla cuyo gamut tenga un área de al menos el 90% de DCI-P3 en el espacio CIE 1931 xyY.
- [C-1-4] SE DEBE admitir OpenGL ES 3.1 o 3.2, y se debe informar correctamente.
- [C-1-5] DEBE anunciar la compatibilidad con las extensiones
EGL_KHR_no_config_context
,EGL_EXT_pixel_format_float
,EGL_KHR_gl_colorspace
,EGL_EXT_gl_colorspace_scrgb
,EGL_EXT_gl_colorspace_scrgb_linear
,EGL_EXT_gl_colorspace_display_p3
,EGL_EXT_gl_colorspace_display_p3_linear
yEGL_EXT_gl_colorspace_display_p3_passthrough
. - [C-SR] SE RECOMIENDA MUY BIEN apoyar a
GL_EXT_sRGB
.
Por el contrario, si las implementaciones de dispositivos no admiten pantallas de amplia gama, sucederá lo siguiente:
- [C-2-1] SE DEBE cubrir el 100% o más de sRGB en el espacio xyY de CIE 1931, aunque el gamut de colores de la pantalla no está definido.
7.1.5 Modo de compatibilidad de aplicaciones heredadas
Android especifica un “modo de compatibilidad” en el que el framework funciona de forma “normal” modo equivalente al tamaño de pantalla (320 dp de ancho) para el beneficio de aplicaciones heredadas no desarrolladas para versiones anteriores de Android que son anteriores a la independencia del tamaño de la pantalla.
7.1.6. Tecnología de pantalla
La plataforma de Android incluye API que permiten a las aplicaciones renderizar gráficos enriquecidos en una pantalla compatible con Android. Los dispositivos DEBEN admitir todas estas APIs, según lo define el SDK de Android, a menos que se permita específicamente en este documento.
Todas las pantallas compatibles con Android de una implementación de dispositivo:
- [C-0-1] DEBE ser capaz de renderizar gráficos de colores de 16 bits.
- SE RECOMIENDA admitir pantallas que admitan gráficos de color de 24 bits.
- [C-0-2] DEBE ser capaz de renderizar animaciones.
- [C-0-3] DEBE tener una relación de aspecto de píxeles (PAR) de entre 0.9 y 1.15. Es decir, la relación de aspecto de los píxeles DEBE ser cercana al cuadrado (1.0) con una tolerancia del 10% al 15%.
7.1.7 Pantallas secundarias
Android incluye compatibilidad con pantallas secundarias compatibles con Android para habilitar las capacidades de uso compartido de contenido multimedia y APIs para desarrolladores para acceder a pantallas externas.
Si las implementaciones de dispositivos admiten una pantalla externa, ya sea a través de una conexión con cable, inalámbrica o una conexión de pantalla adicional incorporada, hacen lo siguiente:
- [C-1-1] SE DEBE implementar el servicio del sistema y la API de
DisplayManager
como se describe en la documentación del SDK de Android.
7.2. Dispositivos de entrada
Implementaciones en dispositivos:
- [C-0-1] DEBE incluir un mecanismo de entrada, como una pantalla táctil o navegación no táctil, para navegar entre los elementos de la IU.
7.2.1. Teclado
Si las implementaciones de dispositivos incluyen compatibilidad con aplicaciones de terceros del Editor de método de entrada (IME), sucederá lo siguiente:
- [C-1-1] DEBE declarar la marca de función
android.software.input_methods
. - [C-1-2] DEBE implementar completamente
Input Management Framework
- [C-1-3] DEBE tener un teclado en pantalla preinstalado.
Implementaciones de dispositivos: * [C-0-1] NO DEBEN incluir un teclado de hardware que no coincida con uno de los formatos especificados en android.content.res.Configuration.tecla (QWERTY o teclas de 12 teclas). * SE DEBE incluir implementaciones adicionales de teclado en pantalla. * PUEDE incluir un teclado de hardware.
7.2.2. Navegación no táctil
Android incluye compatibilidad con pad direccional, bola de seguimiento y rueda como mecanismos de navegación no táctil.
Implementaciones en dispositivos:
- [C-0-1] DEBE informar el valor correcto de android.content.res.Configuration.navigation.
Si las implementaciones de dispositivos no tienen navegaciones no táctiles, sucede lo siguiente:
- [C-1-1] DEBE proporcionar un mecanismo de interfaz de usuario alternativo razonable para la selección y edición de texto que sea compatible con los motores de administración de entradas. La implementación ascendente de código abierto de Android incluye un mecanismo de selección adecuado para su uso con dispositivos que carecen de entradas de navegación no táctiles.
7.2.3. Teclas de navegación
Las funciones Inicio, Recientes y Atrás que, por lo general, se proporcionan mediante la interacción con un botón físico dedicado o una parte distinta de la pantalla táctil, son esenciales para el paradigma de navegación de Android y, por lo tanto, son implementaciones en dispositivos:
- [C-0-1] DEBE proporcionar una indicación visual de usuario para iniciar aplicaciones instaladas que tienen una actividad con el
<intent-filter>
establecido conACTION=MAIN
yCATEGORY=LAUNCHER
oCATEGORY=LEANBACK_LAUNCHER
para implementaciones de dispositivos de televisión. La función Inicio DEBE ser el mecanismo de esta indicación del usuario. - SE DEBE proporcionar botones para las funciones Recientes y Atrás.
Si se proporcionan las funciones Inicio, Recientes o Atrás, significan lo siguiente:
- Se DEBE poder acceder al [C-1-1] con una sola acción (p.ej., tocar, hacer doble clic o gesto) cuando se puede acceder a cualquiera de ellas.
- [C-1-2] DEBE proporcionar una indicación clara de qué acción activaría cada función. Tener un ícono visible impreso en el botón, mostrar un ícono de software en la parte de la barra de navegación de la pantalla o guiar al usuario a través de un flujo de demostración guiado paso a paso durante la experiencia de configuración lista para usar son ejemplos de esta indicación.
Implementaciones en dispositivos:
- Se RECOMIENDA [SR] no proporcionar el mecanismo de entrada para la función Menú, ya que dejó de estar disponible y se reemplazó por la barra de acciones a partir de Android 4.0.
Si las implementaciones de dispositivos proporcionan la función Menú, sucederá lo siguiente:
- [C-2-1] SE DEBE mostrar el botón de ampliación de acciones siempre que la ventana emergente del menú ampliado de acciones no esté vacía y la barra de acciones esté visible.
- [C-2-2] NO DEBE modificar la posición de la ventana emergente de desbordamiento de acciones que se muestra seleccionando el botón de menú ampliado en la barra de acciones, pero PUEDE representarla en una posición modificada en la pantalla cuando se muestra seleccionando la función Menú.
Si las implementaciones de dispositivos no proporcionan la función de menú, para la retrocompatibilidad, harán lo siguiente:
- [C-3-1] DEBE hacer que la función Menú esté disponible para las aplicaciones cuando
targetSdkVersion
es inferior a 10, ya sea por un botón físico, una tecla de software o gestos. Se debe poder acceder a esta función de menú, a menos que esté oculta junto con otras funciones de navegación.
Si las implementaciones de dispositivos proporcionan la función Assist, hacen lo siguiente:
- [C-4-1] DEBE permitir el acceso a la función de asistencia con una sola acción (por ejemplo, tocar, hacer doble clic o gesto) cuando otras teclas de navegación están disponibles.
- [SR] SE RECOMIENDA ENRENDER que se mantenga presionada la función INICIO como esta interacción designada.
Si las implementaciones de dispositivos usan una parte distinta de la pantalla para mostrar las teclas de navegación, harán lo siguiente:
- [C-5-1] Las teclas de navegación DEBEN usar una parte distinta de la pantalla, no están disponibles para las aplicaciones, y NO DEBEN oscurecer ni interferir de ninguna otra manera la parte de la pantalla disponible para las aplicaciones.
- [C-5-2] DEBE poner una parte de la pantalla a disposición de las aplicaciones que cumplan con los requisitos definidos en la sección 7.1.1.
- [C-5-3] DEBE respetar las marcas establecidas por la app a través del método de la API
View.setSystemUiVisibility()
para que esta parte distinta de la pantalla (también conocida como barra de navegación) esté oculta correctamente, como se documenta en el SDK.
Si la función de navegación se proporciona como una acción en pantalla basada en gestos:
- [C-6-1]
WindowInsets#getMandatorySystemGestureInsets()
solo DEBE usarse para informar el área de reconocimiento de gestos de la pantalla principal. - [C-6-2] Los gestos que comienzan dentro de un rectángulo de exclusión proporcionado por la aplicación en primer plano a través de
View#setSystemGestureExclusionRects()
, pero fuera deWindowInsets#getMandatorySystemGestureInsets()
, NO DEBEN ser interceptados para la función de navegación, siempre y cuando el rectángulo de exclusión esté permitido dentro del límite de exclusión máximo especificado en la documentación deView#setSystemGestureExclusionRects()
. - [C-6-3] DEBE enviar a la app en primer plano un evento
MotionEvent.ACTION_CANCEL
una vez que comiencen a interceptarse los toques para un gesto del sistema si la app en primer plano ya envió un eventoMotionEvent.ACTION_DOWN
. - [C-6-4] DEBE proporcionar una indicación visual del usuario para cambiar a una navegación en pantalla basada en botones (por ejemplo, en Configuración).
- SE DEBE proporcionar la función de inicio deslizando el dedo hacia arriba desde el borde inferior de la orientación actual de la pantalla.
- SE DEBE proporcionar la función Recientes al deslizar hacia arriba y mantener presionado antes de soltar, desde la misma área que el gesto de la pantalla principal.
- Los gestos que comienzan en
WindowInsets#getMandatorySystemGestureInsets()
NO DEBEN verse afectados por los rectángulos de exclusión proporcionados por la aplicación en primer plano a través deView#setSystemGestureExclusionRects()
.
Si se proporciona una función de navegación desde cualquier parte de los bordes izquierdo y derecho de la orientación actual de la pantalla:
- [C-7-1] La función de navegación DEBE estar atrás y proporcionarse al deslizar desde los bordes izquierdo y derecho de la orientación actual de la pantalla.
- [C-7-2] Si se proporcionan paneles del sistema deslizables personalizados en los bordes izquierdo o derecho, DEBEN colocarse en el tercio superior de la pantalla con una indicación visual clara y persistente de que, al arrastrar los elementos, se invocarían los paneles mencionados anteriormente y, por lo tanto, no se debería colocar en Atrás. Un usuario PUEDE configurar un panel del sistema de modo que quede debajo del 1/3 de los bordes superiores de la pantalla, pero este panel NO DEBE usar más de 1/3 de ellos.
- [C-7-3] Cuando la app en primer plano tiene configuradas las marcas
View.SYSTEM_UI_FLAG_IMMERSIVE
oView.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
, el deslizamiento desde los bordes DEBE comportarse como se implementó en AOSP, que se documenta en el SDK. - [C-7-4] Cuando la app en primer plano tiene configuradas las marcas
View.SYSTEM_UI_FLAG_IMMERSIVE
oView.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
, los paneles del sistema deslizables personalizados DEBEN ocultarse hasta que el usuario traiga las barras del sistema (también conocidas como barra de estado y navegación) como se implementaron en AOSP.
7.2.4. Entrada de pantalla táctil
Android incluye compatibilidad con una variedad de sistemas de entrada de puntero, como pantallas táctiles, paneles táctiles y dispositivos de entrada táctil falsos. Las implementaciones de dispositivos basados en pantallas táctiles se asocian con una pantalla de modo que el usuario tenga la impresión de manipular directamente elementos en pantalla. Dado que el usuario está tocando directamente la pantalla, el sistema no requiere indicaciones adicionales para indicar los objetos que se están manipulando.
Implementaciones en dispositivos:
- SE RECOMIENDA tener algún tipo de sistema de entrada de puntero (ya sea similar al de un mouse o táctil).
- SE RECOMIENDA admitir punteros con seguimiento independiente en su totalidad.
Si las implementaciones de dispositivos incluyen una pantalla táctil (de un solo toque o mejor) en una pantalla principal compatible con Android, sucederá lo siguiente:
- [C-1-1] SE DEBE informar
TOUCHSCREEN_FINGER
para el campo de APIConfiguration.touchscreen
. - [C-1-2] SE DEBE informar las marcas de función
android.hardware.touchscreen
yandroid.hardware.faketouch
.
Si las implementaciones de dispositivos incluyen una pantalla táctil que puede rastrear más de un toque en una pantalla principal compatible con Android, sucederá lo siguiente:
- [C-2-1] DEBE informar las marcas de función correspondientes
android.hardware.touchscreen.multitouch
,android.hardware.touchscreen.multitouch.distinct
,android.hardware.touchscreen.multitouch.jazzhand
correspondientes al tipo de pantalla táctil específica del dispositivo.
Si las implementaciones de dispositivos dependen de un dispositivo de entrada externo, como un mouse o una bola de seguimiento (es decir, que no toque directamente la pantalla) para ingresar en una pantalla principal compatible con Android y cumplen con los requisitos de entrada táctil falsos de la sección 7.2.5:
- [C-3-1] NO DEBE informar ninguna marca de función que comience con
android.hardware.touchscreen
. - [C-3-2] DEBE informar solo
android.hardware.faketouch
. - [C-3-3] DEBE informar
TOUCHSCREEN_NOTOUCH
para el campo de APIConfiguration.touchscreen
.
7.2.5. Entrada táctil falsa
La interfaz táctil falsa proporciona un sistema de entrada del usuario que se aproxima a un subconjunto de capacidades de pantalla táctil. Por ejemplo, un mouse o un control remoto que impulsa un cursor en pantalla se aproxima al tacto, pero requiere que el usuario primero apunte o enfoque y, luego, haga clic. Varios dispositivos de entrada, como el mouse, el panel táctil, el mouse aéreo basado en giroscopio, el puntero giroscópico, el joystick y el panel táctil multitáctil, pueden admitir interacciones táctiles falsas. Android incluye la función constante android.hardware.faketouch, que corresponde a un dispositivo de entrada de alta fidelidad no táctil (basado en puntero), como un mouse o un panel táctil que puede emular de forma adecuada una entrada táctil (incluida la compatibilidad básica con gestos), e indica que el dispositivo admite un subconjunto emulado de funcionalidad de pantalla táctil.
Si las implementaciones de dispositivos no incluyen una pantalla táctil, pero sí otro sistema de entrada de puntero que desean que esté disponible, sucede lo siguiente:
- SE DEBE declarar la compatibilidad con la marca de función
android.hardware.faketouch
.
Si las implementaciones de dispositivos declaran compatibilidad con android.hardware.faketouch
, sucederá lo siguiente:
- [C-1-1] DEBE informar las posiciones X e Y absolutas de la pantalla de la ubicación del puntero y mostrar un puntero visual en la pantalla.
- [C-1-2] DEBE informar un evento táctil con el código de acción que especifica el cambio de estado que se produce cuando el puntero hacia abajo o hacia arriba en la pantalla.
- [C-1-3] DEBE admitir el puntero hacia abajo y hacia arriba en un objeto en pantalla, lo que permite a los usuarios emular el toque en un objeto en pantalla.
- [C-1-4] DEBE admitir puntero hacia abajo, puntero hacia arriba, puntero hacia abajo y, luego, puntero hacia arriba en el mismo lugar de un objeto en la pantalla dentro de un umbral de tiempo, lo que permite a los usuarios emular presionar dos veces en un objeto en pantalla.
- [C-1-5] DEBE admitir el puntero hacia abajo en un punto arbitrario de la pantalla, el puntero se mueve a cualquier otro punto arbitrario de la pantalla y el puntero hacia arriba, lo que permite a los usuarios emular un arrastre táctil.
- [C-1-6] DEBE admitir el puntero hacia abajo y, luego, permitir a los usuarios mover rápidamente el objeto a una posición diferente en la pantalla y, luego, apuntar hacia arriba en la pantalla, lo que permite a los usuarios desplazar un objeto en la pantalla.
Si las implementaciones de dispositivos declaran compatibilidad con android.hardware.faketouch.multitouch.distinct
, sucederá lo siguiente:
- [C-2-1] DEBE declarar compatibilidad con
android.hardware.faketouch
. - [C-2-2] DEBE admitir un seguimiento distinto de dos o más entradas de puntero independientes.
Si las implementaciones de dispositivos declaran compatibilidad con android.hardware.faketouch.multitouch.jazzhand
, sucederá lo siguiente:
- [C-3-1] DEBE declarar compatibilidad con
android.hardware.faketouch
. - [C-3-2] DEBE admitir un seguimiento distinto de 5 (seguimiento de una mano de dedos) o más entradas del puntero de forma completamente independiente.
7.2.6. Compatibilidad con controles de juegos
7.2.6.1. Asignaciones de botones
Implementaciones en dispositivos:
- [C-1-1] DEBE ser capaz de asignar eventos HID a las constantes
InputEvent
correspondientes, como se indica en las siguientes tablas. La implementación ascendente de Android cumple con este requisito.
Si las implementaciones de dispositivos incorporan un controlador o se envían con un controlador independiente en la caja que proporcionaría medios para ingresar todos los eventos enumerados en las siguientes tablas, sucederá lo siguiente:
- [C-2-1] SE DEBE declarar la marca de función
android.hardware.gamepad
.
Botón | Uso de HID2 | Botón de Android |
---|---|---|
R1 | 0x09 0x0001. | KEYCODE_BUTTON_A (96) |
B1 | 0x09 0x0002 | KEYCODE_BUTTON_B (97) |
X1 | 0x090x0004. | KEYCODE_BUTTON_X (99) |
A1 | 0x090x0005. | KEYCODE_BUTTON_Y (100) |
Arriba de pad direccional1 Pad direccional abajo1 |
0x01 0x00393 | AXIS_HAT_Y4 |
Pad direccional izquierdo1 Pad direccional derecho1 |
0x01 0x00393 | AXIS_HAT_X4 |
Botón del hombro izquierdo1 | 0x090x0007. | KEYCODE_BUTTON_L1 (102) |
Botón del hombro derecho1 | 0x09 0x0008. | KEYCODE_BUTTON_R1 (103) |
Clic con la palanca izquierda1 | 0x09 0x000E | KEYCODE_BUTTON_THUMBL (106) |
Clic derecho1 | 0x09 0x000F | KEYCODE_BUTTON_THUMBR (107) |
Página principal1 | 0x0c 0x0223 | KEYCODE_HOME (3) |
Atrás1 | 0x0c 0x0224 | KEYCODE_BACK (4) |
1 KeyEvent
2 Los usos de HID anteriores se deben declarar en una CA de pad para juegos (0x01 0x0005).
3 Este uso debe tener un mínimo lógico de 0, un máximo lógico de 7, un mínimo físico de 0, un máximo físico de 315, unidades en grados y un tamaño del informe de 4. El valor lógico se define como la rotación en el sentido de las manecillas del reloj, lejos del eje vertical. por ejemplo, un valor lógico de 0 representa que no hay rotación y que se presiona el botón Arriba, mientras que un valor lógico de 1 representa una rotación de 45 grados y que se presionan las teclas Arriba y la izquierda.
Controles analógicos1 | Uso de HID | Botón de Android |
---|---|---|
Activador izquierdo | 0x02 0x00C5 | AXIS_LTRIGGER |
Activador derecho | 0x02 0x00C4 | AXIS_RTRIGGER |
Joystick izquierdo |
0x01 0x0030 0x01 0x0031 |
AXIS_X EJE_Y |
Joystick derecho |
0x01 0x0032 0x01 0x0035. |
AXIS_Z AXIS_RZ |
7.2.7. Control remoto
Consulta la Sección 2.3.1 para conocer los requisitos específicos de los dispositivos.
7.3 Sensores
Si las implementaciones de dispositivos incluyen un tipo de sensor particular que tiene una API correspondiente para desarrolladores externos, la implementación de dispositivos DEBE implementar esa API como se describe en la documentación del SDK de Android y en la documentación de código abierto de Android sobre sensors.
Implementaciones en dispositivos:
- [C-0-1] DEBE informar con precisión la presencia o ausencia de sensores según la clase
android.content.pm.PackageManager
. - [C-0-2] DEBE mostrar una lista precisa de los sensores admitidos por medio de
SensorManager.getSensorList()
y métodos similares. - [C-0-3] DEBE comportarse de manera razonable para todas las demás APIs de sensores (por ejemplo, mostrar
true
ofalse
según corresponda cuando las aplicaciones intenten registrar objetos de escucha y no llamar a objetos de escucha de sensores cuando los sensores correspondientes no estén presentes, etc.).
Si las implementaciones de dispositivos incluyen un tipo de sensor particular que tiene una API correspondiente para desarrolladores externos, hacen lo siguiente:
- [C-1-1] DEBE informar todas las mediciones de los sensores con los valores correspondientes del sistema internacional de unidades (métrica) para cada tipo de sensor, como se define en la documentación del SDK de Android.
- [C-1-2] DEBE informar los datos del sensor con una latencia máxima de 100 milisegundos + 2 * sample_time para la transmisión de un sensor con una latencia solicitada máxima de 0 ms cuando el procesador de la aplicación está activo. Esta demora no incluye ninguna demora en el filtrado.
- [C-1-3] DEBE informar la primera muestra del sensor dentro de los 400 milisegundos + 2 * sample_time del sensor que se está activando. La exactitud aceptable de esta muestra es 0.
- [C-1-4] Para que cualquier API indicada en la documentación del SDK de Android sea un sensor continuo, las implementaciones de dispositivos DEBEN proporcionar continuamente muestras de datos periódicas que DEBEN tener un Jitter inferior al 3%, en el que el Jitter se define como la desviación estándar de la diferencia de los valores de marca de tiempo informados entre eventos consecutivos.
- [C-1-5] DEBE asegurarse de que la transmisión de eventos del sensor NO DEBE evitar que la CPU del dispositivo entre en un estado de suspensión o se active después de un estado de suspensión.
- [C-1-6] DEBE informar el tiempo del evento en nanosegundos, como se define en la documentación del SDK de Android, que representa la hora en que ocurrió el evento y se sincronizó con el reloj SystemClock.elapsedRealtimeNano().
- [C-SR] SE RECOMIENDA ENRENDER que el error de sincronización de la marca de tiempo sea inferior a 100 milisegundos y SE DEBE tener un error de sincronización de marca de tiempo inferior a 1 milisegundo.
- Cuando se activan varios sensores, el consumo de energía NO DEBE superar la suma del consumo de energía informado del sensor individual.
La lista anterior no es exhaustiva. el comportamiento documentado del SDK de Android y la Documentación de código abierto de Android sobre sensors debe considerarse autoritario.
Si las implementaciones de dispositivos incluyen un tipo de sensor particular que tiene una API correspondiente para desarrolladores externos, hacen lo siguiente:
- [C-1-6] DEBE establecer una resolución distinta de cero para todos los sensores e informar el valor a través del método
Sensor.getResolution()
de la API.
Algunos tipos de sensores son compuestos, lo que significa que pueden derivarse de los datos proporcionados por uno o más sensores. (algunos ejemplos incluyen el sensor de orientación y el sensor de aceleración lineal).
Implementaciones en dispositivos:
- SE DEBE implementar estos tipos de sensores cuando incluyen los sensores físicos necesarios, como se describe en tipos de sensores.
Si las implementaciones de dispositivos incluyen un sensor compuesto, sucederá lo siguiente:
- [C-2-1] SE DEBE implementar el sensor como se describe en la documentación de código abierto de Android sobre sensores compuestos.
Si las implementaciones de dispositivos incluyen un tipo de sensor particular que tiene una API correspondiente para desarrolladores externos y el sensor solo informa un valor, las implementaciones de dispositivos hacen lo siguiente:
- [C-3-1] DEBE establecer la resolución del sensor en 1 y, luego, informar el valor a través del método
Sensor.getResolution()
de la API.
Si las implementaciones de dispositivos incluyen un tipo de sensor particular que admite SensorAdditionalInfo#TYPE_VEC3_CALIBRATION y el sensor está expuesto a desarrolladores externos, deben hacer lo siguiente:
- [C-4-1] NO DEBE incluir ningún parámetro de calibración fijo determinado de fábrica en los datos proporcionados.
Si las implementaciones de dispositivos incluyen una combinación de acelerómetro de 3 ejes, sensor de giroscopio de 3 ejes o sensor magnetómetro, sucederá lo siguiente:
- [C-SR] SE RECOMIENDA ENRENDIDO para asegurarse de que el acelerómetro, el giroscopio y el magnetómetro tengan una posición relativa fija, de modo que, si el dispositivo es transformador (p.ej., plegable), los ejes de los sensores permanezcan alineados y coherentes con el sistema de coordenadas del sensor en todos los estados posibles de transformación del dispositivo.
7.3.1. Acelerómetro
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA MUY BIEN incluir un acelerómetro de 3 ejes.
Si las implementaciones en dispositivos incluyen un acelerómetro de 3 ejes, sucederá lo siguiente:
- [C-1-1] DEBE ser capaz de informar eventos con una frecuencia de al menos 50 Hz.
- [C-1-2] SE DEBE implementar e informar el sensor
TYPE_ACCELEROMETER
. - [C-1-3] DEBE cumplir con el sistema de coordenadas del sensor de Android como se detalla en las APIs de Android.
- [C-1-4] DEBE ser capaz de medir desde una caída libre hasta cuatro veces la gravedad(4g) o más en cualquier eje.
- [C-1-5] DEBE tener una resolución de al menos 12 bits.
- [C-1-6] DEBE tener una desviación estándar no superior a 0.05 m/s^, en la que la desviación estándar se debe calcular por eje en las muestras obtenidas durante un período de al menos 3 segundos a la tasa de muestreo más rápida.
- [SR] SE RECOMIENDA ENRENDER implementar el sensor compuesto
TYPE_SIGNIFICANT_MOTION
. - SE RECOMIENDA COMPLEMENTAR [SR] a implementar y a informar el sensor
TYPE_ACCELEROMETER_UNCALIBRATED
. RECOMIENDA QUE los dispositivos Android cumplan con este requisito para que puedan actualizarse a la futura versión de la plataforma, en la que esto podría ser OBLIGATORIO. - SE RECOMIENDA implementar los sensores compuestos de
TYPE_SIGNIFICANT_MOTION
,TYPE_TILT_DETECTOR
,TYPE_STEP_DETECTOR
yTYPE_STEP_COUNTER
como se describe en el documento del SDK de Android. - SE RECOMIENDA informar eventos de hasta 200 Hz como mínimo.
- DEBE tener una resolución de al menos 16 bits.
- SE DEBE calibrar mientras está en uso si las características cambian durante el ciclo de vida y se compensan, y se conservan los parámetros de compensación entre los reinicios del dispositivo.
- SE DEBE compensar la temperatura.
Si las implementaciones de dispositivos incluyen un acelerómetro de 3 ejes y se implementan cualquiera de los sensores compuestos de TYPE_SIGNIFICANT_MOTION
, TYPE_TILT_DETECTOR
, TYPE_STEP_DETECTOR
y TYPE_STEP_COUNTER
, haz lo siguiente:
- [C-2-1] La suma de su consumo de energía DEBE ser siempre inferior a 4 mW.
- Cuando el dispositivo esté en condiciones dinámicas o estáticas, SE DEBE ser inferior a 2 mW y 0.5 mW cada uno.
Si las implementaciones de dispositivos incluyen un acelerómetro de 3 ejes y un sensor de giroscopio de 3 ejes, sucederá lo siguiente:
- [C-3-1] DEBE implementar los sensores compuestos de
TYPE_GRAVITY
yTYPE_LINEAR_ACCELERATION
. - [C-SR] SE RECOMIENDA COMPLETAMENTE implementar el sensor compuesto
TYPE_GAME_ROTATION_VECTOR
.
Si las implementaciones de dispositivos incluyen un acelerómetro de 3 ejes, un sensor de giroscopio de 3 ejes y un sensor magnetómetro, hacen lo siguiente:
- [C-4-1] SE DEBE implementar un sensor compuesto
TYPE_ROTATION_VECTOR
.
7.3.2. Magnetómetro
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENcarecidamente incluir un magnetómetro de 3 ejes (brújula).
Si las implementaciones de dispositivos incluyen un magnetómetro de 3 ejes, sucederá lo siguiente:
- [C-1-1] SE DEBE implementar el sensor
TYPE_MAGNETIC_FIELD
. - [C-1-2] SE DEBE poder informar eventos con una frecuencia de al menos 10 Hz. A su vez, SE DEBE informar eventos de hasta 50 Hz.
- [C-1-3] DEBE cumplir con el sistema de coordenadas del sensor de Android como se detalla en las APIs de Android.
- [C-1-4] DEBE ser capaz de medir entre -900 μT y +900 μT en cada eje antes de saturar.
- [C-1-5] DEBE tener un valor de desplazamiento de hierro resistente inferior a 700 μT y DEBERÍA tener un valor inferior a 200 μT. Para ello, coloca el magnetómetro lejos de los campos magnéticos dinámicos (inducidos por la corriente) y estáticos (inducidos por imanes).
- [C-1-6] DEBE tener una resolución igual o mayor que 0.6 μT.
- [C-1-7] DEBE admitir la calibración en línea y la compensación del sesgo de hierro resistente, y conservar los parámetros de compensación entre los reinicios del dispositivo.
- [C-1-8] SE DEBE aplicar la compensación de hierro blando: la calibración se puede realizar mientras se usa o durante la producción del dispositivo.
- [C-1-9] DEBE tener una desviación estándar, calculada por eje, en muestras recopiladas durante un período de al menos 3 segundos a la tasa de muestreo más rápida, no superior a 1.5 μT; SE DEBE tener una desviación estándar de no más de 0.5 μT.
- [C-SR] SE RECOMIENDA MUY BIEN implementar el sensor
TYPE_MAGNETIC_FIELD_UNCALIBRATED
.
Si las implementaciones de dispositivos incluyen un magnetómetro de 3 ejes, un sensor acelerómetro y un sensor de giroscopio de 3 ejes, sucederá lo siguiente:
- [C-2-1] SE DEBE implementar un sensor compuesto
TYPE_ROTATION_VECTOR
.
Si las implementaciones de dispositivos incluyen un magnetómetro de 3 ejes o un acelerómetro, harán lo siguiente:
- PUEDES implementar el sensor
TYPE_GEOMAGNETIC_ROTATION_VECTOR
.
Si las implementaciones de dispositivos incluyen un magnetómetro de 3 ejes, un acelerómetro y un sensor TYPE_GEOMAGNETIC_ROTATION_VECTOR
, sucederá lo siguiente:
- [C-3-1] DEBE consumir menos de 10 mW.
- SE DEBE consumir menos de 3 mW cuando el sensor está registrado en el modo por lotes a 10 Hz.
7.3.3. GPS
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENERCMENTE incluir un receptor de GPS/GNSS.
Si las implementaciones de dispositivos incluyen un receptor de GPS/GNSS e informan la capacidad a las aplicaciones a través de la marca de función android.hardware.location.gps
, sucederá lo siguiente:
- [C-1-1] DEBE admitir salidas de ubicación a una tasa de al menos 1 Hz cuando se solicita a través de
LocationManager#requestLocationUpdate
. - [C-1-2] DEBE ser capaz de determinar la ubicación en un cielo abierto (señales fuertes, insignificantes de ruta múltiple, HDOP < 2) en un plazo de 10 segundos (tiempo rápido hasta la primera corrección), cuando se conecta a una conexión a Internet de 0.5 Mbps o más velocidad de datos. Por lo general, este requisito se cumple con algún tipo de técnica de GPS/GNSS asistido o previsto para minimizar el tiempo de bloqueo del GPS/GNSS (los datos de asistencia incluyen la hora de referencia, la ubicación de referencia y la efeméris/reloj del satélite).
- [C-1-6] Después de realizar el cálculo de ubicación, las implementaciones en dispositivos DEBEN determinar su ubicación a cielo abierto en un plazo de 5 segundos, cuando se reinicien las solicitudes de ubicación, hasta una hora después del cálculo de ubicación inicial, incluso cuando la solicitud posterior se realice sin una conexión de datos o después de un reinicio.
-
En condiciones a cielo abierto después de determinar la ubicación, mientras estás detenido o en movimiento a menos de 1 metro por segundo al cuadrado de aceleración:
- [C-1-3] DEBE poder determinar la ubicación dentro de los 20 metros y la velocidad dentro de los 0.5 metros por segundo, al menos el 95% de las veces.
- [C-1-4] DEBE realizar un seguimiento y, también, informar simultáneamente mediante
GnssStatus.Callback
al menos 8 satélites de una constelación. - DEBERÍAS poder realizar un seguimiento simultáneo de al menos 24 satélites de múltiples constelaciones (por ejemplo, GPS +, al menos, uno de los objetos Glonass, Beidou, Galileo).
- [C-SR] SE RECOMIENDA ENcarecidamente seguir proporcionando salidas normales de ubicación GPS/GNSS a través de las API del proveedor de ubicación de GNSS durante una llamada telefónica de emergencia.
- [C-SR] SE RECOMIENDA ENcarecidamente que informen las mediciones de GNSS de todas las constelaciones a las que se les realiza un seguimiento (como se informan en los mensajes de GnssStatus), con la excepción de SBAS.
- [C-SR] SE RECOMIENDA ENcarecidamente registrar el AGC y la frecuencia de la medición del GNSS.
- [C-SR] SE RECOMIENDA ENcarecidamente que informen todas las estimaciones de precisión (incluidas las de rumbo, velocidad y vertical) como parte de cada ubicación GPS/GNSS.
- [C-SR] SE RECOMIENDA ENRENDER que informen las mediciones de GNSS tan pronto como se encuentren, incluso si todavía no se informó una ubicación calculada a partir del GPS/GNSS.
- [C-SR] SE RECOMIENDA ENRENDER que informen los pseudorrangos y pseudorrangos GNSS que, en condiciones a cielo abierto después de determinar la ubicación, mientras están en reposo o en movimiento con menos de 0.2 metros por segundo al cuadrado de aceleración, son suficientes para calcular la posición dentro de 20 metros y la velocidad dentro de 0.2 metros por segundo, al menos el 95% del tiempo.
7.3.4. Giroscopio
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA COMPLETAMENTE incluir un sensor de giroscopio.
Si las implementaciones de dispositivos incluyen un giroscopio de 3 ejes, sucederá lo siguiente:
- [C-1-1] DEBE ser capaz de informar eventos con una frecuencia de al menos 50 Hz.
- [C-1-2] SE DEBE implementar el sensor de
TYPE_GYROSCOPE
y SE RECOMIENDA ENERCMENTE implementar también el sensorTYPE_GYROSCOPE_UNCALIBRATED
. - [C-1-4] DEBE tener una resolución de 12 bits o más, y DEBE tener una resolución de 16 bits o más.
- [C-1-5] SE DEBE compensar la temperatura.
- [C-1-6] SE DEBE calibrar y compensar mientras se usa, además de conservar los parámetros de compensación entre reinicios del dispositivo.
- [C-1-7] DEBE tener una varianza no superior a 1e-7 rad^2 / s^2 por Hz (varianza por Hz o rad^2 / s). La varianza puede variar con la tasa de muestreo, pero DEBE estar limitada por este valor. En otras palabras, si mides la varianza del giroscopio a una tasa de muestreo de 1 Hz, NO DEBE ser superior a 1e-7 rad^2/s^2.
- [SR] SE RECOMIENDA QUE el error de la calibración sea inferior a 0.01 rad/s cuando el dispositivo está quieto a temperatura ambiente.
- SE RECOMIENDA informar eventos de hasta 200 Hz como mínimo.
Si las implementaciones de dispositivos incluyen un giroscopio de 3 ejes, un sensor acelerómetro y un sensor magnetómetro, harán lo siguiente:
- [C-2-1] SE DEBE implementar un sensor compuesto
TYPE_ROTATION_VECTOR
.
Si las implementaciones de dispositivos incluyen un acelerómetro de 3 ejes y un sensor de giroscopio de 3 ejes, sucederá lo siguiente:
- [C-3-1] DEBE implementar los sensores compuestos de
TYPE_GRAVITY
yTYPE_LINEAR_ACCELERATION
. - [C-SR] SE RECOMIENDA COMPLETAMENTE implementar el sensor compuesto
TYPE_GAME_ROTATION_VECTOR
.
7.3.5. Barómetro
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA ENcarecidamente incluir un barómetro (sensor de presión de aire ambiental).
Si las implementaciones en dispositivos incluyen un barómetro, hacen lo siguiente:
- [C-1-1] SE DEBE implementar e informar el sensor de
TYPE_PRESSURE
. - [C-1-2] DEBE ser capaz de transmitir eventos a 5 Hz o más.
- [C-1-3] SE DEBE compensar la temperatura.
- [SR] SE RECOMIENDA ENRENDADAMENTE poder informar las mediciones de presión en el rango de 300 hPa a 1,100 hPa.
- SE DEBE tener una precisión absoluta de 1 hPa.
- SE DEBE tener una precisión relativa de 0.12 hPa sobre el rango de 20 hPa (equivalente a una exactitud de ~1 m por sobre el cambio de ~200 m a nivel del mar).
7.3.6. Termómetro
Si las implementaciones de dispositivos incluyen un termómetro de ambiente (sensor de temperatura), sucederá lo siguiente:
- [C-1-1] DEBE definir
SENSOR_TYPE_AMBIENT_TEMPERATURE
para el sensor de temperatura ambiente, y este DEBE medir en grados Celsius la temperatura ambiente (de la habitación o la cabina del vehículo) desde donde el usuario interactúa con el dispositivo.
Si las implementaciones de dispositivos incluyen un sensor de termómetro que mide una temperatura distinta de la temperatura ambiente, como la de la CPU, harán lo siguiente:
- [C-2-1] NO DEBE definir
SENSOR_TYPE_AMBIENT_TEMPERATURE
para el sensor de temperatura.
7.3.7. Fotómetro
- Las implementaciones del dispositivo PUEDEN incluir un fotómetro (sensor de luz ambiente).
7.3.8. Sensor de proximidad
- Las implementaciones de dispositivos PUEDEN incluir un sensor de proximidad.
Si las implementaciones de dispositivos incluyen un sensor de proximidad, sucederá lo siguiente:
- [C-1-1] DEBE medir la proximidad de un objeto en la misma dirección que la pantalla. Es decir, el sensor de proximidad DEBE estar orientado para detectar objetos cercanos a la pantalla, ya que la intención principal de este tipo de sensor es detectar un teléfono en uso por el usuario. Si las implementaciones de dispositivos incluyen un sensor de proximidad con cualquier otra orientación, NO DEBE ser accesible a través de esta API.
- [C-1-2] DEBE tener 1 bit de precisión o más.
7.3.9. Sensores de alta fidelidad
Si las implementaciones de dispositivos incluyen un conjunto de sensores de mayor calidad, como se define en esta sección, y los ponen a disposición de apps de terceros, deben hacer lo siguiente:
- [C-1-1] DEBE identificar la función a través de la marca de función
android.hardware.sensor.hifi_sensors
.
Si las implementaciones de dispositivos declaran android.hardware.sensor.hifi_sensors
, hará lo siguiente:
-
[C-2-1] DEBE tener un sensor
TYPE_ACCELEROMETER
con las siguientes características:- SE DEBE tener un rango de medición de al menos -8 g a +8 g, y SE RECOMIENDA ENcarecidamente que tengas un rango de medición de al menos -16 g y +16 g.
- DEBE tener una resolución de medición de al menos 2048 LSB/g.
- DEBE tener una frecuencia de medición mínima de 12.5 Hz o inferior.
- DEBE tener una frecuencia de medición máxima de 400 Hz o superior. SE DEBE admitir el SensorDirectChannel
RATE_VERY_FAST
. - DEBE tener un ruido de medición que no supere los 400 μg/√ Hz.
- DEBE implementar una forma de este sensor que no sea activa con una capacidad de almacenamiento en búfer de al menos 3,000 eventos de sensores.
- DEBE tener un consumo de energía por lotes que no sea inferior a 3 mW.
- [C-SR] SE RECOMIENDA ENcarecidamente tener un ancho de banda de medición de 3 dB de al menos el 80% de la frecuencia de Nyquist y un espectro de ruido blanco dentro de este ancho de banda.
- SE DEBE hacer una caminata aleatoria de aceleración menor a 30 μg √Hz a temperatura ambiente.
- SE RECOMIENDA tener un cambio de sesgo en comparación con la temperatura de ≤ +/- 1 mg/°C.
- SE RECOMIENDA tener una no linealidad de la línea que mejor se ajuste a ≤ 0.5% y un cambio de sensibilidad en comparación con la temperatura de ≤ 0.03%/C°.
- SE DEBE tener una sensibilidad en el eje cruzado de < 2.5 % y variación de la sensibilidad del eje cruzado < 0.2% en el rango de temperatura de funcionamiento del dispositivo.
-
[C-2-2] DEBE tener una
TYPE_ACCELEROMETER_UNCALIBRATED
con los mismos requisitos de calidad queTYPE_ACCELEROMETER
. -
[C-2-3] DEBE tener un sensor
TYPE_GYROSCOPE
con las siguientes características:- DEBE tener un rango de medición de al menos -1,000 y +1,000 dps.
- DEBE tener una resolución de medición de al menos 16 LSB/dps.
- DEBE tener una frecuencia de medición mínima de 12.5 Hz o inferior.
- DEBE tener una frecuencia de medición máxima de 400 Hz o superior. SE DEBE admitir el SensorDirectChannel
RATE_VERY_FAST
. - DEBE tener un ruido de medición que no supere los 0.014 °/s/√ Hz.
- [C-SR] SE RECOMIENDA ENcarecidamente tener un ancho de banda de medición de 3 dB de al menos el 80% de la frecuencia de Nyquist y un espectro de ruido blanco dentro de este ancho de banda.
- SE RECOMIENDA hacer una caminata aleatoria a una tasa inferior a 0.001 °/s √Hz probada a temperatura ambiente.
- SE RECOMIENDA tener un cambio de sesgo respecto a la temperatura de ≤ +/- 0.05 °/ s / °C.
- SE RECOMIENDA cambiar la sensibilidad frente a la temperatura de ≤ 0.02% / °C.
- SE DEBE tener una no linealidad de la línea más adecuada de ≤ 0.2%.
- SE DEBE tener una densidad de ruido igual o superior a ≤ 0.007 °/s/√ Hz.
- Cuando el dispositivo está quieto, SE DEBE tener un error de calibración inferior a 0.002 rad/s en un rango de temperatura de 10 a 40 °C.
- DEBE tener una g-sensibilidad inferior a 0.1 °/s/g.
- SE DEBE tener una sensibilidad en el eje cruzado de < 4.0 % y variación de sensibilidad entre ejes menor que 0.3% en el rango de temperatura de funcionamiento del dispositivo.
-
[C-2-4] DEBE tener una
TYPE_GYROSCOPE_UNCALIBRATED
con los mismos requisitos de calidad queTYPE_GYROSCOPE
. -
[C-2-5] DEBE tener un sensor
TYPE_GEOMAGNETIC_FIELD
con las siguientes características:- DEBE tener un rango de medición de al menos -900 y +900 μT.
- DEBE tener una resolución de medición de al menos 5 LSB/uT.
- DEBE tener una frecuencia de medición mínima de 5 Hz o inferior.
- DEBE tener una frecuencia de medición máxima de 50 Hz o superior.
- DEBE tener un ruido de medición que no supere los 0.5 uT.
-
[C-2-6] DEBE tener un
TYPE_MAGNETIC_FIELD_UNCALIBRATED
con los mismos requisitos de calidad queTYPE_GEOMAGNETIC_FIELD
y además:- DEBE implementar una forma de este sensor que no sea activa con una capacidad de almacenamiento en búfer de al menos 600 eventos de sensores.
- [C-SR] SE RECOMIENDA ENcarecidamente tener un espectro de ruido blanco de 1 Hz a, al menos, 10 Hz cuando la frecuencia de informe sea de 50 Hz o superior.
-
[C-2-7] DEBE tener un sensor
TYPE_PRESSURE
con las siguientes características:- DEBE tener un rango de medición de al menos 300 y 1,100 hPa.
- DEBE tener una resolución de medición de al menos 80 LSB/hPa.
- DEBE tener una frecuencia de medición mínima de 1 Hz o inferior.
- DEBE tener una frecuencia de medición máxima de 10 Hz o superior.
- DEBE tener un ruido de medición que no supere los 2 Pa/√Hz.
- DEBE implementar una forma de este sensor que no sea activa con una capacidad de almacenamiento en búfer de al menos 300 eventos de sensores.
- DEBE tener un consumo de energía por lotes que no sea inferior a 2 mW.
- [C-2-8] DEBE tener un sensor
TYPE_GAME_ROTATION_VECTOR
. - [C-2-9] DEBE tener un sensor
TYPE_SIGNIFICANT_MOTION
con las siguientes características:- DEBE tener un consumo de energía que no sea inferior a 0.5 mW cuando el dispositivo está estático y 1.5 mW cuando el dispositivo está en movimiento.
- [C-2-10] DEBE tener un sensor
TYPE_STEP_DETECTOR
con las siguientes características:- DEBE implementar una forma de este sensor que no sea activa con una capacidad de almacenamiento en búfer de al menos 100 eventos de sensores.
- DEBE tener un consumo de energía que no sea inferior a 0.5 mW cuando el dispositivo está estático y 1.5 mW cuando el dispositivo está en movimiento.
- DEBE tener un consumo de energía por lotes que no sea inferior a 4 mW.
- [C-2-11] DEBE tener un sensor
TYPE_STEP_COUNTER
con las siguientes características:- DEBE tener un consumo de energía que no sea inferior a 0.5 mW cuando el dispositivo está estático y 1.5 mW cuando el dispositivo está en movimiento.
- [C-2-12] DEBE tener un sensor
TILT_DETECTOR
con las siguientes características:- DEBE tener un consumo de energía que no sea inferior a 0.5 mW cuando el dispositivo está estático y 1.5 mW cuando el dispositivo está en movimiento.
- [C-2-13] La marca de tiempo del evento del mismo evento físico que informan el acelerómetro, el giroscopio y el magnetómetro DEBE tener una diferencia de 2.5 milisegundos. La marca de tiempo del mismo evento físico que informan el acelerómetro y el giroscopio DEBE tener una diferencia de 0.25 milisegundos.
- [C-2-14] DEBE tener marcas de tiempo de eventos del sensor del giroscopio en la misma base de tiempo que el subsistema de la cámara y dentro de 1 milisegundos desde el error.
- [C-2-15] DEBE entregar las muestras a las aplicaciones en un plazo de 5 milisegundos desde el momento en que los datos están disponibles en cualquiera de los sensores físicos mencionados para la aplicación.
- [C-2-16] NO DEBE tener un consumo de energía superior a 0.5 mW cuando el dispositivo está estático y 2.0 mW cuando el dispositivo está en movimiento si se habilita cualquier combinación de los siguientes sensores:
-
SENSOR_TYPE_SIGNIFICANT_MOTION
-
SENSOR_TYPE_STEP_DETECTOR
-
SENSOR_TYPE_STEP_COUNTER
-
SENSOR_TILT_DETECTORS
-
- [C-2-17] PUEDE tener un sensor
TYPE_PROXIMITY
, pero, si está presente, DEBE tener una capacidad de búfer mínima de 100 eventos del sensor.
Ten en cuenta que todos los requisitos de consumo de energía de esta sección no incluyen el consumo de energía del procesador de aplicaciones. Incluye la energía que consume toda la cadena del sensor: el sensor, cualquier circuito de soporte, cualquier sistema de procesamiento de sensores dedicado, etcétera.
Si las implementaciones de dispositivos incluyen compatibilidad directa con el sensor, sucederá lo siguiente:
- [C-3-1] DEBE declarar correctamente la compatibilidad con los tipos de canales directos y el nivel de tarifas de informes directos a través de las APIs de
isDirectChannelTypeSupported
ygetHighestDirectReportRateLevel
. - [C-3-2] DEBE admitir al menos uno de los dos tipos de canal directo de sensores para todos los sensores que declaran compatibilidad con el canal directo de sensores.
- SE DEBE admitir la generación de informes de eventos a través del canal directo del sensor para el sensor principal (variante sin activación) de los siguientes tipos:
-
TYPE_ACCELEROMETER
-
TYPE_ACCELEROMETER_UNCALIBRATED
-
TYPE_GYROSCOPE
-
TYPE_GYROSCOPE_UNCALIBRATED
-
TYPE_MAGNETIC_FIELD
-
TYPE_MAGNETIC_FIELD_UNCALIBRATED
-
7.3.10. Sensores biométricos
Para obtener más información acerca de la medición de la seguridad del desbloqueo biométrico, consulte la documentación sobre la medición de la seguridad biométrica.
Si las implementaciones en dispositivos incluyen una pantalla de bloqueo segura, sucederá lo siguiente:
- SE RECOMIENDA incluir un sensor biométrico
Los sensores biométricos se pueden clasificar como Clase 3 (anteriormente Sólida), Clase 2 (anteriormente Débil) o Clase 1 (anteriormente Conveniencia) en función de sus tasas de aceptación de falsificación y impostor, y en la seguridad de la canalización biométrica. Esta clasificación determina las capacidades que el sensor biométrico tiene para interactuar con la plataforma y con aplicaciones de terceros. Los sensores se clasifican como Clase 1 de forma predeterminada y deben cumplir con los requisitos adicionales que se detallan a continuación si desean clasificarse como Clase 2 o Clase 3. Los datos biométricos de clase 2 y clase 3 obtienen las funciones adicionales que se detallan a continuación.
Si las implementaciones de dispositivos permiten que aplicaciones de terceros utilicen un sensor biométrico a través de android.hardware.biometrics.BiometricManager, android.hardware.biometrics.BiometricPrompt y android.provider.Settings.ACTION_BIOMETRIC_ENROLL, sucede lo siguiente:
- [C-4-1] DEBE cumplir con los requisitos de los campos biométricos de Clase 3 o Clase 2, como se define en este documento.
- [C-4-2] DEBE reconocer y respetar cada nombre de parámetro definido como constante en la clase Authenticators y cualquier combinación de estos. Por el contrario, NO DEBE respetar ni reconocer las constantes de números enteros que se pasan a los métodos canAuthenticate(int) y setAllowedAuthenticators(int) que no sean las documentadas como constantes públicas en Authenticators y cualquier combinación de ellos.
- [C-4-3] DEBE implementar la acción ACTION_BIOMETRIC_ENROLL en dispositivos con datos biométricos de clase 3 o clase 2. Esta acción solo DEBE presentar los puntos de entrada de inscripción para los datos biométricos de Clase 3 o Clase 2.
Si las implementaciones de dispositivos admiten datos biométricos pasivos, sucederá lo siguiente:
- [C-5-1] De forma predeterminada, DEBE requerir un paso de confirmación adicional (p.ej., presionar un botón).
- [C-SR] SE RECOMIENDA ENcarecidamente tener un parámetro de configuración que permita a los usuarios anular la preferencia de aplicación y siempre requerir un paso de confirmación complementario.
- [C-SR] SE RECOMIENDA ENERCMENTE que se asegure la acción de confirmación de modo que la vulneración del sistema operativo o el kernel no pueda falsificarla. Por ejemplo, esto significa que la acción de confirmación basada en un botón físico se enruta a través de un PIN de entrada y salida de uso general (GPIO) de solo entrada de un Elemento seguro (SE) que no se puede impulsar por ningún otro medio que no sea presionar un botón físico.
- [C-5-2] Además, DEBE implementar un flujo de autenticación implícito (sin paso de confirmación) que corresponda a setConfirmationRequired(boolean), que las aplicaciones se pueden configurar para usar en flujos de acceso.
Si las implementaciones de dispositivos tienen varios sensores biométricos:
- [C-SR] SE RECOMIENDA ENRENDER que se solicite solo un dato biométrico por autenticación (p.ej., si el dispositivo cuenta con sensores faciales y de huella dactilar disponibles en el dispositivo, se debe enviar onAuthenticationSucceeded una vez que se confirme alguno de ellos).
Para que las implementaciones de dispositivos permitan el acceso de aplicaciones de terceros a las claves del almacén de claves, deben cumplir con lo siguiente:
- [C-6-1] DEBE cumplir con los requisitos de la Clase 3 según se define en esta sección a continuación.
- [C-6-2] DEBE presentar solo los datos biométricos de Clase 3 cuando la autenticación requiere BIOMETRIC_STRONG o cuando la autenticación se invoca con un CryptoObject.
Si las implementaciones de dispositivos desean tratar un sensor biométrico como Clase 1 (anteriormente Conveniencia), hacen lo siguiente:
- [C-1-1] DEBE tener una tasa de aceptación falsa inferior al 0.002%.
- [C-1-2] DEBE divulgar que este modo puede ser menos seguro que un PIN, un patrón o una contraseña seguros y enumerar claramente los riesgos de habilitarlo si las tasas de aceptación de falsificación y impostor son superiores al 7%, según las mediciones de los Protocolos de prueba biométrica de Android.
- [C-1-3] SE DEBE limitar la frecuencia de intentos durante al menos 30 segundos después de cinco pruebas falsas de verificación biométrica, en las que una prueba falsa es aquella que tiene una calidad de captura adecuada (
BIOMETRIC_ACQUIRED_GOOD
) que no coincide con un dato biométrico inscrito. - [C-1-4] DEBE evitar agregar datos biométricos nuevos sin establecer primero una cadena de confianza. Para ello, debe pedirle al usuario que confirme la credencial existente o agregue una nueva credencial de dispositivo (PIN, patrón o contraseña) protegida por el TEE. la implementación del Proyecto de código abierto de Android proporciona el mecanismo en el framework para hacerlo.
- [C-1-5] SE DEBE quitar por completo todos los datos biométricos identificables de un usuario cuando se quita su cuenta (incluso mediante el restablecimiento de la configuración de fábrica).
- [C-1-6] SE DEBE respetar la marca individual de ese dato biométrico (es decir,
DevicePolicyManager.KEYGUARD_DISABLE_FINGERPRINT
,DevicePolicymanager.KEYGUARD_DISABLE_FACE
oDevicePolicymanager.KEYGUARD_DISABLE_IRIS
). - [C-1-7] SE DEBE solicitar al usuario la autenticación principal recomendada (p.ej., PIN, patrón, contraseña) una vez cada 24 horas o menos en el caso de los dispositivos nuevos que se lanzan con Android 10, una vez cada 72 horas o menos en el caso de los dispositivos que se actualizan desde una versión anterior de Android.
-
[C-1-8] SE DEBE solicitar al usuario la autenticación principal recomendada (p. ej., PIN, patrón, contraseña) después de una de las siguientes acciones:
- un tiempo de espera de inactividad de 4 horas O
- 3 intentos fallidos de autenticación biométrica.
- El tiempo de espera de inactividad y el recuento de autenticaciones fallidas se restablecen después de que se confirma correctamente las credenciales del dispositivo.
La actualización de dispositivos de una versión anterior de Android puede excluirse de la certificación C-1-8. * Se recomienda que [C-SR] use la lógica en el marco proporcionado por el Proyecto de código abierto de Android para aplicar las restricciones especificadas en [C-1-7] y [C-1-8] en dispositivos nuevos. * [C-SR] SE RECOMIENDA ENERCMENTE tener una tasa de rechazo falso inferior al 10%, según la medición del dispositivo. * [C-SR] SE RECOMIENDA ENRENDER que tengan una latencia inferior a 1 segundo, que se mide desde el momento en que se detectan los datos biométricos hasta que se desbloquea la pantalla, para cada dato biométrico inscrito.
Si las implementaciones de dispositivos desean tratar un sensor biométrico como Clase 2 (anteriormente Débil), hacen lo siguiente:
- [C-2-1] DEBE cumplir con todos los requisitos de la Clase 1 mencionados anteriormente.
- [C-2-2] DEBE tener una tasa de aceptación de falsificación de identidad y impostor que no sea superior al 20%, según las mediciones de los Protocolos de prueba de datos biométricos de Android.
- [C-2-3] DEBE realizar la coincidencia biométrica en un entorno de ejecución aislado fuera del espacio de usuario o kernel de Android, como el entorno de ejecución confiable (TEE), o en un chip con un canal seguro al entorno de ejecución aislado.
- [C-2-4] DEBE tener todos los datos identificables encriptados y autenticados de manera criptográfica de modo que no puedan adquirirse, leerse ni alterarse fuera del entorno de ejecución aislado o de un chip con un canal seguro para ese entorno, tal como se documenta en los lineamientos de implementación del sitio del Proyecto de código abierto de Android.
- [C-2-5] Para datos biométricos basados en cámaras, mientras se realiza la autenticación o inscripción basadas en ellos:
- DEBES operar la cámara en un modo que impida que se lean o modifiquen los marcos fuera del entorno de ejecución aislado o en un chip con un canal seguro para el entorno de ejecución aislado.
- En el caso de soluciones RGB de una sola cámara, los marcos de la cámara PUEDEN ser legibles fuera del entorno de ejecución aislado para admitir operaciones como la vista previa para la inscripción, pero Aun así NO deben ser alterables.
- [C-2-6] NO DEBE habilitar aplicaciones de terceros para distinguir entre inscripciones biométricas individuales.
- [C-2-7] NO DEBE permitir el acceso sin encriptar al Procesador de aplicaciones fuera del contexto del TEE a datos biométricos identificables ni a ningún dato derivado de ellos (como incorporaciones).
-
[C-2-8] DEBE tener una canalización de procesamiento segura de modo que el compromiso del sistema operativo o el kernel no pueda permitir que se inserten datos directamente para autenticarse falsamente como el usuario.
Si las implementaciones de dispositivos ya se lanzaron en una versión anterior de Android y no cumplen con el requisito C-2-8 a través de una actualización de software del sistema, PUEDEN estar exentas del requisito.
-
[C-SR] SE RECOMIENDA ENcarecidamente incluir la detección de la actividad física para todas las modalidades biométricas y la detección de la atención para los biométricos faciales.
Si las implementaciones de dispositivos desean tratar un sensor biométrico como Clase 3 (anteriormente Strong), hacen lo siguiente:
- [C-3-1] DEBE cumplir con todos los requisitos de la Clase 2 mencionados anteriormente, excepto para [C-1-7] y [C-1-8]. Las actualizaciones de dispositivos desde una versión anterior de Android no están exentas de C-2-7.
- [C-3-2] DEBE tener una implementación de un almacén de claves guardadas en hardware.
- [C-3-3] DEBE tener una tasa de aceptación de falsificación de identidad y impostor que no sea superior al 7%, según las mediciones de los Protocolos de prueba de datos biométricos de Android.
- [C-3-4] SE DEBE solicitar al usuario la autenticación principal recomendada (p.ej., PIN, patrón o contraseña) una vez cada 72 horas o menos.
7.3.12. Sensor de postura
Implementaciones en dispositivos:
- PUEDE admitir el sensor de poses con 6 grados de libertad.
Si las implementaciones de dispositivos admiten el sensor de poses con 6 grados de libertad, harán lo siguiente:
- [C-1-1] SE DEBE implementar e informar el sensor
TYPE_POSE_6DOF
. - [C-1-2] DEBE ser más preciso que el vector de rotación solo.
7.3.13. Sensor de ángulo de bisagra
Si las implementaciones de dispositivos admiten un sensor de ángulo de bisagra, sucederá lo siguiente:
- [C-1-1] DEBE implementar y, luego, informar
TYPE_HINGLE_ANGLE
. - [C-1-2] DEBE admitir al menos dos lecturas entre 0 y 360 grados (inclusive, es decir, incluidos 0 y 360 grados).
- [C-1-3] SE DEBE devolver un sensor de activación para
getDefaultSensor(SENSOR_TYPE_HINGE_ANGLE)
.
7.4. Conectividad de datos
7.4.1 Telefonía
El término "Telefonía", tal como utilizan las API de Android, y este documento hace referencia específicamente al hardware relacionado con la realización de llamadas de voz y el envío de mensajes SMS a través de una red GSM o CDMA. Si bien estas llamadas de voz pueden o no cambiarse de paquetes, se usan para que Android se considere independientemente de cualquier conectividad de datos que se pueda implementar usando la misma red. En otras palabras, la funcionalidad y las APIs de "telefonía" de Android se refieren específicamente a las llamadas de voz y los SMS. Por ejemplo, las implementaciones de dispositivos que no pueden realizar llamadas ni enviar o recibir mensajes SMS no se consideran dispositivos de telefonía, independientemente de si usan una red móvil para la conectividad de datos.
- Android PUEDE usarse en dispositivos que no incluyen hardware de telefonía. Es decir, Android es compatible con dispositivos que no son teléfonos.
Si las implementaciones de dispositivos incluyen telefonía GSM o CDMA, sucederá lo siguiente:
- [C-1-1] DEBE declarar la marca de función
android.hardware.telephony
y otras marcas secundarias según la tecnología. - [C-1-2] DEBE implementar compatibilidad total con la API para esa tecnología.
Si las implementaciones de dispositivos no incluyen hardware de telefonía:
- [C-2-1] DEBE implementar las APIs completas como no-ops.
Si las implementaciones de dispositivos admiten eUICC o eSIMs o SIM incorporadas, e incluyen un mecanismo de su propiedad para que la funcionalidad de eSIM esté disponible para desarrolladores externos, deben hacer lo siguiente:
- [C-3-1] DEBE proporcionar una implementación completa de
EuiccManager API
.
7.4.1.1. Compatibilidad con bloqueo de números
Si las implementaciones de dispositivos informan el android.hardware.telephony feature
, harán lo siguiente:
- [C-1-1] DEBE incluir asistencia para el bloqueo de números.
- [C-1-2] DEBE implementar por completo
BlockedNumberContract
y la API correspondiente como se describe en la documentación del SDK. - [C-1-3] DEBE bloquear todas las llamadas y los mensajes provenientes de un número de teléfono en "BlockedNumberProvider". sin ninguna interacción con las apps. La única excepción ocurre cuando se quita temporalmente el bloqueo de números, como se describe en la documentación del SDK.
- [C-1-4] NO DEBE escribir al proveedor de registro de llamadas de la plataforma para una llamada bloqueada.
- [C-1-5] NO DEBE escribirle al proveedor de telefonía para un mensaje bloqueado.
- [C-1-6] DEBE implementar una IU de administración de números bloqueados, que se abre con el intent que muestra el método
TelecomManager.createManageBlockedNumbersIntent()
. - [C-1-7] NO DEBE permitir que los usuarios secundarios vean o editen los números bloqueados en el dispositivo, ya que la plataforma de Android asume que el usuario principal tiene el control total de los servicios de telefonía, una única instancia, en el dispositivo. Todas las IUs relacionadas con el bloqueo DEBEN estar ocultas para los usuarios secundarios, y la lista de entidades bloqueadas DEBE respetarse.
- SE DEBE migrar los números bloqueados al proveedor cuando un dispositivo se actualiza a Android 7.0.
7.4.1.2. API de Telecom
Si las implementaciones de dispositivos informan android.hardware.telephony
, sucederá lo siguiente:
- [C-1-1] DEBE admitir las APIs de
ConnectionService
que se describen en el SDK. - [C-1-2] DEBE mostrar una nueva llamada entrante y proporcionarle al usuario la opción de aceptarla o rechazarla cuando esté en una llamada en curso realizada por una app de terceros que no admite la función de espera especificada a través de
CAPABILITY_SUPPORT_HOLD
. - [C-1-3] DEBE tener una aplicación que implemente InCallService.
-
[C-SR] SE RECOMIENDA ENcarecidamente notificar al usuario que contestar una llamada entrante abandonará una llamada en curso.
La implementación del AOSP cumple con estos requisitos mediante una notificación de atención que le indica al usuario que contestar una llamada entrante hará que la otra llamada se interrumpa.
-
[C-SR] SE RECOMIENDA RECOMENDADAMENTE que precargan la app de marcador predeterminada que muestra una entrada de registro de llamadas y el nombre de una app de terceros en su registro de llamadas cuando la app de terceros establece la clave de extras
EXTRA_LOG_SELF_MANAGED_CALLS
en suPhoneAccount
entrue
. - [C-SR] SE RECOMIENDA EXITOSAMENTE para controlar los eventos
KEYCODE_MEDIA_PLAY_PAUSE
yKEYCODE_HEADSETHOOK
de los auriculares de audio para las APIs deandroid.telecom
de la siguiente manera:- Llama a
Connection.onDisconnect()
cuando se detecte una pulsación breve de un evento de tecla durante una llamada en curso. - Llama a
Connection.onAnswer()
cuando se detecte una pulsación breve de un evento de tecla durante una llamada entrante. - Llama a
Connection.onReject()
cuando se detecte la acción de mantener presionado un evento de tecla durante una llamada entrante. - Activa o desactiva el estado de silencio de
CallAudioState
.
- Llama a
7.4.2. IEEE 802.11 (Wi-Fi)
Implementaciones en dispositivos:
- SE DEBE incluir compatibilidad con uno o más formularios de 802.11.
Si las implementaciones de dispositivos incluyen compatibilidad con 802.11 y exponen la funcionalidad a una aplicación de terceros, deben hacer lo siguiente:
- [C-1-1] DEBE implementar la API de Android correspondiente.
- [C-1-2] SE DEBE informar la marca de función de hardware
android.hardware.wifi
. - [C-1-3] DEBE implementar la API de multicast como se describe en la documentación del SDK.
- [C-1-4] DEBE admitir DNS multidifusión (mDNS) y NO filtrar paquetes mDNS (224.0.0.251) en ningún momento de la operación, lo que incluye:
- incluso cuando la pantalla no esté activa.
- Para implementaciones en dispositivos de Android Television, incluso en estados de energía en espera
- [C-1-5] NO DEBE tratar la llamada al método a la API
WifiManager.enableNetwork()
como una indicación suficiente para cambiar elNetwork
actualmente activo que se usa de forma predeterminada para el tráfico de la aplicación y que se muestra en los métodos de la API deConnectivityManager
, comogetActiveNetwork
yregisterDefaultNetworkCallback
. En otras palabras, PUEDEN inhabilitar solo el acceso a Internet proporcionado por cualquier otro proveedor de red (por ejemplo, datos móviles) si validan con éxito que la red Wi-Fi proporciona acceso a Internet. - [C-1-6] SE RECOMIENDA ENERCMENTE que, cuando se llame al método de la API
ConnectivityManager.reportNetworkConnectivity()
, se vuelva a evaluar el acceso a Internet en elNetwork
y, una vez que la evaluación determine que elNetwork
actual ya no proporciona acceso a Internet, se cambien a cualquier otra red disponible (p.ej., datos móviles) que sí lo haga. - [C-SR] SE RECOMIENDA aleatorizar la dirección MAC de origen y el número de secuencia de los marcos de solicitud de sondeo, una vez al comienzo de cada análisis, mientras el STA está desconectado.
- Cada grupo de tramas de solicitud de sondeo que conforma un análisis debe usar una dirección MAC coherente (NO SE DEBE aleatorizar la dirección MAC a mitad del análisis).
- El número de secuencia de la solicitud de sondeo debe iterarse con normalidad (de forma secuencial) entre las solicitudes de sondeo de un análisis.
- El número de secuencia de la solicitud de sondeo debe ser aleatorio entre la última solicitud de sondeo de un análisis y la primera solicitud de sondeo del siguiente análisis.
- [C-SR] SE RECOMIENDA COMPLETAMENTE, mientras el STA está desconectado, para permitir solo los siguientes elementos en los marcos de solicitud de sondeo:
- Conjunto de parámetros de SSID (0)
- Conjunto de parámetros de DS (3)
Si las implementaciones de dispositivos incluyen compatibilidad con el modo de ahorro de energía de Wi-Fi como se define en el estándar IEEE 802.11, deben cumplir con lo siguiente:
- [C-3-1] DEBE desactivar el modo de ahorro de energía de Wi-Fi cada vez que una app adquiere un bloqueo
WIFI_MODE_FULL_HIGH_PERF
oWIFI_MODE_FULL_LOW_LATENCY
a través de las APIs deWifiManager.createWifiLock()
yWifiManager.WifiLock.acquire()
, y el bloqueo está activo. - [C-3-2] La latencia promedio de ida y vuelta entre el dispositivo y un punto de acceso mientras este se encuentra en el modo de Bloqueo de baja latencia de Wi-Fi (
WIFI_MODE_FULL_LOW_LATENCY
) DEBE ser menor que la latencia que se obtiene durante un modo de Bloqueo de rendimiento alto de Wi-Fi (WIFI_MODE_FULL_HIGH_PERF
). - [C-SR] SE RECOMIENDEN ENERGÍAMENTE para minimizar la latencia de ida y vuelta de Wi-Fi cada vez que se adquiere y se aplica un bloqueo de latencia baja (
WIFI_MODE_FULL_LOW_LATENCY
).
Si las implementaciones de dispositivos admiten Wi-Fi y usan Wi-Fi para la búsqueda de ubicación, sucederá lo siguiente:
- [C-2-1] DEBE proporcionar una indicación visual del usuario para habilitar o inhabilitar el valor leído a través del método de API
WifiManager.isScanAlwaysAvailable
.
7.4.2.1. Wi-Fi directo
Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con Wi-Fi directo (Wi-Fi entre pares).
Si las implementaciones de dispositivos incluyen compatibilidad con Wi-Fi directo, sucederá lo siguiente:
- [C-1-1] DEBE implementar la API de Android correspondiente como se describe en la documentación del SDK.
- [C-1-2] DEBE informar la función de hardware
android.hardware.wifi.direct
. - [C-1-3] DEBE admitir el funcionamiento normal de Wi-Fi.
- [C-1-4] DEBE admitir operaciones de Wi-Fi y Wi-Fi directo en simultáneo.
7.4.2.2. Configuración del vínculo directo en túnel Wi-Fi
Implementaciones en dispositivos:
- SE RECOMIENDA incluir compatibilidad con la Configuración de vínculos directos de túneles Wi-Fi (TDLS), como se describe en la documentación del SDK de Android.
Si las implementaciones de dispositivos incluyen compatibilidad con TDLS y TDLS está habilitado por la API de WifiManager, sucederá lo siguiente:
- [C-1-1] DEBE declarar la compatibilidad con TDLS a través de
WifiManager.isTdlsSupported
. - DEBE usar TDLS solo cuando sea posible Y beneficioso.
- SE DEBE tener una heurística y NO usar TDLS cuando su rendimiento podría ser peor que el de pasar por el punto de acceso Wi-Fi.
7.4.2.3 Reconocimiento de Wi-Fi
Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con Wi-Fi Aware.
Si las implementaciones de dispositivos incluyen compatibilidad con el reconocimiento de Wi-Fi y exponen la funcionalidad a apps de terceros, sucederá lo siguiente:
- [C-1-1] SE DEBE implementar las APIs de
WifiAwareManager
como se describe en la documentación del SDK. - [C-1-2] DEBE declarar la marca de función
android.hardware.wifi.aware
. - [C-1-3] DEBE admitir operaciones de Wi-Fi y reconocimiento de Wi-Fi al mismo tiempo.
- [C-1-4] SE DEBE aleatorizar la dirección de la interfaz de administración de reconocimiento de Wi-Fi a intervalos que no superen los 30 minutos y siempre que se habilite esa función, a menos que una operación de rango de reconocimiento esté en curso o que una ruta de datos de reconocimiento esté activa (no se espera la aleatorización mientras la ruta de datos esté activa).
Si las implementaciones de dispositivos incluyen compatibilidad con el reconocimiento de Wi-Fi y la ubicación de Wi-Fi como se describe en la Sección 7.4.2.5 y exponen estas funciones a apps de terceros, sucederá lo siguiente:
- [C-2-1] DEBEN implementar las APIs de descubrimiento basadas en la ubicación: setRangingEnabled, setMinDistanceMm, setMaxDistanceMm y onServiceDiscoveredWithinRange.
7.4.2.4. Passpoint para Wi-Fi
Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con Wi-Fi Passpoint.
Si las implementaciones en dispositivos incluyen compatibilidad con Wi-Fi Passpoint, ocurrirá lo siguiente:
- [C-1-1] DEBE implementar las APIs de
WifiManager
relacionadas con Passpoint, como se describe en la documentación del SDK. - [C-1-2] DEBE ser compatible con el estándar IEEE 802.11u, relacionado específicamente con el descubrimiento y la selección de redes, como el servicio de publicidad genérica (GAS) y el protocolo de consulta de red de acceso (ANQP).
En cambio, si las implementaciones de dispositivos no incluyen compatibilidad con Wi-Fi Passpoint, haz lo siguiente:
- [C-2-1] La implementación de las APIs de
WifiManager
relacionadas con Passpoint DEBE arrojar unaUnsupportedOperationException
.
7.4.2.5. Ubicación de Wi-Fi (tiempo de ida y vuelta de Wi-Fi - RTT)
Implementaciones en dispositivos:
- SE DEBE incluir compatibilidad con la Ubicación Wi-Fi.
Si las implementaciones de dispositivos incluyen compatibilidad con la ubicación de Wi-Fi y exponen la funcionalidad a aplicaciones de terceros, entonces:
- [C-1-1] SE DEBE implementar las APIs de
WifiRttManager
como se describe en la documentación del SDK. - [C-1-2] DEBE declarar la marca de función
android.hardware.wifi.rtt
. - [C-1-3] DEBE aleatorizar la dirección MAC de origen para cada aumento de actividad de RTT que se ejecuta mientras la interfaz Wi-Fi en la cual se ejecuta el RTT no está asociada a un punto de acceso.
7.4.2.6. Descarga de Wi-Fi Keepalive
Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con la descarga de keepalive de Wi-Fi.
Si las implementaciones de dispositivos incluyen compatibilidad con la descarga de keepalive de Wi-Fi y exponen la funcionalidad a apps de terceros, harán lo siguiente:
-
[C-1-1] DEBE admitir la API de SocketKeepAlive.
-
[C-1-2] DEBE admitir al menos tres ranuras de keepalive simultáneas a través de Wi-Fi y al menos una ranura keepalive a través de datos móviles.
Si las implementaciones de dispositivos no incluyen compatibilidad con la descarga de keepalive de Wi-Fi, sucederá lo siguiente:
- [C-2-1] DEBE devolver
ERROR_UNSUPPORTED
.
7.4.2.7. Easy Connect para Wi-Fi (protocolo de aprovisionamiento de dispositivos)
Implementaciones en dispositivos:
- Se recomienda incluir compatibilidad con Easy Connect (DPP) de Wi-Fi.
Si las implementaciones de dispositivos incluyen compatibilidad con Wi-Fi Easy Connect y exponen la funcionalidad a apps de terceros, harán lo siguiente:
- [C-1-1] DEBE hacer que el método WifiManager#isEasyConnectSupported() devuelva
true
.
7.4.3. Bluetooth
Si las implementaciones de dispositivos admiten el perfil de audio Bluetooth, sucederá lo siguiente:
- DEBE admitir Códecs de audio avanzados y códecs de audio Bluetooth (p.ej., LDAC).
Si las implementaciones de dispositivos admiten HFP, A2DP y AVRCP, harán lo siguiente:
- SE RECOMIENDA admitir al menos 5 dispositivos conectados en total.
Si las implementaciones de dispositivos declaran la función android.hardware.vr.high_performance
, hará lo siguiente:
- [C-1-1] DEBE ser compatible con Bluetooth 4.2 y la extensión de longitud de datos de Bluetooth LE.
Android admite Bluetooth y Bluetooth de bajo consumo.
Si las implementaciones de dispositivos incluyen compatibilidad con Bluetooth y Bluetooth de bajo consumo, sucederá lo siguiente:
- [C-2-1] DEBE declarar las funciones relevantes de la plataforma (
android.hardware.bluetooth
yandroid.hardware.bluetooth_le
respectivamente) e implementar las APIs de la plataforma. - SE DEBE implementar perfiles de Bluetooth relevantes, como A2DP, AVRCP, OBEX, HFP, etc., según corresponda para el dispositivo.
Si las implementaciones de dispositivos incluyen compatibilidad con Bluetooth de bajo consumo (BLE), sucederá lo siguiente:
- [C-3-1] SE DEBE declarar la función de hardware
android.hardware.bluetooth_le
. - [C-3-2] DEBE habilitar las APIs de Bluetooth basadas en GATT (perfil de atributo genérico) como se describe en la documentación del SDK y en android.bluetooth.
- [C-3-3] SE DEBE informar el valor correcto de
BluetoothAdapter.isOffloadedFilteringSupported()
para indicar si se implementó la lógica de filtrado para las clases de API ScanFilter. - [C-3-4] SE DEBE informar el valor correcto de
BluetoothAdapter.isMultipleAdvertisementSupported()
para indicar si se admite la publicidad de bajo consumo. - [C-3-5] DEBE implementar un tiempo de espera de dirección privada resolvable (RPA) de no más de 15 minutos y rotar la dirección en el tiempo de espera para proteger la privacidad del usuario cuando el dispositivo usa activamente BLE para escaneo o publicidad. Para evitar ataques de tiempo, los intervalos de tiempo de espera también DEBEN aleatorizarse entre 5 y 15 minutos.
- SE DEBE admitir la transferencia de la lógica de filtrado al chipset de Bluetooth cuando se implementa la API de ScanFilter.
- SE DEBE admitir la transferencia del escaneo por lotes al chipset Bluetooth.
- SE DEBE admitir anuncios múltiples con al menos 4 espacios.
Si las implementaciones de dispositivos admiten Bluetooth LE y usan Bluetooth LE para la búsqueda de la ubicación, sucederá lo siguiente:
- [C-4-1] DEBE proporcionar una indicación visual del usuario para habilitar o inhabilitar el valor leído a través de la API del sistema
BluetoothAdapter.isBleScanAlwaysAvailable()
.
Si las implementaciones de dispositivos incluyen compatibilidad con Bluetooth LE y el perfil de audífonos, como se describe en Compatibilidad con audio de audífonos con Bluetooth de bajo consumo, sucederá lo siguiente:
- [C-5-1] DEBE mostrar
true
para BluetoothAdapter.getProfileProxy(context, audience, BluetoothProfile.HEARING_AID).
7.4.4. Comunicaciones de campo cercano
Implementaciones en dispositivos:
- SE DEBE incluir un transceptor y el hardware relacionado para las comunicaciones de campo cercano (NFC).
- [C-0-1] DEBE implementar las APIs de
android.nfc.NdefMessage
yandroid.nfc.NdefRecord
incluso si no incluyen compatibilidad con NFC o si declaran la funciónandroid.hardware.nfc
, ya que las clases representan un formato de representación de datos independiente del protocolo.
Si las implementaciones de dispositivos incluyen hardware NFC y planean que esté disponible para apps de terceros, deben hacer lo siguiente:
- [C-1-1] SE DEBE informar el atributo
android.hardware.nfc
desde el métodoandroid.content.pm.PackageManager.hasSystemFeature()
. - DEBE ser capaz de leer y escribir mensajes NDEF a través de los siguientes estándares NFC como se indica a continuación:
- [C-1-2] DEBE ser capaz de actuar como lector/escritor de NFC Forum (según se define en la especificación técnica NFCForum-TS-DigitalProtocol-1.0 del foro de NFC) mediante los siguientes estándares de NFC:
- NfcA (ISO14443-3A)
- NfcB (ISO14443-3B)
- NfcF (JIS X 6319-4)
- IsoDep (ISO 14443-4)
- Tipos de etiquetas del foro de NFC 1, 2, 3, 4, 5 (definidas por NFC Forum)
-
[SR] SE RECOMIENDA SER capaz de leer y escribir mensajes NDEF, así como datos sin procesar a través de los siguientes estándares NFC. Ten en cuenta que, si bien los estándares de NFC se indican como MUY RECOMENDADOS, se planea que la definición de compatibilidad para una versión futura cambie a DEBE. Estos estándares son opcionales en esta versión, pero serán obligatorios en versiones futuras. Se recomienda encarecidamente que los dispositivos existentes y nuevos que ejecutan esta versión de Android cumplan con estos requisitos ahora para que puedan actualizarse a versiones futuras de la plataforma.
-
[C-1-13] SE DEBE sondear todas las tecnologías compatibles en el modo de descubrimiento de NFC.
- DEBES estar en el modo de descubrimiento de NFC mientras el dispositivo está activo con la pantalla activa y la pantalla bloqueada desbloqueada.
- SE DEBE poder leer el código de barras y la URL (si están codificados) de los productos Thinfilm NFC Barcode.
Ten en cuenta que los vínculos disponibles públicamente no están disponibles para las especificaciones JIS, ISO y NFC Forum citadas anteriormente.
Android admite el modo de emulación de tarjeta de host NFC (HCE).
Si las implementaciones de dispositivos incluyen un chipset del controlador NFC capaz de HCE (para NfcA o NfcB) y que admiten el enrutamiento de Application ID (AID), deben hacer lo siguiente:
- [C-2-1] DEBE informar la constante de función
android.hardware.nfc.hce
. - [C-2-2] DEBE ser compatible con las APIs de NFC HCE según se define en el SDK de Android.
Si las implementaciones de dispositivos incluyen un chipset del controlador NFC capaz de HCE para NfcF e implementan la función para aplicaciones de terceros, deben hacer lo siguiente:
- [C-3-1] DEBE informar la constante de función
android.hardware.nfc.hcef
. - [C-3-2] DEBE implementar las APIs de emulación de tarjeta de NFC como se define en el SDK de Android.
Si las implementaciones de dispositivos incluyen compatibilidad general con NFC, como se describe en esta sección, y admiten tecnologías MIFARE (MIFARE Classic, MIFARE Ultralight, NDEF en MIFARE Classic) en la función de lector/escritor:
- [C-4-1] SE DEBE implementar las API de Android correspondientes según se documenta en el SDK de Android.
- [C-4-2] SE DEBE informar el atributo
com.nxp.mifare
desde el métodoandroid.content.pm.PackageManager.hasSystemFeature
(). Ten en cuenta que esta no es una función estándar de Android y, por lo tanto, no aparece como una constante en la claseandroid.content.pm.PackageManager
.
7.4.5. Protocolos de red y APIs
7.4.5.1. Capacidad de red mínima
Implementaciones en dispositivos:
- [C-0-1] DEBE incluir compatibilidad con una o más formas de red de datos. Específicamente, las implementaciones en dispositivos DEBEN incluir compatibilidad con al menos un estándar de datos con capacidad de 200 Kbit/s o superior. Algunos ejemplos de tecnologías que cumplen este requisito incluyen EDGE, HSPA, EV-DO, 802.11g, Ethernet y número PAN Bluetooth.
- También se DEBE admitir, al menos, un estándar común de datos inalámbricos, como 802.11 (Wi-Fi), cuando un estándar de red físico (como Ethernet) es la conexión de datos principal.
- PUEDE implementar más de una forma de conectividad de datos.
7.4.5.2. IPv6
Implementaciones en dispositivos:
- [C-0-2] DEBE incluir una pila de red IPv6 y admitir la comunicación IPv6 usando las APIs administradas, como
java.net.Socket
yjava.net.URLConnection
, además de las APIs nativas, como los socketsAF_INET6
. - [C-0-3] SE DEBE habilitar IPv6 de forma predeterminada.
- DEBES asegurarte de que la comunicación IPv6 sea tan confiable como IPv4, por ejemplo:
- [C-0-4] DEBE mantener la conectividad IPv6 en modo Descanso.
- [C-0-5] El límite de frecuencia NO DEBE provocar que el dispositivo pierda conectividad IPv6 en ninguna red compatible con IPv6 que use ciclos de vida con RA de al menos 180 segundos.
- [C-0-6] DEBE proporcionar a las aplicaciones de terceros conectividad IPv6 directa a la red cuando se conecta a una red IPv6, sin que el dispositivo tenga ninguna forma de traducción de direcciones o puertos local. Ambas APIs administradas, como
Socket#getLocalAddress
oSocket#getLocalPort
, y las APIs de NDK, comogetsockname()
oIPV6_PKTINFO
, DEBEN mostrar la dirección IP y el puerto que se usan realmente para enviar y recibir paquetes en la red, y que son visibles como la IP y el puerto de origen para los servidores de Internet (Web).
El nivel requerido de compatibilidad con IPv6 depende del tipo de red, como se muestra en los siguientes requisitos.
Si las implementaciones de dispositivos admiten Wi-Fi, sucederá lo siguiente:
- [C-1-1] DEBE admitir operaciones de pila doble y solo IPv6 en Wi-Fi.
Si las implementaciones de dispositivos son compatibles con Ethernet, deberán hacer lo siguiente:
- [C-2-1] DEBE admitir el funcionamiento de pila doble y solo IPv6 en Ethernet.
Si las implementaciones de dispositivos admiten datos móviles, harán lo siguiente:
- [C-3-1] DEBE admitir la operación de IPv6 (solo IPv6 y posiblemente de pila doble) en redes móviles.
Si las implementaciones de dispositivos admiten más de un tipo de red (p.ej., Wi-Fi y datos móviles), hacen lo siguiente:
- [C-4-1] DEBE cumplir de forma simultánea con los requisitos anteriores en cada red cuando el dispositivo está conectado simultáneamente a más de un tipo de red.
7.4.5.3 Portales cautivos
Un portal cautivo hace referencia a una red que requiere iniciar sesión para obtener acceso a Internet.
Si las implementaciones en dispositivos proporcionan una implementación completa de android.webkit.Webview API
, sucederá lo siguiente:
- [C-1-1] DEBE proporcionar una aplicación de portal cautivo para controlar el intent
ACTION_CAPTIVE_PORTAL_SIGN_IN
y mostrar la página de acceso del portal cautivo enviando ese intent en una llamada a la API del sistemaConnectivityManager#startCaptivePortalApp(Network, Bundle)
. - [C-1-2] DEBE detectar portales cautivos y admitir el acceso a través de la aplicación del portal cautivo cuando el dispositivo está conectado a cualquier tipo de red, incluida la red móvil o móvil, Wi-Fi, Ethernet o Bluetooth.
- [C-1-3] DEBE admitir el acceso a portales cautivos usando DNS de texto simple cuando el dispositivo está configurado para usar el modo estricto de DNS privado.
- [C-1-4] SE DEBE usar DNS encriptado según la documentación del SDK para
android.net.LinkProperties.getPrivateDnsServerName
yandroid.net.LinkProperties.isPrivateDnsActive
para todo el tráfico de red que no se comunique de manera explícita con el portal cautivo. - [C-1-5] DEBEN asegurarse de que, mientras el usuario accede a un portal cautivo, la red predeterminada que usan las aplicaciones (como se muestra en
ConnectivityManager.getActiveNetwork
,ConnectivityManager.registerDefaultNetworkCallback
y que usan las APIs de red Java, como java.net.Socket y APIs nativas como connect()) de forma predeterminada sea cualquier otra red disponible que proporcione acceso a Internet, si está disponible.
7.4.6. Configuración de sincronización
Implementaciones en dispositivos:
- [C-0-1] DEBE tener activada la sincronización automática de la instancia principal de forma predeterminada para que el método
getMasterSyncAutomatically()
muestre el valor “true”.
7.4.7. Ahorro de datos
Si las implementaciones en dispositivos incluyen una conexión de uso medido, son las siguientes:
- [SR] SE RECOMIENDA COMPLETAMENTE proporcionar el modo de Ahorro de datos.
Si las implementaciones de dispositivos proporcionan el modo de Ahorro de datos, sucederá lo siguiente:
- [C-1-1] DEBE admitir todas las APIs de la clase
ConnectivityManager
, como se describe en la documentación del SDK.
Si las implementaciones de dispositivos no proporcionan el modo de Ahorro de datos, sucederá lo siguiente:
- [C-2-1] SE DEBE mostrar el valor
RESTRICT_BACKGROUND_STATUS_DISABLED
paraConnectivityManager.getRestrictBackgroundStatus()
. - [C-2-2] NO DEBE transmitir
ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED
.
7.4.8. Elementos seguros
Si las implementaciones de dispositivos admiten elementos seguros compatibles con Open Mobile API y los ponen a disposición de apps de terceros, sucederá lo siguiente:
-
[C-1-1] SE DEBE enumerar los lectores de elementos seguros disponibles a través de la API de
android.se.omapi.SEService.getReaders()
. -
[C-1-2] DEBE declarar las marcas de función correctas a través de
android.hardware.se.omapi.uicc
para el dispositivo con elementos seguros basados en UICC,android.hardware.se.omapi.ese
para el dispositivo con elementos seguros basados en eSE yandroid.hardware.se.omapi.sd
para el dispositivo con elementos seguros basados en SD.
7.5 Cámaras
Si las implementaciones en dispositivos incluyen al menos una cámara, sucederá lo siguiente:
- [C-1-1] DEBE declarar la marca de función
android.hardware.camera.any
. - [C-1-2] DEBE ser posible para que una aplicación asigne simultáneamente 3 mapas de bits RGBA_8888 igual al tamaño de las imágenes producidas por el sensor de la cámara de mayor resolución en el dispositivo, mientras la cámara está abierta para obtener una vista previa básica y capturar imágenes.
- [C-1-3] DEBE asegurarse de que la aplicación de cámara predeterminada preinstalada que controla los intents
MediaStore.ACTION_IMAGE_CAPTURE
,MediaStore.ACTION_IMAGE_CAPTURE_SECURE
oMediaStore.ACTION_VIDEO_CAPTURE
, es responsable de quitar la ubicación del usuario en los metadatos de la imagen antes de enviarla a la aplicación receptora cuando la aplicación receptora no tengaACCESS_FINE_LOCATION
.
7.5.1 Cámara posterior
Una cámara posterior es una cámara ubicada en el lado del dispositivo opuesto a la pantalla. es decir, captura escenas en el lado más alejado del dispositivo, como una cámara tradicional.
Implementaciones en dispositivos:
- SE RECOMIENDA incluir una cámara posterior.
Si las implementaciones en dispositivos incluyen al menos una cámara posterior, sucederá lo siguiente:
- [C-1-1] SE DEBE informar la marca de función
android.hardware.camera
yandroid.hardware.camera.any
. - [C-1-2] DEBE tener una resolución de al menos 2 megapíxeles.
- SE DEBE tener un enfoque automático de hardware o uno de software implementado en el controlador de la cámara (transparente para el software de aplicación).
- PUEDE tener hardware de enfoque fijo o EDOF (profundidad de campo extendida).
- PUEDE incluir un destello.
Si la cámara incluye flash:
- [C-2-1] La lámpara de flash NO DEBE encenderse mientras se registra una instancia de
android.hardware.Camera.PreviewCallback
en una superficie de vista previa de la cámara, a menos que la aplicación haya habilitado explícitamente el flash habilitando los atributosFLASH_MODE_AUTO
oFLASH_MODE_ON
de un objetoCamera.Parameters
. Ten en cuenta que esta restricción no se aplica a la aplicación de cámara del sistema integrada del dispositivo, sino solo a las aplicaciones de terceros que usanCamera.PreviewCallback
.
7.5.2. Cámara frontal
La cámara frontal es aquella que está ubicada en el mismo lado del dispositivo que la pantalla. es decir, una cámara que generalmente se usa para generar imágenes del usuario, como para videoconferencias y aplicaciones similares.
Implementaciones en dispositivos:
- PUEDE incluir una cámara frontal.
Si las implementaciones de dispositivos incluyen al menos una cámara frontal, sucederá lo siguiente:
- [C-1-1] SE DEBE informar la marca de función
android.hardware.camera.any
yandroid.hardware.camera.front
. - [C-1-2] DEBE tener una resolución de, al menos, VGA (640 x 480 píxeles).
- [C-1-3] NO DEBE usar una cámara frontal como predeterminada para la API de cámara y NO DEBE configurar la API para que considere una cámara frontal como la cámara posterior predeterminada, incluso si es la única cámara del dispositivo.
- [C-1-4] La vista previa de la cámara DEBE duplicarse horizontalmente en relación con la orientación especificada por la aplicación cuando la aplicación actual solicitó explícitamente que se rote la pantalla de la cámara con una llamada al método
android.hardware.Camera.setDisplayOrientation()
. Por el contrario, la vista previa DEBE reflejarse en el eje horizontal predeterminado del dispositivo cuando la aplicación actual no solicita explícitamente que se rote la pantalla de la cámara llamando al métodoandroid.hardware.Camera.setDisplayOrientation()
. - [C-1-5] NO DEBE duplicar la imagen estática final ni las transmisiones de video capturadas que se devuelven a las devoluciones de llamada de la aplicación o se guardan en el almacenamiento de medios.
- [C-1-6] DEBE reflejar la imagen que muestra la vista previa del mismo modo que el flujo de imágenes de vista previa de la cámara.
- PUEDE incluir funciones (como enfoque automático, flash, etc.) disponibles para las cámaras posteriores, según se describe en la sección 7.5.1.
Si el usuario puede rotar las implementaciones de dispositivos (por ejemplo, de forma automática mediante un acelerómetro o de forma manual mediante una entrada del usuario):
- [C-2-1] La vista previa de la cámara DEBE reflejarse horizontalmente en relación con la orientación actual del dispositivo.
7.5.3 Cámara externa
Implementaciones en dispositivos:
- PUEDE incluir compatibilidad con una cámara externa que no siempre está conectada.
Si las implementaciones de dispositivos incluyen compatibilidad con una cámara externa, sucederá lo siguiente:
- [C-1-1] SE DEBE declarar las marcas de función
android.hardware.camera.external
yandroid.hardware camera.any
de la plataforma. - [C-1-2] DEBE ser compatible con la clase de video USB (UVC 1.0 o superior) si la cámara externa se conecta a través del puerto de host USB.
- [C-1-3] DEBE pasar las pruebas del CTS de la cámara con un dispositivo de cámara externo físico conectado. Los detalles de las pruebas del CTS de la cámara están disponibles en source.android.com.
- SE RECOMIENDA admitir compresiones de video como MJPEG para permitir la transferencia de transmisiones de alta calidad sin codificación (es decir, transmisiones de imagen sin procesar o comprimidas de forma independiente).
- PUEDE admitir varias cámaras.
- PUEDE admitir la codificación de video basada en la cámara.
Si se admite la codificación de video basada en la cámara:
- [C-2-1] La implementación del dispositivo DEBE poder acceder a una transmisión MJPEG o sin codificación simultánea (QVGA o superior resolución).
7.5.4. Comportamiento de la API de Camera
Android incluye dos paquetes de API para acceder a la cámara. La nueva API de android.hardware.camera2 expone el control de cámara de nivel inferior a la app, incluidos flujos eficientes de ráfaga o transmisión de copias cero y controles por fotograma de exposición, ganancia, ganancia de balance de blancos, conversión de color, reducción de ruido, nitidez, entre otros.
El paquete de API anterior, android.hardware.Camera
, está marcado como obsoleto en Android 5.0, pero debería estar disponible para que lo usen las apps. Las implementaciones en dispositivos Android DEBEN garantizar la compatibilidad continua de la API, tal como se describe en esta sección y en el SDK de Android.
Todas las funciones comunes entre la clase android.hardware.Camera obsoleta y el paquete android.hardware.camera2 más nuevo DEBEN tener rendimiento y calidad equivalentes en ambas API. Por ejemplo, con parámetros de configuración equivalentes, la velocidad y la precisión del enfoque automático deben ser idénticas, y la calidad de las imágenes capturadas debe ser la misma. No es necesario que las funciones que dependen de la semántica de las dos APIs tengan la misma velocidad o calidad, pero DEBEN coincidir lo más posible.
Las implementaciones de dispositivos DEBEN implementar los siguientes comportamientos para las API relacionadas con la cámara para todas las cámaras disponibles. Implementaciones en dispositivos:
- [C-0-1] DEBE usar
android.hardware.PixelFormat.YCbCr_420_SP
para los datos de vista previa proporcionados a las devoluciones de llamada de la aplicación cuando una aplicación nunca llamó aandroid.hardware.Camera.Parameters.setPreviewFormat(int)
. - [C-0-2] DEBE estar en el formato de codificación NV21 cuando una aplicación registra una instancia de
android.hardware.Camera.PreviewCallback
y el sistema llama al métodoonPreviewFrame()
y el formato de vista previa es YCbCr_420_SP, los datos en el byte[] que se pasa aonPreviewFrame()
. Es decir, NV21 DEBE ser el predeterminado. - [C-0-3] DEBE admitir el formato YV12 (como indica la constante
android.graphics.ImageFormat.YV12
) para las vistas previas de las cámaras frontal y posterior deandroid.hardware.Camera
. (El codificador de video de hardware y la cámara pueden usar cualquier formato de píxeles nativo, pero la implementación del dispositivo DEBE admitir la conversión a YV12). - [C-0-4] DEBE admitir los formatos
android.hardware.ImageFormat.YUV_420_888
yandroid.hardware.ImageFormat.JPEG
como salidas a través de la API deandroid.media.ImageReader
para dispositivosandroid.hardware.camera2
que anuncian la funciónREQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
enandroid.request.availableCapabilities
. - [C-0-5] DE todas formas DEBE implementar la API de Camera completa incluida en la documentación del SDK de Android, independientemente de si el dispositivo incluye enfoque automático de hardware o alguna otra función. Por ejemplo, las cámaras sin enfoque automático DEBEN llamar a cualquier instancia registrada de
android.hardware.Camera.AutoFocusCallback
(aunque esto no sea relevante para una cámara sin enfoque automático). Ten en cuenta que esto se aplica a las cámaras frontales. por ejemplo, aunque la mayoría de las cámaras frontales no admitan el enfoque automático, las devoluciones de llamada de la API se deben “simular” de todas formas, como se describe. - [C-0-6] DEBE reconocer y respetar cada nombre de parámetro definido como una constante en las clases
android.hardware.Camera.Parameters
yandroid.hardware.camera2.CaptureRequest
. Por el contrario, las implementaciones en dispositivos NO DEBEN respetar ni reconocer las constantes de cadena pasadas al métodoandroid.hardware.Camera.setParameters()
que no sean las documentadas como constantes enandroid.hardware.Camera.Parameters
. Es decir, las implementaciones en dispositivos DEBEN admitir todos los parámetros estándar de Camera si el hardware lo permite, y NO DEBEN admitir tipos de parámetros personalizados de Camera. Por ejemplo, las implementaciones en dispositivos que admiten la captura de imágenes con técnicas de imágenes de alto rango dinámico (HDR) DEBEN admitir el parámetro de la cámaraCamera.SCENE_MODE_HDR
. - [C-0-7] DEBE informar el nivel adecuado de compatibilidad con la propiedad
android.info.supportedHardwareLevel
, como se describe en el SDK de Android, además de las marcas de funciones del framework adecuadas. - [C-0-8] También DEBE declarar sus capacidades de cámara individuales de
android.hardware.camera2
a través de la propiedadandroid.request.availableCapabilities
y declarar las marcas de función adecuadas. DEBE definir la marca de función si alguno de los dispositivos de cámara conectados admite la función. - [C-0-9] SE DEBE transmitir el intent
Camera.ACTION_NEW_PICTURE
cada vez que la cámara toma una nueva foto y la entrada de la imagen se agrega a la tienda de contenido multimedia. - [C-0-10] SE DEBE transmitir el intent
Camera.ACTION_NEW_VIDEO
cada vez que la cámara graba un nuevo video y la entrada de la imagen se agrega a la tienda de contenido multimedia. - [C-0-11] SE DEBE poder acceder a todas las cámaras mediante la API
android.hardware.Camera
obsoleta también a través de la APIandroid.hardware.camera2
. - El [C-0-12] DEBE asegurarse de que la apariencia facial NO se vea alterada, lo que incluye, sin limitaciones, alterar la geometría o el tono de la piel facial o su suavizado de la piel facial para cualquier API de
android.hardware.camera2
oandroid.hardware.Camera
. - [C-SR] En el caso de los dispositivos con varias cámaras RGB que apunten a la misma dirección, se RECOMIENDA ENCENDER que sean compatibles con un dispositivo de cámara lógico que indique la capacidad
CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
, que conste de todas las cámaras RGB orientadas a esa dirección como dispositivos secundarios físicos.
Si las implementaciones de dispositivos proporcionan una API de cámara de propiedad a apps de terceros, tendrán que hacer lo siguiente:
- [C-1-1] DEBE implementar una API de cámara de este tipo con la API de
android.hardware.camera2
. - PUEDE proporcionar etiquetas o extensiones del proveedor a la API de
android.hardware.camera2
.
7.5.5 Orientación de la cámara
Si las implementaciones de dispositivos tienen una cámara frontal o posterior, estas cámaras son las siguientes:
- [C-1-1] DEBE orientarse de modo que la dimensión larga de la cámara se alinee con la dimensión larga de la pantalla. Es decir, cuando el dispositivo se mantiene en orientación horizontal, las cámaras DEBEN capturar imágenes en orientación horizontal. Esto se aplica independientemente de la orientación natural del dispositivo. es decir, se aplica a los dispositivos principales horizontales y verticales.
7.6 Memoria y almacenamiento
7.6.1. Memoria y almacenamiento mínimos
Implementaciones en dispositivos:
- [C-0-1] DEBE incluir un Administrador de descargas que las aplicaciones PUEDEN usar para descargar archivos de datos. Además, DEBE tener la capacidad de descargar archivos individuales de al menos 100 MB de tamaño a la ubicación predeterminada de “caché”.
7.6.2. Almacenamiento compartido de la aplicación
Implementaciones en dispositivos:
- [C-0-1] DEBE ofrecer almacenamiento para que lo compartan las aplicaciones, también conocido como “almacenamiento externo compartido” o “almacenamiento compartido de la aplicación”. o con la ruta de acceso de Linux "/sdcard" en la que esté montado.
- [C-0-2] DEBE configurarse con el almacenamiento compartido activado de forma predeterminada, es decir, “listo para usar”, sin importar si el almacenamiento se implementa en un componente de almacenamiento interno o en un medio de almacenamiento extraíble (p.ej., ranura de tarjeta de Secure Digital).
- [C-0-3] SE DEBE activar el almacenamiento compartido de la aplicación directamente en la ruta de acceso de Linux
sdcard
o incluir un vínculo simbólico de Linux desdcard
al punto de activación real. - [C-0-4] SE DEBE habilitar el almacenamiento específico de forma predeterminada para todas las apps orientadas al nivel de API 29 o versiones posteriores, excepto en el siguiente caso:
- Cuando la app solicita
android:requestLegacyExternalStorage="true"
en su manifiesto.
- Cuando la app solicita
- [C-0-5] SE DEBE ocultar los metadatos de ubicación, como las etiquetas Exif de GPS, que se almacenan en archivos multimedia cuando se accede a esos archivos a través de
MediaStore
, excepto cuando la app que realiza la llamada tiene el permisoACCESS_MEDIA_LOCATION
.
Las implementaciones de dispositivos PUEDEN cumplir con los requisitos anteriores usando cualquiera de las siguientes opciones:
- Almacenamiento extraíble accesible para el usuario, como una ranura de tarjeta Secure Digital (SD).
- Una parte del almacenamiento interno (no extraíble) tal como se implementó en el Proyecto de código abierto de Android (AOSP).
Si las implementaciones de dispositivos usan almacenamiento extraíble para cumplir con los requisitos anteriores, sucederá lo siguiente:
- [C-1-1] DEBE implementar un aviso o una interfaz de usuario emergente que advierta al usuario cuando no se insertó un medio de almacenamiento en la ranura.
- [C-1-2] DEBE incluir un medio de almacenamiento con formato FAT (por ejemplo, una tarjeta SD) o aparecer en la caja y otro material disponible en el momento de la compra que indica que el medio de almacenamiento se debe comprar por separado.
Si las implementaciones de dispositivos usan una parte del almacenamiento no extraíble para cumplir con los requisitos anteriores, sucederá lo siguiente:
- SE DEBE usar la implementación de AOSP del almacenamiento compartido interno de la aplicación.
- PUEDE compartir el espacio de almacenamiento con los datos privados de la aplicación.
Si las implementaciones de dispositivos tienen un puerto USB compatible con el modo periférico USB, sucederá lo siguiente:
- [C-3-1] DEBE proporcionar un mecanismo para acceder a los datos en el almacenamiento compartido de la aplicación desde una computadora host.
- SE RECOMIENDA exponer el contenido de ambas rutas de almacenamiento de forma transparente a través del servicio de escáner de contenido multimedia de Android y
android.provider.MediaStore
. - PUEDE utilizar el almacenamiento masivo de USB, pero SE DEBE utilizar el Protocolo de transferencia de medios para cumplir con este requisito.
Si las implementaciones de dispositivos tienen un puerto USB con modo periférico USB y admiten el Protocolo de transferencia de medios, harán lo siguiente:
- DEBE ser compatible con el host de MTP de Android de referencia, Android File Transfer.
- SE DEBE informar una clase de dispositivo USB de 0x00.
- SE DEBE informar que la interfaz USB es "MTP".
7.6.3. Almacenamiento adoptable
Si se espera que el dispositivo sea móvil, a diferencia de la televisión, las implementaciones en dispositivos son las siguientes:
- [SR] SE RECOMIENDA ENRENDER A implementar el almacenamiento adoptable en una ubicación estable a largo plazo, ya que desconectarlos accidentalmente puede provocar la pérdida o corrupción de datos.
Si el puerto del dispositivo de almacenamiento extraíble se encuentra en una ubicación estable a largo plazo, como dentro del compartimento de la batería o alguna otra cubierta protectora, las implementaciones del dispositivo:
- [SR] RECOMIENDA implementar el almacenamiento adoptable.
7.7 USB
Si las implementaciones de dispositivos tienen un puerto USB, tienen las siguientes características:
- SE DEBE admitir el modo de periférico USB y el modo de host USB.
7.7.1 Modo periférico USB
Si las implementaciones de dispositivos incluyen un puerto USB compatible con el modo periférico:
- [C-1-1] El puerto DEBE poder conectarse a un host USB que tenga un puerto USB estándar tipo A o tipo C.
- [C-1-2] SE DEBE informar el valor correcto de
iSerialNumber
en el descriptor de dispositivo USB estándar a través deandroid.os.Build.SERIAL
. - [C-1-3] DEBE detectar cargadores de 1.5 A y 3.0 A según el estándar de resistencia tipo C y DEBE detectar cambios en el anuncio si admiten USB tipo C.
- [SR] El puerto DEBE usar el factor de forma USB micro-B, micro-AB o tipo C. Se RECOMIENDA ENRENDER que los dispositivos Android existentes y nuevos cumplan con estos requisitos para que puedan actualizarse a las versiones futuras de la plataforma.
- [SR] El puerto SE DEBE ubicar en la parte inferior del dispositivo (según la orientación natural) o permitir la rotación de la pantalla del software para todas las apps (incluida la pantalla principal), de modo que la pantalla se dibuje correctamente cuando el dispositivo esté orientado con el puerto en la parte inferior. Se RECOMIENDA ENRENDER que los dispositivos Android existentes y nuevos cumplan con estos requisitos para que puedan actualizarse a versiones futuras de la plataforma.
- [SR] SE DEBE implementar la compatibilidad para generar una corriente de 1.5 A durante el pitido en el puerto HS y el tráfico, como se especifica en la especificación de la carga de batería USB, revisión 1.2. Se RECOMIENDA ENRENDER que los dispositivos Android existentes y nuevos cumplan con estos requisitos para que puedan actualizarse a las versiones futuras de la plataforma.
- [SR] SE RECOMIENDA ENRENDER no admitir métodos de carga patentados que modifiquen el voltaje de Vbus más allá de los niveles predeterminados o que alteren los roles de receptor o fuente, por lo que podría causar problemas de interoperabilidad con cargadores o dispositivos compatibles con los métodos estándar de USB Power Delivery. Si bien se dice que esto se recomienda encarecidamente, en versiones futuras de Android es posible que REQUISITOS que todos los dispositivos tipo C sean compatibles con una interoperabilidad completa con cargadores tipo C estándar.
- [SR] SE RECOMIENDA ENRENDER QUE admita Power Delivery en el intercambio de datos y funciones de batería cuando sea compatible con el modo de host USB y USB tipo C.
- SE RECOMIENDA admitir Power Delivery para la carga de alto voltaje y compatibilidad con modos alternativos, como visualización de salida.
- SE DEBE implementar la API de Android Open Accessory (AOA) y las especificaciones tal como se documenta en la documentación del SDK de Android.
Si las implementaciones de dispositivos incluyen un puerto USB e implementan la especificación AOA, sucederá lo siguiente:
- [C-2-1] DEBE declarar compatibilidad con la función de hardware
android.hardware.usb.accessory
. - [C-2-2] La clase de almacenamiento masivo USB DEBE incluir la cadena "android". al final de la cadena de descripción de la interfaz
iInterface
del almacenamiento masivo USB
7.7.2. Modo de host USB
Si las implementaciones de dispositivos incluyen un puerto USB compatible con el modo de host, sucederá lo siguiente:
- [C-1-1] DEBE implementar la API del host de USB de Android como se documenta en el SDK de Android y DEBE declarar la compatibilidad con la función de hardware
android.hardware.usb.host
. - [C-1-2] SE DEBE implementar la compatibilidad para conectar periféricos USB estándar; en otras palabras, DEBEN:
- Tener un puerto tipo C integrado en el dispositivo o enviar cables que adapten un puerto de propiedad del dispositivo a un puerto USB tipo C estándar (dispositivo USB tipo C).
- Tener un puerto tipo A integrado en el dispositivo o enviar cables que adapten un puerto propio del dispositivo a un puerto USB tipo A estándar.
- Tener un puerto micro-AB en el dispositivo que SE DEBE enviar con un cable que se adapte a un puerto estándar tipo A.
- [C-1-3] NO DEBE enviarse con un adaptador que convierta de puertos USB tipo A o micro-AB a un puerto tipo C (receptáculo).
- [C-SR] SE RECOMIENDA ENERCMENTE implementar la clase de audio USB como se indica en la documentación del SDK de Android.
- SE DEBE admitir la carga del dispositivo periférico USB conectado mientras se esté en modo de host. anunciar una corriente de origen de, al menos, 1.5 A, como se especifica en la sección Parámetros de terminación de la Revisión 1.2 de especificación de cables y conectores USB tipo C para conectores USB tipo C, o uso del rango de corriente de salida del puerto de carga descendente(CDP) según se especifica en la revisión 1.2 de las especificaciones de carga de batería USB para conectores microAB
- SE DEBE implementar y admitir estándares USB tipo C.
Si las implementaciones de dispositivos incluyen un puerto USB compatible con el modo de host y la clase de audio USB, sucederá lo siguiente:
- [C-2-1] DEBE admitir la clase USB HID.
- [C-2-2] DEBE admitir la detección y asignación de los siguientes campos de datos HID especificados en las tablas de uso de HID USB y la Solicitud de uso de comandos por voz a las constantes
KeyEvent
como se muestra a continuación:- Página de uso (0xC) ID de uso (0x0CD):
KEYCODE_MEDIA_PLAY_PAUSE
- Página de uso (0xC) ID de uso (0x0E9):
KEYCODE_VOLUME_UP
- Página de uso (0xC) ID de uso (0x0EA):
KEYCODE_VOLUME_DOWN
- Página de uso (0xC) ID de uso (0x0CF):
KEYCODE_VOICE_ASSIST
- Página de uso (0xC) ID de uso (0x0CD):
Si las implementaciones de dispositivos incluyen un puerto USB compatible con el modo de host y el framework de acceso al almacenamiento (SAF), sucederá lo siguiente:
- [C-3-1] DEBE reconocer cualquier dispositivo MTP (protocolo de transferencia multimedia) conectado de forma remota y permitir el acceso a su contenido a través de los intents
ACTION_GET_CONTENT
,ACTION_OPEN_DOCUMENT
yACTION_CREATE_DOCUMENT
. .
Si las implementaciones de dispositivos incluyen un puerto USB compatible con el modo de host y un USB tipo C, sucederá lo siguiente:
- [C-4-1] DEBE implementar la funcionalidad del puerto de rol dual según se define en la especificación de USB tipo C (sección 4.5.1.3.3).
- [SR] SE RECOMIENDA ENRENDER que sea compatible con DisplayPort, SE DEBE admitir las tasas de datos de SuperSpeed de USB, y SE RECOMIENDA ENCIMAMENTE para admitir Power Delivery en el intercambio de datos y funciones.
- [SR] SE RECOMIENDA ENRENDER NO admitir el modo de accesorio del adaptador de audio como se describe en el Apéndice A de la Revisión 1.2 de la Especificación de cables USB tipo C y conector.
- SE DEBE implementar el modelo Try.* que sea más adecuado para el factor de forma del dispositivo. Por ejemplo, un dispositivo de mano DEBE implementar el modelo Try.SNK.
7.8. Audio
7.8.1. Micrófono
Si las implementaciones en dispositivos incluyen un micrófono, sucederá lo siguiente:
- [C-1-1] DEBE informar la constante de función
android.hardware.microphone
. - [C-1-2] DEBE cumplir con los requisitos de grabación de audio de la sección 5.4.
- [C-1-3] DEBE cumplir con los requisitos de latencia de audio de la sección 5.6.
- [SR] SE RECOMIENDA ENERGMENTE que admitan la grabación casi ultrasónica, como se describe en la sección 7.8.3.
Si las implementaciones de dispositivos omiten un micrófono, sucederán lo siguiente:
- [C-2-1] NO DEBE informar la constante de función
android.hardware.microphone
. - [C-2-2] SE DEBE implementar la API de grabación de audio al menos como no-ops, según la sección 7.
7.8.2. Salida de audio
Si las implementaciones de dispositivos incluyen un altavoz o un puerto de salida de audio/multimedia para un periférico de salida de audio, como un conector de audio de 3.5 mm de 4 conductores o un puerto de modo host USB que usa una clase de audio USB, sucederá lo siguiente:
- [C-1-1] DEBE informar la constante de función
android.hardware.audio.output
. - [C-1-2] DEBE cumplir con los requisitos de reproducción de audio de la sección 5.5.
- [C-1-3] DEBE cumplir con los requisitos de latencia de audio de la sección 5.6.
- [SR] SE RECOMIENDA ESTAR EN FUNDAMENTO para admitir la reproducción casi ultrasónica, como se describe en la sección 7.8.3.
Si las implementaciones de dispositivos no incluyen un puerto de salida de audio o bocina, sucederá lo siguiente:
- [C-2-1] NO DEBE informar la función
android.hardware.audio.output
. - [C-2-2] SE DEBE implementar, al menos, las API relacionadas con la Salida de audio como no-ops.
A los efectos de esta sección, se usará un “puerto de salida” es una interfaz física, como un conector de audio de 3.5 mm, un puerto HDMI o un puerto en modo host USB con clase de audio USB. La compatibilidad con la salida de audio a través de protocolos de radio, como Bluetooth, Wi-Fi o red móvil, no califica como incluir un "puerto de salida".
7.8.2.1. Puertos de audio analógicos
Para que los auriculares y otros accesorios de audio sean compatibles con el enchufe de 3.5 mm en todo el ecosistema de Android, si las implementaciones de dispositivos incluyen uno o más puertos de audio analógicos, deben hacer lo siguiente:
- [C-SR] SE RECOMIENDA ENcarecidamente incluir al menos uno de los puertos de audio para que sea un conector de audio de 3.5 mm para 4 conductores.
Si las implementaciones de dispositivos tienen un conector de audio de 4 conductores de 3.5 mm, sucede lo siguiente:
- [C-1-1] DEBE admitir la reproducción de audio en auriculares estéreo y auriculares estéreo con un micrófono.
- [C-1-2] DEBE admitir conectores de audio TRRS con el orden de pines CTIA.
- [C-1-3] DEBE admitir la detección y la asignación a los códigos de teclas para los siguientes tres rangos de impedancia equivalente entre el micrófono y los conductores de tierra en el enchufe de audio:
-
70 ohm o menos:
KEYCODE_HEADSETHOOK
-
210-290 ohm:
KEYCODE_VOLUME_UP
-
360-680 ohm:
KEYCODE_VOLUME_DOWN
-
70 ohm o menos:
- [C-1-4] DEBE activar
ACTION_HEADSET_PLUG
al insertar un enchufe, pero solo después de que todos los contactos del enchufe toquen sus segmentos relevantes en el conector. - El [C-1-5] DEBE ser capaz de conducir al menos 150 mV ± 10% del voltaje de salida en una impedancia de bocina de 32 ohm.
- [C-1-6] DEBE tener una compensación de voltaje del micrófono entre 1.8 V y 2.9 V.
- [C-1-7] DEBE detectar y asignar el código de clave para el siguiente rango de impedancia equivalente entre el micrófono y los conductores de tierra en el enchufe de audio:
-
110-180 ohm:
KEYCODE_VOICE_ASSIST
-
110-180 ohm:
- [C-SR] SE RECOMIENDA ENcarecidamente admitir enchufes de audio con el orden de pines de OMTP.
- [C-SR] Se RECOMIENDA ENRENDER que sea compatible con la grabación de audio de auriculares estéreo con un micrófono.
Si las implementaciones de dispositivos tienen un conector de audio de 3.5 mm de 4 conductores y admiten un micrófono, y transmiten el android.intent.action.HEADSET_PLUG
con el micrófono de valor adicional establecido en 1, suceden lo siguiente:
- [C-2-1] DEBE admitir la detección del micrófono en el accesorio de audio conectado.
7.8.2.2. Puertos de audio digitales
Para que sea compatible con auriculares y otros accesorios de audio, use conectores USB-C y, además, implemente (clase de audio USB) en todo el ecosistema de Android, como se define en la especificación de auriculares USB de Android.
Consulta la sección 2.2.1 para conocer los requisitos específicos de los dispositivos.
7.8.3. Casi ultrasónica
El audio casi ultrasónico está en la banda de entre 18.5 kHz y 20 kHz.
Implementaciones en dispositivos:
- SE DEBE informar correctamente la compatibilidad de la función de audio casi ultrasónico a través de la API de AudioManager.getProperty de la siguiente manera:
Si PROPERTY_SUPPORT_MIC_NEAR_ULTRASOUND
es “true”, las fuentes de audio VOICE_RECOGNITION
y UNPROCESSED
DEBEN cumplir los siguientes requisitos:
- [C-1-1] La potencia de respuesta del micrófono en la banda de 18.5 kHz a 20 kHz DEBE ser como máximo 15 dB por debajo de la respuesta a 2 kHz.
- [C-1-2] La relación señal-ruido no ponderada del micrófono superior a 18.5 kHz a 20 kHz para un tono de 19 kHz a -26 dBFS no DEBE ser inferior a 50 dB.
Si PROPERTY_SUPPORT_SPEAKER_NEAR_ULTRASOUND
es "true", haz lo siguiente:
- [C-2-1] La respuesta media de la bocina en 18.5 kHz a 20 kHz no DEBE ser inferior a 40 dB por debajo de la respuesta a 2 kHz.
7.8.4. Integridad de la señal
Implementaciones en dispositivos: * SE DEBE proporcionar una ruta de acceso de señal de audio sin fallas para las transmisiones de entrada y salida en dispositivos de mano, según se define en función de cero fallas medidas durante una prueba de un minuto por ruta. Realiza pruebas con [OboeTester] (https://github.com/google/oboe/tree/master/apps/OboeTester) “Automated Glitch Test”.
La prueba requiere una llave de bucle invertido de audio, que se usa directamente en un conector de 3.5 mm o en combinación con un adaptador de USB-C a 3.5 mm. Se DEBEN probar todos los puertos de salida de audio.
Actualmente, OboeTester admite rutas de acceso de AAudio, por lo que las siguientes combinaciones SE DEBEN probar para detectar fallas usando AAudio:
Modo rendimiento | Uso compartido | Tasa de muestreo de salida | En Chans | Oportunidades de salida |
---|---|---|---|---|
BAJO_LATENCIA | EXCLUSIVO | SIN ESPECIFICAR | 1 | 2 |
BAJO_LATENCIA | EXCLUSIVO | SIN ESPECIFICAR | 2 | 1 |
BAJO_LATENCIA | COMPARTIDO | SIN ESPECIFICAR | 1 | 2 |
BAJO_LATENCIA | COMPARTIDO | SIN ESPECIFICAR | 2 | 1 |
NINGUNO | COMPARTIDO | 48000 | 1 | 2 |
NINGUNO | COMPARTIDO | 48000 | 2 | 1 |
NINGUNO | COMPARTIDO | 44100 | 1 | 2 |
NINGUNO | COMPARTIDO | 44100 | 2 | 1 |
NINGUNO | COMPARTIDO | 16000 | 1 | 2 |
NINGUNO | COMPARTIDO | 16000 | 2 | 1 |
Una transmisión confiable DEBE cumplir con los siguientes criterios de relación señal/ruido (SNR) y distorsión total armónica (THD) para el seno de 2,000 Hz.
Transductor | THD | SNR |
---|---|---|
bocina principal integrada, medida con un micrófono de referencia externo | < 3% | 50 dB o superior |
micrófono principal integrado, medido con una bocina de referencia externa | < 3% | 50 dB o superior |
conectores analógicos de 3.5 mm integrados, probados con un adaptador de bucle invertido | < 1% | 60 dB o superior |
Adaptadores USB incluidos con el teléfono, probados con un adaptador de bucle invertido. | < 1% | 60 dB o superior |
7.9 Realidad virtual
Android incluye API e instalaciones para crear "realidad virtual" (RV), incluidas las experiencias de RV móvil de alta calidad. Las implementaciones en dispositivos DEBEN implementar adecuadamente estas APIs y comportamientos, como se detalla en esta sección.
7.9.1 Modo de realidad virtual
Android admite el modo RV, una función que controla la renderización estereoscópica de notificaciones e inhabilita los componentes monoculares de la IU del sistema mientras una aplicación de RV está enfocada en el usuario.
7.9.2. Modo de realidad virtual: Alto rendimiento
Si las implementaciones de dispositivos admiten el modo RV, sucederá lo siguiente:
- [C-1-1] DEBE tener al menos 2 núcleos físicos.
- [C-1-2] SE DEBE declarar la función
android.hardware.vr.high_performance
. - [C-1-3] DEBE admitir el modo de rendimiento sostenido.
- [C-1-4] SE RECOMIENDA ENERGMENTE para ser compatible con OpenGL ES 3.2.
- [C-1-5] DEBE admitir
android.hardware.vulkan.level
0. - SE DEBE admitir
android.hardware.vulkan.level
1 o versiones posteriores. - [C-1-6] DEBE implementar
EGL_KHR_mutable_render_buffer
,EGL_ANDROID_front_buffer_auto_refresh
,EGL_ANDROID_get_native_client_buffer
,EGL_KHR_fence_sync
,EGL_KHR_wait_sync
,EGL_IMG_context_priority
,EGL_EXT_protected_content
,EGL_EXT_image_gl_colorspace
y exponer las extensiones en la lista de extensiones EGL disponibles. - [C-1-8] DEBE implementar
GL_EXT_multisampled_render_to_texture2
,GL_OVR_multiview
,GL_OVR_multiview2
,GL_EXT_protected_textures
y exponer las extensiones en la lista de extensiones de GL disponibles. - [C-SR] SE RECOMIENDA MUY BIEN implementar
GL_EXT_external_buffer
,GL_EXT_EGL_image_array
yGL_OVR_multiview_multisampled_render_to_texture
, y exponer las extensiones en la lista de extensiones de GL disponibles. - [C-SR] SE RECOMIENDA ENcarecidamente que sean compatibles con Vulkan 1.1.
- [C-SR] SE RECOMIENDA COMPLETAMENTE implementar
VK_ANDROID_external_memory_android_hardware_buffer
,VK_GOOGLE_display_timing
yVK_KHR_shared_presentable_image
, y exponerlos en la lista de extensiones de Vulkan disponibles. - [C-SR] SE RECOMIENDA ENRENDER exponer al menos una familia de colas de Vulkan en la que
flags
contieneVK_QUEUE_GRAPHICS_BIT
yVK_QUEUE_COMPUTE_BIT
, yqueueCount
es al menos 2. - [C-1-7] La GPU y la pantalla DEBEN sincronizar el acceso al búfer frontal compartido, de modo que se muestre la renderización ocular alternativa del contenido de RV a 60 fps con dos contextos de renderización sin artefactos de seccionamiento visibles.
- [C-1-9] SE DEBE implementar compatibilidad con las marcas
AHARDWAREBUFFER_USAGE_GPU_DATA_BUFFER
,AHARDWAREBUFFER_USAGE_SENSOR_DIRECT_DATA
yAHARDWAREBUFFER_USAGE_PROTECTED_CONTENT
deAHardwareBuffer
, como se describe en el NDK. - [C-1-10] SE DEBE implementar compatibilidad para
AHardwareBuffer
con cualquier combinación de las marcas de usoAHARDWAREBUFFER_USAGE_GPU_COLOR_OUTPUT
,AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE
,AHARDWAREBUFFER_USAGE_PROTECTED_CONTENT
para, al menos, los siguientes formatos:AHARDWAREBUFFER_FORMAT_R5G6B5_UNORM
,AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM
,AHARDWAREBUFFER_FORMAT_R10G10B10A2_UNORM
,AHARDWAREBUFFER_FORMAT_R16G16B16A16_FLOAT
. - [C-SR] SE RECOMIENDA ENERGENTE para admitir la asignación de elementos
AHardwareBuffer
con más de una capa, además de las marcas y los formatos especificados en C-1-10. - [C-1-11] DEBE ser compatible con la decodificación H.264 de al menos 3840 x 2160 a 30 fps, comprimida a un promedio de 40 Mbps (equivalente a 4 instancias de 1920 x 1080 a 30 FPS-10 Mbps o 2 instancias de 1920 FPS x 20 Mbps a 1080 Mbps).
- [C-1-12] DEBE ser compatible con HEVC y VP9. DEBE ser capaz de decodificar al menos 1920 x 1080 a 30 fps comprimidos a un promedio de 10 Mbps y DEBERÍA ser capaz de decodificar 3,840 x 2,160 a 30 FPS x 1,080 FPS a 10 FPS 10 Mbps a 10 Mbps (equivalente a 8 Mbps a 10 FPS 10 Mbps a 10 Mbps) a 10 Mbps a 10 Mbps
- [C-1-13] DEBE admitir la API de
HardwarePropertiesManager.getDeviceTemperatures
y devolver valores precisos para la temperatura cutánea. - [C-1-14] DEBE tener una pantalla incorporada y su resolución DEBE ser de al menos 1920 x 1080.
- [C-SR] SE RECOMIENDA ENcarecidamente que tengan una resolución de pantalla de al menos 2560 x 1440.
- [C-1-15] La pantalla DEBE actualizar al menos 60 Hz en modo RV.
- [C-1-17] La pantalla DEBE admitir un modo de baja persistencia con una persistencia menor o igual a 5 milisegundos. La persistencia se define como la cantidad de tiempo durante el cual un píxel emite luz.
- [C-1-18] DEBE ser compatible con Bluetooth 4.2 y la extensión de longitud de datos de Bluetooth LE (sección 7.4.3).
- [C-1-19] DEBE admitir e informar correctamente el tipo de canal directo para todos los siguientes tipos de sensores predeterminados:
-
TYPE_ACCELEROMETER
-
TYPE_ACCELEROMETER_UNCALIBRATED
-
TYPE_GYROSCOPE
-
TYPE_GYROSCOPE_UNCALIBRATED
-
TYPE_MAGNETIC_FIELD
-
TYPE_MAGNETIC_FIELD_UNCALIBRATED
-
- [C-SR] SE RECOMIENDA ENERCMENTE admitir el tipo de canal directo
TYPE_HARDWARE_BUFFER
para todos los tipos de canales directos que se mencionaron anteriormente. - [C-1-21] DEBE cumplir con los requisitos relacionados con el giroscopio, el acelerómetro y el magnetómetro para
android.hardware.hifi_sensors
, como se especifica en la sección 7.3.9. - [C-SR] SE RECOMIENDA EXITOSAMENTE que admitan la función
android.hardware.sensor.hifi_sensors
. - [C-1-22] DEBE tener movimiento de extremo a extremo para una latencia de fotón que no supere los 28 milisegundos.
- [C-SR] SE RECOMIENDA ENERCMENTE tener un movimiento de extremo a extremo a una latencia de fotón que no sea superior a 20 milisegundos.
- [C-1-23] DEBE tener una relación de primer fotograma, que es la proporción entre el brillo de los píxeles del primer fotograma después de una transición de negro a blanco y el brillo de los píxeles blancos en estado estable de al menos 85%.
- [C-SR] SE RECOMIENDA ENcarecidamente que tengan una proporción del primer fotograma de al menos un 90%.
- PUEDE proporcionar un núcleo exclusivo a la aplicación en primer plano y PUEDE admitir la API de
Process.getExclusiveCores
para que se devuelvan los números de los núcleos de la CPU que son exclusivos de la aplicación superior en primer plano.
Si se admite el núcleo exclusivo, entonces el núcleo:
- [C-2-1] No DEBE permitir que se ejecuten otros procesos del espacio del usuario en él (excepto los controladores de dispositivos que usa la aplicación), pero PUEDE permitir que se ejecuten algunos procesos de kernel según sea necesario.
7.10. Tecnología háptica
Consulta la sección 2.2.1 para conocer los requisitos específicos de los dispositivos.
7.11. Clase de rendimiento del contenido multimedia
La clase de rendimiento del contenido multimedia de la implementación del dispositivo se puede obtener de
la API de android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
Requisitos
de la clase de rendimiento multimedia se definen para cada versión de Android, comenzando por
R (versión 30). El valor especial de 0 indica que el dispositivo no es de un
clase de rendimiento del medio.
Si las implementaciones de dispositivos muestran un valor distinto de cero en
android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS
, hicieron lo siguiente:
[C-1-1] DEBE mostrar al menos un valor de
android.os.Build.VERSION_CODES.R
.[C-1-2] DEBE ser una implementación de dispositivo de mano.
[C-1-3] DEBE cumplir con todos los requisitos de la "Clase de rendimiento de medios" descritos en la sección 2.2.7.
Consulta la sección 2.2.7 para obtener información sobre atributos específicos del dispositivo y los requisitos de cumplimiento.
8. Rendimiento y potencia
Algunos criterios mínimos de rendimiento y energía son fundamentales para la experiencia del usuario y afectan las suposiciones de referencia que los desarrolladores tendrían al desarrollar una app.
8.1. Coherencia de la experiencia del usuario
Se puede proporcionar una interfaz de usuario fluida al usuario final si hay ciertos requisitos mínimos para garantizar una velocidad de fotogramas y tiempos de respuesta coherentes para aplicaciones y juegos. Las implementaciones de dispositivos, según el tipo, PUEDEN tener requisitos medibles para la latencia de la interfaz de usuario y el cambio de tareas, como se describe en la sección 2.
8.2. Rendimiento del acceso a la E/S de archivos
Proporcionar un modelo de referencia común para un rendimiento coherente de acceso a los archivos en el almacenamiento de datos privados de la aplicación (partición /data
) permite a los desarrolladores de apps establecer una expectativa adecuada que ayudaría en el diseño de su software. Las implementaciones de dispositivos, según el tipo, PUEDEN tener ciertos requisitos que se describen en la sección 2 para las siguientes operaciones de lectura y escritura:
- Rendimiento de la escritura secuencial. Se mide escribiendo un archivo de 256 MB con un búfer de escritura de 10 MB.
- Rendimiento de escritura aleatoria. Se mide escribiendo un archivo de 256 MB con un búfer de escritura de 4 KB.
- Rendimiento de la lectura secuencial. Se mide leyendo un archivo de 256 MB con un búfer de escritura de 10 MB.
- Rendimiento de lectura aleatoria. Se mide leyendo un archivo de 256 MB con un búfer de escritura de 4 KB.
8.3. Modos de ahorro de energía
Si las implementaciones en dispositivos incluyen funciones para mejorar la administración de energía que se incluyen en AOSP (p.ej., intervalo de App Standby o Descanso) o amplían las funciones que no aplican restricciones más duras que el intervalo de App Standby poco frecuente, hacen lo siguiente:
- [C-1-1] NO DEBE desviarse de la implementación de AOSP para la activación, el mantenimiento, los algoritmos de activación y el uso de la configuración global del sistema de los modos de ahorro de energía App Standby y Descanso.
- [C-1-2] NO DEBE desviarse de la implementación de AOSP para usar la configuración global a fin de administrar la limitación de los trabajos, las alarmas y la red para las apps en cada intervalo de App Standby.
- [C-1-3] NO DEBE desviarse de la implementación de AOSP para la cantidad de buckets de App Standby que se usan para App Standby.
- [C-1-4] DEBE implementar los Intervalos de App Standby y Descanso como se describe en Administración de energía.
- [C-1-5] SE DEBE devolver
true
paraPowerManager.isPowerSaveMode()
cuando el dispositivo está en modo de ahorro de energía. - [C-SR] SE RECOMIENDA ENERGÍAMENTE para proporcionar al usuario la posibilidad de habilitar o inhabilitar la función de ahorro de batería.
- [C-SR] SE RECOMIENDA ENERCMENTE para proporcionar al usuario la posibilidad de mostrar todas las apps exentas de los modos de ahorro de energía App Standby y Descanso.
Si las implementaciones de dispositivos extienden las funciones de administración de batería que se incluyen en AOSP y esa extensión aplica restricciones más estrictas que el intervalo de App Standby poco frecuente, consulta la sección 3.5.1.
Además de los modos de ahorro de energía, las implementaciones de dispositivos Android PUEDEN implementar cualquiera o todos los 4 estados de energía suspendida, tal como se define en la Interfaz avanzada de configuración y energía (Advanced Configuration and Power Interface, ACPI).
Si las implementaciones de dispositivos implementan los estados de energía de S4 según lo definido por el ACPI, hacen lo siguiente:
- [C-1-1] DEBE ingresar a este estado solo después de que el usuario haya realizado una acción explícita para colocar el dispositivo en estado inactivo (p.ej., cerrar una tapa que sea parte físicamente del dispositivo o apagar un vehículo o una televisión) y antes de que el usuario reactive el dispositivo (p.ej., abrir la tapa o volver a encender el vehículo o la televisión).
Si las implementaciones de dispositivos implementan estados de energía de S3 según lo definido por el ACPI, hacen lo siguiente:
-
[C-2-1] DEBE cumplir con C-1-1 anterior o DEBE entrar en estado S3 solo cuando las aplicaciones de terceros no necesitan los recursos del sistema (por ejemplo, la pantalla, la CPU).
Por el contrario, DEBE salir del estado de S3 cuando las aplicaciones de terceros necesitan los recursos del sistema, como se describe en este SDK.
Por ejemplo, mientras las aplicaciones de terceros solicitan mantener la pantalla encendida durante
FLAG_KEEP_SCREEN_ON
o la CPU en ejecución durantePARTIAL_WAKE_LOCK
, el dispositivo NO DEBE entrar en estado S3 a menos que, como se describe en C-1-1, el usuario haya realizado una acción explícita para poner el dispositivo en estado inactivo. Por el contrario, cuando se activa una tarea que las apps de terceros implementan a través de JobScheduler o se entrega Firebase Cloud Messaging a apps de terceros, el dispositivo DEBE salir del estado S3, a menos que el usuario lo haya puesto en estado inactivo. Estos no son ejemplos exhaustivos, y el AOSP implementa indicadores de activación extensos que activan una activación a partir de este estado.
8.4. Contabilidad del consumo de energía
Una contabilización e informes más precisos del consumo de energía le proporciona al desarrollador de la app los incentivos y las herramientas para optimizar el patrón de uso de energía de la aplicación.
Implementaciones en dispositivos:
- [SR] SE RECOMIENDA ELIMINARMENTE proporcionar un perfil de energía por componente que defina el valor de consumo actual de cada componente de hardware y el consumo aproximado de batería causado por los componentes a lo largo del tiempo, como se documenta en el sitio del Proyecto de código abierto de Android.
- [SR] SE RECOMIENDA ENRENDER que informe todos los valores de consumo de energía en miliamperios por hora (mAh).
- [SR] SE RECOMIENDA INFORMAR EL Consumo de energía de la CPU por cada UID de proceso. El Proyecto de código abierto de Android cumple con los requisitos a través de la implementación del módulo de kernel
uid_cputime
. - [SR] SE RECOMIENDA ELIMINARSE para que el uso de energía esté disponible a través del comando de shell
adb shell dumpsys batterystats
para el desarrollador de la app. - SE DEBE atribuir al componente de hardware si no es posible atribuir el uso de energía de un componente de hardware a una aplicación.
8.5. Rendimiento coherente
El rendimiento puede fluctuar considerablemente en el caso de las apps de alto rendimiento que se ejecutan durante un tiempo prolongado, ya sea debido a que las otras apps se ejecutan en segundo plano o a la limitación de la CPU debido a los límites de temperatura. Android incluye interfaces programáticas para que, cuando el dispositivo sea compatible, la aplicación en primer plano de la parte superior pueda solicitar que el sistema optimice la asignación de los recursos para abordar esas fluctuaciones.
Implementaciones en dispositivos:
-
[C-0-1] SE DEBE informar con precisión la compatibilidad del Modo de rendimiento sostenido a través del método de la API
PowerManager.isSustainedPerformanceModeSupported()
. -
SE DEBE admitir el Modo de rendimiento sostenido.
Si las implementaciones de dispositivos informan compatibilidad con el Modo de rendimiento sostenido, deben hacer lo siguiente:
- [C-1-1] DEBE proporcionar un nivel constante de rendimiento a la aplicación en primer plano durante al menos 30 minutos, cuando la aplicación lo solicite.
- [C-1-2] DEBE respetar la API de
Window.setSustainedPerformanceMode()
y otras APIs relacionadas.
Si las implementaciones de dispositivos incluyen dos o más núcleos de CPU, sucederán lo siguiente:
- SE DEBE proporcionar al menos un núcleo exclusivo que la aplicación superior en primer plano pueda reservar.
Si las implementaciones de dispositivos permiten reservar un núcleo exclusivo para la aplicación superior en primer plano, sucederá lo siguiente:
- [C-2-1] SE DEBE informar a través del método de la API
Process.getExclusiveCores()
los números de ID de los núcleos exclusivos que la aplicación superior en primer plano puede reservar. - [C-2-2] No DEBE permitir ningún proceso de espacio del usuario, excepto los controladores de dispositivo utilizados por la aplicación para ejecutarse en núcleos exclusivos, pero PUEDE permitir que algunos procesos de kernel se ejecuten según sea necesario.
Si las implementaciones en dispositivos no admiten un núcleo exclusivo, sucederá lo siguiente:
- [C-3-1] DEBE mostrar una lista vacía a través del método de la API
Process.getExclusiveCores()
.
9. Compatibilidad del modelo de seguridad
Implementaciones en dispositivos:
-
[C-0-1] DEBE implementar un modelo de seguridad coherente con el modelo de seguridad de la plataforma de Android según se define en el documento de referencia de Seguridad y permisos en las APIs de la documentación para desarrolladores de Android.
-
[C-0-2] DEBE admitir la instalación de aplicaciones autofirmadas sin requerir permisos o certificados adicionales de terceros o autoridades. Específicamente, los dispositivos compatibles DEBEN admitir los mecanismos de seguridad descritos en las siguientes subsecciones.
9.1 Permisos
Implementaciones en dispositivos:
-
[C-0-1] DEBE admitir el modelo de permisos de Android según se define en la documentación para desarrolladores de Android. Específicamente, DEBEN aplicar cada permiso definido como se describe en la documentación del SDK. no se puede omitir, alterar ni ignorar ningún permiso.
-
PUEDES agregar permisos adicionales, siempre que las nuevas strings de ID del permiso no estén en el espacio de nombres
android.\*
. -
[C-0-2] Los permisos con una
protectionLevel
dePROTECTION_FLAG_PRIVILEGED
solo DEBEN otorgarse a las apps preinstaladas en las rutas de acceso con privilegios de la imagen del sistema y dentro del subconjunto de permisos explícitamente permitidos para cada app. La implementación del AOSP cumple con este requisito, ya que lee y respeta los permisos incluidos en la lista de entidades permitidas de cada app de los archivos de la rutaetc/permissions/
y usa la rutasystem/priv-app
como ruta con privilegios.
Los permisos con un nivel de protección peligroso son permisos de tiempo de ejecución. Aplicaciones con targetSdkVersion
> 22 las solicitan en el tiempo de ejecución.
Implementaciones en dispositivos:
- [C-0-3] DEBE mostrar una interfaz dedicada para que el usuario decida si otorga los permisos de tiempo de ejecución solicitados y también proporcionar una interfaz para que el usuario administre los permisos de tiempo de ejecución.
- [C-0-4] DEBE tener una única implementación de ambas interfaces de usuario.
- [C-0-5] NO DEBE otorgar ningún permiso de tiempo de ejecución a las aplicaciones preinstaladas, a menos que ocurra lo siguiente:
- El consentimiento del usuario se puede obtener antes de que la aplicación lo utilice.
- Los permisos de tiempo de ejecución están asociados con un patrón de intent para el cual la aplicación preinstalada está configurada como controlador predeterminado.
- [C-0-6] DEBE otorgar el permiso
android.permission.RECOVER_KEYSTORE
solo a las apps del sistema que registran un agente de recuperación correctamente protegido. Un agente de recuperación protegido correctamente se define como un agente de software integrado en el dispositivo que se sincroniza con un almacenamiento remoto fuera del dispositivo, que está equipado con hardware seguro con una protección equivalente o más fuerte que la que se describe en el Servicio Google Cloud Key Vault para evitar ataques de fuerza bruta en el factor de conocimiento de la pantalla de bloqueo.
Implementaciones en dispositivos:
-
[C-0-7] DEBE cumplir con las propiedades del permiso de ubicación de Android cuando una app solicita los datos de ubicación o actividad física a través de la API estándar de Android o de un mecanismo de propiedad exclusiva. Estos datos incluyen, entre otros, los siguientes:
- Es la ubicación del dispositivo (p.ej., latitud y longitud).
- Información que se puede usar para determinar o estimar la ubicación del dispositivo (p.ej., SSID, BSSID, ID de celular o ubicación de la red a la que está conectado el dispositivo).
- Indica la actividad física del usuario o la clasificación de la actividad física.
Más concretamente, las implementaciones en dispositivos:
- [C-0-8] SE DEBE obtener el consentimiento del usuario para permitir que una aplicación acceda al ubicación o datos de actividad física.
- [C-0-9] SE DEBE otorgar un permiso de tiempo de ejecución SOLO a la app que lo contiene.
permiso suficiente,
como se describe en el SDK.
Por ejemplo:
TelephonyManager#getServiceState requiere
android.permission.ACCESS_FINE_LOCATION
.
Los permisos se pueden marcar como una restricción que altera su comportamiento.
-
[C-0-10] Los permisos marcados con la marca
hardRestricted
NO DEBEN otorgarse a una app, a menos que ocurra lo siguiente:- Hay un archivo APK de la app en la partición del sistema.
- El usuario asigna una función que está asociada con los permisos
hardRestricted
a una app. - El instalador otorga el
hardRestricted
a una app. - A una app se le otorga la
hardRestricted
en una versión anterior de Android.
-
[C-0-11] Las apps que tienen un permiso de
softRestricted
DEBEN tener acceso limitado y NO DEBEN obtener acceso completo hasta que se incluya en la lista de entidades permitidas como se describe en el SDK, donde se define el acceso total y limitado para cada permiso desoftRestricted
(por ejemplo,READ_EXTERNAL_STORAGE
).
Si las implementaciones de dispositivos proporcionan una indicación visual para que el usuario elija qué apps pueden superponerse a otras con una actividad que controle el intent ACTION_MANAGE_OVERLAY_PERMISSION
, sucederá lo siguiente:
- [C-2-1] DEBE asegurarse de que todas las actividades con filtros de intents para el intent
ACTION_MANAGE_OVERLAY_PERMISSION
tengan la misma pantalla de IU, independientemente de la app de inicio o cualquier información que proporcione.
9.2 UID y aislamiento de procesos
Implementaciones en dispositivos:
- [C-0-1] DEBE ser compatible con el modelo de zona de pruebas de aplicaciones de Android, en el que cada aplicación se ejecuta como un UID único de estilo Unix y en un proceso independiente.
- [C-0-2] DEBE admitir la ejecución de varias aplicaciones como el mismo ID de usuario de Linux, siempre que las aplicaciones estén debidamente firmadas y construidas, como se define en la referencia de seguridad y permisos.
9.3 Permisos del sistema de archivos
Implementaciones en dispositivos:
- [C-0-1] DEBE admitir el modelo de permisos de acceso de archivos de Android según se define en la referencia de seguridad y permisos.
Entornos de ejecución alternativos
Las implementaciones de dispositivos DEBEN mantener la coherencia del modelo de permisos y seguridad de Android, incluso si incluyen entornos de tiempo de ejecución que ejecutan aplicaciones con algún otro software o tecnología que no sea el formato ejecutable Dalvik o el código nativo. En otras palabras:
-
[C-0-1] Los entornos de ejecución alternativos DEBEN ser aplicaciones de Android y cumplir con el modelo de seguridad estándar de Android, como se describe en otras secciones de la sección 9.
-
[C-0-2] A los entornos de ejecución alternativos NO DEBEN otorgarse acceso a recursos protegidos por permisos no solicitados en el archivo
AndroidManifest.xml
del tiempo de ejecución a través del <uses-permission
> de atención. -
[C-0-3] Los tiempos de ejecución alternativos NO DEBEN permitir que las aplicaciones usen funciones protegidas por permisos de Android restringidos a aplicaciones del sistema.
-
[C-0-4] Los tiempos de ejecución alternativos DEBEN cumplir con el modelo de zona de pruebas de Android, y las aplicaciones instaladas con un tiempo de ejecución alternativo NO DEBEN reutilizar la zona de pruebas de ninguna otra aplicación instalada en el dispositivo, excepto a través de los mecanismos estándar de Android de ID de usuario compartido y certificado de firma.
-
[C-0-5] Los tiempos de ejecución alternativos NO DEBEN iniciarse con las zonas de pruebas correspondientes a otras aplicaciones de Android, ni deben conceder o recibir acceso a ellas.
-
[C-0-6] Los entornos de ejecución alternativos NO DEBEN iniciarse con otras aplicaciones, otorgarse ni otorgarse privilegios del superusuario (raíz) ni de ningún otro ID de usuario.
-
[C-0-7] Cuando los archivos
.apk
de entornos de ejecución alternativos se incluyen en la imagen del sistema de las implementaciones de dispositivos, se DEBEN firmar con una clave distinta de la que se usa para firmar otras aplicaciones incluidas con las implementaciones del dispositivo. -
[C-0-8] Al instalar aplicaciones, los tiempos de ejecución alternativos DEBEN obtener el consentimiento del usuario para los permisos de Android que utiliza la aplicación.
-
[C-0-9] Cuando una aplicación necesita usar un recurso de dispositivo para el que hay un permiso de Android correspondiente (como Cámara, GPS, etc.), el tiempo de ejecución alternativo DEBE informar al usuario que la aplicación podrá acceder a ese recurso.
-
[C-0-10] Cuando el entorno de ejecución no registra las capacidades de la aplicación de esta manera, DEBE enumerar todos los permisos que tiene el propio tiempo de ejecución cuando se instala cualquier aplicación que usa ese tiempo de ejecución.
-
Los entornos de ejecución alternativos DEBEN instalar las apps a través de
PackageManager
en zonas de pruebas independientes de Android (ID de usuario de Linux, etc.). -
Los tiempos de ejecución alternativos PUEDEN proporcionar una única zona de pruebas de Android compartida por todas las aplicaciones que utilizan el tiempo de ejecución alternativo.
9.5 Compatibilidad multiusuario
Android admite varios usuarios y admite el aislamiento total de los usuarios.
- PUEDEN POSIBLES implementaciones en dispositivos, pero NO DEBEN habilitar la función multiusuario si usan medios extraíbles para el almacenamiento externo principal.
Si las implementaciones en dispositivos incluyen varios usuarios, sucederá lo siguiente:
- [C-1-1] DEBE cumplir con los siguientes requisitos relacionados con la compatibilidad con multiusuario.
- [C-1-2] DEBE, para cada usuario, implementar un modelo de seguridad coherente con el modelo de seguridad de la plataforma de Android, tal como se define en el documento de referencia de Seguridad y permisos en las APIs.
- [C-1-3] DEBE tener directorios de almacenamiento de aplicaciones compartidos separados y aislados (también conocido como
/sdcard
) para cada instancia de usuario. - [C-1-4] SE DEBE asegurarse de que las aplicaciones que son propiedad de un usuario determinado y se ejecutan en su nombre no puedan enumerar, leer ni escribir en los archivos que son propiedad de cualquier otro usuario, incluso si los datos de ambos usuarios se almacenan en el mismo volumen o sistema de archivos.
- [C-1-5] DEBE encriptar el contenido de la tarjeta SD cuando el multiusuario esté habilitado con una clave almacenada solo en medios no extraíbles al que solo puede acceder el sistema si las implementaciones de dispositivos usan medios extraíbles para las APIs de almacenamiento externo. Como esto hará que el contenido multimedia no sea legible para una PC host, las implementaciones del dispositivo deberán cambiar a MTP o un sistema similar para proporcionarles a las PC host acceso a los datos del usuario actual.
9.6 Advertencia de SMS premium
Android incluye compatibilidad con la advertencia de usuarios sobre cualquier mensaje SMS premium saliente. Los SMS premium son mensajes de texto enviados a un servicio registrado con un operador que puede generar un cargo al usuario.
Si las implementaciones de dispositivos declaran compatibilidad con android.hardware.telephony
, sucederá lo siguiente:
- [C-1-1] DEBE advertir a los usuarios antes de enviar un mensaje SMS a los números identificados por las expresiones regulares definidas en el archivo
/data/misc/sms/codes.xml
del dispositivo. El Proyecto de código abierto de Android ascendente proporciona una implementación que cumple con este requisito.
9.7 Funciones de seguridad
Las implementaciones del dispositivo DEBEN garantizar el cumplimiento de las funciones de seguridad, tanto en el kernel como en la plataforma, como se describe a continuación.
La zona de pruebas de Android incluye funciones que utilizan el sistema de control de acceso obligatorio (MAC) Security-Enhanced Linux (SELinux), la zona de pruebas seccomp y otras funciones de seguridad en el kernel de Linux. Implementaciones en dispositivos:
- [C-0-1] SE DEBE mantener la compatibilidad con las aplicaciones existentes, incluso cuando SELinux o cualquier otra función de seguridad se implemente debajo del framework de Android.
- [C-0-2] NO DEBE tener una interfaz de usuario visible cuando se detecta una infracción de seguridad y la bloquea correctamente la función de seguridad implementada debajo del framework de Android, pero PUEDE tener una interfaz de usuario visible cuando se produce una violación de la seguridad desbloqueada que resulta en un exploit exitoso.
- [C-0-3] NO DEBE permitir que el usuario o el desarrollador de la app puedan configurar SELinux o cualquier otra función de seguridad implementada debajo del framework de Android.
- [C-0-4] NO DEBE permitir que una aplicación que pueda afectar a otra a través de una API (como una API de administración de dispositivos) configure una política que robe la compatibilidad.
- [C-0-5] SE DEBE dividir el framework de medios en varios procesos para que sea posible otorgar acceso de manera más específica a cada proceso, como se describe en el sitio del Proyecto de código abierto de Android.
- [C-0-6] DEBE implementar un mecanismo de zona de pruebas de aplicaciones de kernel que permita filtrar llamadas al sistema usando una política configurable de programas multiproceso. El Proyecto de código abierto de Android ascendente cumple este requisito al habilitar seccomp-BPF con sincronización de grupo de subprocesos (TSYNC), como se describe en la sección de configuración de kernel de source.android.com.
Las funciones de integridad del kernel y de autoprotección son esenciales para la seguridad de Android. Implementaciones en dispositivos:
- [C-0-7] DEBE implementar mecanismos de protección contra el desbordamiento del búfer de la pila del kernel. Algunos ejemplos de estos mecanismos son
CC_STACKPROTECTOR_REGULAR
yCONFIG_CC_STACKPROTECTOR_STRONG
. - [C-0-8] DEBEN implementar protecciones estrictas de memoria de kernel en las que el código ejecutable es de solo lectura, los datos de solo lectura no se pueden ejecutar ni escribir, y los datos que admiten escritura no son ejecutables (p.ej.,
CONFIG_DEBUG_RODATA
oCONFIG_STRICT_KERNEL_RWX
). - [C-0-9] DEBE implementar la verificación de límites de tamaño de objeto estático y dinámico de las copias entre el espacio del usuario y el espacio del kernel (p.ej.,
CONFIG_HARDENED_USERCOPY
) en dispositivos que se enviaron originalmente con nivel de API 28 o superior. - [C-0-10] NO DEBE ejecutar la memoria del espacio del usuario cuando se ejecuta en modo kernel (p.ej., PXN de hardware o emulado a través de
CONFIG_CPU_SW_DOMAIN_PAN
oCONFIG_ARM64_SW_TTBR0_PAN
) en dispositivos que se enviaron originalmente con nivel de API 28 o superior. - [C-0-11] NO DEBE leer ni escribir la memoria del espacio del usuario en el kernel fuera de las APIs de acceso de usuario normales (p.ej., número PAN de hardware o emulado a través de
CONFIG_CPU_SW_DOMAIN_PAN
oCONFIG_ARM64_SW_TTBR0_PAN
) en dispositivos que se enviaron originalmente con un nivel de API 28 o superior. - [C-0-12] SE DEBE implementar el aislamiento de la tabla de la página de kernel si el hardware es vulnerable a CVE-2017-5754 en todos los dispositivos que originalmente se enviaron con nivel de API 28 o superior (p.ej.,
CONFIG_PAGE_TABLE_ISOLATION
oCONFIG_UNMAP_KERNEL_AT_EL0
). - [C-0-13] SE DEBE implementar el endurecimiento de la predicción de ramas si el hardware es vulnerable a CVE-2017-5715 en todos los dispositivos que se enviaron originalmente con nivel de API 28 o superior (p.ej.,
CONFIG_HARDEN_BRANCH_PREDICTOR
). - [SR] SE RECOMIENDA ENRENDER Mantener los datos del kernel que se escriben solo durante la inicialización marcados como de solo lectura después de la inicialización (p.ej.,
__ro_after_init
). -
[C-SR] SE RECOMIENDEN ENERGMENTE para aleatorizar el diseño del código del kernel y la memoria, y para evitar exposiciones que comprometan la aleatorización (p.ej.,
CONFIG_RANDOMIZE_BASE
con entropía de bootloader a través de/chosen/kaslr-seed Device Tree node
oEFI_RNG_PROTOCOL
). -
[C-SR] SE RECOMIENDEN ENERGMENTE para habilitar la integridad del flujo de control (CFI) en el kernel para brindar protección adicional contra ataques de reutilización de código (p.ej.,
CONFIG_CFI_CLANG
yCONFIG_SHADOW_CALL_STACK
). - [C-SR] SE RECOMIENDA EJECUTAR no inhabilitar la integridad de flujo de control (CFI), la pila de llamadas paralelas (SCS) o la limpieza de desbordamiento de números enteros (IntSan) en los componentes que la tienen habilitada.
- [C-SR] SE RECOMIENDA ENERCMENTE habilitar CFI, IntSan y SCS para cualquier componente adicional del espacio del usuario que sea sensible a la seguridad, como se explica en IntSan y CFI.
- [C-SR] SE RECOMIENDA COMPLETAMENTE habilitar la inicialización de pila en el kernel para evitar el uso de variables locales no inicializadas (
CONFIG_INIT_STACK_ALL
oCONFIG_INIT_STACK_ALL_ZERO
). Además, las implementaciones en dispositivos NO DEBEN suponer el valor que usa el compilador para inicializar los elementos locales. - [C-SR] SE RECOMIENDEN ENERGMENTE para habilitar la inicialización de montón en el kernel y evitar el uso de asignaciones de montón no inicializadas (
CONFIG_INIT_ON_ALLOC_DEFAULT_ON
), y NO DEBEN suponer el valor que usa el kernel para inicializar esas asignaciones.
Si las implementaciones de dispositivos usan un kernel de Linux, sucederán lo siguiente:
- [C-1-1] DEBE implementar SELinux.
- [C-1-2] DEBE configurar SELinux en el modo de aplicación global.
- [C-1-3] SE DEBE configurar todos los dominios en modo de aplicación forzosa. No se permiten dominios en modo permisivo, incluidos dominios específicos de un dispositivo o proveedor.
- [C-1-4] NO DEBE modificar, omitir ni reemplazar las reglas de nuncaallow presentes dentro de la carpeta del sistema o de la política proporcionada en el Proyecto de código abierto de Android (AOSP) ascendente, y la política DEBE compilar con todas las reglas de tipo “Neverallow” presentes, tanto para dominios SELinux del AOSP como para dominios específicos de dispositivos o proveedores.
- [C-1-5] DEBE ejecutar aplicaciones de terceros orientadas al nivel de API 28 o superior en zonas de pruebas de SELinux por aplicación con restricciones de SELinux por app en el directorio de datos privados de cada aplicación.
- DEBE conservar la política de SELinux predeterminada proporcionada en la carpeta sistema/sepolicy del Proyecto de código abierto de Android ascendente y solo agregar más a esta política para su propia configuración específica del dispositivo.
Si las implementaciones de dispositivos ya se lanzaron en una versión anterior de Android y no cumplen con los requisitos [C-1-1] y [C-1-5] a través de una actualización de software del sistema, PUEDEN estar exentas de estos requisitos.
Si las implementaciones de dispositivos usan un kernel distinto de Linux, suceden lo siguiente:
- [C-2-1] DEBE usar un sistema de control de acceso obligatorio equivalente a SELinux.
Android incluye varias funciones de defensa en profundidad que son esenciales para la seguridad de los dispositivos.
9.8 Privacidad
9.8.1 Historial de uso
Android almacena el historial de selecciones del usuario y lo administra mediante UsageStatsManager.
Implementaciones en dispositivos:
- [C-0-1] DEBE mantener un período razonable de retención de dicho historial del usuario.
- [SR] SE RECOMIENDA IMPORTANTEMENTE mantener el período de retención de 14 días según la configuración predeterminada en la implementación de AOSP.
Android almacena los eventos del sistema con los identificadores StatsLog
y administra el historial mediante StatsManager
y la API del sistema IncidentManager
.
Implementaciones en dispositivos:
- [C-0-2] solo DEBE incluir los campos marcados con
DEST_AUTOMATIC
en el informe de incidente creado por la claseIncidentManager
de la API del sistema. - [C-0-3] No DEBEN usar los identificadores de eventos del sistema para registrar ningún evento distinto de lo descrito en los documentos del SDK de
StatsLog
. Si se registran eventos del sistema adicionales, PUEDEN usar un identificador atómico diferente en el rango entre 100,000 y 200,000.
9.8.2. Grabando
Implementaciones en dispositivos:
- [C-0-1] NO DEBE precargar ni distribuir componentes de software listos para usar que envíen información privada del usuario (por ejemplo, pulsaciones de teclas, texto que se muestra en la pantalla, informe de errores) fuera del dispositivo sin el consentimiento del usuario o la eliminación de las notificaciones en curso.
- [C-0-2] SE DEBE mostrar y obtener el consentimiento explícito del usuario para permitir
información que se muestra en la pantalla del usuario para que se capture siempre
la transmisión de pantalla o la grabación de pantalla se habilita mediante
MediaProjection
o APIs propias de Google. NO DEBEN brindarles a los usuarios la posibilidad de inhabilitar una futura mostrar el consentimiento del usuario. - [C-0-3] DEBE tener una notificación continua para el usuario mientras la transmisión o la grabación de pantalla están habilitadas. Para cumplir con este requisito, el AOSP muestra un ícono de notificación continua en la barra de estado.
Si las implementaciones del dispositivo incluyen funciones en el sistema que capturan el contenido que se muestra en la pantalla o graban la transmisión de audio que se reproduce en el dispositivo de forma distinta a la ContentCaptureService
de la API del sistema o a otros medios de propiedad descritos en el Artículo 9.8.6, Captura de contenido, hacen lo siguiente:
- [C-1-1] DEBE tener una notificación continua al usuario siempre que esta funcionalidad esté habilitada y que se esté capturando o grabando de forma activa.
Si las implementaciones de dispositivos incluyen un componente habilitado listo para usar que es capaz de grabar audio ambiental o grabar el audio reproducido en el dispositivo para inferir información útil sobre el contexto del usuario, sucederá lo siguiente:
- [C-2-1] NO DEBE almacenar en el almacenamiento persistente integrado en el dispositivo ni transmitir desde el dispositivo el audio grabado sin procesar ni ningún formato que pueda volver a convertirse al audio original o a un facsímil, excepto con el consentimiento explícito del usuario.
9.8.3 Conectividad
Si las implementaciones de dispositivos tienen un puerto USB compatible con el modo periférico USB, sucederá lo siguiente:
- [C-1-1] DEBE presentar una interfaz de usuario en la que se solicite el consentimiento del usuario antes de permitir el acceso al contenido del almacenamiento compartido a través del puerto USB.
9.8.4. Tráfico de red
Implementaciones en dispositivos:
- [C-0-1] SE DEBE preinstalar los mismos certificados raíz para el almacén de la autoridad certificadora (CA) de confianza del sistema que se proporcionan en el Proyecto de código abierto de Android ascendente.
- [C-0-2] SE DEBE enviar con un almacén de AC raíz de usuario vacío.
- [C-0-3] SE DEBE mostrar una advertencia al usuario en la que se indique que se puede supervisar el tráfico de red, cuando se agrega una AC raíz del usuario.
Si el tráfico del dispositivo se enruta a través de una VPN, las implementaciones de los dispositivos:
- [C-1-1] DEBE mostrar una advertencia al usuario en la que se indique lo siguiente:
- Es posible que ese tráfico de red esté supervisado.
- Ese tráfico de red se enruta a través de la aplicación VPN específica que proporciona la VPN.
Si las implementaciones de dispositivos tienen un mecanismo, habilitado listo para usar de forma predeterminada, que enruta el tráfico de datos de red a través de un servidor proxy o una puerta de enlace de VPN (por ejemplo, precargar un servicio de VPN con android.permission.CONTROL_VPN
otorgado), hacen lo siguiente:
- [C-2-1] SE DEBE solicitar el consentimiento del usuario antes de habilitar ese mecanismo, a menos que el controlador de Device Policy haya habilitado la VPN a través de
DevicePolicyManager.setAlwaysOnVpnPackage()
, en cuyo caso el usuario no necesita dar su consentimiento por separado, pero solo DEBE recibir una notificación.
Si las implementaciones de dispositivos implementan una indicación visual del usuario para activar la "VPN siempre activada" función de una app de VPN de terceros, hacen lo siguiente:
- [C-3-1] SE DEBE inhabilitar esta indicación visual del usuario para las apps que no admiten el servicio VPN siempre activo en el archivo
AndroidManifest.xml
configurando el atributoSERVICE_META_DATA_SUPPORTS_ALWAYS_ON
enfalse
.
9.8.5 Identificadores de dispositivos
Implementaciones en dispositivos:
- [C-0-1] DEBE evitar el acceso al número de serie del dispositivo y, cuando corresponda, al IMEI/MEID, al número de serie de SIM y a la identidad internacional de suscriptor móvil (IMSI) desde una app, a menos que cumpla con uno de los siguientes requisitos:
- es una app de operador firmada y verificada por los fabricantes de dispositivos.
- se le otorgó el permiso
READ_PRIVILEGED_PHONE_STATE
. - Tenga privilegios de operador, tal como se define en los Privilegios de proveedor de UICC.
- es un propietario de dispositivo o perfil al que se le otorgó el permiso
READ_PHONE_STATE
. - (Solo para el número de serie de SIM o ICCID) tiene el requisito de reglamentaciones locales que exige que la app detecte cambios en la identidad del suscriptor.
9.8.6 Captura de contenido
Android, a través de la API del sistema ContentCaptureService
, o a través de otros medios privados, admite un mecanismo para que las implementaciones en dispositivos capturen las siguientes interacciones entre las aplicaciones y el usuario.
- Texto y gráficos renderizados en la pantalla, incluidas, sin limitaciones, las notificaciones y los datos de asistencia, a través de la API de
AssistStructure
- Datos multimedia, como audio o video, que el dispositivo graba o reproduce
- Eventos de entrada (p. ej., tecla, mouse, gesto, voz, video y accesibilidad)
- Cualquier otro evento que una aplicación proporcione al sistema a través de la API de
Content Capture
o una API propia con capacidad similar - Cualquier texto o cualquier otro dato que se envíe a través de
TextClassifier API
al Sistema TextClassifier, es decir, al servicio del sistema para comprender el significado del texto, así como generar las próximas acciones previstas en función de este.
Si las implementaciones de dispositivos capturan los datos anteriores, sucederá lo siguiente:
- [C-1-1] SE DEBE encriptar todos esos datos cuando estén almacenados en el dispositivo. Esta encriptación PUEDE llevarse a cabo mediante la encriptación basada en archivos de Android o cualquiera de los cifrados incluidos en la API 26 o versiones posteriores, descritos en Cipher SDK.
- [C-1-2] NO DEBE crear una copia de seguridad de los datos encriptados ni sin procesar con los métodos de copia de seguridad de Android ni con ningún otro método de copia de seguridad.
- [C-1-3] Solo se DEBE enviar todos esos datos y el registro del dispositivo a través de un mecanismo que preserve la privacidad. El mecanismo de preservación de la privacidad se define como "aquellos que solo permiten el análisis agregado y evitan la coincidencia de eventos registrados o resultados derivados con usuarios individuales" para evitar que los datos por usuario sean introspecbles (p.ej., implementados con una tecnología de privacidad diferencial, como
RAPPOR
). - [C-1-4] NO DEBE asociar esos datos con ninguna identidad del usuario (como
Account
) en el dispositivo, excepto con el consentimiento explícito del usuario cada vez que se asocian los datos. - [C-1-5] NO DEBE compartir esos datos con otras aplicaciones, excepto con el consentimiento explícito del usuario cada vez que se comparten.
- [C-1-6] DEBE proporcionar la indicación visual del usuario para borrar los datos que recopila el
ContentCaptureService
o el medio de propiedad si los datos se almacenan de cualquier forma en el dispositivo.
Si las implementaciones de dispositivos incluyen un servicio que implementa la API del sistema ContentCaptureService
o cualquier servicio de propiedad que capture los datos como se describió anteriormente, sucederá lo siguiente:
- [C-2-1] NO DEBE permitir que los usuarios reemplacen el servicio de captura de contenido con una aplicación o servicio instalable, y solo DEBE permitir que el servicio preinstalado capture esos datos.
- [C-2-2] NO DEBE permitir que ninguna aplicación que no sea el mecanismo del servicio de captura de contenido preinstalado pueda capturar dichos datos.
- [C-2-3] DEBE proporcionar la indicación visual del usuario para inhabilitar el servicio de captura de contenido.
- [C-2-4] NO DEBE omitir la indicación visual del usuario para administrar los permisos de Android que posee el servicio de captura de contenido y seguir el modelo de permisos de Android, como se describe en la Sección 9.1. Permiso.
-
[C-SR] SE RECOMIENDA ENERGENTE para mantener separados los componentes del servicio de captura de contenido (por ejemplo, sin vincular el servicio ni compartir IDs de procesos) de otros componentes del sistema, excepto por lo siguiente:
- Telefonía, Contactos, IU del sistema y Contenido multimedia
9.8.7 Acceso al portapapeles
Implementaciones en dispositivos:
- [C-0-1] NO DEBE mostrar datos recortados en el portapapeles (p.ej., a través de la API de
ClipboardManager
), a menos que la app sea el IME predeterminado o sea la app que actualmente está enfocada.
9.8.8. Ubicación
Implementaciones en dispositivos:
- [C-0-1] NO DEBE activar/desactivar la configuración de ubicación del dispositivo ni la configuración de búsqueda de Wi-Fi/Bluetooth sin el consentimiento explícito del usuario ni su iniciación.
- [C-0-2] DEBE permitir que el usuario acceda a información relacionada con la ubicación, incluidas las solicitudes de ubicación recientes, los permisos a nivel de la app y el uso de la búsqueda de Wi-Fi/Bluetooth para determinar la ubicación.
- [C-0-3] DEBE asegurarse de que la aplicación que usa la API de Emergency Location Bypass [LocationRequest.setLocationSettingsIgnored()] sea una sesión de emergencia iniciada por el usuario (p.ej., marcar 911 o enviar un mensaje de texto al 911). Sin embargo, en el caso de la industria automotriz, un vehículo PUEDE iniciar una sesión de emergencia sin interacción activa del usuario en caso de que se detecte un accidente o accidente (p.ej., para cumplir con los requisitos de llamadas electrónicas).
- [C-0-4] DEBE preservar la capacidad de la API de Emergency Location Bypass para omitir la configuración de ubicación del dispositivo sin cambiar la configuración.
- [C-0-5] DEBE programar una notificación que le recuerde al usuario después de que una app en segundo plano acceda a su ubicación con el permiso [
ACCESS_BACKGROUND_LOCATION
].
9.8.9. Apps instaladas
Las apps para Android orientadas al nivel de API 30 o versiones posteriores no pueden ver detalles sobre otras apps instaladas de forma predeterminada (consulta Visibilidad de paquetes en la documentación del SDK de Android).
Implementaciones en dispositivos:
- [C-0-1] NO DEBE exponer a ninguna aplicación que se oriente al nivel de API 30 o superior con los detalles de ninguna otra aplicación instalada, a menos que la aplicación ya pueda ver los detalles de la otra aplicación instalada a través de las API administradas. Esto incluye, entre otros, los detalles que exponen las APIs personalizadas que agrega el implementador de dispositivos o a los que se puede acceder a través del sistema de archivos.
9.8.10 Informe de errores de conectividad
Si las implementaciones de dispositivos generan informes de errores usando la API del sistema BUGREPORT_MODE_TELEPHONY
con BugreportManager, harán lo siguiente:
- [C-1-1] SE DEBE obtener el consentimiento del usuario cada vez que se llama a la API del sistema
BUGREPORT_MODE_TELEPHONY
para generar un informe, y NO DEBE pedirle al usuario que dé su consentimiento para todas las solicitudes futuras de la aplicación. - [C-1-2] SE DEBE mostrar y obtener el consentimiento explícito del usuario cuando comienzan a generarse los informes, y NO DEBEN devolver el informe generado a la aplicación solicitante sin su consentimiento explícito.
- [C-1-3] DEBE generar los informes solicitados que contengan, al menos, la siguiente información:
- Volcado de TelephonyDebugService
- Volcado de TelephonyRegistry
- Volcado de WifiService
- Volcado de ConnectivityService
- Un volcado de la instancia de CarrierService del paquete de llamada (si está vinculado)
- Búfer de registro de radio
- [C-1-4] NO DEBE incluir lo siguiente en los informes generados:
- Cualquier tipo de información no relacionada con la depuración de conectividad.
- Cualquier tipo de registros de tráfico de aplicaciones instaladas por el usuario o perfiles detallados de aplicaciones o paquetes instalados por el usuario (los UID están bien, los nombres de paquetes no lo son).
- PUEDE incluir información adicional que no esté asociada con ninguna identidad de usuario. (p.ej., registros del proveedor).
Si las implementaciones de dispositivos incluyen información adicional (p. ej., registros del proveedor) en el informe de errores y esa información tiene un impacto en la privacidad, la seguridad, la batería, el almacenamiento y la memoria, sucederá lo siguiente:
- [C-SR] SE RECOMIENDA INTENSIFICAMENTE tener inhabilitada la configuración de desarrollador de forma predeterminada. Para cumplir con esto, el AOSP proporciona la opción
Enable verbose vendor logging
en la configuración del desarrollador para incluir registros adicionales de proveedores específicos del dispositivo en los informes de errores.
9.8.11 Uso compartido de BLOB de datos
A través de BlobStoreManager, Android permite que las apps aporten BLOB de datos al sistema para que se compartan con un conjunto seleccionado de apps.
Si las implementaciones de dispositivos admiten BLOB de datos compartidos, como se describe en la documentación del SDK, sucederá lo siguiente:
- [C-1-1] NO DEBE compartir BLOB de datos que pertenezcan a apps más allá de lo previsto (es decir, el alcance del acceso predeterminado y los otros modos de acceso que se pueden especificar mediante BlobStoreManager.session#allowPackageAccess(), BlobStoreManager.session#allowSameAccess() o BlobStoreManager.session#allowPublicAccess() NO SE DEBEN modificar). La implementación de referencias de AOSP cumple con estos requisitos.
- [C-1-2] NO DEBE enviar fuera del dispositivo ni compartir con otras aplicaciones los hashes seguros de los BLOB de datos (que se usan para controlar el acceso).
9.9 Encriptación del almacenamiento de datos
Todos los dispositivos DEBEN cumplir con los requisitos de la sección 9.9.1. Los dispositivos que se lanzaron en un nivel de API anterior al de este documento están exentos de los requisitos de las secciones 9.9.2 y 9.9.3. En su lugar, DEBEN cumplir con los requisitos de la sección 9.9 del documento Definición de compatibilidad de Android correspondiente al nivel de API en el que se lanzó el dispositivo.
9.9.1 Inicio directo
Implementaciones en dispositivos:
-
[C-0-1] DEBE implementar las APIs de modo de inicio directo incluso si no son compatibles con la encriptación de almacenamiento.
-
[C-0-2] Los intents
ACTION_LOCKED_BOOT_COMPLETED
yACTION_USER_UNLOCKED
DEBEN transmitirse para indicar a las aplicaciones con reconocimiento de inicio directo que las ubicaciones de almacenamiento de Device Encrypted (DE) y Credential Encrypted (CE) están disponibles para el usuario.
9.9.2. Requisitos de encriptación
Implementaciones en dispositivos:
- [C-0-1] DEBE encriptar los datos privados de la aplicación (partición
/data
), así como la partición de almacenamiento compartido de la aplicación (partición/sdcard
) si es una parte permanente del dispositivo no extraíble. - [C-0-2] SE DEBE habilitar la encriptación de almacenamiento de datos de forma predeterminada en el momento en que el usuario completa la experiencia de configuración integrada.
-
[C-0-3] DEBE cumplir con el requisito de encriptación de almacenamiento de datos anterior implementando uno de los dos métodos de encriptación siguientes:
- Encriptación basada en archivos (FBE) y Encriptación de metadatos, como se describe en la sección 9.9.3.1.
- Encriptación a nivel de bloqueo por usuario, como se describe en la sección 9.9.3.2.
9.9.3 Métodos de encriptación
Si las implementaciones de dispositivos están encriptadas, suceden lo siguiente:
- [C-1-1] DEBE iniciarse sin solicitar credenciales al usuario y permitir que las apps compatibles con el inicio directo accedan al almacenamiento de dispositivo encriptado (DE) después de que se transmita el mensaje
ACTION_LOCKED_BOOT_COMPLETED
. - [C-1-2] Solo DEBE permitir el acceso al almacenamiento de Credential Encrypted (CE) después de que el usuario haya desbloqueado el dispositivo proporcionando sus credenciales (p. ej., contraseña, PIN, patrón o huella dactilar) y se haya transmitido el mensaje
ACTION_USER_UNLOCKED
. - [C-1-13] NO DEBE ofrecer ningún método para desbloquear el almacenamiento protegido por CE sin las credenciales proporcionadas por el usuario, una clave de custodia registrada o una implementación de currículum en el reinicio que cumpla con los requisitos de la sección 9.9.4.
- [C-1-4] DEBE usar el inicio verificado.
9.9.3.1 Encriptación basada en archivos con encriptación de metadatos
Si las implementaciones de dispositivos usan la encriptación basada en archivos con la encriptación de metadatos, sucederá lo siguiente:
- [C-1-5] DEBE encriptar el contenido del archivo y los metadatos del sistema de archivos mediante AES-256-XTS o Adiantum. AES-256-XTS hace referencia al Estándar de encriptación avanzada con una longitud de clave de algoritmo de cifrado de 256 bits, operada en modo XTS. la longitud completa de la clave es de 512 bits. Adiantum hace referencia a Adiantum-XChaCha12-AES, como se especifica en https://github.com/google/adiantum. Los metadatos del sistema de archivos son datos como el tamaño, la propiedad, los modos y los atributos extendidos de los archivos (xattrs).
- [C-1-6] SE DEBE encriptar los nombres de los archivos con AES-256-CBC-CTS o Adiantum.
- [C-1-12] Si el dispositivo tiene instrucciones del Estándar de encriptación avanzada (AES) (como extensiones de criptografía de ARMv8 en dispositivos basados en ARM o AES-NI en dispositivos basados en x86), se DEBEN usar las opciones basadas en AES anteriores para el nombre del archivo, el contenido del archivo y la encriptación de metadatos del sistema de archivos, no Adiantum.
- [C-1-13] DEBE usar una función de derivación de clave criptográficamente segura y no reversible (p.ej., HKDF-SHA512) para derivar cualquier subclave necesaria (p.ej., claves por archivo) de las claves CE y DE. "Criptográficamente sólida y no reversible" Significa que la función de derivación de claves tiene una seguridad de seguridad de al menos 256 bits y se comporta como una familia de funciones pseudoaleatoria en sus entradas.
-
[C-1-14] NO DEBE usar las mismas claves o subclaves de encriptación basada en archivos (FBE) para diferentes propósitos criptográficos (p.ej., para la encriptación y la derivación de claves, o para dos algoritmos de encriptación diferentes).
-
Las claves que protegen las áreas de almacenamiento CE y DE, y los metadatos del sistema de archivos:
-
[C-1-7] DEBE vincularse criptográficamente a un almacén de claves guardado en hardware. Este almacén de claves DEBE estar vinculado al inicio verificado y a la raíz de confianza del hardware del dispositivo.
- [C-1-8] Las claves CE DEBEN estar vinculadas a las credenciales de la pantalla de bloqueo de un usuario.
- [C-1-9] Las claves CE DEBEN estar vinculadas a una contraseña predeterminada cuando el usuario no especifica las credenciales de la pantalla de bloqueo.
- [C-1-10] DEBE ser única y diferente; en otras palabras, ninguna clave CE o DE del usuario coincide con ninguna de las teclas CE o DE de otro usuario.
-
[C-1-11] SE DEBE usar los algoritmos de cifrado, las longitudes de clave y los modos admitidos de manera obligatoria.
-
SE DEBE permitir que las aplicaciones esenciales preinstaladas (p.ej., Alarma, Teléfono, Messenger) reconozcan el inicio directo.
El proyecto upstream de código abierto de Android proporciona una implementación preferida de encriptación basada en archivos basada en el kernel de Linux "fscrypt" de encriptación de metadatos y la encriptación de metadatos basada en el kernel de Linux “dm-default-key” .
9.9.3.2. Encriptación a nivel de bloqueo por usuario
Si las implementaciones de dispositivos usan encriptación a nivel de bloque por usuario, sucederá lo siguiente:
- [C-1-1] SE DEBE habilitar la asistencia multiusuario como se describe en la sección 9.5.
- [C-1-2] DEBE proporcionar particiones por usuario, ya sea a través de particiones sin procesar o volúmenes lógicos.
- [C-1-3] DEBE usar claves de encriptación únicas y distintas por usuario para la encriptación de los dispositivos de almacenamiento en bloques subyacentes.
-
[C-1-4] DEBE usar AES-256-XTS para la encriptación a nivel de bloque de las particiones de usuario.
-
Estas son las claves que protegen los dispositivos encriptados por usuario a nivel de bloque:
-
[C-1-5] DEBE vincularse de forma criptográfica a un almacén de claves guardado en hardware. Este almacén de claves DEBE estar vinculado al inicio verificado y a la raíz de confianza del hardware del dispositivo.
- [C-1-6] DEBE vincularse con las credenciales de la pantalla de bloqueo del usuario correspondiente.
La encriptación a nivel de bloque por usuario se puede implementar con la función “dm-crypt” del kernel de Linux en particiones por usuario.
9.9.4 Reanudar en el reinicio
La reanudación en el reinicio permite desbloquear el almacenamiento de CE de todas las apps, incluidas las que aún no admiten el inicio directo, después de un reinicio que se inicia de manera inalámbrica. Esta función permite que los usuarios reciban notificaciones de apps instaladas después del reinicio.
Una implementación de la función Reanudación en el reinicio debe continuar garantizando que cuando un dispositivo caiga en manos de un atacante, sea extremadamente difícil para ese atacante recuperar los datos encriptados CE del usuario, incluso si el dispositivo está encendido, el almacenamiento CE está desbloqueado y el usuario desbloquea el dispositivo después de recibir una actualización inalámbrica. Para la resistencia ante ataques de usuarios con información privilegiada, también suponemos que el atacante obtiene acceso a la transmisión de claves de firma criptográficas.
Más precisamente:
-
[C-0-1] El almacenamiento CE NO DEBE ser legible incluso para el atacante que tiene físicamente el dispositivo y luego presenta las siguientes capacidades y limitaciones:
- Se puede usar la clave de firma de cualquier proveedor o empresa para firmar mensajes arbitrarios.
- Puede hacer que el dispositivo reciba una actualización inalámbrica.
- Pueden modificar el funcionamiento de cualquier hardware (AP, flash, etc.), excepto como se detalla a continuación, pero dicha modificación implica un retraso de al menos una hora y un reinicio de energía que destruye el contenido de la RAM.
- No se puede modificar el funcionamiento del hardware resistente a alteraciones (p. ej., Titan M).
- No se puede leer la RAM del dispositivo activo.
- No se puede obtener la credencial del usuario (PIN, patrón o contraseña) o generarla de otro modo.
A modo de ejemplo, una implementación de dispositivo que implemente todas las descripciones que se encuentran aquí y cumpla con ellas cumplirá con [C-0-1].
9.10. Integridad del dispositivo
Los siguientes requisitos garantizan que el estado de la integridad del dispositivo sea transparente. Implementaciones en dispositivos:
-
[C-0-1] DEBE informar correctamente a través del método
PersistentDataBlockManager.getFlashLockState()
de la API del sistema si el estado del bootloader permite la instalación de la imagen del sistema. El estadoFLASH_LOCK_UNKNOWN
se reserva para las implementaciones en dispositivos que se actualizan desde una versión anterior de Android en la que no existía este nuevo método de API del sistema. -
[C-0-2] DEBE admitir el inicio verificado para la integridad del dispositivo.
Si las implementaciones en dispositivos ya se lanzaron sin compatibilidad con el inicio verificado en una versión anterior de Android y no pueden agregar compatibilidad para esta función con una actualización de software del sistema, PUEDEN estar exentas del requisito.
El inicio verificado es una función que garantiza la integridad del software del dispositivo. Si las implementaciones en dispositivos admiten la función, sucederá lo siguiente:
- [C-1-1] SE DEBE declarar la marca de función de la plataforma
android.software.verified_boot
. - [C-1-2] SE DEBE verificar cada secuencia de inicio.
- [C-1-3] DEBE iniciar la verificación desde una clave de hardware inmutable que es la raíz de confianza y avanzar hasta la partición del sistema.
- [C-1-4] DEBE implementar cada etapa de verificación para comprobar la integridad y autenticidad de todos los bytes en la siguiente etapa antes de ejecutar el código en la siguiente etapa.
- [C-1-5] DEBEN usar algoritmos de verificación tan sólidos como las recomendaciones actuales del NIST para los algoritmos de hash (SHA-256) y los tamaños de claves públicas (RSA-2048).
- [C-1-6] NO DEBE permitir que el inicio se complete cuando falla la verificación del sistema, a menos que el usuario dé su consentimiento para intentar iniciar de todos modos, en cuyo caso, los datos de cualquier bloque de almacenamiento no verificado no DEBEN usarse.
- [C-1-7] NO DEBE permitir que se modifiquen las particiones verificadas en el dispositivo, a menos que el usuario haya desbloqueado explícitamente el bootloader.
- [C-SR] Si hay varios chips discretos en el dispositivo (p.ej., radio o procesador de imágenes especializado), se RECOMIENDA EJECUTAR el proceso de inicio de cada uno de ellos para verificar cada etapa durante el inicio.
- [C-1-8] SE DEBE usar el almacenamiento de manipulación evidente, es decir, para almacenar si el bootloader está desbloqueado. El almacenamiento a prueba de sabotajes significa que el bootloader puede detectar si se manipuló el almacenamiento desde el interior de Android.
- [C-1-9] SE DEBE solicitar al usuario, mientras usa el dispositivo, y requerir confirmación física antes de permitir una transición del modo bloqueado de bootloader al modo desbloqueado de bootloader.
- [C-1-10] DEBE implementar la protección contra reversión para las particiones que usa Android (p.ej., inicio, particiones del sistema) y usar almacenamiento a prueba de manipulaciones para almacenar los metadatos usados para determinar la versión mínima permitida del SO.
- [C-SR] SE RECOMIENDA COMPLETAMENTE verificar todos los archivos APK de app con privilegios con una cadena de confianza basada en particiones protegidas por el inicio verificado.
- [C-SR] SE RECOMIENDA ENERGMENTE verificar todos los artefactos ejecutables cargados por una aplicación con privilegios desde fuera de su archivo APK (como el código cargado de forma dinámica o el código compilado) antes de ejecutarlos, o SE RECOMIENDA ELEGIR ESTRICTAMENTE no ejecutarlos en absoluto.
- SE DEBE implementar la protección contra reversión para cualquier componente con firmware persistente (por ejemplo, módem, cámara) y DEBERÍA utilizar almacenamiento a prueba de manipulaciones para almacenar los metadatos usados para determinar la versión mínima permitida.
Si las implementaciones de dispositivos ya se lanzaron sin compatibilidad con C-1-8 a C-1-10 en una versión anterior de Android y no pueden agregar compatibilidad para estos requisitos con una actualización de software del sistema, PODRÍAN estar exentas de los requisitos.
El Proyecto de código abierto de Android upstream proporciona una implementación preferida de esta función en el repositorio external/avb/
, que se puede integrar en el bootloader que se usa para cargar Android.
Implementaciones en dispositivos:
- [C-0-3] DEBE admitir la verificación criptográfica del contenido del archivo según una clave de confianza sin leer todo el archivo.
- [C-0-4] NO DEBE permitir que las solicitudes de lectura en un archivo protegido se ejecuten correctamente cuando el contenido de lectura no se verifica con una clave de confianza.
Si las implementaciones de dispositivos ya se lanzaron sin la capacidad de verificar el contenido del archivo con una clave de confianza en una versión anterior de Android y no pueden agregar compatibilidad con esta función con una actualización de software del sistema, PUEDEN estar exentas del requisito. El proyecto upstream de código abierto de Android proporciona una implementación preferida de esta función, según la función fs-verity del kernel de Linux.
Implementaciones en dispositivos:
- [C-R] SE RECOMIENDA que sean compatibles con la API de Protected Confirmation de Android.
Si las implementaciones de dispositivos admiten la API de Protected Confirmation de Android, sucederá lo siguiente:
-
[C-3-1] DEBE informar
true
para la API deConfirmationPrompt.isSupported()
. -
[C-3-2] SE DEBE asegurarse de que el código que se ejecuta en el SO Android, incluido su kernel, malicioso o de otro modo, no pueda generar una respuesta positiva sin interacción del usuario.
-
[C-3-3] SE DEBE asegurarse de que el usuario haya podido revisar y aprobar el mensaje solicitado aun en el caso de que el SO Android, incluido su kernel, se vea comprometido.
9.11. Claves y credenciales
El sistema Android Keystore permite a los desarrolladores de apps almacenar claves criptográficas en un contenedor y usarlas en operaciones criptográficas a través de la API de KeyChain o la API de Keystore. Implementaciones en dispositivos:
- [C-0-1] DEBE permitir que se importen o generen al menos 8,192 claves.
- [C-0-2] La autenticación de la pantalla de bloqueo DEBE intentos con límite de frecuencia y DEBE tener un algoritmo de retirada exponencial. Si supera los 150 intentos fallidos, la demora DEBE ser de al menos 24 horas por intento.
- No se DEBE limitar la cantidad de claves que se pueden generar.
Cuando la implementación del dispositivo admite una pantalla de bloqueo segura, hace lo siguiente:
- [C-1-1] SE DEBE hacer una copia de seguridad de la implementación del almacén de claves con un entorno de ejecución aislado.
- [C-1-2] DEBE tener implementaciones de algoritmos criptográficos RSA, AES, ECDSA y HMAC y funciones hash de la familia MD5, SHA1 y SHA-2 para admitir adecuadamente los algoritmos compatibles del sistema Android Keystore en un área aislada de forma segura del código que se ejecuta en el kernel y superior. El aislamiento seguro DEBE bloquear todos los posibles mecanismos mediante los cuales el kernel o el código del espacio del usuario podrían acceder al estado interno del entorno aislado, incluida la DMA. El Proyecto de código abierto de Android (AOSP) ascendente cumple este requisito mediante la implementación de Trusty, pero otra solución basada en ARM TrustZone o una implementación segura revisada por terceros de un aislamiento adecuado basado en un hipervisor son opciones alternativas.
- [C-1-3] SE DEBE realizar la autenticación de la pantalla de bloqueo en el entorno de ejecución aislado y solo cuando se realiza correctamente, se deben permitir el uso de claves vinculadas a la autenticación. Las credenciales de la pantalla de bloqueo DEBEN almacenarse de una manera que permita que solo el entorno de ejecución aislado realice la autenticación de la pantalla de bloqueo. El Proyecto de código abierto de Android ascendente ofrece la capa de abstracción de hardware (HAL) de Gatekeeper y Trusty, que se pueden usar para cumplir con este requisito.
- [C-1-4] DEBE admitir la certificación de claves cuando la clave de firma de la certificación está protegida por hardware seguro y la firma se realiza en hardware seguro. Las claves de firma de certificación DEBEN compartirse entre una gran cantidad de dispositivos para evitar que se usen como identificadores de dispositivos. Una forma de cumplir con este requisito es compartir la misma clave de certificación, a menos que se produzcan al menos 100,000 unidades de un SKU determinado. Si se producen más de 100,000 unidades de un SKU, PUEDE usar una clave diferente por cada 100,000 unidades.
Ten en cuenta que, si la implementación de un dispositivo ya se inició en una versión anterior de Android, ese dispositivo estará exento del requisito de tener un almacén de claves respaldado por un entorno de ejecución aislado y admitir la certificación de claves, a menos que declare la función android.hardware.fingerprint
que requiera un almacén de claves respaldado por un entorno de ejecución aislado.
- [C-1-5] DEBE permitir que el usuario elija el tiempo de espera de suspensión para la transición del estado desbloqueado al bloqueado, con un tiempo de espera mínimo permitido de hasta 15 segundos. En los dispositivos automotores, que bloquean la pantalla cuando se apaga la consola central o se cambia el usuario el usuario, NO PUEDEN tener la configuración de tiempo de espera de suspensión.
9.11.1 Pantalla de bloqueo y autenticación seguras
La implementación del AOSP sigue un modelo de autenticación por niveles en el que una autenticación principal basada en la fábrica del conocimiento puede respaldarse a través de un método biométrico seguro secundario o modalidades terciarias más débiles.
Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA EXITOSAMENTE configurar solo uno de los siguientes como método de autenticación principal:
- Un PIN numérico
- Una contraseña alfanumérica
- Un patrón de deslizamiento en una cuadrícula de exactamente 3 x 3 puntos.
Ten en cuenta que los métodos de autenticación anteriores se refieren a los métodos de autenticación principales recomendados en este documento.
Si las implementaciones de dispositivos agregan o modifican los métodos de autenticación principales recomendados y usan un método de autenticación nuevo como método seguro para bloquear la pantalla, el nuevo método de autenticación hace lo siguiente:
- [C-2-1] DEBE ser el método de autenticación del usuario tal como se describe en Solicitud de autenticación del usuario para el uso de la clave.
Si las implementaciones de dispositivos agregan o modifican los métodos de autenticación para desbloquear la pantalla de bloqueo si se basan en un secreto conocido y usan un método de autenticación nuevo que se considere una forma segura de bloquear la pantalla:
- [C-3-1] La entropía de la longitud más corta permitida de entradas DEBE ser superior a 10 bits.
- [C-3-2] La entropía máxima de todas las entradas posibles DEBE ser mayor que 18 bits.
- [C-3-3] El nuevo método de autenticación NO DEBE reemplazar ninguno de los métodos de autenticación principales recomendados (es decir, PIN, patrón o contraseña) implementados y proporcionados en el AOSP.
- [C-3-4] El nuevo método de autenticación DEBE inhabilitarse cuando la aplicación del controlador de política de dispositivo (DPC) estableció la política de calidad de la contraseña a través del método
DevicePolicyManager.setPasswordQuality()
con una constante de calidad más restrictiva quePASSWORD_QUALITY_SOMETHING
. - [C-3-5] Los nuevos métodos de autenticación DEBEN recurrir a los métodos de autenticación principales recomendados (es decir, PIN, patrón, contraseña) una vez cada 72 horas o menos O informarle claramente al usuario que no se creará una copia de seguridad de algunos datos para preservar la privacidad de sus datos.
Si las implementaciones de dispositivos agregan o modifican los métodos de autenticación principales recomendados para desbloquear la pantalla de bloqueo y usan un nuevo método de autenticación basado en datos biométricos que se trate como una forma segura de bloquear la pantalla, el nuevo método:
- [C-4-1] DEBE cumplir con todos los requisitos descritos en la sección 7.3.10 para la Clase 1 (anteriormente, Conveniencia).
- [C-4-2] DEBE tener un mecanismo de resguardo para usar uno de los métodos de autenticación principales recomendados que se basan en un secreto conocido.
- [C-4-3] SE DEBE inhabilitar y solo permitir la autenticación principal recomendada para desbloquear la pantalla cuando la aplicación del controlador de política de dispositivo (DPC) haya configurado la política de funciones de bloqueo de teclado llamando al método
DevicePolicyManager.setKeyguardDisabledFeatures()
, con cualquiera de las marcas biométricas asociadas (es decir,KEYGUARD_DISABLE_BIOMETRICS
,KEYGUARD_DISABLE_FINGERPRINT
,KEYGUARD_DISABLE_FACE
oKEYGUARD_DISABLE_IRIS
).
Si los métodos de autenticación biométrica no cumplen con los requisitos de la Clase 3 (anteriormente Sólida), como se describe en la sección 7.3.10:
- [C-5-1] Los métodos DEBEN inhabilitarse si la aplicación del controlador de política de dispositivo (DPC) estableció la política de calidad de la contraseña a través del método
DevicePolicyManager.setPasswordQuality()
con una constante de calidad más restrictiva quePASSWORD_QUALITY_BIOMETRIC_WEAK
. - [C-5-2] Se DEBE cuestionar al usuario para obtener la autenticación principal recomendada (p. ej., PIN, patrón, contraseña) como se describe en [C-1-7] y [C-1-8] en la sección 7.3.10.
- [C-5-3] Los métodos NO DEBEN tratarse como una pantalla de bloqueo segura y DEBEN cumplir con los requisitos que comienzan con C-8 en esta sección a continuación.
Si las implementaciones de dispositivos agregan o modifican los métodos de autenticación para desbloquear la pantalla de bloqueo y un nuevo método de autenticación se basa en un token físico o en la ubicación:
- [C-6-1] DEBEN tener un mecanismo de resguardo para usar uno de los métodos de autenticación principales recomendados, el cual se basa en un secreto conocido y cumple con los requisitos para que se los considere como una pantalla de bloqueo segura.
- [C-6-2] El nuevo método DEBE inhabilitarse y permitir que solo uno de los métodos de autenticación principales recomendados desbloquee la pantalla cuando la aplicación del controlador de política de dispositivo (DPC) haya establecido la política con el método
DevicePolicyManager.setKeyguardDisabledFeatures(KEYGUARD_DISABLE_TRUST_AGENTS)
oDevicePolicyManager.setPasswordQuality()
con una constante de calidad más restrictiva quePASSWORD_QUALITY_UNSPECIFIED
. - [C-6-3] Se DEBE cuestionar al usuario por uno de los métodos de autenticación principales recomendados (p.ej., PIN, patrón o contraseña) al menos una vez cada 4 horas o menos.
- [C-6-4] El nuevo método NO DEBE tratarse como una pantalla de bloqueo segura y DEBE seguir las restricciones que aparecen en C-8 a continuación.
Si las implementaciones de dispositivos tienen una pantalla de bloqueo segura e incluyen uno o más agentes de confianza, que implementan la API del sistema de TrustAgentService
, harán lo siguiente:
- [C-7-1] DEBE tener una indicación clara en el menú de configuración y en la pantalla de bloqueo cuando el bloqueo del dispositivo se aplaza o los agentes de confianza pueden desbloquearlo. Por ejemplo, para cumplir con este requisito, AOSP muestra una descripción de texto para el parámetro de configuración "Bloqueo automático". y "El botón de encendido se bloquea al instante" en el menú de configuración y un ícono distinguible en la pantalla de bloqueo.
- [C-7-2] DEBE respetar e implementar por completo todas las APIs de agente de confianza en la clase
DevicePolicyManager
, como la constanteKEYGUARD_DISABLE_TRUST_AGENTS
. - [C-7-3] NO DEBE implementar por completo la función
TrustAgentService.addEscrowToken()
en un dispositivo que se use como dispositivo personal principal (p.ej., portátil), pero PUEDE implementar por completo la función en implementaciones de dispositivos que normalmente se comparten (p.ej., dispositivo Android Automotive o Automotive). - [C-7-4] DEBE encriptar todos los tokens almacenados que agregó
TrustAgentService.addEscrowToken()
. - [C-7-5] NO DEBE almacenar la clave de encriptación ni el token de depósito en el mismo dispositivo en el que se usa la clave. Por ejemplo, se permite que una llave almacenada en un teléfono desbloquee una cuenta de usuario en una TV. En el caso de los dispositivos Automotive, no se permite que el token de depósito se almacene en ninguna parte del vehículo.
- [C-7-6] DEBE informar al usuario sobre las implicaciones de seguridad antes de habilitar el token de custodia para desencriptar el almacenamiento de datos.
- [C-7-7] DEBE tener un mecanismo de resguardo para usar uno de los métodos de autenticación principales recomendados.
- [C-7-8] SE DEBE cuestionar al usuario por uno de los métodos de autenticación principales recomendados (p. ej., PIN, patrón, contraseña) al menos una vez cada 72 horas o menos, a menos que la seguridad del usuario (p. ej., la distracción del conductor) sea de preocupación.
- [C-7-9] Se DEBE cuestionar al usuario por uno de los métodos de autenticación principales recomendados (p. ej., PIN, patrón, contraseña) como se describe en [C-1-7] y [C-1-8] en la sección 7.3.10, a menos que la seguridad del usuario (p. ej., la distracción del conductor) sea de interés.
- [C-7-10] NO DEBE tratarse como una pantalla de bloqueo segura y DEBE seguir las restricciones que se mencionan en C-8 a continuación.
- [C-7-11] NO DEBE permitir que TrustAgents acceda a los dispositivos personales principales (p. ej., de mano) para desbloquear el dispositivo y solo puede usarlos para mantener un dispositivo ya desbloqueado en ese estado durante un máximo de 4 horas. La implementación predeterminada de TrustManagerService en AOSP cumple con este requisito.
- [C-7-12] DEBE usar un canal de comunicación seguro a nivel criptográfico (p. ej., UKEY2) para pasar el token de depósito del dispositivo de almacenamiento al dispositivo de destino.
Si las implementaciones de dispositivos agregan o modifican los métodos de autenticación para desbloquear la pantalla de bloqueo que no es segura, como se describió anteriormente, y usan un método de autenticación nuevo para desbloquear el bloqueo de teclado:
- [C-8-1] El nuevo método DEBE inhabilitarse cuando la aplicación del controlador de política de dispositivo (DPC) estableció la política de calidad de la contraseña a través del método
DevicePolicyManager.setPasswordQuality()
con una constante de calidad más restrictiva quePASSWORD_QUALITY_UNSPECIFIED
. - [C-8-2] NO DEBEN restablecer los temporizadores de vencimiento de contraseñas establecidos por
DevicePolicyManager.setPasswordExpirationTimeout()
. - [C-8-3] NO DEBEN exponer una API para que la usen aplicaciones de terceros para cambiar el estado de bloqueo.
9.11.2. StrongBox
El sistema Android Keystore permite a los desarrolladores de apps almacenar claves criptográficas en un procesador dedicado y seguro, así como en el entorno de ejecución aislado que se describió anteriormente. Este procesador seguro dedicado se llama "StrongBox". Los requisitos de C-1-3 a C-1-11 que se encuentran a continuación definen los requisitos que debe cumplir un dispositivo para calificar como StrongBox.
Implementaciones en dispositivos que tienen un procesador seguro dedicado:
- [C-SR] SE RECOMIENDA EXITOSAMENTE para admitir StrongBox. Es probable que StrongBox se convierta en un requisito en una versión futura.
Si las implementaciones de dispositivos admiten StrongBox, hacen lo siguiente:
-
[C-1-1] DEBE declarar FEATURE_STRONGBOX_KEYSTORE.
-
[C-1-2] DEBE proporcionar hardware seguro dedicado que se utilice para respaldar el almacén de claves y la autenticación de usuario segura. El hardware seguro dedicado también se puede usar para otros fines.
-
[C-1-3] DEBE tener una CPU discreta que no comparta caché, DRAM, coprocesadores ni otros recursos centrales con el procesador de la aplicación (AP).
-
[C-1-4] SE DEBE asegurarse de que los periféricos compartidos con el AP no puedan alterar el procesamiento de StrongBox de ninguna manera ni obtener información de StrongBox. El AP PUEDE inhabilitar o bloquear el acceso a StrongBox.
-
[C-1-5] DEBE tener un reloj interno con una precisión razonable (+-10%) que sea inmune a la manipulación por parte de AP.
-
[C-1-6] DEBE tener un verdadero generador de números aleatorios que produzca resultados impredecibles y distribuidos de manera uniforme.
-
El [C-1-7] DEBE tener resistencia a la manipulación, incluida la resistencia a la penetración física y a las fallas.
-
El [C-1-8] DEBE tener resistencia de canal lateral, incluida la resistencia contra fugas de información a través de canales de energía, sincronización, radiación electromagnética y canales laterales de radiación térmica.
-
[C-1-9] DEBE tener almacenamiento seguro que garantice la confidencialidad, integridad, autenticidad, coherencia y actualidad de los contenidos. NO SE DEBE poder leer ni modificar el almacenamiento, excepto según lo permitan las APIs de StrongBox.
-
Para validar el cumplimiento de [C-1-3] a [C-1-9], las implementaciones en dispositivos:
- [C-1-10] DEBE incluir el hardware que esté certificado según el Perfil de protección segura de IC BSI-CC-PP-0084-2014 o que lo evalúe un laboratorio de pruebas acreditado a nivel nacional y que incorpore una evaluación de vulnerabilidad de alto potencial de ataque según la Aplicación de criterios comunes de potencial de ataque a las tarjetas inteligentes.
- [C-1-11] DEBE incluir el firmware que evalúa un laboratorio de pruebas acreditado a nivel nacional que incorpora la evaluación de vulnerabilidades de alto potencial de ataque de acuerdo con la Aplicación Common Criteria of Attack Potenci to Smartcards.
- [C-SR] SE RECOMIENDA ENERGMENTE incluir el hardware que se evalúa mediante un objetivo de seguridad, un nivel de garantía de evaluación (EAL) 5, aumentado por AVA_VAN.5. Es probable que la certificación EAL 5 se convierta en un requisito en una versión futura.
-
[C-SR] se RECOMIENDA ENERGMENTE para proporcionar resistencia ante ataques de usuarios con información privilegiada (IAR), lo que significa que un usuario con información privilegiada con acceso a claves de firma de firmware no puede producir firmware que haga que StrongBox filtre secretos, evite los requisitos de seguridad funcionales o habilite el acceso a datos sensibles del usuario. La forma recomendada de implementar IAR es permitir las actualizaciones de firmware solo cuando la contraseña de usuario principal se proporciona a través de la HAL de IAuthSecret.
9.11.3 Credencial de identidad
El Sistema de credenciales de identidad se define y logra implementando todas las APIs del paquete android.security.identity.*
. Estas APIs permiten a los desarrolladores de apps almacenar y recuperar documentos de identidad de usuarios. Implementaciones en dispositivos:
- [C-SR] SE RECOMIENDA COMPLETAMENTE implementar el Sistema de credenciales de identidad.
Si las implementaciones de dispositivos implementan Identity Credential System, ocurrirá lo siguiente:
-
[C-0-1] DEBE mostrar un valor no nulo para el método IdentityCredentialStore#getInstance().
-
[C-0-2] SE DEBE implementar el Sistema de credenciales de identidad (p.ej., las APIs de
android.security.identity.*
) con código que se comunique con una aplicación de confianza en un área aislada de forma segura del código que se ejecuta en el kernel y en los superiores. El aislamiento seguro DEBE bloquear todos los posibles mecanismos mediante los cuales el kernel o el código del espacio del usuario podrían acceder al estado interno del entorno aislado, incluida la DMA. -
[C-0-3] Las operaciones criptográficas necesarias para implementar el Sistema de credenciales de identidad (p.ej., las APIs de
android.security.identity.*
) DEBEN realizarse por completo en la aplicación de confianza y el material de clave privada DEBEN nunca salir del entorno de ejecución aislado, a menos que las APIs de nivel superior lo requieran específicamente (p.ej., el método createEphemeralKeyPair()). -
[C-0-4] La aplicación de confianza DEBE implementarse de manera tal que sus propiedades de seguridad no se vean afectadas (por ejemplo, los datos de credenciales no se liberan a menos que se cumplan las condiciones de control de acceso, no se pueden producir MAC para datos arbitrarios) incluso si Android se comporta mal o está comprometido.
9.12. Eliminación de Datos
Todas las implementaciones en dispositivos:
- [C-0-1] DEBE proporcionarles a los usuarios un mecanismo para restablecer la configuración de fábrica.
- [C-0-2] SE DEBE borrar todos los datos del sistema de archivos userdata.
- [C-0-3] SE DEBE borrar los datos de manera tal que satisfaga los estándares relevantes de la industria, como NIST SP800-88.
- [C-0-4] SE DEBE activar el “restablecimiento de la configuración de fábrica” anterior. cuando la app de Device Policy Controller del usuario principal llama a la API de
DevicePolicyManager.wipeData()
. - PUEDE proporcionar una opción de limpieza de datos rápida que lleve a cabo solo una eliminación lógica de datos.
9.13 Modo de inicio seguro
Android ofrece un modo de inicio seguro, que permite a los usuarios iniciar en un modo en el que solo se permite la ejecución de apps preinstaladas del sistema y se inhabilitan todas las apps de terceros. Este modo, conocido como "modo de inicio seguro", proporciona al usuario la capacidad de desinstalar apps de terceros potencialmente dañinas.
Las implementaciones en dispositivos son las siguientes:
- [SR] SE RECOMIENDA COMPLETAMENTE implementar el modo de inicio seguro.
Si las implementaciones de dispositivos implementan el modo de inicio seguro, sucederá lo siguiente:
-
El [C-1-1] DEBE brindarle al usuario la opción de ingresar al modo de inicio seguro de una manera que no se pueda interrumpir con las apps de terceros instaladas en el dispositivo, excepto cuando la app de terceros es un controlador de Device Policy y estableció la marca
UserManager.DISALLOW_SAFE_BOOT
como verdadera. -
[C-1-2] DEBE permitir que el usuario desinstale apps de terceros en el modo seguro.
-
SE DEBE ofrecerles al usuario la opción de ingresar al modo de inicio seguro desde el menú de inicio mediante un flujo de trabajo diferente al de un inicio normal.
9.14. Aislamiento de sistemas para vehículos
Se espera que los dispositivos Android Automotive intercambien datos con subsistemas críticos del vehículo usando la HAL del vehículo para enviar y recibir mensajes a través de redes del vehículo, como CAN bus.
El intercambio de datos puede protegerse implementando funciones de seguridad debajo de las capas del framework de Android para evitar la interacción maliciosa o involuntaria con estos subsistemas.
9,15 Planes de suscripción
"Planes de suscripción" consulta los detalles del plan de relación de facturación que proporciona el operador de telefonía celular a través de SubscriptionManager.setSubscriptionPlans()
.
Todas las implementaciones en dispositivos:
- [C-0-1] DEBE devolver los planes de suscripción solo a la aplicación del operador de telefonía celular que los proporcionó originalmente.
- [C-0-2] NO DEBE crear una copia de seguridad de los planes de suscripción ni subirlos de forma remota.
- [C-0-3] Solo DEBE permitir anulaciones, como
SubscriptionManager.setSubscriptionOverrideCongested()
, de la app del operador de telefonía celular que actualmente proporciona planes de suscripción válidos.
9.16. Migración de datos de aplicaciones
Si las implementaciones de dispositivos incluyen la capacidad de migrar datos de un dispositivo a otro y no limitan los datos de la aplicación que copian a lo que configura el desarrollador de la aplicación en el manifiesto a través del atributo android:fullBackupContent, sucede lo siguiente:
- [C-1-1] NO DEBE iniciar transferencias de datos de aplicaciones desde dispositivos en los que el usuario no estableció una autenticación principal, como se describe en 9.11.1 Autenticación y pantalla de bloqueo seguras.
- [C-1-2] DEBE confirmar de forma segura la autenticación principal en el dispositivo de origen y confirmar con la intención del usuario de copiar los datos en el dispositivo de origen antes de que se transfieran los datos.
- [C-1-3] SE DEBE usar la certificación de llave de seguridad para garantizar que tanto el dispositivo de origen como el de destino en la migración de dispositivo a dispositivo sean dispositivos Android legítimos y tengan un bootloader bloqueado.
- [C-1-4] Solo se DEBEN migrar datos de la aplicación a la misma aplicación en el dispositivo de destino, con el mismo nombre de paquete Y certificado de firma.
- [C-1-5] DEBE mostrar una indicación de que se migraron datos al dispositivo de origen a través de una migración de datos de un dispositivo a otro en el menú de configuración. Los usuarios NO DEBEN quitar esta indicación.
10. Pruebas de compatibilidad de software
Las implementaciones en dispositivos DEBEN superar todas las pruebas que se describen en esta sección. Sin embargo, ten en cuenta que ningún paquete de prueba de software es completamente completo. Por este motivo, SE RECOMIENDA EJECUTAR a los implementadores de dispositivos realizar la cantidad mínima de cambios posible en la referencia y la implementación preferida de Android a partir del Proyecto de código abierto de Android. Esto minimizará el riesgo de introducir errores que creen incompatibilidades que requieran reelaboración y posibles actualizaciones del dispositivo.
10.1 Conjunto de pruebas de compatibilidad (CTS)
Implementaciones en dispositivos:
-
[C-0-1] DEBE aprobar el Conjunto de pruebas de compatibilidad (CTS) de Android disponible en el Proyecto de código abierto de Android con el software de envío final del dispositivo.
-
[C-0-2] SE DEBE garantizar la compatibilidad en casos de ambigüedad en CTS y para cualquier reimplementación de partes del código fuente de referencia.
El CTS está diseñado para ejecutarse en un dispositivo real. Como cualquier software, el CTS puede contener errores. Se realizará un control de versiones del CTS independientemente de esta definición de compatibilidad, y es posible que se publiquen varias revisiones del CTS para Android 11.
Implementaciones en dispositivos:
-
[C-0-3] DEBE pasar la última versión disponible del CTS en el momento en que se completa el software del dispositivo.
-
SE DEBE usar la implementación de referencia en el árbol de código abierto de Android tanto como sea posible.
10.2. Verificador del CTS
El verificador del CTS se incluye con el Conjunto de pruebas de compatibilidad y está diseñado para que lo ejecute un operador humano a fin de probar funciones que un sistema automatizado no pueda probar, como el funcionamiento correcto de la cámara y los sensores.
Implementaciones en dispositivos:
- [C-0-1] DEBE ejecutar correctamente todos los casos aplicables en el verificador del CTS.
El verificador del CTS tiene pruebas para muchos tipos de hardware, incluidos algunos que son opcionales.
Implementaciones en dispositivos:
- [C-0-2] DEBE superar todas las pruebas de hardware que posee. por ejemplo, si un dispositivo posee un acelerómetro, DEBE ejecutar correctamente el caso de prueba del acelerómetro en el verificador del CTS.
PUEDEN omitirse o omitirse los casos de prueba de las funciones indicadas como opcionales en este Documento de definición de compatibilidad.
- [C-0-2] Todos los dispositivos y las compilaciones DEBEN ejecutar correctamente el verificador del CTS, como se indicó anteriormente. Sin embargo, dado que muchas compilaciones son muy similares, no se espera que los implementadores de dispositivos ejecuten explícitamente el verificador del CTS en compilaciones que difieren solo de maneras triviales. Específicamente, las implementaciones en dispositivos que difieren de una que aprobó el verificador del CTS solo por el conjunto de configuraciones regionales incluidas, marcas, etc. PUEDEN omitir la prueba del verificador del CTS.
11. Software actualizable
-
[C-0-1] Las implementaciones del dispositivo DEBEN incluir un mecanismo para reemplazar todo el software del sistema. No es necesario que el mecanismo realice actualizaciones “en vivo”, es decir, PUEDE ser necesario reiniciar el dispositivo. Se puede utilizar cualquier método, siempre que pueda reemplazar todo el software preinstalado en el dispositivo. Por ejemplo, cualquiera de los siguientes enfoques cumplirá con este requisito:
- Descargas “inalámbricas” con actualización sin conexión mediante el reinicio
- "Conexión mediante dispositivo móvil" se actualiza a través de USB desde una PC host.
- "Sin conexión" se actualiza a través del reinicio y la actualización desde un archivo en almacenamiento extraíble.
-
[C-0-2] El mecanismo de actualización utilizado DEBE admitir actualizaciones sin limpiar los datos del usuario. Es decir, el mecanismo de actualización DEBE preservar los datos privados y los datos compartidos de la aplicación. Ten en cuenta que el software upstream de Android incluye un mecanismo de actualización que cumple con este requisito.
-
[C-0-3] Se DEBE firmar toda la actualización y el mecanismo de actualización integrado en el dispositivo DEBE verificar la actualización y la firma con una clave pública almacenada en el dispositivo.
- [C-SR] Se RECOMIENDA EJECUTIVO al mecanismo de firma para aplicar la codificación hash a la actualización con SHA-256 y validar el hash con la clave pública mediante ECDSA NIST P-256.
Si las implementaciones de dispositivos incluyen compatibilidad con una conexión de datos no medida, como el perfil 802.11 o PAN (red de área personal) Bluetooth, entonces:
- [C-1-1] DEBE admitir descargas OTA con actualización sin conexión a través del reinicio.
Para las implementaciones en dispositivos que se lanzan con Android 6.0 y versiones posteriores, el mecanismo de actualización DEBE admitir la verificación de que la imagen del sistema sea idéntica al resultado esperado después de una actualización inalámbrica. La implementación inalámbrica basada en bloques del Proyecto de código abierto de Android ascendente, agregado a partir de Android 5.1, cumple con este requisito.
Además, las implementaciones en dispositivos DEBEN admitir las actualizaciones del sistema A/B. AOSP implementa esta función mediante la HAL de control de inicio.
Si se encuentra un error en la implementación de un dispositivo después de su lanzamiento, pero dentro del ciclo de vida razonable del producto, que se determina en consulta con el Equipo de compatibilidad de Android para afectar la compatibilidad de aplicaciones de terceros, haz lo siguiente:
- [C-2-1] El implementador de dispositivos DEBE corregir el error a través de una actualización de software disponible que se pueda aplicar según el mecanismo que se acaba de describir.
Android incluye funciones que permiten que la app del propietario del dispositivo (si está presente) controle la instalación de actualizaciones del sistema. Si el subsistema de actualización del sistema para dispositivos informa android.software.device_admin, sucederá lo siguiente:
- [C-3-1] SE DEBE implementar el comportamiento que se describe en la clase SystemUpdatePolicy.
12. Registro de cambios del documento
Para obtener un resumen de los cambios en la definición de compatibilidad de esta versión, consulta lo siguiente:
Para obtener un resumen de los cambios realizados en las secciones de persona:
- Introducción
- Tipos de dispositivos
- Software
- Empaquetado de la aplicación
- Multimedia
- Herramientas y opciones para desarrolladores
- Compatibilidad de hardware
- Rendimiento y potencia
- Modelo de seguridad
- Pruebas de compatibilidad de software
- Software actualizable
- Registro de cambios del documento
- Comunicarte con nosotros
12.1 Sugerencias para ver el registro de cambios
Los cambios se marcan de la siguiente manera:
-
CDD
Cambios sustanciales en los requisitos de compatibilidad. -
Documentos
Cambios estéticos o relacionados con la compilación.
Para una mejor visualización, adjunta los parámetros de URL pretty=full
y no-merges
a las URLs de tu registro de cambios.
13. Comunícate con nosotros
Puedes unirte al foro de compatibilidad de Android y solicitar aclaraciones o plantear problemas que creas que no se tratan en el documento.