From 45ae5f4259a41860f91de90f3e0c9f77182a61c6 Mon Sep 17 00:00:00 2001
From: Shuzhen Wang <shuzhenwang@google.com>
Date: Wed, 23 May 2018 11:18:04 -0700
Subject: [PATCH] Camera: Add clarification on camera id ordering for logical
 camera

Test: Compile
Bug: 80075565
Change-Id: I765a0de40f773b9fe1142f974e1cf3d1da406f13
---
 camera/ndk/include/camera/NdkCameraMetadataTags.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/camera/ndk/include/camera/NdkCameraMetadataTags.h b/camera/ndk/include/camera/NdkCameraMetadataTags.h
index ee3e98ef2b..3010646afc 100644
--- a/camera/ndk/include/camera/NdkCameraMetadataTags.h
+++ b/camera/ndk/include/camera/NdkCameraMetadataTags.h
@@ -7050,6 +7050,10 @@ typedef enum acamera_metadata_enum_acamera_request_available_capabilities {
     /**
      * <p>The camera device is a logical camera backed by two or more physical cameras that are
      * also exposed to the application.</p>
+     * <p>Camera application shouldn't assume that there are at most 1 rear camera and 1 front
+     * camera in the system. For an application that switches between front and back cameras,
+     * the recommendation is to switch between the first rear camera and the first front
+     * camera in the list of supported camera devices.</p>
      * <p>This capability requires the camera device to support the following:</p>
      * <ul>
      * <li>This camera device must list the following static metadata entries in <a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html">CameraCharacteristics</a>:<ul>