Kamera-ITS-Tests für faltbare Geräte

Ab Android 13 unterstützt die Kamera-ITS-Funktion Tests für faltbare Geräte. Bei faltbaren Geräten sind die Kameras je nach Zustand des Geräts (gefaltet oder aufgeklappt) verfügbar oder nicht.

Die Kamera-IDs ändern sich je nach Gerätetyp, Modell und Marke. und die Die Verfügbarkeit physischer Frontkameras ändert sich je nach Zustand. Daher werden die Szenen- und Kamerakombinationen, die für die Tests verwendet werden sollen, dynamisch vom Kamera-ITS bestimmt. Da Kameras sowohl im zusammengeklappten als auch im aufgeklappten Zustand getestet werden müssen, muss das DUT während des Tests neu montiert werden.

Front- und Rückkamera testen

Die auf einem faltbaren Gerät verfügbaren Kamerasensoren unterscheiden sich je nachdem, ob das Gerät zusammengeklappt oder aufgeklappt ist. Bei faltbaren Smartphones hängt die Verfügbarkeit der Frontkamera vom Status ab. Zum Beispiel ist die Vorderseite Kamera im zusammengeklappten Zustand nicht verfügbar. Aufgrund dieser Änderung müssen Frontkameras sowohl im zusammengeklappten als auch im nicht gefalteten Zuständen. Die Kamera-ITS geht davon aus, dass die Verfügbarkeit der Rückkamera unabhängig davon ist, ob das Gerät aufgeklappt oder zugeklappt ist. Daher müssen Rückkameras nur einmal getestet werden.

Je nach Gerätestatus werden die nicht verfügbaren Kameras von der Kamera-ITS-Funktion herausgefiltert und nicht in der Liste der Kamera- und Szenenkombinationen aufgeführt.

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

Kameraausrichtung ITS-Testverhalten der Kamera
Rückkamera Die Kamera wird einmal im zusammengeklappten oder aufgeklappten Zustand getestet.
Haupt-Frontkamera Testet die Kamera einmal im zusammengeklappten und einmal im geöffneten Zustand aufgeklappt ist.
Physische Frontkamera Testet die Kamera nur in Status, in denen sich die Kamera befindet verfügbar.

Testverfahren

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

Gerät einrichten

Informationen zur Einrichtung findest du unter Einrichtung:

Test-API-Zugriff gewähren

Damit die Kamera-ITS feststellen kann, ob das Gerät faltbar ist, müssen Sie vor dem Aufrufen der Tests Test-API-Zugriff gewähren. Wenn kein Zugriff gewährt wird, die ITS-Tests der Kamera führen dazu, dass die App abstürzt.

Führen Sie den folgenden ADB-Befehl aus, um Zugriff zu gewähren. Dieser Befehl muss ausgeführt werden einmal pro Gerät. Wenn CTS Verifier neu installiert wird, Version verwenden, müssen Sie den Befehl noch einmal ausführen.

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

Konfigurationsdatei

Wenn du angeben möchtest, dass es sich um ein faltbares Gerät handelt, füge das foldable_device hinzu in den tablet- und sensor_fusion-Testbeds im config.yml -Datei. ITS der Kamera verwendet diesen Parameter, um camera_id und Szene zu bestimmen Kombinationen für auf- und zugeklappte Zustände.

Im Folgenden finden Sie ein Beispiel für eine 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

Tests ausführen

Führen Sie den Befehl run_all_tests.py aus, um die ITS-Tests auf einem faltbaren Gerät auszuführen. Weitere Informationen finden Sie unter Tests aufrufen.

Wenn die Kamera-ITS-Funktion auf einem faltbaren Gerät ausgeführt wird, wird die primäre Frontkamera in beiden Zuständen getestet, also zugeklappt und aufgeklappt. Wenn das Gerät zusammengeklappt ist, werden die Ergebnisse in der CTS Verifier App unter der Option camera1_SCENE_NAME_folded angezeigt. Je nach Gerätestatus sind bestimmte physische Kamera-IDs an der Vorderseite nicht verfügbar und werden nicht getestet. Die Rückkamera muss nur in einem Zustand getestet werden, vorzugsweise im zusammengefalteten Zustand. Die Ergebnisse für die Rückkamera haben kein _folded-Suffix.

Führen Sie den folgenden Befehl aus, um sicherzustellen, dass die gefalteten Szenen mit dem Gerät in gefaltetem Zustand ausgeführt werden, und den Status des faltbaren DUT zu prüfen.

adb shell cmd device_state state

Bei Tests im geschlossenen Zustand zeigt die Kamera-ITS im Bereich Terminal, um den Nutzer aufzufordern, das Gerät ordnungsgemäß auf dem ITS einzurichten . Drücken Sie die Eingabetaste, um den Test nach der Eingabeaufforderung fortzusetzen.

Wenn Sie alle Szenen sowohl im geöffneten als auch im offenen Zustand ausführen, zuerst ausgeführt werden, gefolgt von den eingeblendeten Szenen. Dadurch wird die Anzahl der erforderlichen Neumounts während des Tests minimiert.

Kamera-ITS fügt dem Verzeichnis tmp außerdem das Suffix folded hinzu die für Falt-Szenen erstellt wurden.

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 „scene0“ aus. Wenn das Gerät zugeklappt ist und der Nutzer primären Frontkamera zu sehen, bestimmt das Skript den Gerätestatus und füge dem Szenennamen das Suffix _folded hinzu. Nutzer müssen keine das Suffix, um die Seitenumbruchsszenen auszuführen.
python tests/scene0/ -c config.yml Führt einen bestimmten Test aus.