Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Camera: Clarify doc for onPhysicalCameraUnavailable" into tm-qpr-dev am: 0a9fbfe94c

Browse Source 
Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/19784829

Change-Id: I3c8f2c3162bf1bb68e4e7b9e2fb355e97e76fa6f
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
TreeHugger Robot
2022-09-02 17:11:45 +00:00
committed by Automerger Merge Worker
parent e53ffab69a 0a9fbfe94c
commit e766e4e525
1 changed files with 32 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
core/java/android/hardware/camera2/CameraManager.java
View File

@@ -1204,6 +1204,20 @@ public final class CameraManager {
* to begin with, {@link #onPhysicalCameraUnavailable} may be invoked after * to begin with, {@link #onPhysicalCameraUnavailable} may be invoked after
* {@link #onCameraAvailable}.</p> * {@link #onCameraAvailable}.</p>
* *
* <p>Limitation: Opening a logical camera disables the {@link #onPhysicalCameraAvailable}
* and {@link #onPhysicalCameraUnavailable} callbacks for its physical cameras. For example,
* if app A opens the camera device:</p>
*
* <ul>
*
* <li>All apps subscribing to ActivityCallback get {@link #onCameraUnavailable}.</li>
*
* <li>No app (including app A) subscribing to ActivityCallback gets
* {@link #onPhysicalCameraAvailable} or {@link #onPhysicalCameraUnavailable}, because
* the logical camera is unavailable (some app is using it).</li>
*
* </ul>
*
* <p>The default implementation of this method does nothing.</p> * <p>The default implementation of this method does nothing.</p>
* *
* @param cameraId The unique identifier of the logical multi-camera. * @param cameraId The unique identifier of the logical multi-camera.
@@ -1221,11 +1235,24 @@ public final class CameraManager {
* A previously-available physical camera has become unavailable for use. * A previously-available physical camera has become unavailable for use.
* *
* <p>By default, all of the physical cameras of a logical multi-camera are * <p>By default, all of the physical cameras of a logical multi-camera are
* available, so {@link #onPhysicalCameraAvailable} is not called for any of the physical * unavailable if the logical camera itself is unavailable.
* cameras of a logical multi-camera, when {@link #onCameraAvailable} for the logical * No availability callbacks will be called for any of the physical
* multi-camera is invoked. If some specific physical cameras are unavailable * cameras of its parent logical multi-camera, when {@link #onCameraUnavailable} for
* to begin with, {@link #onPhysicalCameraUnavailable} may be invoked after * the logical multi-camera is invoked.</p>
* {@link #onCameraAvailable}.</p> *
* <p>Limitation: Opening a logical camera disables the {@link #onPhysicalCameraAvailable}
* and {@link #onPhysicalCameraUnavailable} callbacks for its physical cameras. For example,
* if app A opens the camera device:</p>
*
* <ul>
*
* <li>All apps subscribing to ActivityCallback get {@link #onCameraUnavailable}.</li>
*
* <li>No app (including app A) subscribing to ActivityCallback gets
* {@link #onPhysicalCameraAvailable} or {@link #onPhysicalCameraUnavailable}, because
* the logical camera is unavailable (some app is using it).</li>
*
* </ul>
* *
* <p>The default implementation of this method does nothing.</p> * <p>The default implementation of this method does nothing.</p>
* *