Ejecuta pruebas de reproducción de contenido multimedia del verificador de CTS

En esta página, se incluyen las instrucciones para ejecutar las pruebas de reproducción de contenido multimedia en CTS Verifier (CTS-V), que se incluye en Android 17.

El paquete de pruebas de reproducción de contenido multimedia ubicado en el agente de prueba de CTS-V en cts/apps/SecurePlaybackTestApp verifica que la reproducción segura muestre fotogramas en la pantalla del dispositivo sin pérdidas de fotogramas.

El paquete de pruebas de reproducción de medios prueba las siguientes APIs:

• android.media.MediaCodec#queueSecureInputBuffer
• android.media.MediaDrm#getKeyRequest
• android.media.MediaDrm#provideKeyResponse
• android.media.MediaCrypto#MediaCrypto

El paquete de pruebas de reproducción de medios verifica los siguientes códecs: AVC, HEVC, VP9 y AV1.

Configura el entorno de prueba

Para ejecutar pruebas de reproducción segura, configura lo siguiente:

• Un dispositivo en prueba (DUT)
• Una máquina anfitrión
• Herramienta de análisis de reproducción (PAT) para dispositivos móviles Puedes comprar un PAT en Tempo Manufacturing.

Configura el DUT

Para configurar un DUT, sigue estos pasos:

1. Conecta el DUT a una máquina anfitrión a través de USB.
2. Otorga permisos para que el host acceda al DUT a través de ADB.
3. Instala la app de CTS-V (CtsVerifier.apk) en el dispositivo. Para obtener más información, consulta Cómo ejecutar pruebas de CTS-V.
4. Conecta el DUT a Internet.
5. Conecta el PAT al host.
   1. Con el DUT en orientación vertical, coloque el lado acolchado de la PAT sobre la pantalla de forma plana con la flecha blanca de la PAT apuntando hacia arriba.
   2. Coloca las dos correas alrededor del DUT y tira del cordón con el extremo blanco para ajustarlas.

Configura el host

Para configurar el entorno de prueba, descarga los archivos de configuración de PAT y extrae el contenido en un nuevo directorio pat-cts:

cd pat-cts/v2.4.0
./setup.sh

Este comando configura la interfaz de línea de comandos de PAT y accede a un entorno virtual con Python instalado. Si no ingresa automáticamente al entorno, ejecuta el siguiente comando:

source venv/bin/activate

Te recomendamos que actualices el PAT para que coincida con la versión de firmware incluida en los archivos de configuración. Para verificar la versión de tu firmware, ejecuta el siguiente comando:

(venv) patctl --usb --info | grep "Firmware version"

Si la versión del firmware es anterior a la 2.4.0, actualízalo. Ejecución:

(venv) patctl --usb --update pat_fw_v2.4.0rc2.bin

Para las pruebas de CTS, debes instalar el framework de pruebas de Mobly y snippet-uiautomator en el entorno virtual:

(venv) pip install mobly
(venv) pip install snippet-uiautomator

Antes de ejecutar las pruebas, también debes establecer una variable de entorno que identifique la ubicación de los recursos de prueba mientras el entorno virtual está activo. Para realizar esta acción debes ejecutar lo siguiente:

(venv) cd SecurePlaybackTestApp
(venv) source build/envsetup.sh

Para volver a ingresar al entorno, ejecuta el siguiente comando:

source pat-cts/v2.4.0/venv/bin/activate

Crea los archivos de configuración.

Con el framework de Mobly, debes crear un archivo de configuración config.yml para definir el banco de pruebas de Mobly.

El siguiente es un archivo config.yml de ejemplo. Se proporciona una plantilla en el directorio SecurePlaybackTestApp/.

TestBeds:
  # A testbed where adb will find Android devices.
  - Name: PlaybackAnalysisTestBed
    Controllers:
        AndroidDevice:
        - serial: 8A9X0NS5Z  # quotes are needed if serial id is entirely numeric
          label: dut
    TestParams:
        video_scaling: 1.0  # from 0.0 to 1.0, used if the test video is too large to fit the Playback Analysis Tool

Cómo ejecutar pruebas

Para ejecutar las pruebas de reproducción de contenido multimedia de CTS-V, haz lo siguiente:

1. Desde el entorno virtual de Python en la máquina anfitrión, navega al directorio SecurePlaybackTestApp/.

2. Ejecuta la prueba:

   python ./secure_playback_test.py -c config.yml

   Después de unos 10 segundos, comenzará a reproducirse un video en el dispositivo.

3. Alinea las ranuras de la PAT con las cinco barras blancas y negras del video, como se muestra en el siguiente diagrama. Asegúrate de que la PAT esté alineada con la flecha que apunta hacia la izquierda con respecto a la orientación del video.

   

   Figura 1: La PAT está alineada correctamente.

   

   Figura 2: El PAT necesita escalamiento.

4. Después de alinear la PAT, envuelve los dos cables alrededor del dispositivo y ajústalos con la lengüeta de tracción que sobresale del lado izquierdo de la PAT. Verifica que la alineación no haya cambiado y vuelve a alinearla si es necesario. Para ello, puedes desconectar el DUT del host, pero verifica que el DUT esté reconectado antes de continuar. Asegúrate de que la PAT quede completamente plana contra el DUT, como se muestra en la Figura 4. Coloca el dispositivo en un lugar donde no se toque durante unos minutos y presiona y para continuar con la prueba. Verifica que el dispositivo no se mueva después de la alineación.

   

   Figura 3: PAT y DUT, vista superior.

   

   Figura 4: PAT y DUT, vista lateral.

Cuando la prueba se completa correctamente, se habilita el botón Aprobar. Presiona este botón para registrar una prueba aprobada.