การสตรีมจากกล้องพร้อมกัน

Android อนุญาตให้อุปกรณ์รองรับการสตรีมอุปกรณ์กล้องพร้อมกัน สำหรับ เช่น ทำให้อุปกรณ์ทำงานได้ทั้งกล้องหน้าและกล้องหลัง ไปพร้อมๆ กัน ตั้งแต่ Android 11 เป็นต้นไป Camera2 API จะมีเมธอดต่อไปนี้ที่แอปสามารถเรียกใช้เพื่อระบุว่ากล้องรองรับสตรีมมิงพร้อมกันหรือไม่ และเพื่อดูการกำหนดค่าสตรีมที่รองรับ

  • getConcurrentCameraIds รับชุดอุปกรณ์กล้องที่เชื่อมต่ออยู่ในปัจจุบัน ตัวระบุที่รองรับการกำหนดค่าเซสชันของอุปกรณ์กล้องพร้อมกัน
  • isConcurrentSessionConfigurationSupported ตรวจสอบว่าชุดอุปกรณ์กล้องที่ให้มาและชุดอุปกรณ์นั้น สามารถกำหนดค่าเซสชัน พร้อมกันได้

ชุดของสตรีมแบบผสมที่บังคับซึ่งต้องรองรับระหว่างการเกิดขึ้นพร้อมกัน สตรีมมิงจะรวมผ่านลักษณะกล้องของอุปกรณ์กล้องใน SCALER_MANDATORY_CONCURRENT_STREAM_COMBINATIONS

อุปกรณ์กล้องแต่ละเครื่องที่โฆษณาผ่าน getConcurrentStreamingCameraIds() ต้อง รองรับการกำหนดค่าที่รับประกันการแสดงผลพร้อมกันต่อไปนี้

เป้าหมาย 1 เป้าหมาย 2
ประเภท ขนาดสูงสุด ประเภท ขนาดสูงสุด ตัวอย่างกรณีการใช้งาน
YUV S1440P การประมวลผลวิดีโอหรือรูปภาพในแอป
PRIV s1440p การวิเคราะห์ช่องมองภาพในแอป
JPEG s1440p ไม่มีการจับภาพนิ่งในช่องมองภาพ
YUV / PRIV S720P JPEG s1440p การสร้างภาพต่อเนื่องแบบมาตรฐาน
YUV / PRIV S720P YUV / PRIV S1440P วิดีโอในแอปหรือการประมวลผลพร้อมการแสดงตัวอย่าง

อุปกรณ์ที่มีความสามารถของ MONOCHROME (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES) มี CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MONOCHROME) การรองรับ Y8 ต้องรองรับการแทนที่สตรีม YUV ด้วย Y8 ในการรับประกันทั้งหมด ชุดค่าผสมของสตรีม

s720p หมายถึง 720p (1280 x 720) หรือความละเอียดสูงสุดที่รองรับสำหรับ รูปแบบเฉพาะที่แสดงผลโดย StreamConfigurationMap.getOutputSizes() s1440p หมายถึง 1440p (1920 x 1440) หรือความละเอียดสูงสุดที่รองรับสำหรับรูปแบบที่ StreamConfigurationMap.getOutputSizes() แสดง อุปกรณ์ที่ไม่มีความสามารถ ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE ต้องรองรับสตรีม Y16 อย่างน้อย 1 สตรีม Dataspace::DEPTH ที่มี sVGA ในระหว่างการทำงานพร้อมกัน โดย sVGA จะมีค่าน้อยกว่า ความละเอียดต่อไปนี้:

  • ความละเอียดเอาต์พุตสูงสุดสำหรับรูปแบบที่กำหนด
  • 640 x 480

การใช้งาน

ในการอนุญาตให้แอปค้นหาอุปกรณ์เพื่อดูว่า กล้องรองรับการสตรีมพร้อมกัน ให้ใช้ ICameraProvider@2.6 อินเทอร์เฟซ HAL ซึ่งประกอบด้วยวิธีการต่อไปนี้

ดูการใช้งานอ้างอิงของICameraProvider@2.6อินเทอร์เฟซ HAL ได้ที่ห้องสมุด HAL ของกล้องจำลองที่ EmulatedCameraProviderHWLImpl.cpp

การตรวจสอบความถูกต้อง

หากต้องการทดสอบว่าการใช้งานฟีเจอร์นี้ทำงานได้ตามที่ตั้งใจไว้ ให้ใช้การทดสอบ ConcurrentCameraTest.java กับ CTS นอกจากนี้ ให้ทดสอบโดยใช้แอปที่เปิดกล้องหลายตัวและใช้งานพร้อมกัน

ปัญหาการจัดสรรทรัพยากร

หาก HAL ของกล้องโฆษณาการสนับสนุนสำหรับการดำเนินการพร้อมกันของ กล้องอาจพบปัญหาในการจัดสรรทรัพยากร ในกรณีที่มีทรัพยากรตัวประมวลผลสัญญาณภาพ (ISP) เพียงพอบน โทรศัพท์เพื่อสตรีมกล้องทั้งหน้าและกล้องหลัง (หรือกล้องอื่นๆ) พร้อมกัน แต่ไม่ให้สตรีม อย่างเต็มความสามารถ ในกรณีนี้ HAL ของกล้องต้องจัดสรรทรัพยากรฮาร์ดแวร์ที่มีจํากัดให้กับอุปกรณ์กล้องแต่ละเครื่อง

สถานการณ์ตัวอย่าง

สถานการณ์ต่อไปนี้แสดงถึงปัญหานี้

ปัญหา

อุปกรณ์มีการกําหนดค่าต่อไปนี้

  • รหัสกล้อง 0 คือกล้องเชิงตรรกะซึ่งรองรับโดยกล้องแบบไวด์และอัลตราไวด์ โดยแต่ละกล้องจะใช้ทรัพยากร ISP 1 รายการ
  • รหัสกล้อง 1 คือกล้องที่ใช้ทรัพยากร ISP 1 รายการ

อุปกรณ์ (โทรศัพท์) มี ISP 2 ราย หากรหัสกล้อง 0 เปิดอยู่และมีการกําหนดค่าเซสชัน HAL ของกล้องอาจจอง ISP 2 รายไว้เพื่อรองรับการใช้งานทั้งกล้องมุมกว้างพิเศษและกล้องมุมกว้าง

ในกรณีนี้ กล้องหน้า (รหัส 1) จะกำหนดค่าสตรีมไม่ได้เนื่องจากมีการใช้ ISP ทั้ง 2 ราย

โซลูชัน

เพื่อแก้ไขปัญหานี้ เฟรมเวิร์กสามารถเปิดทั้งรหัสกล้อง 0 และ 1 ก่อนกำหนดค่าเซสชันเพื่อให้คำแนะนำแก่ HAL ของกล้องเกี่ยวกับวิธีจัดสรรทรัพยากร (เนื่องจากตอนนี้ระบบคาดว่าจะมีการใช้งานกล้องพร้อมกัน) อย่างไรก็ตาม การดำเนินการนี้อาจทำให้ความสามารถมีข้อจำกัด เช่น การซูมอาจไม่สามารถจัดการอัตราส่วนช่วงการซูมแบบเต็มได้ (เนื่องจากการเปลี่ยนรหัสกล้องจริงอาจทำให้เกิดปัญหา)

หากต้องการใช้โซลูชันนี้ ให้ทําการอัปเดตต่อไปนี้ใน provider@2.6::ICameraProvider::getConcurrentCameraStreamingCameraIds

  • ข้อบังคับว่าเมื่อใช้กล้องพร้อมกันได้ กล้อง เฟรมเวิร์กต้องเปิดอุปกรณ์กล้อง (@3.2::ICameraDevice::open) ก่อน การกำหนดค่าเซสชันในอุปกรณ์กล้อง ซึ่งจะช่วยให้ผู้ให้บริการกล้องจัดสรรทรัพยากรได้อย่างเหมาะสม

  • หากต้องการแก้ไขปัญหาที่ไม่สามารถจัดการอัตราส่วนช่วงการซูมได้เต็มรูปแบบ ให้ตรวจสอบว่าแอปกล้องใช้การตั้งค่าการควบคุม ZOOM_RATIO ระหว่าง 1x กับ MAX_DIGITAL_ZOOM เท่านั้นเมื่อใช้กล้องพร้อมกันแทนที่จะใช้ ZOOM_RATIO_RANGE แบบเต็ม (วิธีนี้จะช่วยป้องกันไม่ให้กล้องจริงสลับกันภายใน ซึ่งอาจต้องใช้ ISP เพิ่มเติม)

ปัญหาเกี่ยวกับ testDualcameraPreview

เมื่อคุณทำการอัปเดตข้างต้น อาจทำให้เกิดปัญหาเกี่ยวกับลักษณะการทำงานที่อนุญาต ตามการทดสอบ MultiViewTest.java#testDualCameraPreview

การทดสอบ testDualCameraPreview ไม่กำหนดค่าเซสชันหลังจากเปิดเท่านั้น กล้องทั้งหมด โดยลำดับคือ

for each camera  in cameraDevices :
  device = openCamera(camera)
     createCaptureSession(device);

แต่รองรับการทำงานล้มเหลวของกล้องได้ด้วย ERROR_MAX_CAMERAS_IN_USE [1] แอปของบุคคลที่สามอาจต้องใช้ลักษณะการทำงานนี้

เนื่องจาก HAL ของกล้องจะไม่ทราบว่ามีการเปิดชุดรหัสกล้องทั้งหมดสําหรับการดําเนินการพร้อมกันก่อนที่จะกําหนดค่าเซสชัน จึงอาจทำให้ HAL กระจายทรัพยากรฮาร์ดแวร์ได้ยาก (ในกรณีที่มีการแข่งขันกันใช้ทรัพยากร)

ในการแก้ปัญหานี้ การรักษาความเข้ากันได้แบบย้อนหลังนอกเหนือจาก รองรับสตรีมมิงหลายรายการพร้อมกัน HAL ของกล้องไม่ควรเรียกใช้ openCamera ด้วย ERROR_MAX_CAMERAS_IN_USE หากไม่สามารถรองรับการกำหนดค่าสตรีมแบบเต็มสำหรับ กล้องทุกตัวทำงานพร้อมกัน