Checklist pengujian HAL Kamera

Halaman ini mencantumkan semua pengujian yang tersedia untuk mengevaluasi lapisan abstraksi hardware kamera Android (HAL). API ini ditujukan untuk produsen peralatan asli (OEM) dan vendor pemroses aplikasi (AP) sehingga mereka dapat memastikan penerapan HAL kamera yang tepat dengan cacat minimum. Meskipun ini adalah penambahan sukarela ke Android Compatibility Test Suite (CTS), hal ini sangat meningkatkan cakupan pengujian kamera dan pasti akan mengidentifikasi potensi bug.

Dengan lulus pengujian ini, OEM akan memvalidasi apakah mereka telah mengintegrasikan antarmuka lapisan abstraksi hardware kamera Android (HAL) 3 dengan tepat. Jika sesuai dengan semua item dalam checklist, implementasi perangkat dapat dianggap lengkap sehubungan dengan antarmuka Android Camera HAL. Hal ini akan memungkinkan perangkat mendukung paket android.hardware.camera2 yang digunakan aplikasi kamera.

Spesifikasi kamera HAL3

Spesifikasi Android Camera HAL3 adalah sumber informasi yang kredibel tentang hal yang harus dipenuhi perangkat; halaman ini memberikan ringkasan semua pengujian yang dapat digunakan sebagai checklist. Implementator HAL Kamera (misalnya, vendor AP) harus memeriksa spesifikasi Camera HAL3 baris demi baris dan memastikan perangkat mereka sesuai dengan spesifikasi tersebut.

Spesifikasi HAL saat ini ditentukan dalam file ini dalam Android 5.0 dan Android Platform Development Kit (PDK) generik yang lebih baru:

Jenis pengujian kamera

Berikut adalah jenis pengujian utama yang tersedia untuk kamera Android terbaru bersama dengan referensi ke petunjuk terkait di bawah:

Semua jenis pengujian ini dijelaskan secara mendetail di bawah. Pengujian ini ditampilkan dalam urutan kronologis yang diharapkan OEM untuk menjalankannya.

Misalnya, jika perangkat gagal dalam pengujian native, perangkat pasti akan gagal dalam pengujian Compatibility Test Suite (CTS) berikutnya. Selain itu, jika perangkat gagal dalam CTS, tidak ada gunanya melanjutkan ke Image Test Suite (ITS). Sebaiknya atasi kegagalan di setiap jenis pengujian sebelum melanjutkan ke kumpulan pengujian berikutnya.

Pengujian Vendor Test Suite (VTS)

Android Vendor Test Suite (VTS) adalah suite pengujian yang berfungsi pada level antarmuka HIDL. Untuk informasi selengkapnya tentang penggunaan VTS, lihat Vendor Test Suite.

Pengujian Compatibility Test Suite (CTS)

Pengujian Compatibility Test Suite (CTS) Android Kamera berfokus pada kompatibilitas perangkat. Untuk informasi tentang cara menyiapkan lingkungan pengujian, lihat Menyiapkan CTS.

Jalur awal untuk pengujian CTS kamera adalah: platform/cts.

Saat menjalankan CTS kamera untuk perangkat yang mendukung kamera eksternal (seperti webcam USB), Anda harus mencolokkan perangkat saat menjalankan CTS atau pengujian akan otomatis gagal. Contoh kamera eksternal meliputi: Logitech HD Pro Webcam C920 dan Microsoft LifeCam HD-3000.

Lihat pengantar CTS dan subhalamannya untuk mengetahui petunjuk umum tentang cara menjalankan CTS.

Pengujian CTS untuk android.hardware.Camera API

Temukan pengujian kamera ini di bagian cts/tests/tests/:

  • hardware/src/android/hardware/cts/CameraTest.java
  • hardware/src/android/hardware/cts/CameraGLTest.java
  • hardware/src/android/hardware/cts/Camera_SizeTest.java
  • permission/src/android/permission/cts/CameraPermissionTest.java

Pengujian CTS untuk android.hardware.camera2 API

Temukan pengujian kamera ini di bagian cts/tests/tests/:

  • hardware/src/android/hardware/camera2/cts/*
  • permission/src/android/permission/cts/Camera2PermissionTest.java

Pengujian kamera CTS Verifier

Temukan pengujian kamera ini di bagian: cts/apps/CtsVerifier/src/com/android/cts/verifier/camera/*

Pengujian Image Test Suite (ITS)

Pengujian Camera Image Test Suite (ITS) berfokus pada kebenaran gambar. Untuk melakukan pengujian, jalankan skrip Python di workstation dengan perangkat Android yang terhubung melalui USB.

Infrastruktur dan pengujian ITS Kamera terletak di direktori cts/apps/CameraITS. Setiap pengujian berada di subdirektori tests/scene#.

Untuk informasi selengkapnya tentang cara menyiapkan dan menjalankan pengujian, lihat Kamera ITS.

Untuk deskripsi scene dan pengujian, lihat Pengujian ITS Kamera.

Pengujian ITS lulus atau gagal. Semua pengujian yang diwajibkan di setiap folder scene harus lulus. Pengujian yang tidak diwajibkan dapat gagal dan tetap dihitung sebagai lulus dalam CtsVerifier.

ITS menguji skenario pengujian yang tidak diuji di CTS dan merupakan komponen penting dari rencana pengujian HAL 3.2.

Pengujian Framework Media

Lulus semua pengujian media terkait kamera di MediaFrameworkTest. Perhatikan bahwa pengujian ini memerlukan mediaframeworktest.apk yang diinstal di perangkat Android. Anda harus make mediaframeworktest, lalu menggunakan adb untuk menginstal .apk yang dihasilkan. Contoh perintah disertakan di bawah.

Jalur awal untuk pengujian framework media terkait Kamera adalah: platform/frameworks/base

Temukan kode sumber untuk pengujian di sini: frameworks/base/media/tests/MediaFrameworkTest

Untuk menyiapkan pengujian ini:

make mediaframeworktest
adb install out/target/product/name/data/app/mediaframeworktest.apk

Dengan variabel name mewakili direktori yang berisi produk vendor.

Temukan semua pengujian di direktori berikut atau subdirektorinya:

frameworks/base/media/tests/MediaFrameworkTest/src/com/android/mediaframeworktest

Setiap subdirektori mewakili class pengujian:

  • functional/
  • integration/
  • performance/
  • power/
  • stress/
  • unit/

Menjalankan pengujian Framework Media

Untuk melihat semua pengujian yang tersedia:

adb shell pm list instrumentation

Tindakan ini akan menghasilkan hasil yang menyerupai:

instrumentation:com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaRecorderStressTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
(target=com.android.mediaframeworktest)
instrumentation:com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner
(target=com.android.mediaframeworktest)

Identifikasi dan ekstrak komponen (antara instrumentation: dan (target=com.android.mediaframeworktest) dari setiap baris pengujian. Komponen terdiri dari nama paket target (com.android.mediaframeworktest) dan nama runner pengujian (MediaFrameworkTestRunner).

Sebagai contoh:

com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner
com.android.mediaframeworktest/.MediaRecorderStressTestRunner
com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner
com.android.mediaframeworktest/.MediaFrameworkPowerTestRunner

Anda kemudian dapat meneruskan setiap komponen ke adb shell am instrument seperti berikut:

adb shell am instrument -w component.name

Dalam hal ini, component.name sama dengan nilai yang diekstrak di atas. Contoh:

adb shell am instrument -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Perhatikan bahwa meskipun jalur class adalah paket Java + nama class, paket instrumentasi tidak harus sama dengan paket Java. Pastikan Anda menggunakan paket AndroidManifest.xml saat menggabungkan nama komponen, bukan paket Java tempat class runner pengujian berada.

Untuk menjalankan satu class pengujian, teruskan argumen class -e, seperti ini:

adb shell am instrument -e class com.android.mediaframeworktest.integration.CameraBinderTest -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Untuk menjalankan satu metode saja dalam class pengujian, tambahkan tanda pound (#) dan nama metode (dalam hal ini, testConnectPro) ke nama class, seperti ini:

adb shell am instrument -e class 'com.android.mediaframeworktest.integration.CameraBinderTest#testConnectPro' -w com.android.mediaframeworktest/.MediaFrameworkIntegrationTestRunner

Pengujian fungsional setelan media

Berikut adalah contoh pengujian fungsional yang dijalankan. Pengujian ini memverifikasi fungsi dasar dari berbagai kombinasi setelan kamera. (yaitu, Flash, eksposur, WB, scene, ukuran gambar, dan geoTag)

Jalankan perintah pengujian:

adb shell am instrument -w -r  -e delay_msec 15 -e log true -e class com.android.mediaframeworktest.functional.camera.CameraPairwiseTest com.android.mediaframeworktest/com.android.mediaframeworktest.CameraStressTestRunner

Pengujian integrasi media

Berikut adalah contoh pengujian integrasi yang dijalankan, dalam hal ini mediaframeworktest/integration/CameraBinderTest.java dan mediaframeworktest/CameraStressTestRunner.java:

adb  shell am instrument -e class \ 'com.android.mediaframeworktest.integration.CameraBinderTest' -w \ 'com.android.mediaframeworktest/.CameraStressTestRunner'

Jika berhasil, outputnya akan menyerupai:

-----

com.android.mediaframeworktest.integration.CameraBinderTest:...........
Test results for CameraStressTestRunner=...........
Time: 3.328

OK (11 tests)

-----

Pengujian performa media

Pengujian memori pratinjau ini akan membuka dan merilis pratinjau kamera sebanyak 200 kali. Dalam setiap 20 iterasi, snapshot mediaserver ps akan direkam dan akan membandingkan penggunaan memori yang berbeda setelah 200 iterasi. Pengujian akan gagal jika perbedaannya lebih dari 150 kM.

Jalankan perintah pengujian:

adb shell am instrument -w -r  -e class com.android.mediaframeworktest.performance.MediaPlayerPerformance#testCameraPreviewMemoryUsage com.android.mediaframeworktest/.MediaFrameworkPerfTestRunner

Output yang lebih mendetail dapat ditemukan di: /sdcard/mediaMemOutput.txt

Pengujian unit media

Perintah untuk menjalankan pengujian unit semuanya serupa. Misalnya, untuk CameraMetadataTest.java, perintahnya adalah:

adb shell am instrument -e class 'com.android.mediaframeworktest.unit.CameraMetadataTest' -w 'com.android.mediaframeworktest/.CameraStressTestRunner'

Pengujian stres media

Pengujian ini bertujuan untuk menguji pengambilan gambar dan perekaman video kamera.

Jalankan perintah pengujian:

adb shell am instrument -w com.google.android.camera.tests/com.android.camera.stress.CameraStressTestRunner

Semua pengujian seharusnya berhasil.

Pengujian TestingCam manual

Aplikasi TestingCam harus dijalankan secara manual dengan pemeriksaan berikut dilakukan. Sumber untuk TestingCam ada di sini: pdk/apps/TestingCamera/

Fokus tak terbatas dengan kemiringan kamera

Mulai TestingCam, aktifkan pratinjau, dan pastikan mode fokus otomatis disetel ke tanpa batas. Dengan menggunakan tombol Ambil gambar, ambil foto subjek yang jauh (minimal 10 m) dengan kamera mengarah secara horizontal, ke atas (dekat ke vertikal), dan ke bawah (mendekati vertikal); contoh foto ke atas dapat berupa daun/cabang pohon yang tinggi dari bawah dan contoh bidikan ke bawah dapat berupa jalan seperti yang terlihat dari atap. Dalam semua kasus, subjek yang jauh harus tajam dan fokus. Simpan dan lihat gambar dalam tampilan galeri sehingga Anda dapat memperbesar dan memeriksa ketajaman dengan lebih mudah.

Perhatikan bahwa agar kamera dengan aktuator VCM dapat lulus pengujian ini, kamera akan memerlukan sistem kontrol AF loop tertutup, atau akan memerlukan semacam koreksi SW berdasarkan penggunaan data akselerometer untuk menentukan orientasi kamera. Kalibrasi pabrik yang andal untuk posisi infinity lensa juga akan diperlukan.

Pengujian TestingCam2 manual

Aplikasi TestingCam2 harus dijalankan secara manual dengan pemeriksaan berikut yang dilakukan. Sumber untuk TestingCam2 ada di sini: pdk/apps/TestingCamera2/

Perekaman JPEG

Mulai TestingCam2, lalu tekan tombol JPEG. Gambar yang muncul di sebelah kanan gambar jendela bidik akan terlihat sama dengan jendela bidik, termasuk memiliki orientasi yang sama.