Hỗ trợ nhiều camera

Trong Hệ thống xem bên ngoài (EVS) 1.1, thiết bị máy ảnh logic bao gồm nhiều thiết bị máy ảnh thực sẽ được hỗ trợ. Để sử dụng thiết bị ảo này, các hoạt động triển khai thiết bị phải hỗ trợ Khung đồng bộ hoá.

Liệt kê, mở và đóng thiết bị máy ảnh logic

Ứng dụng có thể sử dụng các phương thức IEvsEnumerator tương tự để sử dụng các thiết bị máy ảnh logic hiện có. Đối tượng EvsCamera được trả về (biểu thị một thiết bị máy ảnh logic) phải chứa các mục sau trong siêu dữ liệu:

  • ANDROID_REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
    Nếu đối tượng EvsCamera được trả về đại diện cho một máy ảnh logic, thì siêu dữ liệu máy ảnh của đối tượng đó phải chứa khoá chức năng này trong trường ANDROID_REQUEST_AVAILABLE_CAPABILITIES.
  • Trường ANDROID_LOGICAL_MULTI_CAMERA_PHYSICAL_IDS liệt kê giá trị nhận dạng thiết bị máy ảnh thực.
  • Trường ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE có thể có một trong các giá trị enum dưới đây:
    • ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_APPROXIMATE dành cho cảm biến ở chế độ chính-chính, không có màn trập/độ phơi sáng phần cứng đồng bộ hoá.
    • ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_CALIBRATED dành cho cảm biến ở chế độ chủ-tớ, đồng bộ hoá màn trập/độ phơi sáng phần cứng. Các máy ảnh GMSL2 được đồng bộ hoá phải có giá trị này.

Ứng dụng có thể truy xuất chỉ số mô tả của các thiết bị máy ảnh thực thông qua IEvsCamera trong phương thức getPhysicalCameraInfo(stringcameraId) mới.

/**
 * Returns the description of the physical camera device that backs this
 * logical camera.
 *
 * If a requested device does not either exist or back this logical device,
 * this method returns a null camera descriptor. And, if this is called on
 * a physical camera device, this method is the same as getCameraInfo_1_1()
 * method if a given device ID is matched. Otherwise, this returns a
 * null camera descriptor.
 *
 * @param  deviceId Physical camera device identifier string.
 * @return info     The description of a member physical camera device.
 *                  This must be the same value as reported by
 *                  EvsEnumerator::getCameraList_1_1().
 */
getPhysicalCameraInfo(string deviceId) generates (CameraDesc info);

Định cấu hình tính năng hỗ trợ nhiều camera

Tất cả máy ảnh logic đều phải được xác định tĩnh và phải được liệt kê thông qua việc triển khai trình quản lý cấu hình. Vì EVS cho phép mỗi thiết bị trong nhóm được định cấu hình theo cách khác nhau, nên EVS cung cấp danh sách các thiết bị thành viên và cho biết liệu tính năng chụp ảnh có được đồng bộ hoá hay không.

<!-- camera group 0 -->
<group id='group0' synchronized='CALIBRATED'>
    <caps>
        <!-- list of supported controls supported by all physical devices -->
        <supported_controls>
            <control name='BRIGHTNESS' min='0' max='255'/>
            <control name='CONTRAST' min='0' max='255'/>
        </supported_controls>

        <!-- list of stream configuration supported by all physical devices -->
        <stream id='0' width='640' height='480' format='RGBA_8888' framerate='30'/>
    </caps>

    <!-- list of parameters -->
    <characteristics>
        <parameter
            name='REQUEST_AVAILABLE_CAPABILITIES'
            type='enum'
            size='1'
            value='LOGICAL_MULTI_CAMERA'
        />
        <parameter
            name='LOGICAL_MULTI_CAMERA_PHYSICAL_IDS'
            type='byte[]'
            size='2'
            value='/dev/video3,/dev/video4'
        />
    </characteristics>
</group>