ICameraProvider@2.6: Add documentation about resource cost constraints for concurrent camera combinations.

- Also clarify requirements for MONOCHROME devices supporting Y8 outputs.

Bug: 150225538

Test: builds (doc change only)

Change-Id: I992f1bcee4bf266b6e66ddb32ece8291381c8e56
Signed-off-by: Jayant Chowdhary <jchowdhary@google.com>
This commit is contained in:
Jayant Chowdhary 2020-02-25 11:45:59 -08:00
parent 3e9669ff69
commit 6ae828b6f0
2 changed files with 16 additions and 1 deletions

View file

@ -56,11 +56,26 @@ interface ICameraProvider extends @2.5::ICameraProvider {
* s720p - min (max output resolution for the given format, 1280 X 720) * s720p - min (max output resolution for the given format, 1280 X 720)
* s1440p - min (max output resolution for the given format, 1920 X 1440) * s1440p - min (max output resolution for the given format, 1920 X 1440)
* *
* If a device has MONOCHROME capability (device's capabilities include
* ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MONOCHROME) and therefore supports Y8
* outputs, stream combinations mentioned above, where YUV is substituted by
* Y8 must be also supported.
*
* The camera framework must call this method whenever it gets a * The camera framework must call this method whenever it gets a
* cameraDeviceStatusChange callback adding a new camera device or removing * cameraDeviceStatusChange callback adding a new camera device or removing
* a camera device known to it. This is so that the camera framework can get new combinations * a camera device known to it. This is so that the camera framework can get new combinations
* of camera ids that can stream concurrently, that might have potentially appeared. * of camera ids that can stream concurrently, that might have potentially appeared.
* *
* For each combination (and their subsets) of camera device ids returned by
* getConcurrentStreamingCameraIds(): If only the mandatory combinations can
* be supported concurrently by each device, then the resource costs must
* sum up to > 100 for the concurrent set, to ensure arbitration between
* camera applications work as expected. Only if resources are sufficient
* to run a set of cameras at full capability (maximally
* resource-consuming framerate and stream size settings available in the
* configuration settings exposed through camera metadata), should the sum
* of resource costs for the combination be <= 100.
*
* @return status Status code for the operation * @return status Status code for the operation
* @return cameraIds a list of camera id combinations that support * @return cameraIds a list of camera id combinations that support
* concurrent stream configurations with the minimum guarantees * concurrent stream configurations with the minimum guarantees

View file

@ -639,7 +639,7 @@ ae6315fd42196478ac08441cb489d854118001bca5b9b9fd58af5110952be30e android.hardwar
07d0a252b2d8fa35887908a996ba395cf392968395fc30afab791f46e0c22a52 android.hardware.boot@1.1::IBootControl 07d0a252b2d8fa35887908a996ba395cf392968395fc30afab791f46e0c22a52 android.hardware.boot@1.1::IBootControl
74049a402be913963edfdd80828a53736570e9d8124a1bf18166b6ed46a6b0ab android.hardware.boot@1.1::types 74049a402be913963edfdd80828a53736570e9d8124a1bf18166b6ed46a6b0ab android.hardware.boot@1.1::types
b8c63679e1a3874b356f3e691aecce1191d38f59063cf2ed2dce8a9d4cabf00e android.hardware.camera.device@3.6::ICameraDevice b8c63679e1a3874b356f3e691aecce1191d38f59063cf2ed2dce8a9d4cabf00e android.hardware.camera.device@3.6::ICameraDevice
daad72a2f482d8a1f660d0e99ac1b78fedb414a4cfbe3fa56b2cd480e5d6f0cb android.hardware.camera.provider@2.6::ICameraProvider 99aae72ae75a8ddf63ccffbc585f3a55f4d0847b4adff3d7a0f8bd9e2305bec1 android.hardware.camera.provider@2.6::ICameraProvider
8f8d9463508ff9cae88eb35c429fd0e2dbca0ca8f5de7fdf836cc0c4370becb6 android.hardware.camera.provider@2.6::ICameraProviderCallback 8f8d9463508ff9cae88eb35c429fd0e2dbca0ca8f5de7fdf836cc0c4370becb6 android.hardware.camera.provider@2.6::ICameraProviderCallback
a35d5151b48505f06a775b38c0e2e265f80a845d92802324c643565807f81c53 android.hardware.camera.device@3.6::types a35d5151b48505f06a775b38c0e2e265f80a845d92802324c643565807f81c53 android.hardware.camera.device@3.6::types
c1aa508d00b66ed5feefea398fd5edf28fa651ac89773adad7dfda4e0a73a952 android.hardware.cas@1.2::ICas c1aa508d00b66ed5feefea398fd5edf28fa651ac89773adad7dfda4e0a73a952 android.hardware.cas@1.2::ICas