Camera2的API出來有些年頭了，只是趕專案多次使用，沒時間好好總結，年終了，正好結合google的官方Camera2demo 和開發中使用的情況，做個詳細梳理，研究總結之後，才發現Camera2並非想象的難用，充分理解相關幾個類之後，實現自己需求還是很簡單的。

該篇詳細介紹Camera2相關的類，根據API各個類的方法，欄位含義都詳細用表格記錄。 
下一篇將介紹Camera2的使用流程。

<一>SurfaceView 相關的類

在Camera的時候，自定義相機預覽首選 SurfaceView當展示佈局，更深層的結合openCV openGL庫的GLSurfaceView，做渲染濾鏡遊戲動畫等。首先了解相關類SurfaceView和SurfaceHolder的API。

當SurfaceView視窗可見時，就可以建立這個表面，當urfaceView展示或者隱藏時，需要對它進行建立和銷燬，你就需要實現SurfaceViewCreated(SurfaceHolder)方法或者SurfaceViewDestroyed(SurfaceHolder）方法。 
這個類的用途之一就是提供了一個可以在螢幕上顯示輔助執行緒的Surface，要使用，需要了解執行緒語義：回撥方法Callback將從執行的SurfceView視窗呼叫，所以需要正確的同步繪製執行緒。在SurfaceHolder.Callback.surfaceCreated() 方法和 SurfaceHolder.Callback.surfaceDestroyed()方法之間是有效的期間，你必須確保繪圖執行緒只和使用的SurfaceView有聯絡。 
注意:從android7.0開始，SurfaceView的視窗位置與其他檢視呈現同步更新。這意味著在螢幕上平移和縮放一個SurfaceView將不會導致呈現工件

protected的方法

<2> SurfaceHolder API

<3> SurfaceHolder.Callback介面

<二>Camera2 相關的類

<1>CameraManager

官方文件解釋： 
一種系統服務管理器，用於檢測、描述和連線到照相機裝置。 
獲取該例項的方法:CameraManager manager =（CameraManager）Context.getSystemService(Context.CAMERA_SERVICE);或者 
CameraManager manager =（CameraManager）Context. getSystemService(CameraManager.class);

<1-1>CameraManager.AvailabilityCallback

CameraManager的內部類AvailabilityCallback回撥，官方文件解釋：

一個用於相機裝置的回撥或無法開啟的回撥。

當相機不再使用時，或者當一個新的可拆卸相機連線起來時，Cameras就會變的可用了。 
當一些應用程式或服務開始使用相機時，或者當一個可移動的相機被斷開時，它們就變得不可用了。

擴充套件這個回撥並將子類的例項傳遞給CameraManager的registerAvailabilityCallback(CameraManager.AvailabilityCallback, Handler) 方法通知這些可用性更改。

<1-2>CameraManager.TorchCallback

CameraManager的內部類TorchCallback回撥，官方文件解釋： 
一個相機閃光燈torch模式變得可用不可用的回撥。

當相機裝置所屬的相機裝置變得不可用或其他相機資源時，由於其他更高的優先順序相機活動， torch mode就變得不可用。當它被關閉時，或者當它所屬的相機裝置不再使用，它所需要的其他相機資源不再忙碌時，torch mode就會不可用。當應用程式呼叫CameraManager的setTorchMode(String, boolean)關閉相機的torch mode，或者當應用程式開啟其他相機的torch mode，，如果同時不支援多個火炬模式，相機的torch mode就會被關閉。當通過setTorchMode(String, boolean)開啟torch mode時，torch mode就會可用。

只有當處於禁用或啟用狀態時，才可以通過setTorchMode(String、boolean)設定torch mode。

擴充套件這個回撥並將一個子類的例項傳遞給CameraManager的registerTorchCallback(CameraManager.TorchCallback, Handler)將被通知此類狀態更改。

<2>CameraDevice

官方文件詳解： 
CameraDevice 類是一個連線安卓裝置的單一攝像頭的代表，可以在高幀率下對影象捕捉和後期處理進行精確控制。

你的應用程式需要在manifest中生命相機許可權才可以訪問相機裝置。

一個給定的相機裝置可以提供兩個級別的支援:有限的或完全的。如果一個裝置只支援有限的級別，那麼攝像頭會公開一個功能集，它大致相當於舊的攝像頭API，不過它的介面更簡潔、更高效。如果是全支援，提供了比舊的攝像頭API更好的功能。針對有限級別裝置的應用程式將在全級裝置上保持不變，而如果應用程式需要一個全級別支援的操作,在manifest中宣告“android.hardware.camera.level.full”的特徵。

該類的常量：

該常量一般在CameraDevice的createCaptureRequest(int)方法引數中設定。

該類的方法：

CameraDevice還一個方法,就不寫在表格中了： 
createReprocessableCaptureSessionByConfigurations(InputConfiguration , outputs, CameraCaptureSession.StateCallback, Handler) ,通過為相機裝置提供所需的再處理輸入配置和輸出輸出配置，建立一個新的可重新處理的相機捕捉會話。

<2-1>CameraDevice.StateCallback

CameraDevice的內部類StateCallback，官方文件介紹： 
一個回到物件，用於接收關於相機的更新狀態。

一個回撥例項必須先實現CameraManager的openCamera(String cameraId, CameraDevice.StateCallback callback, Handler handler) 方法來開啟相機裝置。

這些狀態更新包括關於裝置完成啟動的通知(允許CameraDevice的createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)被呼叫），關於裝置斷開或閉包，以及意外的裝置錯誤。

關於特定的CaptureRequests程序事件是由 CameraCaptureSession.CaptureCallback 提供的，該回調的所有方法見上邊表格。 
常量及方法：

<3>CameraCaptureSession

文件解釋： 
CameraDevice類的一個配置捕捉會話，用於捕捉相機的照片，或者用於之前同一個會話中處理相機捕捉的圖片。

提供一組目標輸出表面給 CameraDevice的createCaptureSession()方法，或者提供一 個InputConfiguration類和為了一個可加工捕捉會話提供一組目標輸出表面給CameraDevice的createReprocessableCaptureSession()方法，就會建立CameraCaptureSession物件，一旦建立CameraCaptureSession，這個會話就處於活動狀態，除非相機又新建一個會話或者裝置關閉。

所有的捕捉會話都可用於從相機捕捉照片，但是隻有可加工捕捉會話在之前同一個會話中可以處理從相機捕捉的照片。 
建立一個會話是個昂貴的操作，可以花費零點幾秒時間，因為它需要配置攝像機裝置的內部管道( pipelines),並分配記憶體緩衝區，以便將影象傳送到所需的目標。因此設定非同步操作, CameraDevice的createCaptureSession和createReprocessableCaptureSession方法會將創建出的CameraCaptureSession物件傳送給CameraCaptureSession.StateCallback的onConfigured 回撥方法，如果配置不能完成，就會回撥 onConfigureFailed方法，會話就不能被啟用。

如果一個新的會話被相機建立，name之前的會話就會被關閉，他的關聯回撥CameraCaptureSession.StateCallback的onClosed方法就會被呼叫，如果會話被關閉，所有會話方法都將丟擲IllegalStateException異常。

一個關閉的會話會清除所有重複的操作（就像呼叫CameraCaptureSession的stopRepeating()方法），但是，在新建的會話接管並配置相機前，仍然像正常一樣完成所有的程序捕捉請求。

<3-1>CameraCaptureSession.CaptureCallback

CameraCaptureSession的內部類CaptureCallback，官方文件解釋： 
一個回撥物件，用於跟蹤向相機提交CaptureRequest物件的程序，見下邊的CameraDevice.StateCallback的文件解釋。

這個回撥是在一個請求觸發一個捕獲開始時呼叫的，當捕獲完成時呼叫。如果出現錯誤捕獲影象，則會觸發錯誤方法，而不是完成方法。 
重寫的七個方法：

<3-2>CameraCaptureSession.StateCallback

CameraCaptureSession的內部類StateCallback，一個回撥物件，用於接收關於相機捕捉會話狀態的更新。 
重寫的七個方法：

<4>CaptureRequest，CameraCharacteristics,TotalCaptureResult和CaptureResult四個類的區別

這四個類放在一起，是因為他們有共同的欄位列表，都繼承於CameraMetadata，具體的關係如下: 
1: CaptureRequest extendsCameraMetadata implements Parcelable 
2:CameraCharacteristics extends CameraMetadata 
3:TotalCaptureResult extends CaptureResult CameraMetadata 
4:CameraMetadata比較單一，放在下邊一節的表格中顯示。

四個類文件解釋

<1>CaptureRequest 官方文件解釋：

一個不可變的設定和輸出，用來從相機裝置捕捉單個影象。

包含捕獲硬體的配置(感測器sensor,、透鏡 lens、閃光燈flash)，處理管道pipeline，控制演算法和輸出緩衝區。還包含目標表面的列表，以便將影象資料傳送給該捕獲。

使用CaptureRequest.Builder例項建立CaptureRequests物件，通過呼叫CameraDevice的createCaptureRequest(int templateType) 獲取CaptureRequest.Builder物件。 
CaptureRequest物件呼叫CameraCaptureSession的capture(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler)或者setRepeatingRequest(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler) 方法從相機捕捉照片。

每個請求都可以指定目標表面的不同子集，以便將捕獲的資料傳送到。當請求被提交到會話時，請求中使用的所有表面都必須是對方法 createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)的最後一次呼叫所給出的地表列表的一部分（ All the surfaces used in a request must be part of the surface list given to the last call to createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)， when the request is submitted to the session）

例如，一個用於重複預覽的請求可能只包含預覽SurfaceView或SurfaceTexture的表面，而高解析度的靜態捕獲還包括一個用於高解析度JPEG影象的ImageReader的表面。

可處理捕獲請求允許從攝像機裝置獲取以前捕獲的影象，並將其傳送回裝置進行進一步處理。 會話用CameraDevice的createReprocessCaptureRequest(TotalCaptureResult)建立，可修理拍照會話用CameraDevice的createReprocessableCaptureSession(InputConfiguration, List, CameraCaptureSession.StateCallback, Handler)建立.

<2>CameraCharacteristics官方文件解釋：

描述攝像頭裝置的屬性。

這些屬性是給定的攝像頭的屬性，可以通過CameraManager的getCameraCharacteristics(String cameraId) 方法獲取單個攝像頭的CameraCharacteristics物件（個人觀點：通過該物件可以判斷攝像頭都支援什麼功能，比如閃光燈，方向等等）。

CameraCharacteristics物件是不可變的。 
<3>TotalCaptureResult官方文件解釋： 
從影象感測器捕捉到的單個影象捕獲的全部結果。

包含捕獲硬體的配置(感測器sensor,、透鏡 lens、閃光燈flash)，處理管道pipeline，控制演算法和輸出緩衝區。

處理完 CaptureRequest之後，TotalCaptureResult由CameraDevice類產生。所有捕獲請求的屬性列表都可以在捕獲結果中查詢到 ，以確定用於捕獲的最終的值。結果還包括在捕捉期間相機裝置狀態的附加元資料。

getAvailableCaptureResultKeys()返回的所有屬性是可用的(這是get(CaptureResult.Key)方法將返回非空值,當且僅當啟用的關鍵要求）。除非啟用了一個開關(如STATISTICS_FACE_DETECT_MODE)，否則在預設情況下，一些關鍵字將被禁用。請參考每個關鍵文件的具體情況。

TotalCaptureResult物件是不可變的。

<4>CaptureResult官方文件解釋： 
從影象感測器捕獲單個影象的結果子集。

包含捕獲硬體的配置(感測器sensor,、透鏡 lens、閃光燈flash)，處理管道pipeline，控制演算法和輸出緩衝區。

處理完 CaptureRequest之後，CaptureResults由CameraDevice類產生。所有捕獲請求的屬性列表都可以在捕獲結果中查詢到，以確定用於捕獲的最終的值。結果還包括在捕捉期間相機裝置狀態的附加元資料。

不是所有屬性呼叫CameraCharacteristics的getAvailableCaptureResultKeys()返回必然是可用的。一些結果是區域性的(CaptureResult)，並且不會有每一個鍵集。只有TotalCaptureResult被保證擁有由請求啟用的所有可用的鍵。

CaptureResult物件是不可變的。

四個類各自獨有的方法和欄位

<1>CaptureRequest

CaptureRequest和CaptureResult的父類欄位，以及所有各自的欄位都是相同的

<1-1>CaptureRequest.Builder

CaptureRequest內部類Builder，捕獲請求的構建器。要獲得構建器例項，可以使用CameraDeviced的createCaptureRequest(int)方法，該方法將請求欄位初始化為在CameraDevice定義的一個模板。

常用的方法已加粗，通過CaptureRequest.Builder的set(Key key, T value)方法設定各種引數，比如自動對焦，設定flash，key值就是上面表中CaptureRequest的欄位表，再通過build()方法生成CaptureRequest物件。注意，CaptureRequest繼承於CameraMetadata類，CameraMetadata類的欄位才是相機屬性值的基類。

<2>CameraCharacteristics