บันทึกประจำรุ่นของชุดเครื่องมือทดสอบรูปภาพจากกล้องของ Android 17

Android 17 เวอร์ชันที่เผยแพร่มีการเปลี่ยนแปลงหลายอย่างใน Camera ITS หน้านี้สรุปการเปลี่ยนแปลงของ Camera ITS สำหรับ Android 17

Python และเวอร์ชันแพ็กเกจ

สำหรับ Android 17 ขึ้นไป เราขอแนะนำอย่างยิ่งให้ใช้ซอฟต์แวร์การจัดการแพ็กเกจเพื่อรวมแพ็กเกจเวอร์ชันที่ถูกต้องเข้าด้วยกันเพื่อสร้างสภาพแวดล้อมเสมือนสำหรับการพัฒนาเวอร์ชันที่เผยแพร่ของ Android ดูเครื่องมือการจัดการแพ็กเกจตัวอย่าง ที่จัดการแพ็กเกจส่วนใหญ่ที่จำเป็นได้ที่เอกสารประกอบของ Python 3 สำหรับ venv

หากต้องการสร้างสภาพแวดล้อมเสมือนด้วย venv ให้ทำตามขั้นตอนต่อไปนี้

  1. ติดตั้ง Python 3.12 และ python3-venv

    sudo apt install python3.12
sudo apt install python3.12-venv python3.12-dev

  2. ยืนยันการติดตั้ง Python

    python3.12 --version

  3. อัปเดต apt และติดตั้ง pip

    sudo apt-get update
sudo apt install python3-pip

  4. สร้างสภาพแวดล้อมเสมือน

    python3.12 -m venv its_android17_env

  5. เปิดใช้งานสภาพแวดล้อมเสมือน

    source its_android17_env/bin/activate

  6. สร้าง its_android17_env.txt พร้อมรายการแพ็กเกจที่จำเป็น

    contourpy==1.3.1
cycler==0.12.1
fonttools==4.56.0
imagecodecs==2026.3.6
ImageIO==2.37.3
kiwisolver==1.4.8
lazy-loader==0.5
matplotlib==3.10.0
mobly==1.12.3
mobly-android-partner-tools==1.5.2
networkx==3.6.1
numpy==2.2.2
opencv-python==4.11.0.86
packaging==24.2
pillow==11.1.0
portpicker==1.6.0
protobuf==6.33.6
psutil==6.1.1
pyparsing==3.2.1
pyserial==3.5
python-dateutil==2.9.0.post0
pyudev==0.24.4
PyYAML==6.0.2
scikit-image==0.26.0
scipy==1.15.1
six==1.17.0
snippet-uiautomator==1.1.2
tifffile==2026.3.3

  7. ติดตั้งแพ็กเกจที่ระบุไว้ใน its_android17_env.txt

    pip install -r its_android17_env.txt

  8. ติดตั้ง FFmpeg เวอร์ชัน 7.0.2 ด้วยตัวดาวน์โหลด FFmpeg

    pip install ffmpeg-downloader
ffdl install 7.0.2

    (ไม่บังคับ) หากตัวดาวน์โหลด FFmpeg ไม่ทำงาน ให้ดาวน์โหลด 7.0.2 จากแหล่งข้อมูลออนไลน์

  9. ยืนยันการติดตั้ง FFmpeg เวอร์ชัน 7.0.2

    ffmpeg -version

    หาก FFmpeg ยังคงไม่ใช่เวอร์ชัน 7.0.2 ให้สร้างลิงก์สัญลักษณ์สำหรับไบนารี (ปรับ PATH ตามตำแหน่งที่คุณบันทึก its_android17_env)

    ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffmpeg ~/PATH/its_android17_env/bin/ffmpeg
ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffprobe ~/PATH/its_android17_env/bin/ffprobe

  10. ยืนยันว่ามีการติดตั้งแพ็กเกจใดบ้าง

    pip freeze

  11. (ไม่บังคับ) คำสั่งเพื่อปิดใช้งานสภาพแวดล้อม

    deactivate

ฉากใหม่หรือฉากที่อัปเดต

Android 17 ขอแนะนำฉากต่อไปนี้

ฉาก คำอธิบาย
gen2_chart ฉากใหม่ที่ใช้แผนภูมิกระดาษ test_chart_gen2 แทนฉากแท็บเล็ตเพื่อปรับปรุงความสอดคล้องและความน่าเชื่อถือของการทดสอบ นอกจากนี้ test_chart_gen2 ยังใช้ใน scene_ip ด้วย
wide_gamut ฉากใหม่สำหรับแท็บเล็ตที่รองรับขอบเขตสีที่กว้าง
3 ใช้มาร์กเกอร์ ArUco สำหรับการตรวจหาแผนภูมิเพื่อปรับปรุงความเร็วและความน่าเชื่อถือ การเปลี่ยนแปลงนี้รองรับ FoV และระยะทางที่กว้างขึ้นซึ่งพบในการทดสอบกล้องเทเล การใช้มาร์กเกอร์จะข้ามตรรกะการปรับขนาดปัจจุบันและปัญหาตัวเพิ่มประสิทธิภาพ ดูข้อมูลเพิ่มเติมได้ที่ scene3
flash สามารถเรียกใช้การทดสอบได้โดยใช้แท่นทดสอบ Gen2

การทดสอบใหม่

Android 17 ขอแนะนำการทดสอบต่อไปนี้

ฉาก ชื่อการทดสอบ คำอธิบาย
gen2_chart test_tonemap_sequence ยืนยันว่าพารามิเตอร์ android.tonemap.mode ใช้ได้อย่างถูกต้องสำหรับการกระจายแบบสม่ำเสมอและไม่สม่ำเสมอ
ip test_jca_jpegr_ip ยืนยันว่าความแตกต่างของสมดุลสีขาวระหว่างภาพหน้าจอตัวอย่าง JPEG_R JCA กับรูปภาพที่ถ่ายอยู่ในเกณฑ์ที่เลือก
wide_gamut test_display_p3 ยืนยันว่าเอาต์พุต JPEG P3 มีโปรไฟล์ ICC ที่เหมาะสมและมีสีมากกว่า 1 เปอร์เซ็นต์ที่อยู่นอกขอบเขตสี sRGB

การทดสอบที่ปรับโครงสร้างใหม่

ใน Android 17 การทดสอบต่อไปนี้ได้รับการปรับโครงสร้างใหม่เพื่อเพิ่มความครอบคลุมของการทดสอบและจัดกลุ่มการทดสอบอย่างมีเหตุผลมากขึ้น

ฉาก ชื่อการทดสอบ คำอธิบาย
1_2 tests_param_tonemap_mode เวอร์ชัน scene1_2 ของการทดสอบ tests_param_tonemap_mode เลิกใช้งานแล้วและใช้ได้เฉพาะในอุปกรณ์ที่ใช้ Android 16 หรือต่ำกว่า
1_2 test_tonemap_sequence เวอร์ชัน scene1_2 ของการทดสอบ test_tonemap_sequence ใช้ได้เฉพาะในอุปกรณ์ที่ใช้ Android 16 หรือต่ำกว่า
2_b test_yuv_jpeg_capture_sameness ลดเกณฑ์ความแตกต่างของ RMS เพื่อช่วยให้ระบบแจ้งว่าความคลาดเคลื่อนของสีที่เกี่ยวข้องกับเฉดสีเป็นความล้มเหลวทุกครั้งที่ทำให้ผู้ใช้เห็นความแตกต่าง
3 test_edge_enhancement ใช้มาร์กเกอร์ ArUco เพื่อตรวจสอบทั้งการมีอยู่และการวางแนว วิธีนี้ ช่วยให้ตรวจจับกล้องได้อย่างเสถียรตั้งแต่แอปพลิเคชัน Ultra-Wide (UW) ไปจนถึง แอปพลิเคชันเทเล
3 test_flip_mirror ใช้มาร์กเกอร์ ArUco เพื่อตรวจสอบทั้งการมีอยู่และการวางแนว ระบบจะให้สถานะ PASS ก็ต่อเมื่อตรวจพบมาร์กเกอร์ทั้งหมดและ จัดแนวอย่างถูกต้อง การทดสอบจะล้มเหลวสำหรับแผนภูมิที่เคลื่อนย้ายหรือหมุน
3 test_landscape_to_portrait โหลดแผนภูมิ scene3 ที่อัปเดตแล้วพร้อมมาร์กเกอร์ ArUco
3 test_lens_movement_report ใช้มาร์กเกอร์ ArUco เพื่อตรวจสอบทั้งการมีอยู่และการวางแนว วิธีนี้ ช่วยให้ตรวจจับกล้องได้อย่างเสถียรตั้งแต่แอปพลิเคชัน Ultra-Wide (UW) ไปจนถึง แอปพลิเคชันเทเล
4 test_multi_camera_alignment ข้ามการทดสอบหากอุปกรณ์มีกล้องมุมกว้างและกล้องเทเลซูมพิเศษเพียงตัวเดียว
flash test_auto_flash อัปเดตการทดสอบเพื่อยืนยันว่าแฟลชทำงานอย่างถูกต้องที่ระดับการซูมต่างๆ
ip test_default_jca_ip กำหนดให้มีการตรวจสอบที่มีอยู่ ได้แก่ ความแตกต่างของความสว่าง ความแตกต่างของสมดุลสีขาว และ FoV ไม่ตรงกัน เพิ่มการตรวจสอบ not_yet_mandated สำหรับความแตกต่างของการแสดงสีระหว่างแอปกล้องเริ่มต้นกับการจับภาพ JCA

กิจกรรมการทดสอบที่แยกกัน

ใน Android 17 สำหรับการทดสอบแบบขนานในอุปกรณ์แยกกัน ระบบจะแยกการทดสอบ Camera ITS ออกเป็น 2 กิจกรรม CTS Verifier ได้แก่ Camera ITS Test และ Camera ITS Sensor Fusion Rig Test กิจกรรม Camera ITS Sensor Fusion Rig Test มีฉาก feature_combination และ sensor_fusion และสามารถเรียกใช้ แยกกันในแท่นทดสอบการผสานเซ็นเซอร์ ตารางต่อไปนี้อธิบายฉากที่รวมอยู่ในแต่ละกิจกรรม

กิจกรรม ฉาก คำอธิบาย
Camera ITS Test gen2_chart, scene0, scene1_1, scene1_2, scene1_3, scene2_a, scene2_b, scene2_c, scene2_d, scene2_e, scene2_f, scene2_g, scene3, scene4, scene5, scene6, scene8, scene9, scene_flash, scene_hdr, scene_ip, scene_low_light, scene_video, wide_gamut ฉากที่ทำงานใน แท่นทดสอบ Camera ITS-in-a-box และ แท่นทดสอบ Gen2
Camera ITS Sensor Fusion Rig Test feature_combination, sensor_fusion ฉากที่ทำงานใน แท่นทดสอบการผสานเซ็นเซอร์

การทดสอบที่เลิกใช้งานแล้ว

ใน Android 17 การทดสอบต่อไปนี้เลิกใช้งานแล้วเนื่องจากฟังก์ชันการทดสอบครอบคลุมโดยการทดสอบอื่นๆ

ฉาก ชื่อการทดสอบ คำอธิบาย
sensor_fusion test_video_stabilization การทดสอบนี้เลิกใช้งานแล้ว ให้ใช้ test_video_stabilization_jca แทน

การอัปเดตแท่นทดสอบ Gen2

Android 17 การทดสอบต่อไปนี้ได้รับการย้ายไปยัง แท่นทดสอบ Gen2:

ฉาก ชื่อการทดสอบ คำอธิบาย
7 test_multi_camera_switch ย้ายการทดสอบไปยังการตั้งค่าแท่นทดสอบ Gen2 เพื่อใช้แผนภูมิ Gen2 สำหรับการตรวจสอบ AE และ AWB การเปลี่ยนนี้จะแทนที่เป้าหมายที่ใช้แท็บเล็ตด้วยแผนภูมิจริงเพื่อขจัดเอฟเฟกต์มัวเรและมอบสภาพแวดล้อมการทดสอบที่เสถียรและทำซ้ำได้มากขึ้น
flash all tests ย้ายการทดสอบ scene_flash ในแท่นทดสอบ Gen2 ผู้ใช้สามารถทำการทดสอบเหล่านี้ในสภาพแวดล้อมแท่นทดสอบการผสานเซ็นเซอร์หรือแท่นทดสอบ Gen2
sensor_fusion all tests ย้ายการทดสอบ sensor_fusion ไปยังแท่นทดสอบ Gen2 ผู้ใช้สามารถทำการทดสอบเหล่านี้ในสภาพแวดล้อมแท่นทดสอบการผสานเซ็นเซอร์หรือแท่นทดสอบ Gen2

ก่อนเรียกใช้การทดสอบที่ย้าย ให้ติดตั้งแผนภูมิแท่นทดสอบ Gen2 ที่เปิดตัวใน Android 17 แผนภูมิใหม่ช่วยให้คุณเรียกใช้การทดสอบการผสานเซ็นเซอร์ทั้งหมดในแท่นทดสอบ Gen2 ได้ ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าแผนภูมิสำหรับการ ทดสอบ

สถานะการทดสอบใหม่: PASS*

17 ขอแนะนำสถานะการทดสอบ PASS* เพื่อตรวจหาการทดสอบที่ผ่านแบบเฉียดฉิว ดูข้อมูลเพิ่มเติมได้ที่การทดสอบที่ผ่านแบบเฉียดฉิว (สถานะการทดสอบ PASS*)

การปรับปรุงการปรับขนาดแผนภูมิ

Android 17 เพิ่มพารามิเตอร์ chart_scaling ใน config.yml สำหรับ TEST_BED_TABLET_SCENES เพื่อจัดการปัญหาการปรับขนาดแผนภูมิกับอุปกรณ์กล้องเทเลที่มีขอบเขตการมองเห็น (FoV) กว้างขึ้น ดูข้อมูลเพิ่มเติมได้ที่ การปรับปรุงการปรับขนาดแผนภูมิ: พารามิเตอร์ chart_scaling

แท็บเล็ตใหม่สำหรับการรองรับการทดสอบขอบเขตสีที่กว้าง

สำหรับ Android 17 ขึ้นไป Samsung Galaxy Tab S10 FE (ทั้งรุ่น Wi-Fi และ 5G) อยู่ในรายการที่อนุญาตของแท็บเล็ต Samsung Galaxy Tab S10 FE ได้รับอนุมัติให้แสดงแผนภูมิการทดสอบขอบเขตสีที่กว้าง รวมถึงฉากอื่นๆ ทั้งหมดที่ใช้แท็บเล็ต หากต้องการยืนยันว่าอุปกรณ์ของคุณอยู่ในรายการที่อนุญาต ให้ใช้คำสั่ง adb shell getprop ro.product.device เพื่อยืนยันว่ารหัสผลิตภัณฑ์ตรงกับค่าที่แสดงในรายการต่อไปนี้

    'gts10fewifi',  # Samsung Galaxy Tab S10 FE
    'gts10fe',  # Samsung Galaxy Tab S10 FE 5G

การส่งผลลัพธ์รวมสำหรับการอนุมัติบิลด์

Android 17 ขอแนะนำกระบวนการส่งผลลัพธ์รวมของการทดสอบ Camera ITS เพื่อขออนุมัติบิลด์โดยใช้ CTS Verifier APK ที่อัปเดต

ระบบการรวมใหม่มีการปรับปรุงดังต่อไปนี้

  • ประหยัดเวลา: ไม่จำเป็นต้องเรียกใช้ฉากที่ผ่านซ้ำๆ ในอุปกรณ์ที่ใช้รหัสเฉพาะของบิลด์เดียวกัน
  • การดำเนินการแบบขนาน: อนุญาตให้ทดสอบหลายฉากพร้อมกันในอุปกรณ์หลายเครื่องได้ หากอุปกรณ์เหล่านั้นใช้รหัสเฉพาะของบิลด์เดียวกัน
  • การรายงานที่ง่ายขึ้น: ช่วยให้รวมผลการทดสอบจากรายงาน CTS Verifier หลายรายการ (รวบรวมจากการทดสอบหรืออุปกรณ์ต่างๆ) เป็นการส่งรายการเดียวที่รวมเป็นหนึ่งเดียว

ดูข้อมูลเพิ่มเติมได้ที่ ส่งผลการทดสอบรวม