• Android CameraX
  https://android-developers.googleblog.com/2019/05/whats-new-with-android-jetpack.html
• ExtensionsManager
  https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager

CameraX Extensions

CameraX Extensions 涵蓋的內容

1.0.0 版本的 CameraX Extensions 包括一些最常見的內置相機特效:

• BOKEH (焦外成像): 在人像模式下拍攝照片時，讓前景人物更清晰。
• HDR (高動態范圍):拍照時使用不同的自動曝光 (AE) 配置，以獲得最佳效果。
• NIGHT (夜間):在低照度環境下 (通常是在夜間) 捕獲最佳靜態圖像。
• FACE RETOUCH (臉部照片修復):拍攝靜態圖像時，修飾臉部膚色、輪廓等。
• AUTO (自動):根據周圍的景色自動調整最終圖像。

讓我們來看幾組在 Android 手機上拍攝的照片，拍照時分別啟用和禁用了由 CameraX Extensions API 提供的特效。

NIGHT 模式例子

△圖 3:右側照片啟用了 NIGHT 特效。

視覺上的差異是很明顯的。您可以使用 CameraX Extensions API 在您自己的應用中實現這些圖像的效果。

現在讓我們看看如何將 CameraX 的 API 集成到您的應用中。

Extensions API

在現有的 CameraX 應用中，首先您可以引入 camera-extensions Jetpack 庫來添加 CameraX Extensions:

dependencies {    // 與 Extensions 庫版本號相匹配的 CameraX 核心庫    implementation 'androidx.camera1.1.0-alpha08'    implementation 'androidx.camera1.1.0-alpha08'    implementation 'androidx.camera1.1.0-alpha08'
    // CameraX Extensions 庫    implementation 'androidx.camera1.0.0-alpha28'
    // 其他依賴項    implementation('androidx.concurrent1.1.0')        …}

1. 獲取 ExtensionsManager 實例:

   https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager

2. 檢查目標設備是否支持需要用到的擴展模式；
3. 獲取一個啟用擴展的 CameraSelector；

4. 使用啟用擴展的 CameraSelector 調用 bindToLifecycle:

   https://developer.android.google.cn/reference/androidx/camera/lifecycle/ProcessCameraProvider#bindToLifecycle(androidx.lifecycle.LifecycleOwner,%20androidx.camera.core.CameraSelector,%20androidx.camera.core.UseCase...)

獲取 ExtensionsManager 實例

第一步是用擴展庫的 getInstance(Context) API 獲得一個 ExtensionsManager 實例。這個 API 返回一個 ListenableFuture，我們可以在 Kotlin 掛起函數中使用 await() 來獲取結果以避免阻塞主線程。(注意:在 ListenableFuture 上使用 await() 須引入 androidx.concurrent 1.1.0 依賴項。)

// 創建擴展管理器（使用 Jetpack Concurrent 庫）valextensionsManager=ExtensionsManager.getInstance(context).await()

• getInstance(Context)

  https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager#getInstance(android.content.Context)

• ExtensionsManager

  https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager

通過 ExtensionsManager，您可以確定設備是否支持某一特定的擴展模式，并為其獲取一個啟用擴展的 CameraSelector。請注意以下幾點:

• ExtensionsManager 是一個進程范圍的全局資源: 一個進程中只存在一個 ExtensionsManager 實例。

• ExtensionsManager 始終存在:無論底層設備是否支持擴展，CameraX 都提供一個有效的 ExtensionsManager 實例。

檢查擴展模式可用性

        // 獲取相機設備來檢查是否支持擴展        val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
        // 檢查是否支持 BOKEH        if (extensionsManager.isExtensionAvailable(                cameraProvider,                cameraSelector,                ExtensionMode.BOKEH            )) {            ...}

• isExtensionAvailable(CameraProvider, CameraSelector, int)

  https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager#isExtensionAvailable(androidx.camera.core.CameraProvider,%20androidx.camera.core.CameraSelector,%20int)

獲取啟用擴展的 CameraSelector

val bokehCameraSelector = extensionsManager                          .getExtensionEnabledCameraSelector(cameraProvider,cameraSelector,ExtensionMode.BOKEH)

• getExtensionEnabledCameraSelector(CameraProvider, CameraSelector, int)

  https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager#getExtensionEnabledCameraSelector(androidx.camera.core.CameraProvider,%20androidx.camera.core.CameraSelector,%20int)

使用啟用擴展的 CameraSelector 調用 bindToLifecycle()

// 將開啟了 BOKEH 的相機選擇器綁定到用例上val imageCapture = ImageCapture.Builder().build()val preview = Preview.Builder().build()cameraProvider.bindToLifecycle(                lifecycleOwner,                bokehCameraSelector,                imageCapture,                preview)

• bindToLifecycle()
  https://developer.android.google.cn/reference/androidx/camera/lifecycle/ProcessCameraProvider#bindToLifecycle(androidx.lifecycle.LifecycleOwner,%20androidx.camera.core.CameraSelector,%20androidx.camera.core.UseCase...)

• DEFAULT_BACK_CAMERA
  https://developer.android.google.cn/reference/androidx/camera/core/CameraSelector#DEFAULT_BACK_CAMERA

• DEFAULT_FRONT_CAMERA
  https://developer.android.google.cn/reference/androidx/camera/core/CameraSelector#DEFAULT_FRONT_CAMERA

使用 Extensions API 的樣例代碼

fun onCreate() {    lifecycleScope.launch {        // 創建 cameraProvider        val cameraProvider = ProcessCameraProvider.getInstance(context).await() 
        // 創建 extensionsManager（使用 Jetpack Concurrent 庫）        val extensionsManager =                 ExtensionsManager.getInstance(context).await()
        // 獲取相機設備來檢查是否支持擴展                val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
        // 檢查是否支持 BOKEH        if (extensionsManager.isExtensionAvailable(                cameraProvider,                cameraSelector,                ExtensionMode.BOKEH            )) {            // 在啟用不同擴展模式之前解除所有用例的綁定            cameraProvider.unbindAll()
//獲取啟用了BOKEH的相機選擇器            val bokehCameraSelector = extensionsManager                    .getExtensionEnabledCameraSelector(                cameraProvider,                cameraSelector,                ExtensionMode.BOKEH            )
            // 將開啟了 BOKEH 的相機選擇器綁定到用例上            val imageCapture = ImageCapture.Builder().build()            val preview = Preview.Builder().build()            cameraProvider.bindToLifecycle(                lifecycleOwner,                bokehCameraSelector,                imageCapture,                preview            )        }    }}

Extensions API 對核心模塊的依賴

CameraX Extensions API 是在 camera-extensions 庫中實現的，并且它依賴 CameraX 核心模塊 (core、camera2 和 lifecycle)。使用 CameraX Extensions 時，請務必使用與您正在使用的 CameraX 核心模塊相同的發布包中的版本。例如，要使用 camera-extensions:1.0.0-alpha28，則您必須在應用的依賴列表中包含 1.0.0-alpha08 版本的 camera-lifecycle、camera-core 和 camera-camera2，因為它們是于 2021 年 8 月 18 日在同一軟件包中發布的。

• 相同的發布包
  https://developer.android.google.cn/jetpack/androidx/releases/camera

支持擴展的設備

• CameraX Vendor Extensions 接口
  https://source.android.com/devices/camera/camerax-vendor-extensions

• CameraX 設備頁面
  https://developer.android.google.cn/training/camerax/devices

移除舊版 Extensions API

2019 年 8 月發布的舊版 Extensions API 現已廢棄。這個舊版的 Extensions API 提供了擴展器類，需要將擴展相關的配置應用到每個 Preview 和 ImageCapture 用例上。舊版的擴展器設計可能會導致開發人員忘記要在 Preview 或 ImageCapture 上啟用擴展模式，并可能導致非預期的行為。

新的 CameraX Extensions 庫在 1.0.0-alpha26 中引入。較新的 Extensions API 將擴展綁定從用例切換到目標相機，使用起來更加方便。請務必遷移以利用新的 Extensions API。