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

Camera: Clarify doc for onPhysicalCameraUnavailable

Browse Source 
Clarify that no physical camera availability callbacks will be called
if the parent logical camera becomes unavailable.

Test: Build doc
Bug: 243738805
Change-Id: I339b7cedf1df10f89aa6ead0c67ed9f2bda9ed0c
This commit is contained in:
Shuzhen Wang
2022-08-30 13:29:01 -07:00
parent 16219f2ea4
commit d216f25f6b
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
* {@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>
*
* @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.
*
* <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
* cameras of a logical multi-camera, when {@link #onCameraAvailable} for the logical
* multi-camera is invoked. If some specific physical cameras are unavailable
* to begin with, {@link #onPhysicalCameraUnavailable} may be invoked after
* {@link #onCameraAvailable}.</p>
* unavailable if the logical camera itself is unavailable.
* No availability callbacks will be called for any of the physical
* cameras of its parent logical multi-camera, when {@link #onCameraUnavailable} for
* the logical multi-camera is invoked.</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>
*