Kamera-ITS-Faltkameratest

Ab Android 13 bietet Camera ITS Testunterstützung für faltbare Geräte. Bei faltbaren Geräten sind Kameras verfügbar oder nicht verfügbar, je nachdem, ob sich das Gerät im zusammengeklappten oder aufgeklappten Zustand befindet.

Die Kamera-IDs ändern sich je nach Gerätetyp, Modell und Marke; und die Verfügbarkeit physischer Frontkameras variiert je nach Bundesland. Aus diesem Grund bestimmt Camera ITS dynamisch die Szenen- und Kamerakombinationen, die zum Testen verwendet werden sollen. Da Kameras sowohl im zusammengeklappten als auch im aufgeklappten Zustand getestet werden müssen, erfordert die Prüfung faltbarer Kameras, dass der Prüfling während des Testvorgangs erneut montiert wird.

Testen der Vorder- und Rückkamera

Die auf einem faltbaren Gerät verfügbaren Kamerasensoren unterscheiden sich je nachdem, ob sich das Gerät im zusammengeklappten oder aufgeklappten Zustand befindet. Bei faltbaren Geräten variiert die Verfügbarkeit der Frontkamera je nach Bundesland. Beispielsweise ist die Frontkamera im zusammengeklappten Zustand nicht verfügbar. Aufgrund dieser Änderung bei der Verfügbarkeit von Frontkameras müssen Frontkameras sowohl im zusammengeklappten als auch im aufgeklappten Zustand getestet werden. Beim Kamera-ITS wird davon ausgegangen, dass die Verfügbarkeit der Rückfahrkamera unabhängig davon, ob das Gerät ein- oder ausgeklappt ist, gleich bleibt, sodass Rückfahrkameras nur einmal getestet werden müssen.

Abhängig vom Zustand des Geräts filtert Camera ITS die nicht verfügbaren Kamerageräte heraus und die Kamerageräte erscheinen nicht in der Liste der Kamera- und Szenenkombinationen.

In der folgenden Tabelle wird das Kamera-ITS-Testverhalten für jede Kameraausrichtung beschrieben.

Kameraausrichtung Kamera-ITS-Testverhalten
Rückfahrkamera Testet die Kamera einmal im zusammengeklappten oder aufgeklappten Zustand
Primäre Frontkamera Testet die Kamera einmal im zusammengeklappten Zustand und einmal im aufgeklappten Zustand.
Physische Frontkamera Testet die Kamera nur in Staaten, in denen die Kamera verfügbar ist.

Testprozedur

In diesem Abschnitt werden die Schritte zum Testen von Kameras für faltbare Geräte beschrieben.

Gerät einrichten

Informationen zur Einrichtung finden Sie unter Einrichtung .

Gewähren Sie Test-API-Zugriff

Damit Camera ITS feststellen kann, ob das Gerät faltbar ist oder nicht, müssen Sie vor dem Aufrufen der Tests Test-API-Zugriff gewähren. Wenn der Zugriff nicht gewährt wird, führt die Ausführung der Kamera-ITS-Tests zum Absturz der App.

Um Zugriff zu gewähren, führen Sie den folgenden ADB-Befehl aus. Dieser Befehl muss einmal für ein einzelnes Gerät ausgeführt werden. Wenn CTS Verifier mit einer anderen Version neu installiert wird, müssen Sie den Befehl erneut ausführen.

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

Konfigurationsdatei

Um anzugeben, dass es sich bei dem Gerät um ein faltbares Gerät handelt, fügen Sie den Parameter foldable_device “ in den Testbeds tablet “ und sensor_fusion in der Datei config.yml hinzu. Camera ITS verwendet diesen Parameter, um die camera_id und Szenenkombinationen für den gefalteten und entfalteten Zustand zu bestimmen.

Das Folgende ist ein Beispiel einer config.yml Datei für ein faltbares Gerät.

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

Führen Sie Tests durch

Um die ITS-Tests auf einem faltbaren Gerät auszuführen, führen Sie den Befehl run_all_tests.py aus. Einzelheiten finden Sie unter „Aufrufen von Tests“ .

Wenn Camera ITS auf einem faltbaren Gerät ausgeführt wird, wird die primäre Frontkamera in beiden Zuständen getestet, eingeklappt und ausgeklappt. Wenn das Gerät zusammengeklappt ist, werden die Ergebnisse unter der Option camera1_ SCENE_NAME _folded in der CTS Verifier-App angezeigt. Abhängig vom Gerätestatus sind bestimmte physische Frontkamera-IDs nicht verfügbar und werden nicht getestet. Die Rückfahrkamera muss nur in einem Zustand getestet werden, vorzugsweise im zusammengeklappten Zustand, und die Ergebnisse für die Rückfahrkamera haben nicht das Suffix _folded .

Um sicherzustellen, dass die gefalteten Szenen bei zusammengeklapptem Gerät ausgeführt werden, und um den Zustand des faltbaren DUT zu überprüfen, führen Sie den folgenden Befehl aus.

adb shell cmd device_state state

Bei der Durchführung von Tests im zusammengeklappten Zustand zeigt Camera ITS im Terminal eine Meldung an, die den Benutzer auffordert, das Gerät ordnungsgemäß auf der ITS-Box einzurichten. Um mit der Ausführung des Tests nach der Eingabeaufforderung fortzufahren, drücken Sie die Eingabetaste .

Wenn Sie alle Szenen sowohl im gefalteten als auch im entfalteten Zustand ausführen, werden zuerst die gefalteten Szenen ausgeführt, gefolgt von den entfalteten Szenen. Dies minimiert den Umfang der beim Testen erforderlichen Neumontage.

Camera ITS fügt außerdem das folded Suffix zum tmp Verzeichnis hinzu, das für Folded-State-Szenen erstellt wurde.

Beispielbefehle

Im Folgenden finden Sie Beispielbefehle für die Testausführung auf faltbaren Geräten.

Befehl Beschreibung
python tools/run_all_tests.py Führt alle Szenen aus.
python tools/run_all_tests.py scenes=scene0 Führt Szene0 aus. Wenn das Gerät zusammengeklappt ist und der Benutzer die primäre Frontkamera testet, ermittelt das Skript den Gerätestatus und fügt dem Szenennamen das Suffix _folded hinzu. Benutzer müssen das Suffix nicht hinzufügen, um die gefalteten Szenen auszuführen.
python tests/scene0/ -c config.yml python tests/scene0/ -c config.yml Führt einen bestimmten Test aus.