Tests de l'ITS de l'appareil photo sur les appareils pliables

À partir d'Android 13, l'outil Appareil photo de l'ITS inclut une prise en charge des tests. pour les appareils pliables. Les appareils pliables sont équipés de caméras disponibles ou indisponible selon que l'appareil est plié ou déplié.

Les identifiants d'appareil photo varient en fonction du type, du modèle et de la marque de l'appareil. et la disponibilité des caméras avant physiques varie en fonction de l'état. En raison de Caméra ITS détermine de manière dynamique les combinaisons de scène et de caméra à utiliser. à des fins de test. Les caméras doivent être testées aussi bien lorsqu'elles sont pliées, soit dépliées. les tests d'appareils pliables nécessitent de réinstaller l'appareil testé processus.

Test des caméras avant et arrière

Les capteurs photo disponibles sur un appareil pliable varient selon que l'appareil soit plié ou déplié. Pour les appareils pliables, la disponibilité de la caméra avant varie en fonction de l'état. Par exemple, la partie avant l'appareil photo n'est pas disponible lorsque l'appareil est plié. En raison de cette modification de la disponibilité de la caméra avant, les caméras avant doivent être testées à la fois à l'état plié et déplié. L'ITS de la caméra suppose que la disponibilité de la caméra arrière reste la même, que l'appareil soit plié ou déplié. Par conséquent, les caméras arrière ne doivent être testées qu'une seule fois.

Selon l'état de l'appareil, l'outil Caméra filtre les images et les caméras n'apparaissent pas dans la liste combinaisons de scènes.

Le tableau suivant décrit le comportement du test ITS de la caméra pour chaque orientation de la caméra.

Orientation de l'appareil photo Comportement des tests ITS de la caméra
Caméra arrière Teste la caméra une fois dans l'état plié ou déplié
Caméra avant principale Teste l'appareil photo une fois plié et une fois posé à l'état déplié.
Caméra avant physique Teste la caméra uniquement dans les États où elle est disponible.

Procédure de test

Cette section décrit la procédure à suivre pour tester les appareils photo sur les appareils pliables.

Configurer un appareil

Pour en savoir plus sur la configuration, consultez la section Configuration.

Accorder l'accès à l'API de test

Pour que l'ITS de la caméra puisse déterminer si l'appareil est pliable ou non, vous devez accorder un accès à l'API de test avant d'appeler les tests. Si l'accès n'est pas accordé, l'exécution des tests ITS de la caméra entraîne le plantage de l'application.

Pour accorder l'accès, exécutez la commande ADB suivante. Cette commande doit être exécutée une fois pour un seul appareil. Si CTS Verifier est réinstallé avec une autre version, vous devez exécuter à nouveau la commande.

adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

Fichier de configuration

Pour spécifier qu'il s'agit d'un appareil pliable, ajoutez le paramètre foldable_device dans les plates-formes de test tablet et sensor_fusion du fichier config.yml. L'ITS de l'appareil photo utilise ce paramètre pour déterminer les combinaisons camera_id et de scène pour les états plié et déplié.

Voici un exemple de fichier config.yml pour un appareil pliable.

TestBeds:
  - Name: TABLET_SCENES
    # Test configuration for scenes[0:4, 6]
    Controllers:
        AndroidDevice:
          - serial: 8A9X0NS5Z
            label: dut
          - serial: 5B16001229
            label: tablet

    TestParams:
      brightness: 192
      chart_distance: 22.0
      debug_mode: "False"     # "quotes" needed
      chart_loc_arg: ""
      camera: 0
      scene: scene2_a
  lighting_cntl: arduino    # can be "arduino" or "None"
  lighting_ch: 1
  foldable_device: "True"     # "False" for non-foldable DUTs

Exécuter des tests

Pour exécuter les tests ITS sur un appareil pliable, exécutez la commande run_all_tests.py. Pour en savoir plus, consultez Appeler des tests.

Lorsque vous exécutez l'ITS de l'appareil photo sur un appareil pliable, la caméra avant principale est testée dans les deux états, plié et déplié. Si l'appareil est plié, les résultats sont affiché sous camera1_SCENE_NAME_folded dans l'application CTS Verifier. Selon l'état de l'appareil, certains composants les identifiants de caméras physiques ne sont pas disponibles et n'ont pas été testés. Vous ne devez tester la caméra arrière que dans un état, de préférence plié et les résultats pour la caméra arrière ne comportent pas le suffixe _folded.

Pour vous assurer que les scènes pliées s'exécutent avec l'appareil plié et vérifier l'état de l'appareil testé pliable, exécutez la commande suivante :

adb shell cmd device_state state

Lors de l'exécution de tests lorsque l'appareil est plié, le service ITS de l'appareil photo affiche un message dans le terminal pour inviter l'utilisateur à configurer correctement l'appareil sur l'ITS . Pour continuer à exécuter le test après l'invite, appuyez sur Entrée.

Si vous exécutez toutes les scènes dans l'état plié et déplié, sont exécutées en premier, suivies des scènes dépliées. Cela réduit de réinstallation nécessaire pendant les tests.

L'ITS de l'appareil photo ajoute également le suffixe folded au répertoire tmp créé pour les scènes d'état plié.

Exemples de commandes

Vous trouverez ci-dessous des exemples de commandes pour l'exécution de tests sur des appareils pliables.

Commande Description
python tools/run_all_tests.py Exécution de toutes les scènes
python tools/run_all_tests.py scenes=scene0 Exécute la scène 0. Si l'appareil est plié et que l'utilisateur teste caméra avant principale, le script détermine l'état de l'appareil et Ajoutez le suffixe _folded au nom de la scène. Les utilisateurs n'ont pas besoin d'ajouter le suffixe pour exécuter les scènes pliées.
python tests/scene0/ -c config.yml Exécute un test spécifique.