โบเก้ของกล้อง

โบเก้ของกล้องคือเอฟเฟกต์ระยะชัดตื้นที่สร้างขึ้นโดยการเบลอบางส่วนของ ฉากเพื่อให้ไม่อยู่ในโฟกัส ในกล้องบนอุปกรณ์เคลื่อนที่ โบเก้จะ เกิดขึ้นโดยใช้ข้อมูลความลึกที่ได้จากภาพสามมิติจากกล้อง 2 ตัว หรือจากโฟโตไดโอดคู่ (PD) ของกล้องตัวเดียว

ตั้งแต่ Android 11 เป็นต้นไป แพลตฟอร์ม Android รองรับการใช้งานโบเก้และมี API เพื่อให้ฟีเจอร์นี้พร้อมใช้งาน ในแอปของบุคคลที่สาม

การใช้งาน

หากต้องการให้ฟีเจอร์โบเก้ของกล้องพร้อมใช้งานในอุปกรณ์ ให้ทำดังนี้

• โฆษณา ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES:

  แท็กนี้อยู่ในรูปแบบของอาร์เรย์ทูเพิลจำนวนเต็ม 3 รายการ โดยแต่ละทูเพิล อยู่ในรูปแบบ {mode, maxWidth, maxHeight} นอกจาก {ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}แล้ว HAL ของกล้องต้องแสดงรายการโหมด ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTUREและ ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUSอย่างน้อย 1 โหมดพร้อม ขนาดการสตรีมสูงสุดที่เกี่ยวข้องด้วย

• โฆษณา ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES:

  แท็กนี้อยู่ในรูปแบบ{minZoomRatio, maxZoomRatio}อาร์เรย์ ซึ่งมีช่วงอัตราส่วนการซูมทั้งหมดสำหรับโหมดฉากขยายที่เปิดใช้ ตามลำดับเดียวกับใน ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES ช่วงการซูมที่ [1.0, 1.0] หมายความว่าไม่รองรับการซูม

• ป้อนข้อมูล ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE ใน ANDROID_CONTROL_AVAILABLE_MODES

หากต้องการให้แอปเรียกใช้ฟีเจอร์โบเก้ แอปต้องตั้งค่า ANDROID_CONTROL_MODE เป็น ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE และ ANDROID_CONTROL_EXTENDED_SCENE_MODE เป็นโหมดฉากขยายที่รองรับโหมดใดโหมดหนึ่ง โปรดทราบว่าการใช้โบเก้อาจทำให้ใช้หน่วยความจำมากขึ้นเนื่องจาก การคำนวณสเตอริโอ

หากใช้โหมดฉากขยายที่รองรับต่อเฟรมไม่ได้และทำให้เกิดความล่าช้าที่ไม่คาดคิดเมื่อเปิด/ปิดใช้ ให้ใส่ ANDROID_CONTROL_EXTENDED_SCENE_MODE ใน ANDROID_REQUEST_AVAILABLE_SESSION_KEYS ในขณะเดียวกัน ให้ใช้เมธอด ICameraDeviceSession::isReconfigurationRequired() เพื่อหลีกเลี่ยง การกำหนดค่าใหม่สำหรับโหมดฉากที่ขยายซึ่งไม่จำเป็นต้องกำหนดค่าใหม่

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

หากต้องการตรวจสอบฟีเจอร์โบเก้ในอุปกรณ์ ให้เรียกใช้การทดสอบ CTS, VTS และ CTS Verifier ต่อไปนี้

• CtsCameraTestCases
• VtsHalCameraProviderV2_4TargetTest
• CameraBokehTest ในโปรแกรมตรวจสอบ CTS