关于android:使用-CameraX-Extensions-API-将特效应用到照片上

Android CameraX 的设计旨在帮忙您简化相机利用的开发工作。随着对 CameraX 一直的开发，相机利用的开发者们向咱们展现了他们的激情和热诚，以后的 API 中曾经融入了许多很棒的创意，例如值得称赞的 CameraX Extensions API。最近咱们驳回了开发者社区的意见，对扩大进行了重构，现在有了新的 ExtensionsManager，您只需两行代码就能够应用这些扩大！本文将介绍如何在您的利用中应用 Extensions API。

Android 设施装备了弱小的相机，制造商们投入了大量精力将泛滥前沿的性能个性或特效融入这些相机设施中。过来，这些弱小的性能只能由设施的原生相机利用提供。现在，凭借 CameraX Extensions API，第三方开发者能够通过一个通用的、简略的接口来拜访这些弱小的相机性能。

1.0.0 版本的 CameraX Extensions 包含一些最常见的内置相机特效:

BOKEH (焦外成像): 在人像模式下拍摄照片时，让前景人物更清晰。
HDR (高动静范畴): 拍照时应用不同的主动曝光 (AE) 配置，以获得最佳成果。
NIGHT (夜间): 在低照度环境下 (通常是在夜间) 捕捉最佳动态图像。
FACE RETOUCH (脸部照片修复): 拍摄动态图像时，润饰脸部肤色、轮廓等。
AUTO (主动): 依据四周的风景主动调整最终图像。

让咱们来看几组在 Android 手机上拍摄的照片，拍照时别离启用和禁用了由 CameraX Extensions API 提供的特效。

△ 图 1: 右侧照片启用了 BOKEH 特效。

△ 图 2: 右侧照片启用了 HDR 特效。

△ 图 3: 右侧照片启用了 NIGHT 特效。

视觉上的差别是很显著的。您能够应用 CameraX Extensions API 在您本人的利用中实现这些图像的成果。

当初让咱们看看如何将 CameraX 的 API 集成到您的利用中。

在现有的 CameraX 利用中，首先您能够引入 camera-extensions Jetpack 库来增加 CameraX Extensions:

dependencies {
    // 与 Extensions 库版本号相匹配的 CameraX 外围库
    implementation 'androidx.camera:camera-core:1.1.0-alpha08'
    implementation 'androidx.camera:camera-camera2:1.1.0-alpha08'
    implementation 'androidx.camera:camera-lifecycle:1.1.0-alpha08'

    // CameraX Extensions 库
    implementation 'androidx.camera:camera-extensions:1.0.0-alpha28'

    // 其余依赖项
    implementation('androidx.concurrent:concurrent-futures-ktx:1.1.0')
        …
}

接下来，通过以下步骤集成 Extensions:

获取 ExtensionsManager 实例。
查看指标设施是否反对须要用到的扩大模式；
获取一个启用扩大的 CameraSelector；
应用启用扩大的 CameraSelector 调用 bindToLifecycle)。

第一步是用扩大库的 getInstance(Context)) API 取得一个 ExtensionsManager 实例。这个 API 返回一个 ListenableFuture，咱们能够在 Kotlin 挂起函数中应用 await() 来获取后果以防止阻塞主线程。( 留神: 在 ListenableFuture 上应用 await() 须引入 androidx.concurrent:concurrent-futures-ktx: 1.1.0 依赖项。)

// 创立扩大管理器（应用 Jetpack Concurrent 库）val extensionsManager =  ExtensionsManager.getInstance(context).await()

通过 ExtensionsManager，您能够确定设施是否反对某一特定的扩大模式，并为其获取一个启用扩大的 CameraSelector。请留神以下几点:

ExtensionsManager 是一个过程范畴的全局资源: 一个过程中只存在一个 ExtensionsManager 实例。
ExtensionsManager 始终存在: 无论底层设施是否反对扩大，CameraX 都提供一个无效的 ExtensionsManager 实例。

通过 ExtensionsManager，应用 isExtensionAvailable(CameraProvider, CameraSelector, int)) 函数查看扩大的可用性: 如果设施上存在任何经由 CameraSelector 过滤的相机反对所查问的扩大，则返回 true，否则返回 false。

// 获取相机设施来查看是否反对扩大
val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA

// 查看是否反对 BOKEH
 if (extensionsManager.isExtensionAvailable(
    cameraProvider,
    cameraSelector,
    ExtensionMode.BOKEH
   )) {...}

一旦您确认了设施反对该扩大模式，就能够用 getExtensionEnabledCameraSelector(CameraProvider, CameraSelector, int)) 函数获取一个启用扩大的 CameraSelector。此函数返回启用扩大的 CameraSelector，其蕴含对于指定扩大模式的所有详细信息。

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

最初一步是应用 bindToLifecycle()) 将您的用例与启用扩大的 CameraSelector 绑定。应用启用扩大的 CameraSelector 如同应用一般的 CameraSelector 一样，例如应用 DEFAULT_BACK_CAMERA 或 DEFAULT_FRONT_CAMERA。当应用启用扩大的 CameraSelector 绑定用例时，CameraX 会间接在相机上启用指定的扩大模式。例如，当绑定到 Preview 时，扩大成果被利用到预览中，或者利用到由所绑定的 ImageCapture 所捕捉的图像上。

// 将开启了 BOKEH 的相机选择器绑定到用例上
val imageCapture = ImageCapture.Builder().build()
val preview = Preview.Builder().build()
cameraProvider.bindToLifecycle(
                lifecycleOwner,
                bokehCameraSelector,
                imageCapture,
                preview
            )

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
            )
        }
    }
}

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 日在同一软件包中公布的。

为了能应用 CameraX Extensions API，设施制造商须要实现 CameraX Vendor Extensions 接口。您能够在 CameraX 设施页面上找到反对 CameraX Extensions API 的局部设施列表。请留神，这不是一个详尽的列表。如果您的设施被列出，但可用性查看返回了 false，您可能须要将您的设施更新到制造商的最新 ROM 版本。

除了反对扩大的设施列表外，从 Android 12 开始，您还能够通过查看 Android 属性 ro.camerax.extensions.enabled 来确定设施是否反对 CameraX Extensions。

2019 年 8 月公布的旧版 Extensions API 现已废除。这个旧版的 Extensions API 提供了扩展器类，须要将扩大相干的配置利用到每个 Preview 和 ImageCapture 用例上。旧版的扩展器设计可能会导致开发人员遗记要在 Preview 或 ImageCapture 上启用扩大模式，并可能导致非预期的行为。

新的 CameraX Extensions 库在 1.0.0-alpha26 中引入。较新的 Extensions API 将扩大绑定从用例切换到指标相机，应用起来更加不便。请务必迁徙以利用新的 Extensions API。

咱们特别感谢那些帮忙实现 CameraX Extensions API 的杰出的 Android 相机开发者和设施制造商！如果您想理解 CameraX 的最新进展，请退出 Android CameraX 讨论组。

CameraX Extensions API 指南
Extensions API 参考
扩大测试利用
CameraX 公布阐明
开始应用 CameraX
CameraX Github 样例代码

欢迎您点击这里向咱们提交反馈，或分享您喜爱的内容、发现的问题。您的反馈对咱们十分重要，感谢您的反对！

关于android:使用-CameraX-Extensions-API-将特效应用到照片上

CameraX Extensions

CameraX Extensions 涵盖的内容

BOKEH 模式的例子

HDR 模式的例子

NIGHT 模式例子

Extensions API

获取 ExtensionsManager 实例

查看扩大模式可用性

获取启用扩大的 CameraSelector

应用启用扩大的 CameraSelector 调用 bindToLifecycle()

应用 Extensions API 的样例代码

Extensions API 对外围模块的依赖

反对扩大的设施

移除旧版 Extensions API

更多信息