作者 / Android 開(kāi)發(fā)者關(guān)系工程師 Francesco Romano

• 預(yù)覽 (Preview)

  https://developer.android.google.cn/training/camerax/preview

• CaptureSession

  https://developer.android.google.cn/reference/android/hardware/camera2/CameraDevice#createCaptureSession(android.hardware.camera2.params.SessionConfiguration)

  
  

• 不要假定應(yīng)用將一直在縱向窗口中運(yùn)行。Android 13 仍然支持應(yīng)用固定屏幕方向的請(qǐng)求，但現(xiàn)在設(shè)備制造商可以選擇覆蓋應(yīng)用的首選屏幕方向請(qǐng)求。

• 不要假定應(yīng)用有任何固定尺寸或?qū)捀弑?/span>。即使您設(shè)置了 resizableActivity = "false"，您的應(yīng)用仍然可以在大屏幕設(shè)備 (>=600dp) 上以多窗口模式使用。

• 不要假定屏幕方向和相機(jī)方向之間存在固定關(guān)系?！?/span>Android 兼容性定義文檔》中明確了相機(jī)圖像傳感器 "必須朝向正確方向，以便相機(jī)的長(zhǎng)度方向與屏幕的長(zhǎng)度方向?qū)R"。從 API 級(jí)別 32 開(kāi)始，查詢可折疊設(shè)備方向的相機(jī)客戶端可以收到一個(gè)根據(jù)設(shè)備/折疊狀態(tài)動(dòng)態(tài)變化的值。

  
  

• Android 兼容性定義文檔

  https://source.android.com/docs/compatibility/13/android-13-cdd#755_camera_orientation

  
  

• 不要假定邊襯區(qū)的大小無(wú)法更改。新的任務(wù)欄會(huì)作為邊襯區(qū)報(bào)告給應(yīng)用，且當(dāng)任務(wù)欄與手勢(shì)導(dǎo)航一起使用時(shí)，任務(wù)欄可以動(dòng)態(tài)隱藏和顯示。

• 不要假定您的應(yīng)用享有專屬的相機(jī)訪問(wèn)權(quán)限。當(dāng)您的應(yīng)用處于多窗口模式時(shí)，其他應(yīng)用也可以獲得對(duì)相機(jī)和麥克風(fēng)等共享資源的訪問(wèn)權(quán)限。

雖然 CameraX 已經(jīng)能處理上述大多數(shù)情況，但使用 Camera2 API 實(shí)現(xiàn)適用于不同場(chǎng)景的預(yù)覽可能會(huì)很復(fù)雜。我們?cè)?"在您的相機(jī)應(yīng)用中支持可調(diào)整大小的 Surface" Codelab 中介紹了這一點(diǎn)。

• 在您的相機(jī)應(yīng)用中支持可調(diào)整大小的 Surface

  https://developer.android.google.cn/codelabs/android-camera2-preview

  
  

• CameraViewfinder

  https://developer.android.google.cn/reference/kotlin/androidx/camera/viewfinder/CameraViewfinder

implementation "androidx.camera:camera-viewfinder:1.3.0-alpha01"

<androidx.camera.viewfinder.CameraViewfinder
  android:id="@+id/view_finder"
  app:scaleType="fitCenter"
  app:implementationMode="performance"
  android:layout_width="match_parent"
  android:layout_height="match_parent"/>

• View

  https://developer.android.google.cn/reference/android/view/View

  
  

• PreviewView

  https://developer.android.google.cn/reference/kotlin/androidx/camera/view/PreviewView

• 實(shí)現(xiàn)模式

  https://developer.android.google.cn/training/camerax/preview#implementation-mode

• 縮放類型

  https://developer.android.google.cn/training/camerax/preview#scale-type

  
  

現(xiàn)在該組件是布局的一部分，您仍然可以創(chuàng)建 CameraCaptureSession，但不提供 TextureView 或 SurfaceView 作為目標(biāo)界面，而是使用 requestSurfaceAsync() 的結(jié)果。

fun startCamera(){
    val previewResolution = Size(width, height)
    val viewfinderSurfaceRequest = 
ViewfinderSurfaceRequest(previewResolution, characteristics)
    val surfaceListenableFuture =
        cameraViewfinder.requestSurfaceAsync(viewfinderSurfaceRequest)


    Futures.addCallback(surfaceListenableFuture, object :FutureCallback {
        override fun onSuccess(surface:Surface) {
            //像往常一樣使用這個(gè)界面創(chuàng)建 CaptureSession
        }
        override fun onFailure(t:Throwable) { /* 出錯(cuò)了 */}
    }, ContextCompat.getMainExecutor(context))
}

• CameraCaptureSession
  https://developer.android.google.cn/reference/android/hardware/camera2/CameraCaptureSession

• requestSurfaceAsync()

  https://developer.android.google.cn/reference/kotlin/androidx/camera/viewfinder/CameraViewfinder#requestSurfaceAsync(androidx.camera.viewfinder.ViewfinderSurfaceRequest)

• Jetpack WindowManager

  https://developer.android.google.cn/jetpack/androidx/releases/window

  
  

• 處理姿勢(shì)變化的代碼

  https://github.com/androidx/androidx/blob/androidx-main/camera/integration-tests/viewfindertestapp/src/main/java/androidx/camera/integration/viewfinder/CameraViewfinderFoldableFragment.kt#L583

  
  

  
  

?點(diǎn)擊屏末|閱讀原文|即刻了解 CameraViewfinder 更多相關(guān)信息