Exécuter les tests de lecture multimédia CTS Verifier

Cette page explique comment exécuter les tests de lecture multimédia dans CTS Verifier (CTS-V), inclus dans Android 17.

La suite de tests de lecture multimédia située dans le harnais de test CTS-V sous cts/apps/SecurePlaybackTestApp vérifie que la lecture sécurisée affiche les images sur l'écran de l'appareil sans perte d'images.

La suite de tests de lecture multimédia teste les API suivantes :

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

La suite de tests de lecture multimédia vérifie les codecs suivants : AVC, HEVC, VP9 et AV1.

Remarque : Cette suite de tests est un test de bout en bout pour la lecture sécurisée. Contrairement aux tests GTS, les tests de lecture multimédia CTS Verifier peuvent analyser ce qui est affiché sur l'écran de l'appareil.

Configurer l'environnement de test

Pour exécuter des tests de lecture sécurisée, configurez les éléments suivants :

• Un appareil testé (DUT)
• Une machine hôte
• Outil d'analyse de la lecture (PAT) (Nous vous recommandons d'acheter un PAT auprès de Tempo Manufacturing.)

Configurer le DUT

Pour configurer un DUT, procédez comme suit :

1. Connectez le DUT à une machine hôte via USB.
2. Accordez à l'hôte l'autorisation d'accéder à l'appareil en test via ADB.
3. Installez l'application CTS-V (CtsVerifier.apk) sur l'appareil. Pour en savoir plus, consultez Exécuter des tests CTS-V.
4. Connectez le DUT à Internet.
5. Connectez le PAT à l'hôte.
   1. Placez le DUT à la verticale, puis posez le côté rembourré du PAT à plat sur l'écran, en veillant à ce que la flèche blanche du PAT pointe vers le haut.
   2. Enroulez les deux bandes autour de l'appareil à tester et tirez sur le cordon à l'extrémité blanche pour les serrer.

Configurer l'hôte

Pour configurer l'environnement de test, téléchargez les fichiers de configuration PAT et extrayez le contenu dans un nouveau répertoire pat-cts :

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

Cette commande configure l'interface de ligne de commande PAT et accède à un environnement virtuel avec Python installé. Si l'environnement n'est pas saisi automatiquement, exécutez la commande suivante :

source venv/bin/activate

Nous vous recommandons de mettre à jour le PAT pour qu'il corresponde à la version du micrologiciel incluse dans les fichiers d'installation. Pour vérifier la version du micrologiciel, exécutez la commande suivante :

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

Si la version du micrologiciel est antérieure à 2.4.0, mettez-le à jour. Exécutez la commande suivante :

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

Pour les tests CTS, vous devez installer le framework de test Mobly et snippet-uiautomator dans l'environnement virtuel :

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

Avant d'exécuter les tests, vous devez également définir une variable d'environnement qui identifie l'emplacement des ressources de test lorsque l'environnement virtuel est actif. Pour cela, saisissez la commande :

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

Pour revenir dans l'environnement, exécutez la commande suivante :

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

Créez des fichiers de configuration.

À l'aide du framework Mobly, vous devez créer un fichier de configuration config.yml pour définir le banc d'essai Mobly.

Voici un exemple de fichier config.yml. Un modèle est fourni dans le répertoire 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

Exécuter des tests

Pour exécuter les tests de lecture multimédia CTS-V :

1. Dans l'environnement virtuel Python de la machine hôte, accédez au répertoire SecurePlaybackTestApp/.

2. Exécutez le test :

   python ./secure_playback_test.py -c config.yml

   Au bout de 10 secondes environ, une vidéo commence à être lue sur l'appareil.

3. Alignez les rainures du PAT avec les cinq barres noires et blanches de la vidéo, comme indiqué dans le schéma suivant. Assurez-vous que le PAT est aligné sur la flèche pointant vers la gauche par rapport à l'orientation de la vidéo.

   

   Figure 1. Le PAT est correctement aligné.

   Remarque : Si les barres de la vidéo sont trop larges pour tenir dans les encoches, comme dans le diagramme ci-dessous, le script vous invite à saisir un nombre compris entre 0,0 et 1,0 pour réduire la taille de la vidéo jusqu'à ce que les encoches correspondent à la largeur des barres. Vous pouvez également définir cette valeur video_scaling dans config.yml, comme indiqué dans Créer des fichiers de configuration.

   

   Figure 2. Le PAT doit être mis à l'échelle.

4. Après avoir aligné le PAT, enroulez les deux câbles autour de l'appareil et serrez-les à l'aide de la languette qui dépasse du côté gauche du PAT. Vérifiez que l'alignement n'a pas changé et réalignez si nécessaire. Pour ce faire, vous pouvez déconnecter le DUT de l'hôte, mais assurez-vous qu'il est reconnecté avant de continuer. Assurez-vous que le PAT est complètement à plat contre le DUT, comme illustré sur la figure 4. Placez l'appareil dans un endroit où il ne sera pas touché pendant quelques minutes, puis saisissez y pour continuer le test. Vérifiez que l'appareil ne bouge pas après l'alignement.

   

   Figure 3. PAT et DUT, vue de dessus.

   

   Figure 4. PAT et DUT, vue latérale.

   Remarque : Le voyant du PAT doit passer au vert dans les cinq secondes. Si elle reste rouge, vérifiez à nouveau l'alignement et redémarrez le test. Vérifiez que la flèche est orientée dans le bon sens, comme indiqué sur la figure 1.

Lorsque le test réussit, le bouton Pass (Réussite) est activé. Enregistrez un test réussi en appuyant sur ce bouton.