Camera2: Clarify ordering between onCaptureStart and onCaptureProgressed

It's not a guarantee that onCaptureProgressed happens after onCaptureStart for a particular request. Bug: 26676240 Change-Id: I900c3b36e1738dd3514954498023eaa4a1618989
2016-02-10 13:47:32 -08:00
parent cc725a4b6c
commit 0fc589cb29
1 changed files with 3 additions and 0 deletions
--- a/core/java/android/hardware/camera2/CameraCaptureSession.java
+++ b/core/java/android/hardware/camera2/CameraCaptureSession.java
@@ -847,6 +847,9 @@ public abstract class CameraCaptureSession implements AutoCloseable {
         * to make forward progress from the partial results and avoid waiting for the completed
         * result.</p>
         *
+         * <p>For a particular request, {@link #onCaptureProgressed} may happen before or after
+         * {@link #onCaptureStarted}.</p>
+         *
         * <p>Each request will generate at least {@code 1} partial results, and at most
         * {@link CameraCharacteristics#REQUEST_PARTIAL_RESULT_COUNT} partial results.</p>
         *