Merge "Camera: Modify CameraCharacteristics documentation about static keys." into udc-dev

 * <p>The properties describing a

 * {@link CameraDevice CameraDevice}.</p>

 *

 * <p>These properties are fixed for a given CameraDevice, and can be queried

 * <p>These properties are primarily fixed for a given CameraDevice, and can be queried

 * through the {@link CameraManager CameraManager}

 * interface with {@link CameraManager#getCameraCharacteristics}.</p>

 * interface with {@link CameraManager#getCameraCharacteristics}. Beginning with API level 32, some

 * properties such as {@link #SENSOR_ORIENTATION} may change dynamically based on the state of the

 * device. For information on whether a specific value is fixed, see the documentation for its key.

 * </p>

 *

 * <p>When obtained by a client that does not hold the CAMERA permission, some metadata values are

 * not included. The list of keys that require the permission is given by

     * <p>The field definitions can be

     * found in {@link CameraCharacteristics}.</p>

     *

     * <p>Querying the value for the same key more than once will return a value

     * which is equal to the previous queried value.</p>

     *

     * @throws IllegalArgumentException if the key was not valid

     *

     * @param key The characteristics field to read.

 * </p>

 *

 * <p>

 * All instances of CameraMetadata are immutable. The list of keys with {@link #getKeys()}

 * never changes, nor do the values returned by any key with {@code #get} throughout

 * the lifetime of the object.

 * All instances of CameraMetadata are immutable. Beginning with API level 32, the list of keys

 * returned by {@link #getKeys()} may change depending on the state of the device, as may the

 * values returned by any key with {@code #get} throughout the lifetime of the object. For

 * information on whether a specific value is fixed, see the documentation for its key.

 * </p>

 *

 * @see CameraDevice