一、簡介

CameraCharacteristics 是專門用來描述相機裝置屬性的一個類，繼承自 CameraMetadata 類。給對給定的相機，它裡面所包含的屬性都是 固定的 。

包括：曝光補償（Exposure compensation）、自動曝光/自動對焦/自動白平衡模式（AE / AF / AWB mode）、自動曝光/自動白平衡鎖（AE / AWB lock）、自動對焦觸發器（AF trigger）、拍攝前自動曝光觸發器（Precapture AE trigger）、測量區域（Metering regions）、閃光燈觸發器（Flash trigger）、曝光時間（Exposure time）、感光度（ISO Sensitivity）、幀間隔（Frame duration）、鏡頭對焦距離（Lens focus distance）、色彩校正矩陣（Color correction matrix）、JPEG 元資料（JPEG metadata）、色調對映曲線（Tonemap curve）、裁剪區域（Crop region）、目標 FPS 範圍（Target FPS range）、拍攝意圖（Capture intent）、硬體視訊防抖（Video stabilization）等。

官方文件連結：https://developer.android.google.cn/reference/android/hardware/camera2/CameraCharacteristics

二、獲取 CameraCharacteristics 示例

通過 CameraManager 的 getCameraCharacteristics(String cameraId) 方法獲取指定相機裝置的 CameraCharacteristics 物件。

private int mCameraId = CameraCharacteristics.LENS_FACING_FRONT; // 要開啟的攝像頭ID
 

private CameraManager mCameraManager; // 相機管理者
private CameraCharacteristics mCameraCharacteristics; // 相機屬性

public void openCamera() {
    try {
        mCameraCharacteristics = mCameraManager.getCameraCharacteristics(Integer.toString(mCameraId));
        StreamConfigurationMap map = mCameraCharacteristics.
 
get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
        // ...省略
    } catch (CameraAccessException e) {
        e.printStackTrace();
    }
}

三、內部類

包含一個 CameraCharacteristics.Key<T> 的內部類，用做相機特性的欄位查詢使用。

常搭配 CameraCharacteristics.get(CameraCharacteristics.Key<T> key) 方法使用。

四、常用方法

1. T get(CameraCharacteristics.Key key)

獲取相機屬性中對應欄位的值。如果輸入的 key 沒有設定，將返回 null。

2. List<CameraCharacteristics.Key<?>> getKeys()

獲取該相機裝置支援的 CameraCharacteristics.Key 的列表。
該方法獲取的 Key 的列表，可以保證用作 CameraCharacteristics 類的 get() 方法時不會返回 null。
返回的 list 是不允許修改的，否則將丟擲 UnsupportedOperationException 異常。

3. List<CaptureRequest.Key<?>> getAvailableCaptureRequestKeys()

獲取該相機裝置支援的 CaptureRequest.Key 的列表。可用於 CaptureRequest 類的 get() 方法。

4. List<CaptureResult.Key<?>> getAvailableCaptureResultKeys()

獲取該相機裝置支援的 CaptureResult.Key 的列表。可用於 CaptureResult 類的 get() 方法。

五、成員欄位

這個太多了，差不多就是翻譯一下官方文件了，這裡一些常用的我就加粗表示吧。

對於一些縮寫，你應該也需要了解，例如 自動曝光 AE（auto exposure）、自動聚焦 AF（auto focus）、自動白平衡 AWB（auto white balance） 等。