Obsługa wielu kamer

W ramach systemu kamery zewnętrznej (EVS) 1.1 obsługiwane jest urządzenie z kamerą logiczną, które składa się z wielu fizycznych kamer. Aby można było używać tego urządzenia wirtualnego, jego implementacje muszą obsługiwać ramę synchronizacji.

Wyliczanie, otwieranie i zamykanie logicznego urządzenia z kamerą

Aplikacja może używać tych samych metod IEvsEnumerator do korzystania z dostępnych logicznych urządzeń z kamerą. Zwrócony obiekt EvsCamera, który reprezentuje logiczne urządzenie z kamerą, musi zawierać w metadanych te elementy:

  • ANDROID_REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
    Jeśli zwrócony obiekt EvsCamera reprezentuje kamerę logiczną, jego metadane kamery muszą zawierać ten klucz możliwości w polu ANDROID_REQUEST_AVAILABLE_CAPABILITIES.
  • ANDROID_LOGICAL_MULTI_CAMERA_PHYSICAL_IDS pole zawiera identyfikatory fizycznych urządzeń z kamerą.
  • ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE pole może mieć jedną z tych wartości enum:
    • ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_APPROXIMATE jest przeznaczony do czujników w trybie master-master, bez synchronizacji migawki/ekspozycji sprzętowej.
    • ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_CALIBRATED jest przeznaczony do czujników w trybie master-slave, synchronizacji migawki/ekspozycji sprzętowej. Synchronizowane kamery GMSL2 muszą mieć tę wartość.

Aplikacja może pobierać opisy urządzeń z fizycznymi kamerami za pomocą IEvsCamera w ramach nowej metody getPhysicalCameraInfo(stringcameraId).

/**
 * 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);

Konfigurowanie obsługi wielu aparatów

Wszystkie kamery logiczne muszą być zdefiniowane statycznie i wyliczone za pomocą implementacji menedżera konfiguracji. Ponieważ EVS umożliwia skonfigurowanie każdego urządzenia w grupie w inny sposób, EVS udostępnia listę urządzeń członkowskich i wskazuje, czy przechwytywanie obrazu jest zsynchronizowane.

<!-- 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>