如何在您的应用中使用Extensions API将特效应用到照片上

Android CameraX 的设计旨在帮助您简化相机应用的开发工作随着对 CameraX 不断的开发，相机应用的开发者们向我们展示了他们的激情和热忱，当前的 API 中已经融入了许多很棒的创意，例如值得称赞的 CameraX Ex。

tensions API最近我们采纳了开发者社区的意见，对扩展进行了重构，如今有了新的 ExtensionsManager，您只需两行代码就可以使用这些扩展！本文将介绍如何在您的应用中使用 Extensions API。

Android CameraXhttps://android-developers.googleblog.com/2019/05/whats-new-with-android-jetpack.htmlExtensionsManager

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

Android 设备配备了强大的相机，制造商们投入了大量精力将众多前沿的功能特性或特效融入这些相机设备中过去，这些强大的功能只能由设备的原生相机应用提供如今，凭借 CameraX Extensions API，第三方开发者可以通过一个通用的、简单的。

接口来访问这些强大的相机功能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

)复制 …复制}接下来，通过以下步骤集成 Extensions:获取 ExtensionsManager 实例:https://developer.android.google.cn/reference/androidx/camera/extensions/ExtensionsManager

检查目标设备是否支持需要用到的扩展模式；获取一个启用扩展的 CameraSelector；使用启用扩展的 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)

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

通过 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复制 )) {复制 ...复制}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一旦您确认了设备支持该扩展模式，就可以用 getExtensionEnabledCameraSelector(CameraProvider, CameraSelector, int)

函数获取一个启用扩展的 CameraSelector此函数返回启用扩展的 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()最后一步是使用 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复制)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_CAMERAhttps://developer.android.google.cn/reference/androidx/camera/core/CameraSelector#DEFAULT_BACK_CAMERA

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

使用 Extensions API 的样例代码Extensions API 示例的完整代码如下:复制funonCreate() {复制 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 Extensions API，设备制造商需要实现 CameraX Vendor Extensions 接口您可以在 CameraX 设备页面上找到支持 CameraX Extensions API 的部分设备列表。

请注意，这不是一个详尽的列表如果您的设备被列出，但可用性检查返回了 false，您可能需要将您的设备更新到制造商的最新ROM 版本CameraX Vendor Extensions 接口https://source.android.com/devices/camera/camerax-vendor-extensions。

CameraX 设备页面https://developer.android.google.cn/training/camerax/devices除了支持扩展的设备列表外，从 Android 12 开始，您还可以通过检查 Android 属性

ro.camerax.extensions.enabled来确定设备是否支持 CameraX Extensions移除旧版 Extensions API2019 年 8 月发布的旧版 Extensions API 现已废弃。

这个旧版的 Extensions API 提供了扩展器类，需要将扩展相关的配置应用到每个 Preview 和 ImageCapture 用例上旧版的扩展器设计可能会导致开发人员忘记要在 Preview 或

ImageCapture 上启用扩展模式，并可能导致非预期的行为新的 CameraX Extensions 库在 1.0.0-alpha26 中引入较新的 Extensions API 将扩展绑定从用例切换到目标相机，使用起来更加方便。

请务必迁移以利用新的 Extensions API 编辑：jq

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。