Merge "Camera: Clarify doc for onPhysicalCameraUnavailable" into tm-qpr-dev (0a9fbfe9) · Commits · e / os / android_frameworks_base

core/java/android/hardware/camera2/CameraManager.java

+32 −5

Original line number	Diff line number	Diff line
		@@ -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>
		*