CameraX

此表列出了 androidx.camera 组中的所有工件。

设备测试

CameraX 在我们实验室的许多设备上进行了测试。要查看实验室中当前的设备列表，请参阅 CameraX 实验室测试设备。

声明依赖项

要添加对 CameraX 的依赖项，您必须将 Google Maven 存储库添加到您的项目中。阅读 Google 的 Maven 存储库 以获取更多信息。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.5.0-alpha01"
  // The following line is optional, as the core library is included indirectly by camera-camera2
  implementation "androidx.camera:camera-core:${camerax_version}"
  implementation "androidx.camera:camera-camera2:${camerax_version}"
  // If you want to additionally use the CameraX Lifecycle library
  implementation "androidx.camera:camera-lifecycle:${camerax_version}"
  // If you want to additionally use the CameraX VideoCapture library
  implementation "androidx.camera:camera-video:${camerax_version}"
  // If you want to additionally use the CameraX View class
  implementation "androidx.camera:camera-view:${camerax_version}"
  // If you want to additionally add CameraX ML Kit Vision Integration
  implementation "androidx.camera:camera-mlkit-vision:${camerax_version}"
  // If you want to additionally use the CameraX Extensions library
  implementation "androidx.camera:camera-extensions:${camerax_version}"
}

dependencies {
    // CameraX core library using the camera2 implementation
    val camerax_version = "1.5.0-alpha01"
    // The following line is optional, as the core library is included indirectly by camera-camera2
    implementation("androidx.camera:camera-core:${camerax_version}")
    implementation("androidx.camera:camera-camera2:${camerax_version}")
    // If you want to additionally use the CameraX Lifecycle library
    implementation("androidx.camera:camera-lifecycle:${camerax_version}")
    // If you want to additionally use the CameraX VideoCapture library
    implementation("androidx.camera:camera-video:${camerax_version}")
    // If you want to additionally use the CameraX View class
    implementation("androidx.camera:camera-view:${camerax_version}")
    // If you want to additionally add CameraX ML Kit Vision Integration
    implementation("androidx.camera:camera-mlkit-vision:${camerax_version}")
    // If you want to additionally use the CameraX Extensions library
    implementation("androidx.camera:camera-extensions:${camerax_version}")
}

反馈

您的反馈有助于改进 Jetpack。如果您发现新的问题或有改进此库的想法，请告知我们。在创建新问题之前，请查看此库中 现有问题。您可以通过点击星形按钮为现有问题添加您的投票。

创建新问题

请参阅 问题跟踪器文档 以获取更多信息。

相机取景器 Compose 版本 1.0

版本 1.0.0-alpha02

2024 年 6 月 12 日

androidx.camera:camera-viewfinder-compose:1.0.0-alpha02 已发布。版本 1.0.0-alpha02 包含 这些提交。

版本 1.0.0-alpha01

2024 年 5 月 14 日

androidx.camera:camera-viewfinder-compose:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含 这些提交。

新功能

• 新库。此库引入了 Compose 原生取景器可组合项，可与 CameraX 和 Camera2 一起使用。可组合取景器支持不同的纵横比，以及触摸事件的处理。

相机取景器版本 1.4

版本 1.4.0-alpha07

2024 年 6 月 12 日

androidx.camera:camera-viewfinder:1.4.0-alpha07 和 androidx.camera:camera-viewfinder-core:1.4.0-alpha07 已发布。版本 1.4.0-alpha07 包含 这些提交。

版本 1.4.0-alpha06

2024 年 5 月 14 日

androidx.camera:camera-viewfinder:1.4.0-alpha06 和 androidx.camera:camera-viewfinder-core:1.4.0-alpha06 已发布。版本 1.4.0-alpha06 包含 这些提交。

API 更改

• 将 Viewfinder 的 ImplementationMode 枚举重命名为更好地反映底层实现，并为 TransformationInfo.sourceRotation 添加固定常量。（Ic6149）
• 添加了 ZoomGestureDetector.ZoomEvent 来封装缩放手势的状态。（I84cdf）

Camera 版本 1.5

版本 1.5.0-alpha01

2024 年 9 月 4 日

androidx.camera:camera-*:1.5.0-alpha01 已发布。版本 1.5.0-alpha01 包含 这些提交。

API 更改

• 提供 API 用于设置双并发摄像头视频捕获的合成设置。这些设置包括混合的 alpha 值、x、y 坐标的偏移量以及摄像头帧显示窗口宽度和高度的缩放比例。偏移量、宽度和高度以归一化设备坐标指定。（Ia2b8a）
• 将 CameraProvider.getCameraInfo 暴露为正式 API。（I901cd）
• 添加了 API PendingRecording.withAudioEnabled(boolean initialMuted) 用于控制初始静音状态。（I635c3，b/354829267）

错误修复

• 修复了当使用已销毁的 LifecycleOwner 调用 bindToLifecycle 时发生的崩溃。（I6e6d8）
• 修复了在 Motorola Edge 20 Fusion 上使用 VideoCapture 绑定时前置摄像头预览出现黑屏的问题。（I1fe88）
• 优化了 PreviewView 中检测缩放手势的配置，以提高流畅度。（I04ffc）

Camera 版本 1.4

版本 1.4.0-rc01

2024 年 8 月 7 日

androidx.camera:camera-*:1.4.0-rc01 已发布。版本 1.4.0-rc01 包含 这些提交。

新功能

• 添加了实验性的 CameraInfo.getCameraInfo，以便在无需将用例绑定到摄像头的情况下提供特定的摄像头信息。（I550d1）

API 更改

• 添加了 PreviewView.getScreenFlash 和 PreviewView.setScreenFlashOverlayColor API，用于未显式添加 ScreenFlashView 的情况。（I43945）

错误修复

• 修复了在启用闪光灯的情况下，在弱光环境下使用 VideoCapture 用例捕获图像时出现的曝光和色彩色调问题。（Ic9814）
• 修复了使用启用扩展功能的中断 takePicture 请求可能会导致无法获取结果，并且下一个 takePicture 请求可能无法工作的问题。（Iae78f）
• 修复了启用扩展功能时发生的内存泄漏问题。（Iab276）
• 解决了 Pixel 7/8 和 Samsung Galaxy S24 系列等设备上的 CameraX 扩展功能故障。该问题源于发布模式下 Camera2OutputConfigImpl 转换问题，在将 AGP 升级到 8.5.1 并启用混淆后出现。（I99598，b/354824993）

版本 1.4.0-beta02

2024 年 6 月 12 日

androidx.camera:camera-*:1.4.0-beta02 已发布。版本 1.4.0-beta02 包含 这些提交。

API 更改

• 与 VideoCapture 类似，为 Preview 用例添加 setMirrorMode。它将通过 API 33 及更高版本的 OutputConfiguration.setMirrorMode 支持 Preview 流的镜像模式开启和关闭，对于较旧的 API，它将不执行任何操作。（I821f4）

错误修复

• 修复了在 Samsung Tab A8 上，当 ImageCapture 在 Preview + VideoCapture + ImageCapture UseCase 组合下选择 1920x1080 时，应用程序无法成功拍摄照片的问题。（I5a463，b/336925549）
• 修复了持续录制在切换摄像头后可能无法继续录制的问题。（Icb0a1）

版本 1.4.0-beta01

2024 年 5 月 14 日

androidx.camera:camera-*:1.4.0-beta01 已发布。版本 1.4.0-beta01 包含 这些提交。

API 更改

• 添加了 ZoomGestureDetector.ZoomEvent 来封装缩放手势的状态。（I84cdf）

错误修复

• 修复了一个错误，即捕获和点按对焦仍未使用重复请求 FPS/稳定模式值，这可能会重新创建捕获会话并在某些设备上导致延迟问题或预览冻结。（I7dc0b）
• 修复了在某些设备上启用 CameraEffect 时无法选择高分辨率的问题（例如，Samsung A32 5G 上的 4000x3000）。（Ie3ed3，b/337336152）
• 修复了在 Pixel 4XL API29 上绑定 Preview、ImageCapture 和 VideoCapture(UHD) 时拍摄照片时发生的崩溃。（I5b288）
• 支持虚拟设备：传递给 ProcessCameraProvider 的 Context 将保留设备 ID，以确保在虚拟设备环境中的功能。（I5ba48）

版本 1.4.0-alpha05

2024 年 4 月 17 日

androidx.camera:camera-*:1.4.0-alpha05 已发布。版本 1.4.0-alpha05 包含 这些提交。

新功能

• 将 ProcessCameraProvider 转换为 Kotlin 实现。（I46d4f）
• 添加了 ImageCapture.takePicture 悬挂函数，以便能够以 Kotlin 风格的方式调用它。（I920be）

API 更改

• 向 ImageCapture 添加输出格式 API，并向 ImageCaptureCapabilities 添加 getSupportedOutputFormats 方法以查询设备功能。默认输出格式值为 OUTPUT_FORMAT_JPEG，它以 JPEG 格式捕获 SDR 图像。当设备支持 Ultra HDR 且输出格式设置为 OUTPUT_FORMAT_JPEG_ULTRA_HDR 时，CameraX 将使用 JPEG/R 图像格式捕获 Ultra HDR 压缩图像。该格式与 SDR JPEG 格式向后兼容，并支持 HDR 内容渲染。这意味着在较旧的应用程序或设备上，图像将无缝显示为常规 JPEG；在已更新为完全支持该格式的应用程序和设备上，图像将显示为 HDR。（I5de50）
• 在 CameraInfo 中添加 PhysicalCameraInfo 以查询物理摄像头信息，并在 CameraSelector 中添加物理摄像头 ID 设置器/获取器（Ic5b90）
• 将 CameraController#COORDINATE_SYSTEM_VIEW_REFERENCED 替换为 ImageAnalysis#COORDINATE_SYSTEM_VIEW_REFERENCED。常量的值保持不变。这是为了将所有常量合并到一个地方。（I890bb）
• 新的 RetryPolicy API 使开发人员能够自定义 CameraX 初始化的重试行为。（I36dd2）
• 启用创建 ImageCaptureLatencyEstimate 对象以帮助进行可测试性（Iaba99）
• 添加 ImageAnalysis#COORDINATE_SYSTEM_SENSOR。当使用此项时，MlKitAnalyzer 将以摄像头传感器坐标系返回坐标。（I3ec61）
• 公开了扩展元数据 API。新的 CameraExtensionsInfo 和 CameraExtensionsControl 接口允许应用程序监控和调整扩展强度设置。应用程序可以通过新添加的 ExtensionsManager#getCameraExtensionsInfo() 或 ExtensionsManager#getCameraExtensionsControl() 方法获取 CameraExtensionsInfo 或 CameraExtensionsControl 实例。（I28e1a）
• 添加了 ProcessCameraProvider.awaitInstance，它是 ProcessCameraProvider.getInstance 的一个挂起版本（Ib22b9）
• 添加了一个 PreviewView#getSensorToViewTransform() API。矩阵表示从摄像头传感器坐标到 PreviewView 坐标的转换。这可以用来将一个 UseCase 的坐标转换为另一个 UseCase。例如，将 ImageAnalysis 中检测到的对象的坐标转换为 PreviewView 叠加层。（I947ab）
• 使 camera-viewfinder-core API 更通用，以便 camera-viewfinder 和 camera-viewfinder-compose 可以使用它。（I1e295）
• 向 ViewfinderSurfaceRequest 添加 getSurface 函数。（I781a0）
• 在 camera-viewfinder 中使用 camera-viewfinder-core 并弃用 ViewfinderSurfaceRequest 和 CameraViewfinder。（I6198c）
• 添加了 ZoomGestureDetector，它解释专门为捏合缩放活动配置的缩放手势。（Ifafbf）

错误修复

• 修复了与分析器默认目标分辨率设置相关的 ImageAnalysis 分辨率选择问题：即使应用程序已设置不同的分析器默认分辨率设置，目标分辨率也被错误地保留为 640x480。如果应用程序遇到此问题 (1.3.0 ~ 1.3.2) 并且无法升级到使用包含解决方案的较新版本，则可以直接将具有首选分辨率和匹配 AspectRatioStrategy 的 ResolutionSelector 设置到 ImageAnalysis UseCase 可以解决此问题。（I81f72，b/330091012）
• 修复了如果当前请求失败，则排队的 takePicture 请求可能无法运行的问题。（Ie0801）

• 将无效 JPEG 数据检查应用于 Vivo X60 和 X60 Pro 设备。这可以修复这些设备上异常大的图像问题。（I82247，b/288828159）
• 修复了 Samsung A24 设备上 JPEG 图像元数据错误的问题。通过此修复，CameraX 可以成功保存 JPEG 图像，或者在 Samsung A24 设备上调用 ImageProxy.toBitmap() 函数时可以返回正确的 Bitmap 对象。（I8d6eb，b/309005680）
• 如果捕获的图像大于 10 MB，则将无效 JPEG 数据检查应用于所有 Samsung 设备。这可以修复 Samsung 设备上异常大的图像问题。（Ic2a65，b/288828159）
• 从 CameraX 扩展中删除了 ImageAnalysis 支持，因为许多 OEM 的扩展实现无法很好地与 ImageAnalysis 配合使用，并且可能会导致不一致的问题。（I2d926）

版本 1.4.0-alpha04

2024 年 1 月 24 日

发布了 androidx.camera:camera-*:1.4.0-alpha04。 版本 1.4.0-alpha04 包含这些提交。

新功能

• 新构件：camera-effects：一个用于将实时效果应用于 CameraX 输出的库，包括 Preview、VideoCapture 和/或 ImageCapture。此构件包含 CameraEffect API 的 OpenGL 实现，该 API 可有效地操作相机输出。
• OverlayEffect：用于使用 Android 的 Canvas API 绘制叠加层。这允许应用在相机输出上添加水印或突出显示检测到的对象。
• 用于预览用例的 DynamicRange API：现在可以在预览用例上设置动态范围，独立于视频用例。这允许仅用于预览的 HDR 动态范围，例如 HLG10。CameraInfo 中也提供了新的 API 来查询每个相机支持的动态范围。

API 更改

• 将 ScreenFlashUiCompleter 重命名为 ScreenFlashListener，并将 ScreenFlashUiCompleter#getExpirationTimeMillis 移动到 ScreenFlash#apply 的 expirationTimeMillis 参数。（I13944）
• 添加了新的 API 以允许在预览用例上设置动态范围，并查询每个相机支持的动态范围。这允许仅使用预览用例使用 HDR 动态范围（例如 HLG10），不再需要同时绑定 VideoCapture。（If25e3）
• 将 getMirroring() 重命名为 isMirroring()（I47063）
• 在 CameraX 中添加了实时静态捕获延迟估计支持。相机扩展允许应用程序使用提供捕获所需时间的估计值的 API。该估计值考虑了当前的环境条件、相机状态，并包括处理多帧捕获请求所花费的时间，以及如有必要，编码处理过的缓冲区所需的任何额外时间。（I05c3a）
• 将 ScreenFlashUiControl 重命名为 ScreenFlash，将 ScreenFlashUiControl#applyScreenFlashUi 重命名为 ScreenFlash#apply，将 ScreenFlashUiControl#clearScreenFlashUi 重命名为 ScreenFlash#clear，并添加了 getScreenFlashUiApplyTimeoutSeconds 方法，而不是直接公开 SCREEN_FLASH_UI_APPLY_TIMEOUT_SECONDS。（Iccdd0）

错误修复

• 修复了一个内存泄漏问题，该问题会导致在启用扩展时活动或片段未释放（I14215）
• 修复了当应用递增缩放比例时 getZoomRatio 错误地返回减小的值的问题。（I4aa0d，b/317543616）
• 当 ImageCapture 解绑或相机关闭时，会立即调用 ImageCapture#ScreenFlash#clear 事件，还修复了一些由于这些情况下捕获未正确完成而从未调用该事件的错误。（If99f9）
• 修复了在 takePicture 请求完成之前生命周期停止时发生的崩溃问题（Idf017，b/306202751）
• 修复了在某些设备上启用扩展时相机预览变黑的问题（I1ffd0）
• 修复了使用 Snapdragon 778G SoC 的设备上视频录制时间错误的问题。（If6aa7，b/316057919）

版本 1.4.0-alpha03

2023 年 12 月 13 日

发布了 androidx.camera:camera-*:1.4.0-alpha03。 版本 1.4.0-alpha03 包含这些提交。

新功能

• 添加了 CameraInfo.mustPlayShutterSound 以提供有关是否必须根据区域限制播放快门声的信息。（Ifda84）
• 添加了 OnImageCapturedCallback.onCaptureStarted 和 OnImageSavedCallback.onCaptureStarted 用于在相机开始曝光帧时发出通知。建议在此处播放快门声或快门动画。（Ic49b3）
• 在 CameraX 中添加了前置摄像头图像捕获的屏幕闪光功能支持。CameraX 将负责框架侧 API 处理，并根据需要（例如，应用屏幕颜色/亮度更改后的 AE 预捕获触发）与应用程序的 UI 更改同步时间。应用只需要在提供给 CameraX 的 ScreenFlashUiControl 接口中添加其 UI 侧实现。（I8ae84）
• 在 CameraX 中添加了屏幕闪光功能 UI 侧实现支持。应用将能够从 PreviewView 或新添加的 ScreenFlashView 获取基本的 ImageCapture.ScreenFlashUiControl 实现，这将在屏幕闪光照片捕获期间添加单色叠加视图并最大化屏幕亮度。（I1810e）

API 更改

• 支持新的扩展功能（后视和捕获过程进度）：为应用添加了 ImageCapture#getImageCaptureCapabilities() API 以查询后视和捕获过程进度回调的功能。应用可以使用 ImageCapture.Builder#setPostviewEnabled() 启用后视。可以使用 ImageCapture.Builder#setPostviewResolutionSelector() 选择后视大小。调用 takePicture() 时，可以在 OnImageSavedCallback 或 OnImageCapturedCallback 中实现 onPostviewBitmapAvailable 和 onCaptureProcessProgressed 以获取后视和处理进度通知（如果支持）。（I5cd88）
• 用于计算从传感器到当前缓冲区的坐标转换的 API，以及一个标志，指示 Surface 是否包含相机方向信息。（I59096）
• 在预览 UseCase 中公开查询 PreviewCapabitlity 的 API。（Ie5b6c）
• 添加了 API 以支持 VideoCapture 的更多质量。 Recorder.Builder#setVideoCapabilitiesSource(int) 可以与 VIDEO_CAPABILITIES_SOURCE_CODEC_CAPABILITIES 一起使用来创建支持比 VIDEO_CAPABILITIES_SOURCE_CAMCORDER_PROFILE 更多质量的 Recorder 实例。一个常见的用例是当应用程序力求在任何可能的情况下录制 UHD 视频时，但设备的 CamcorderProfile 不包含 UHD 设置，即使编解码器能够录制 UHD 视频。（Iedbe2，b/263961771）
• 将 ImageAnalysis 输出格式的 getter/setter 添加到 CameraController。（I9a96c，b/308240643）

错误修复

• 从 相机 1.3.1：改进了 ProcessCameraProvider#bindToLifecycle() 的性能。主要更改是优化识别 UseCases 最合适的尺寸组合的过程。最佳结果根据特定的 UseCase 组合和目标设备支持的输出尺寸数量而有所不同。（I454f2）
• 允许在启用扩展时使用 VideoCapture。（I91f32）
• 修复了 Samsung A71 和 M51 系列设备上捕获的 JPEG 图像过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据。这会导致捕获的图像具有极大的文件大小。这些冗余的 0 填充数据将被删除，以使捕获的图像具有正常的图像文件大小。（I01afc，b/288828159）
• 在 Pixel 上禁用 ImageAnalysis 支持，以避免 Pixel 上意外返回非空 ImageAnalysis 支持尺寸的错误。（I7ec31）
• 修复了启用扩展时 CPU 负载和功耗增加的性能问题。（Ibdccb）
• 将 Snapdragon 480 添加到 CameraUseInconsistentTimebaseQuirk 中。这修复了 Android 12 上使用此芯片组的设备上的一个问题，即录音中的音频会偏移设备处于挂起状态的时间量。（I58010）

版本 1.4.0-alpha02

2023 年 10 月 18 日

发布了 androidx.camera:camera-*:1.4.0-alpha02。 版本 1.4.0-alpha02 包含这些提交。

API 更改

• 将 API 重命名为 setCameraOpenRetryMaxTimeoutInMillisWhileResuming 并重命名参数。（I72370）
• 添加 API 以查询设备功能并启用视频/预览稳定。（I87544）
• 提供 API 以自定义相机打开重试的最大超时时间。（I0c642）
• 发布 ProcessCameraProvider.shutdownAsync 作为公共测试 API，以允许在测试套件中使用流程相机提供程序，这些测试套件可能需要在测试之间以不同的方式初始化 CameraX。（I9eca7）
• 添加用于配置视频捕获动态范围、帧速率和镜像模式的 API。（Ifb8f7）

• 弃用 OutputSize 并将其替换为 ResolutionSelector。 ResolutionSelector 是选择分辨率的更全面方法，并且与 camera-core API 保持一致。（I93abd，b/286801438）

错误修复

• 修复了在 Samsung Galaxy S23 Ultra 5G 上，当启用 Extensions 模糊或面部修饰功能并使用后置摄像头上的 ImageAnalysis 时出现的预览黑屏问题。（I2e8b1）
• 修复了 Moto E5 Play 上的预览和 VideoCapture 拉伸问题。（73dce2）

版本 1.4.0-alpha01

2023年9月20日

androidx.camera:camera-*:1.4.0-alpha01 已发布。 版本 1.4.0-alpha01 包含以下提交。

API 更改

• 添加了在录制期间访问音频幅度信息的新 API。（Id4925）

错误修复

• 通过确保初始化和反初始化事件按正确的顺序触发来提高 Extensions 的稳定性。（Ib3b8e）
• 修复了由于内部添加了额外的重复表面导致捕获会话配置失败的问题，该问题超过了支持的表面组合。（Id718c）
• 修复了 Vivo S16 设备上捕获的 JPEG 图像文件过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据，这导致捕获的图像文件大小过大。这些冗余的 0 填充数据将被移除，以使捕获的图像具有正常的图像文件大小。（I79505，b/299069235）
• 修复了在某些设备上启用某些扩展模式时，ImageAnalysis 无法与 ImageCapture 和预览一起绑定使用的问题。此修复程序将在应用通过 ExtensionsManager#isImageAnalysisSupported() 查询 ImageAnalysis 可用性时返回正确的值。（I7d538）
• 更新 JavaDoc 以匹配行为。 #setZoomRatio、#setLinearZoom 和 #enableTorch 不再立即完成，而是等待相机准备好。还添加了有关如何使用 #takePicture API 获取最大 FOV 的信息。（I23588）

版本 1.3

版本 1.3.4

2024 年 6 月 12 日

androidx.camera:camera-*:1.3.4 已发布。版本 1.3.4 包含 以下提交。

错误修复

• 修复了当应用递增缩放比例时 getZoomRatio 错误地返回减小的值的问题。（I4aa0d，b/317543616）
• 修复了静止捕获/点触对焦未使用重复请求 FPS/稳定模式值的问题，这可能会重新创建捕获会话并在某些设备上导致延迟问题或预览冻结。（I7dc0b）
• 修复了使用 setTargetFrameRate 和 FRAME_RATE_RANGE_UNSPECIFIED 调用时，帧速率设置为较低值的问题。（I78c61）

版本 1.3.3

2024 年 4 月 17 日

androidx.camera:camera-*:1.3.3 已发布。版本 1.3.3 包含 以下提交。

错误修复

• 修复了与分析器默认目标分辨率设置相关的 ImageAnalysis 分辨率选择问题：即使应用程序设置了不同的分析器默认分辨率设置，目标分辨率也被错误地保留为 640x480。如果应用程序遇到此问题（1.3.0 ~ 1.3.2）并且无法升级到使用包含解决方案的较新版本，则可以直接将具有首选分辨率和匹配 AspectRatioStrategy 的 ResolutionSelector 设置到 ImageAnalysis UseCase 可以解决此问题。（I81f72，b/330091012）

版本 1.3.2

2024年3月6日

androidx.camera:camera-*:1.3.2 已发布。版本 1.3.2 包含 以下提交。

错误修复

• 修复了 Samsung A24 设备上的 JPEG 元数据问题。CameraX 现在可以准确保存图像，并且 ImageProxy.toBitmap() 函数返回正确的 Bitmap 对象。（I8d6eb，b/309005680）
• 由于存在问题，已删除 Redmi Note 9 Pro 设备上的 9280x6944 分辨率选项。（Ia23da）

版本 1.3.1

2023 年 12 月 13 日

androidx.camera:camera-*:1.3.1 已发布。 版本 1.3.1 包含以下提交。

错误修复

改进了 ProcessCameraProvider#bindToLifecycle() 的性能。主要更改是优化了识别 UseCases 最合适的尺寸组合的过程。最佳结果因特定的 UseCase 组合以及目标设备支持的输出尺寸数量而异。（I454f2）

以下是各种场景的一些参考结果

• 四个 UseCases：Preview + ImageCapture + ImageAnalysis + VideoCapture

  • Google Pixel 7：大约 430 毫秒到 60 毫秒
  • Samsung Galaxy S23 Ultra：大约 540 毫秒到 45 毫秒
  • Samsung A53 5G：大约 115 毫秒到 70 毫秒

• 三个 UseCases：Preview + ImageCapture + ImageAnalysis

  • Google Pixel 7：大约 9 毫秒到 7 毫秒
  • Samsung Galaxy S23 Ultra：大约 6 毫秒到 5 毫秒
  • Samsung A53 5G：大约 32 毫秒到 12 毫秒

• 将 Snapdragon 480 添加到 CameraUseInconsistentTimebaseQuirk 中。这修复了 Android 12 上使用此芯片组的设备上的一个问题，即录音中的音频会偏移设备处于挂起状态的时间量。（I58010）

版本 1.3.0

2023 年 10 月 18 日

androidx.camera:camera-*:1.3.0 已发布。 版本 1.3.0 包含以下提交。

自 1.2.0 以来的一些重要更改

• 视频功能，包括 10 位 HDR、裁剪、镜像/非镜像、静音/取消静音、设置帧速率等等。
• 双并发摄像头
• 效果库
• 分辨率选择器
• 超广角和长焦摄像头的选择
• 录制视频期间切换摄像头（实验性功能）

版本 1.3.0-rc02

2023年9月20日

androidx.camera:camera-*:1.3.0-rc02 已发布。 版本 1.3.0-rc02 包含以下提交。

错误修复

• 通过确保初始化和反初始化事件按正确的顺序触发来提高 Extensions 的稳定性。这修复了在切换 Extensions 模式或切换摄像头时出现的一些预览黑屏问题。（Iddaac）
• 修复了在某些设备上启用某些扩展模式时，ImageAnalysis 无法与 ImageCapture 和预览一起绑定使用的问题。此修复程序将在应用通过 ExtensionsManager#isImageAnalysisSupported() 查询 ImageAnalysis 可用性时返回正确的值。（I7d538）
• 修复了在 Xiaomi Poco X3 NFC 上启用镜像模式时，录制视频的音频和视频不同步的问题。（I20b4c）

版本 1.3.0-rc01

2023年8月23日

androidx.camera:camera-*:1.3.0-rc01 已发布。 版本 1.3.0-rc01 包含以下提交。

API 更改

• 添加了 PendingRecording.asPersistentRecording 以允许录制在与其 Recorder 附加的 VideoCapture 重新绑定时持续录制。（I517c6）

错误修复

• 修复了当流与 VideoCapture 和预览共享时发生的崩溃问题。还修复了在启用流共享时，LEGACY 设备上出现的黑屏问题。
• 修复了 Samsung S7 (SM-G930T、SM-G930V) 系列设备上捕获的 JPEG 图像文件过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据，这导致捕获的图像文件大小过大。这些冗余的 0 填充数据将被移除，以使捕获的图像具有正常的图像文件大小。（I407b0，b/288828159）
• 修复了 Samsung S22 (SM-S901B、SM-S901B/DS) 和 S22+ (SM-S906B) 系列设备上捕获的 JPEG 图像文件过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据，这导致捕获的图像文件大小过大，在 S22 SM-S901B/DS 设备上约为 13MB。这些冗余的 0 填充数据将被移除，以使捕获的图像具有正常的图像文件大小。（I73be9，b/288828159）
• 修复了 Samsung A5、A52、A70 和 A72 系列设备上捕获的 JPEG 图像文件过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据，这导致捕获的图像文件大小过大（例如约 32MB 或甚至 96 MB）。这些冗余的 0 填充数据将被移除，以使捕获的图像具有正常的图像文件大小。（I97c4d，b/288828159）
• 修复了在启用 Extensions 时拍摄照片时发生的原生崩溃问题（I698f5）

版本 1.3.0-beta02

2023年7月26日

androidx.camera:camera-*:1.3.0-beta02 已发布。 版本 1.3.0-beta02 包含以下提交。

错误修复

• 对 Pixel 4 和 5 变体使用手电筒作为闪光灯，以提高弱光环境下的捕获质量（I56ff5，b/280221967）
• 修复了 Samsung A5 (2017) 系列设备上捕获的 JPEG 图像文件过大的问题。捕获的 JPEG 图像在 JFIF 压缩数据段中包含冗余的 0 填充数据，这导致捕获的图像文件大小约为 32 MB。这些冗余的 0 填充数据将被移除，以使捕获的图像具有正常的图像文件大小。（I29837，b/288828159）
• 修复了在 CaptureFailedRetryQuirk 中提到的有问题的设备中，捕获失败时重试未正确触发的問題。（I7b589）

版本 1.3.0-beta01

2023年6月21日

androidx.camera:camera-*:1.3.0-beta01 已发布。 版本 1.3.0-beta01 包含以下提交。

API 更改

• 将 ResolutionSelector.Builder#setHighResolutionEnabledFlag(int) 函数名称重命名为 setAllowedResolutionMode，并将 ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF/ON 常量重命名为 PREFER_CAPTURE_RATE_OVER_HIGHER_RESOLUTION/PREFER_HIGHER_RESOLUTION_OVER_CAPTURE_RATE。（If84e8）
• 已移除已弃用的 API ImageAnalysis.setTargetRotationDegrees(int)、ImageCapture.setTargetRotationDegrees(int) 和 VideoCapture.setTargetRotationDegrees(int)。(Id8e77)
• DynamicRange 类表示图像的动态范围。这可用于通过 VideoCapture.Builder#setDynamicRange() 选择高动态范围格式作为 VideoCapture 的输出。(Ib0377)
• 在 ExtensionsManager 中添加了 isImageAnalysisSupported API，应用程序可以使用它来确定在启用扩展时，是否可以将 ImageAnalysis 用例与预览和 ImageCapture 绑定。(I1bc63)
• 从 Recorder 获取的新 VideoCapabilities 类可用于查询设备上支持的视频录制动态范围和质量。 QualitySelector 的 getSupportedQualities() 和 isQualitySupported() 方法已弃用。请改用 VideoCapabilities 的 getSupportedQualities() 和 isQualitySupported() 方法。(I04014)
• CameraController#setVideoCaptureTargetQuality() 重命名为 setVideoCaptureQualitySelector 并接受参数 QualitySelector，这为视频质量设置提供了更大的灵活性。 CameraController#getVideoCaptureTargetQuality() 相应地更改为 getVideoCaptureQualitySelector。(I520ed)
• 已移除视频功能的实验性注释。视频功能现已稳定。(I1a113)

错误修复

• 在 Samsung SM-A320 型号上使用手电筒作为闪光灯，以提高弱光环境下的速度和拍摄图像质量。(I6a022，b/286190938)
• 为 ImageProxy.toBitmap() 添加了 ImageFormat.JPEG 格式支持。如果无法解码 JPEG 字节数组，则会抛出 UnsupportedOperationException。(I81958，b/282057603)

版本 1.3.0-alpha07

2023 年 5 月 24 日

androidx.camera:camera-*:1.3.0-alpha07 已发布。 版本 1.3.0-alpha07 包含以下提交。

新功能

• 新的 VideoCapture.Builder# setTargetFrameRate(Range) API 允许以除设备默认帧率之外的其他帧率捕获视频录制。可以通过新的 CameraInfo#getSupportedFrameRates() API 查询录制可用的帧率。

API 更改

• 将 ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF/ON 常量重命名为 ALLOWED_RESOLUTIONS_NORMAL/SLOW，并将构建器 setHighResolutionEnabledFlag 函数名称重命名为 setAllowedResolutionMode。(Iae817)
• CameraInfo#getSupportedFrameRateRanges() 现在返回 Set 而不是 List，以更好地表示范围是无序的。(I02f43)
• 向 CameraEffect 添加错误侦听器以处理不可恢复的错误 (Ice471)
• 在 ResolutionInfo 中添加公共构造函数以提高可测试性 (If6d1c)
• 提供了 API UseCase.snapToSurfaceRotation(int) 来替换 setTargetRotationDegrees 的用法并弃用 API ImageAnalysis.setTargetRotationDegrees(int)、ImageCapture.setTargetRotationDegrees(int) 和 VideoCapture.setTargetRotationDegrees(int)。(Ia9010)
• 添加了新的 API Preview#getTargetFrameRate 和 Preview.Builder#setTargetFrameRate 以能够设置和检索预览用例的目标帧率 (If4f22)
• VideoRecordEvent.Finalize 现在将在 Recording 对象因垃圾回收而停止时使用错误代码 ERROR_RECORDING_GARBAGE_COLLECTED 完成。(Iba974)

错误修复

• 修复了当 StreamConfigurationMapCompat 中的缓存输出大小为 null 时发生的 NullPointerException。(Idf124，b/282025204)
• 修复了在扩展程序中 Preview.setSurfaceProvider(null) 不会暂停预览的问题 (Ia903e)
• 修复了在绑定 VideoCapture 时打开相机期间抛出 ConcurrentModificationException 的问题。(Ic8ac4)

版本 1.3.0-alpha06

2023 年 4 月 19 日

androidx.camera:camera-*:1.3.0-alpha06 已发布。 版本 1.3.0-alpha06 包含以下提交。

新功能

• 并发相机是从 Android 11 开始引入的一项新功能，它支持同时流式传输相机设备，例如，它允许设备同时使用前后摄像头。CameraX 目前仅支持双并发相机，这允许两个相机同时运行，每个相机最多绑定两个 {@link UseCase}。最大分辨率为 720p 或 1440p，更多详细信息请参阅以下链接，请参阅 CameraManager#getConcurrentCameraIds()
• 介绍新的 ResolutionSelector API，其中包含以下功能
  • 应用程序可以指定纵横比和分辨率策略，以根据其需求选择最佳分辨率。
  • 所有尺寸和纵横比参数都以相机设备传感器的坐标表示。
  • 应用程序可以实现自定义分辨率过滤器，以按所需的顺序排列支持的尺寸。
  • 应用程序还可以启用高分辨率捕获以获取更高分辨率的图像。但是，请注意，使用高分辨率可能会导致捕获时间变慢。
  • 添加了 VideoCapture 镜像 API。默认情况下，VideoCapture 记录的视频不会镜像。但是，相机预览在默认情况下会在前置摄像头上镜像。 VideoCapture 镜像 API 使在使用前置摄像头时可以与相机预览对齐成为可能。有三种 MirrorMode，OFF、ON 和 ON_FRONT_ONLY。为了与相机预览对齐，建议使用 ON_FRONT_ONLY，这意味着后置摄像头的镜像功能未启用，但前置摄像头的镜像功能已启用。

API 更改

• 公开了新的 ResolutionSelector API。应用程序可以指定纵横比和分辨率策略，并使用回退规则或自定义分辨率过滤器来获得所需的结果。应用程序可以指定一个标志来启用高分辨率捕获。这将允许 CameraX 在拍摄照片或视频时选择更高的分辨率。但是，请注意，使用高分辨率可能会导致捕获时间变慢。(Ibed95)
• 现在可以通过 CameraInfo#getSupportedFrameRateRanges() 查询 AE 算法支持的 FPS 范围。(Iaa67f)
• 将所有帧率方法的名称统一为使用“FrameRate”。更正了 VideoCapture#getTargetFrameRate() 中的 javadoc 错误 (I83304)
• 已弃用旧的 setTargetAspectRatio 和 setTargetResolution API。请改用新的 ResolutionSelector API。(I542c3)
• 添加了用于并发双摄像头的公共 API，包括
  1. List<List<CameraInfo>> getAvailableConcurrentCameraInfos()
  2. ConcurrentCamera bindToLifecycle(@NonNull ConcurrentCameraConfig concurrentCameraConfig)
  3. boolean isConcurrentCameraModeOn() 和 ConcurrentCameraConfig、SingleCameraConfig 和 ConcurrentCamera (Iab1c1)
• 使 ImageProcessor.Response#getOutputImage 为 NonNull (Ib9c60)
• 添加了 VideoCapture 镜像 API，包括 VideoCapture.Builder.setMirrorMode(int) 和 VideoCapture.getMirrorMode()。这些 API 对于需要视频录制与常见相机预览行为一致的应用程序很有用，即后置摄像头预览不镜像，但前置摄像头预览镜像。(I713b6，b/194634656)
• 在 VideoCapture.Builder 中添加 setTargetFrameRate() API，并在 VideoCapture 中添加 getTargetFramerate() API (I109d4)
• 使 SurfaceOutput 扩展 Closable 并隐藏 SurfaceOutput.Event 的公共构造函数。(I60ea8)
• 添加了 Recording.mute 以动态静音或取消静音正在处理的录制。当显式静音正在处理的录制时，RecordingStats 将包含 AudioStats.AUDIO_STATE_MUTED。(Ie17fc)
• 使 #setEffects() 参数为非空。添加一个 #clearEffects() API 用于清除效果。应用程序应调用 #clearEffects() 以移除效果。(I4b4d9)
• 为 ViewfinderSurfaceRequest.Builder 添加第二个构造函数以获取用于复制构造函数的构建器 (I621a7)

错误修复

• 修复了调用扩展程序 API 的应用程序在关闭相机时可能崩溃的问题 (Ib27e5)
• 修复了 VideoCapture 在某些设备上无法与前置摄像头一起使用的问题。例如，在 Samsung Galaxy S23 和 Xiaomi 2107113SG 上。(Ibec7e，b/270656244)
• 修复了在 Android 10 或更高版本中使用外部存储公共文件夹中的文件拍摄照片始终失败的问题。请注意，在 Android 10 中，使用外部存储公共文件夹中的文件拍摄照片还需要在应用程序标签中将 requestLegacyExternalStorage 设置为 true。(I11b2c)
• 修复了 DefaultSurfaceProcessor 中的 RejectedExecutionException 崩溃问题。当绑定 VideoCapture 并暂停活动时，可能会发生此崩溃。(Idb46a，b/273713906)

版本 1.3.0-alpha05

2023 年 3 月 22 日

androidx.camera:camera-*:1.3.0-alpha05 已发布。 版本 1.3.0-alpha05 包含以下提交。

API 更改

• 添加了 VideoCapture 旋转 API，包括 VideoCapture.Builder.setTargetRotation(int)、VideoCapture.setTargetRotation(int)、VideoCapture.setTargetRotationDegrees(int) 和 VideoCapture.getTargetRotation()。这些 API 适用于锁定设备方向的应用程序。ImageCapture.setTargetRotationDegrees(int) 和 ImageAnalysis.setTargetRotationDegrees(int) 也已添加。（Id3ffe，b/205242781）
• 允许 VIDEO_CAPTURE 和 PREVIEW|VIDEO_CAPTURE 作为效果目标。目标为 VIDEO_CAPTURE 的效果将应用于 VideoCapture UseCase；目标为 PREVIEW|VIDEO_CAPTURE 的效果将在复制到预览和 VideoCapture 流之前应用于共享流。（Iee6f3）

错误修复

• 从 Camera 1.2.2：修复了在某些设备（例如 Pixel）上启用 ProGuard 时 CameraX 扩展无法正常工作的问题。（I90aa2）
• 修复了 PreviewView 的一个错误，如果应用本身处理屏幕方向，则预览在旋转后可能会变形。这仅在某些设备上发生。可以在 Pixel a4、Pixel 5 和 Pixel 6a 上重现此问题。（I14340，b/223488673）

版本 1.3.0-alpha04

2023 年 2 月 22 日

androidx.camera:camera-*:1.3.0-alpha04 已发布。版本 1.3.0-alpha04 包含这些提交。

新功能

一项支持之前不支持的 Surface 组合的新功能，通过将一个流共享到多个 UseCase 来实现。

• 之前，当在相机硬件级别 FULL 及以下绑定“预览、VideoCapture、ImageAnalysis”，或在硬件级别 LEGACY 绑定“预览、VideoCapture、ImageCapture”时，CameraX 会抛出 IllegalArgumentException。
• 新的行为是绑定将正常工作，不会抛出异常。相反，CameraX 使用 OpenGL 将共享流复制到预览和 VideoCapture。
• 由于缓冲区复制的成本，应用程序可能会看到延迟和功耗增加。

API 更改

• 添加 API 用于将 ImageProxy 转换为 Bitmap。支持的 ImageProxy 格式为 ImageFormat.YUV_420_888 和 PixelFormat.RGBA_8888。如果格式无效，将抛出 IllegalArgumentException。（Ic7110）
• 添加 CoroutineCameraViewfinder 以支持在 Kotlin 中使用挂起函数配置取景器。（I657bc）
• 为 ViewfinderSurfaceRequest 添加新的公共构造函数。当用户无法提供 CameraCharacteristics 时，它提供了灵活性。（Ie6549）

错误修复

• 修复了在某些三星设备上，如果应用程序过快地暂停/恢复，扩展程序会崩溃的问题。（Iaca26）

版本 1.3.0-alpha03

2023 年 1 月 25 日

androidx.camera:camera-*:1.3.0-alpha03 已发布。版本 1.3.0-alpha03 包含这些提交。

API 更改

• 添加了 CameraInfo.getIntrinsicZoomRatio 以提供相对于默认相机的视角信息。（Ib300c）
• 添加了 CameraInfo.getLensFacing 以提供镜头朝向信息。添加了 CameraSelector#LENS_FACING_EXTERNAL 作为选择外部相机的实验性功能。（Icaf3e）
• 添加 #setEffect() 到 CameraController，允许将效果添加到相机输出。（I1d21f）
• 添加 invalidate() 方法到 SurfaceRequest。Surface 提供程序可以通知之前提供的 Surface 无效。（Idc649）
• 添加 ImageProcessor API。此接口用于将后处理效果注入 ImageCapture 管道。（I575c6）
• 添加了 API Recorder.Builder.setAspectRatio()，它可以与 QualitySelector 结合使用以支持更多视频分辨率。（I8a082）
• 添加了 Recorder.Builder#setTargetVideoEncodingBitRate 用于设置目标视频编码 BitRate，以及 Recorder#getTargetVideoEncodingBitRate 用于获取目标视频编码 BitRate。（I5984d）

错误修复

• 修复了当没有闪光灯单元且闪光灯模式打开时 ImageCapture 失败的问题。（I9e8b4，b/263391112）
• 修复了在某些三星 Android 12 设备上写入 Exif 位置数据时 JPEG 图像损坏的问题。（Ib7086，b/263747161，b/263289024）
• 在相机初始化完成之前设置手电筒/变焦时，例如调用 CameraController#enableTorch，挂起的操作将被缓存并在初始化完成后提交。（I11e92，b/264157663）

版本 1.3.0-alpha02

2022 年 12 月 7 日

androidx.camera:camera-*:1.3.0-alpha02 已发布。版本 1.3.0-alpha02 包含这些提交。

API 更改

• 添加了一个新的 API 用于将后处理效果应用于预览输出。（Ic17d5）
• 将 OutputOptions.getDurationLimit 重命名为 OutputOptions.getDurationLimitMillis，并将 OutputOptions.setDurationLimit 重命名为 OutputOptions.setDurationLimitMillis。（I91f0c）
• 添加 AudioConfig 类来处理录制视频时的音频相关设置。@RequiresPermission 注解已从 startRecording 函数移动到 AudioConfig，以避免在不需要音频的情况下进行不必要的权限请求。（I28755）
• 删除了应用新视频捕获 API 后不再使用的 Metadata、OnVideoSavedCallback、OutputFileOptions 和 OutputFileResults 类。（I38cd8）
• 应用新的视频捕获 API。getVideoCaptureTargetSize 和 setVideoCaptureTargetSize 方法分别替换为 getVideoCaptureTargetQuality 和 setVideoCaptureTargetQuality 方法，因为 setTargetResolution 已不再支持。（I2a1d5）

错误修复

• 删除已弃用的 core.VideoCapture API。（I531e0）
• 修复了在没有存储权限的情况下拍摄照片时 onError 回调未被调用的问题。（I936db，b/244807669）
• 提高相机扩展的质量和可靠性。由于存在散景支持、图像捕获和预览未恢复的问题，因此在使用 Camera Extensions v1.1.0 及更早版本的摩托罗拉设备上禁用了相机扩展。（Id3ce3）
• 修复了在传统设备上启用视频裁剪（通过 ViewPort）时发生的原生崩溃。（I16b8a，b/251357665）

版本 1.3.0-alpha01

2022 年 11 月 9 日

androidx.camera:camera-*:1.3.0-alpha01 已发布。版本 1.3.0-alpha01 包含这些提交。

新功能

• Camera-viewfinder 已正式发布。Camera-viewfinder 提供了一个基本的取景器小部件，可以显示 Camera2 的相机馈送。请查看 示例代码 以获取示例。

API 更改

• 添加了 OutputOptions.setDurationLimit 以允许设置视频时长限制。超过指定时长限制后，录制将自动结束。（I902a0）
• 添加视频录制音频错误状态 AudioStats.AUDIO_STATE_SOURCE_ERROR。音频源设置失败或发生某些错误时发送。（I37410）

错误修复

• 添加了一个技巧，允许某些有问题的设备在遇到捕获失败时重试一次捕获。（Id4795）
• 修复了 PreviewView SurfaceView 实现 ViewPager2 上的黑屏问题。作为修复的一部分，如果请求的分辨率没有更改，PreviewView 将重用其 SurfaceView。（Ib3f27）
• 支持使用 ViewPort 或 CameraController API 进行视频裁剪（所见即所得功能）。（Ifbba8，b/201085351）
• 修复了使用前置摄像头拍摄的视频无法在华为 P40 lite 上录制的错误。（I87c57，b/250807400）

版本 1.2

版本 1.2.3

2023 年 5 月 24 日

androidx.camera:camera-*:1.2.3 已发布。版本 1.2.3 包含这些提交。

错误修复

• 修复了 VideoCapture 在某些设备上无法与前置摄像头一起使用的问题。例如，在 Samsung Galaxy S23 和 Xiaomi 2107113SG 上。(Ibec7e，b/270656244)

版本 1.2.2

2023 年 3 月 22 日

androidx.camera:camera-*:1.2.2 已发布。版本 1.2.2 包含这些提交。

错误修复

• 修复了在某些设备（例如 Pixel）上启用 ProGuard 时 CameraX 扩展无法正常工作的问题。（I90aa2）

版本 1.2.1

2023 年 1 月 25 日

androidx.camera:camera-*:1.2.1 已发布。版本 1.2.1 包含这些提交。

错误修复

• 修复了在某些三星 Android 12 设备上写入 Exif 位置数据时 JPEG 图像损坏的问题。（b/263289024）

版本 1.2.0

2022 年 12 月 7 日

androidx.camera:camera-*:1.2.0 已发布。版本 1.2.0 包含这些提交。

自 1.1.0 以来重要的更改

• 新的库 camera-mlkit-vision。轻松地将 CameraX 与许多 MLKit 功能集成，包括条形码扫描、人脸检测、文本检测等。添加了 MLKitAnalyzer 作为新的 API。
• 新的实验性零快门延迟 API。优化捕获管道以获得更好的延迟，同时保持良好的图像质量。当捕获模式设置为 CAPTURE_MODE_ZERO_SHUTTER_LAG 时，与其他捕获模式相比，预计按下快门按钮和拍摄照片之间的延迟将最小化。在不支持 ZERO_SHUTTER_LAG 的设备上，它将回退到 CAPTURE_MODE_MINIMIZE_LATENCY。

• 弃用 android.camera.core.VideoCapture。
• 添加 setStreamUseCase() 作为公共 Camera2Interop API。
• 添加 setOutputImageRotationEnabled 的 API 级别要求。
• 将 ImageAnalysis.Analyzer#getTargetResolutionOverride() 重命名为 ImageAnalysis.Analyzer#getDefaultTargetResolution()。
• 添加用于将位置元数据设置为已保存视频的 API。
• 修复使用 VideoCapture 和预览用例且纵横比为 16:9 时帧率低的问题。
• 修复在某些三星设备上启用 BOKEH 扩展程序并切换摄像头时出现的预览变黑问题。
• 修复了三星 J7 Prime (SM-G610M) 和 J7 (SM-J710MN) 在 API 级别 27 设备上 Preview/VideoCapture 拉伸的问题。
• 禁用在三星 Android T 上水平翻转前置摄像头 AF 区域的解决方法，因为该问题已修复。

版本 1.2.0-rc01

2022 年 10 月 24 日

androidx.camera:camera-*:1.2.0-rc01 已发布。 版本 1.2.0-rc01 包含这些提交。

API 更改

• 为 OutputConfiguration 添加 setStreamUseCase API。用户可以为流会话指定流用例，覆盖 CameraX 的内部逻辑以选择流用例，以便根据其需要进行优化。（Ib1a95）

错误修复

• 修复了三星 J7 Prime (SM-G610M) 和 J7 (SM-J710MN) 在 API 级别 27 设备上 Preview/VideoCapture 拉伸的问题。分辨率 1920x1080 会导致 Preview/VideoCapture 图像被拉伸。添加了解决方法，即不选择 1920x1080 分辨率用于预览或 VideoCapture 以避免图像拉伸问题。（I0e04e）
• 修复了在某些华为设备上使用 VideoCapture 和预览用例且纵横比为 16:9 时帧率低的问题。（If8c88，b/223643510）
• 修复了预览的 SurfaceProvider 未设置时相机打开失败的问题。作为修复的一部分，现在不会将未设置 SurfaceProvider 的预览配置到相机捕获会话中。（I99681）

版本 1.2.0-beta02

2022 年 9 月 21 日

androidx.camera:camera-*:1.2.0-beta02 已发布。 版本 1.2.0-beta02 包含这些提交。

API 更改

• 添加 setOutputImageRotationEnabled 的 API 级别要求（I26e3e，b/240993561）

错误修复

• 禁用在三星 Android T 上水平翻转前置摄像头 AF 区域的解决方法，因为该问题已修复。（I05f69）
• 修复了在某些三星设备上启用 BOKEH 扩展程序并切换摄像头时出现的预览变黑问题。（If6168）

版本 1.2.0-beta01

2022 年 8 月 24 日

androidx.camera:camera-*:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含这些提交。

新功能

• 新库 camera-mlkit-vision。轻松将 CameraX 与许多 MLKit 功能集成，包括条形码扫描、人脸检测、文本检测等。请在此处查找示例代码 此处。
• 新的实验性 零快门延迟 API。优化捕获管道以获得更好的延迟，同时保持良好的图像质量。当捕获模式设置为 CAPTURE_MODE_ZERO_SHUTTER_LAG 时，与其他捕获模式相比，预计按下快门按钮到拍摄照片之间的延迟将降至最低。在不支持 ZERO_SHUTTER_LAG 的设备上，它将回退到 CAPTURE_MODE_MINIMIZE_LATENCY。
• 将 ImageAnalysis.Analyzer 和 MLKitAnalyzer 设为正式 API。
• 公开用于将位置元数据设置为已保存视频的 API。
• 将 ImageAnalysis.Analyzer#getTargetResolutionOverride() 重命名为 ImageAnalysis.Analyzer#getDefaultTargetResolution()。

错误修复

• 修复了 Alps k61v1_basic_ref 图像捕获问题。从 HAL 捕获的 JPEG 图像具有错误的 Exif 元数据。Exif 元数据没有 0xffd9 或 0xffda 标记，导致 ExifInterface 无法正确解析属性。通过以 YUV 格式捕获图像，然后将其压缩为 JPEG 输出图像来解决此问题。（I45abb）

版本 1.2.0-alpha04

2022 年 7 月 27 日

androidx.camera:camera-*:1.2.0-alpha04 已发布。 版本 1.2.0-alpha04 包含这些提交。

API 更改

• 将 ImageAnalysis.Analyzer#getTargetResolutionOverride() 重命名为 ImageAnalysis.Analyzer#getDefaultTargetResolution()。行为也已更改，以便此方法返回的值可以被 ImageAnalysis#setTargetResolution() 的值覆盖。（If1d36）
• 公开用于将位置元数据设置为已保存视频的 API。可以通过新的 API androidx.camera.video.OutputOptions.Builder.setLocation(Location) 设置 android.location.Location 对象。（I313a0，b/204197544）

错误修复

• 修复了在取消绑定预览的情况下拍摄照片的问题（Ie70b6，b/235119898）
• 修复了当尝试录制时音频源不可用时 Recorder 中的崩溃。（I9f652）

版本 1.2.0-alpha03

2022 年 6 月 29 日

androidx.camera:camera-*:1.2.0-alpha03 已发布。 版本 1.2.0-alpha03 包含这些提交。

API 更改

• 删除了 ImageAnalysis.Analyzer 和 MLKitAnalyzer 的实验性注释。（I0ff22）

错误修复

• 添加了自动对焦默认超时 5000 毫秒，如果 FocusMeteringAction 未取消且 AF 部分在持续时间内未收敛，则将使用 isFocusSuccessful 为 false 完成 AF 部分。（Ibc2e3）
• 修复了在取消绑定预览的情况下拍摄照片的问题（I1d3a2，b/235119898）
• 启用高级扩展程序实现并将 CameraX 支持扩展程序接口版本更新到 1.2（I92256）

版本 1.2.0-alpha02

2022 年 6 月 1 日

androidx.camera:camera-*:1.2.0-alpha02 已发布。 版本 1.2.0-alpha02 包含这些提交。

新功能

• 公开 CameraX 零快门延迟 API 作为实验性功能。

API 更改

• 在 ImageCapture 中添加新的捕获模式 CAPTURE_MODE_ZERO_SHUTTER_LAG，并在 CameraInfo 中添加 isZslSupported 以查询设备功能。CAPTURE_MODE_ZERO_SHUTTER_LAG 模式旨在为即时捕获提供最小的延迟。它是基于环形缓冲区实现的，该缓冲区缓存中间捕获结果，以便在用户按下按钮拍照时进行后期处理。如果绑定了 {@link VideoCapture} 或闪光灯模式不是关闭状态或 OEM 扩展程序已开启，则此模式将自动禁用。（I9ae74）
• 添加 ImageAnalysis.getBackgroundExecutor() 方法（Icc945）

错误修复

• 修复了 ImageCapture takePicture 方法在报告的设备上关闭手电筒的问题。（Ib5eb5，b/228272227）
• 修复了一个错误，即在获取 CONTROL_ZOOM_RATIO_RANGE 特性时未处理 AssertionError。（/Ia248a，b/231701345）

版本 1.2.0-alpha01

2022 年 5 月 18 日

androidx.camera:camera-*:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含这些提交。

新功能

• 启动了新的库 camera-mlkit-vision

错误修复

• 修复了启用回退策略时 QualitySelector 无法录制 UHD 视频的问题。当 VideoCapture 与 ImageCapture 和预览绑定在 FULL 或更高硬件级别的相机设备上时，会出现此问题。QualitySelector 的回退策略导致 VideoCapture 错误地获取 FHD 分辨率。UHD 分辨率实际上支持此用例组合，应予采用。（I0e788，b/230651237）
• 修复了 ImageCapture.takePicture() 上的 NullPointerException。（I92366，b/230454568，b/229766155）
• 修复 androidx.camera.video.Recorder 的异步暂停行为（Ia8ce8）

Camera-Camera2、Camera-Core、Camera-Lifecycle 和 Camera-Video 版本 1.1.0

版本 1.1.0

2022 年 6 月 29 日

androidx.camera:camera-*:1.1.0 已发布。 版本 1.1.0 包含这些提交。

自 1.0.0 以来重要更改

• 发布了 View、扩展和视频捕获库的第一个 RC 版本。从 1.1.0-beta01 开始，所有 CameraX 库将统一版本号。这将帮助开发人员更容易跟踪版本，并降低大型版本兼容性矩阵的复杂性。
• 引入了新的公共 API 和功能，包括
• 添加官方 camera-video 库以支持视频捕获用例。
• YUV 到 RGB 转换和旋转功能（ImageAnalysis.Builder.setOutputImageRotationEnabled 和 setOutputImageFormat）
• 通过允许 CameraX 应用程序在相机被其他应用程序中断并重新聚焦时恢复相机来支持多窗口模式。
• 通过修复一些预览问题，确保 CameraX 在折叠设备上正常工作。
• 添加了一个 CameraState API，该 API 将通过 CameraInfo 公开。
• 添加了一个 API ProcessCameraProvider.getAvailableCameraInfos() 以直接检索有关可用摄像机的的信息。
• 当启用扩展程序时，为 ImageCapture#OnImageCapturedCallback 输出 JPEG 格式。

• 在 CameraInfo 中添加了一个 API isFocusMeteringSupported，允许应用程序检查给定的 FocusMeteringAction 是否在当前相机上受支持。
• 公开了 getResolutionInfo API，以提供预览、ImageCapture 和 ImageAnalysis 的分辨率信息。
• 添加了一个新的 API ImageCapture.Builder#setJpegQuality，允许在拍照时更改输出 JPEG 图片的压缩质量。
• 将 CameraSelector#filter 添加到公共 API 中，以便根据 CameraSelector 过滤 CameraInfos 列表。
• 添加了 Camera2CameraControl.clearCaptureRequestOptions 用于清除现有的捕获请求选项。
• 添加了一个实验性 API，用于将 CameraController 与外部图像处理库一起使用。例如 MLKit
• 添加了实验性 API CameraInfo#getCameraSelector()，它返回一个与其相机唯一对应的 CameraSelector。
• 将多个实验性 API 提升为正式的公共 API。
• 将实验性 API 中的注释 @Experimental 替换为 @RequiresOptIn。要调用实验性 API，请使用 androidx.annotation.OptIn 而不是已弃用的 androidx.annotation.experimental.UseExperimental。
• 将以下实验性 API 提升为正式 API：CameraXConfig.Builder#setAvailableCamerasLimiter()、CameraXConfig.Builder#setMinimumLoggingLevel()、CameraXconfig.Builder#setSchedulerHandler()、CameraXConfig#getAvailableCamerasLimiter()、CameraXConfig#getMinimumLoggingLevel()、CameraXConfig#getCameraExecutor()、CameraXConfig#getSchedulerHandler()。
• @ExperimentalCameraFilter API
• 实验性的曝光补偿 API。
• 将 camera-core、camera-lifecycle 和 camera-video 的实验性 UseCaseGroup API 提升为正式 API。添加了 ViewPort#getLayoutDirection、ViewPort.Builder#setLayoutDirection 和 ViewPort.Builder#setScaleType 用于自定义视口。
• 将 ExperimentalUseCaseGroupLifecycle 提升为正式的公共 API。
• 对现有 API 的更改
• MediaStoreOutputOptions.getCollection 已重命名为 MediaStoreOutputOptions.getCollectionUri。
• ActiveRecording 已重命名为 "Recording" 以减少冗余。
• 将 QualitySelector 创建器 API 更改为基于列表的 API。

错误修复

• 修复了当启用扩展模式并设置 ImageCapture#CAPTURE_MODE_MAX_QUALITY 模式时，YuvToJpegProcessor EOFException 问题。
• 修复了由于视频录制关闭导致编解码器配置失败的问题。
• 修复了以 FHD 录制时预览/视频纵横比拉伸的问题。
• 修复了某些设备上暂停和恢复后音频/视频不同步的问题。
• 修复了在低光环境下，当闪光灯模式为自动或始终开启时，轻触对焦 (startFocusAndMetering) 期间触发闪光灯的问题。

版本 1.1.0-rc02

2022 年 6 月 1 日

androidx.camera:camera-*:1.1.0-rc02 已发布。 版本 1.1.0-rc02 包含这些提交。

错误修复

• 修复了 ImageCapture.takePicture() 上的 NullPointerException。（I92366，b/230454568，b/229766155）
• 修复了一个错误，即在获取 CONTROL_ZOOM_RATIO_RANGE 特性时，未处理 AssertionError。 (Ia248a，b/231701345)

版本 1.1.0-rc01

2022 年 5 月 11 日

androidx.camera:camera-*:1.1.0-rc01 已发布。 版本 1.1.0-rc01 包含这些提交。

新功能

• 发布 camera-video、camera-view 和 camera-extension 的第一个 RC 版本。

错误修复

• 修复了当 VideoCapture<Recorder> 解绑时视频编解码器未释放的问题，导致随后使用 VideoCapture<Recorder> 在录制时出现 MediaCodec.CodecException 错误，尤其是在 API 21-22 设备上。 (Ie7f68)
• 修复 CameraExtensionsActivity 捕获的图像未在 ImageCaptureTest 中删除的问题。

版本 1.1.0-beta03

2022 年 4 月 6 日

androidx.camera:camera-*:1.1.0-beta03 已发布。 版本 1.1.0-beta03 包含这些提交。

API 更改

• 使 CaptureRequestOptions 构造函数受限。 (I261b6)
• 添加了一个实验性 API，用于将 CameraController 与外部图像处理库一起使用。例如 MLKit (I4ea71)

错误修复

• 修复了在多窗口模式下，当活动在旋转设备后未重新启动时，PreviewView 中的预览变为侧向的问题。 (I1ea36，b/223488673)
• 修复了一个多窗口问题，即当焦点切换回应用程序时，如果 (1) 其他高优先级应用程序打开不同的相机 (2) 设备为三星 Android 12 设备，则无法恢复相机。 (I7e9f2)
• 为检查闪光灯可用性时崩溃的设备包含了解决方法。这些设备将无法使用手电筒。 (If26a3，b/216667482)
• 修复了应用程序使用扩展程序并启用 proguard 时发生的 AbstractMethodError 问题。 (I7cbaf，b/222726805)
• 强制禁用摩托罗拉 razr 5G 设备上的散景扩展模式，该模式会导致预览屏幕变黑。 (I35d49)
• 修复了某些三星 API 29 之前的设备上暂停和恢复后音频/视频不同步的问题。 (I64622，b/202798609，b/202798572)
• 修复了 Sony G3125 上暂停和恢复后音频/视频不同步的问题。 (I2a1a5，b/202799148)
• 修复了 Recorder 遇到 InvalidConfigException 时发生的崩溃问题。但是，此修复程序仅防止应用程序崩溃，而不会解决 InvalidConfigException 的根本原因。如果仍然无法配置 Recorder，则应用程序将在开始录制时收到错误回调。 (I89c29，b/213617227)

外部贡献

• 由于 test-coroutines-lib 迁移，更新了 :compose:ui:ui-test api (updateApi) (I3366d)

版本 1.1.0-beta02

2022 年 2 月 23 日

androidx.camera:camera-*:1.1.0-beta02 已发布。 版本 1.1.0-beta02 包含这些提交。

API 更改

• 添加了通过 Camera2Interop 指定物理相机 ID 的功能。 (I5aed8)

错误修复

• 修复了 Oppo Find N 上的预览拉伸问题。 (I7d004)
• 修复了 Galaxy J7 Prime 上预览失真的问题。 (I4c500)
• 使用兼容的比特率查找视频编码器。 (d969052)

版本 1.1.0-beta01

2022 年 1 月 26 日

androidx.camera:camera-*:1.1.0-beta01 已发布。 版本 1.1.0-beta01 包含这些提交。

新功能

• 从 1.1.0-beta01 开始，所有 CameraX 库将对齐相同的版本号。这将有助于开发人员更轻松地跟踪版本，并降低大型版本兼容性矩阵的复杂性。

API 更改

• 添加了 Camera2CameraControl.clearCaptureRequestOptions 用于清除现有的捕获请求选项。 (Ifa07d)

错误修复

• 修复了在某些 Android O(API 26) 之前的设备上录制视频时发生的崩溃问题。 (I88fdf，b/212328261)
• 修复了在三星设备的前置摄像头中使用 cameraControl#startFocusAndMetering() 时出现的错误 AF 区域问题。 (Ifbf59，b/210548792)
• 在 Pixel 3a/Pixel 3a XL 上使用手电筒作为闪光灯，以提高黑暗环境下的速度和捕获图像质量。 (Ib12b6，b/211474332)
• 使应用程序能够在多窗口模式下，当相机被其他更高优先级的应用程序中断且焦点切换回应用程序时恢复相机。请注意，由于某些框架问题，焦点更改和相机重新打开之间可能存在一些延迟（1 秒到 10 秒或更长时间）。 (I4d092)

版本 1.1.0-alpha12

2021 年 12 月 15 日

androidx.camera:camera-*:1.1.0-alpha12 已发布。 版本 1.1.0-alpha12 包含这些提交。

API 更改

• 从内部类/接口中删除了不必要的 @RequiresApi(21) 注释。 (I8e286，b/204917951)
• QualitySelector 的质量常量和回退策略常量已更改为由类对象表示。例如，QualitySelector.QUALITY_HD 已更改为 Quality.HD，而 QualitySelector.FALLBACK_STRATEGY_LOWER 已更改为 FallbackStrategy.lowerQualityOrHigherThan(Quality) 返回的实例。用于创建 QualitySelector 的 API 已更改为基于列表的 API。新的 API QualitySelector.fromOrderedList(List<Quality>) 将引用输入质量列表的顺序，而不是由 QualitySelector.Procedure 创建的顺序。QualitySelector.Procedure 类已被删除。 (I43343)
• PendingRecording.withEventListener() 已被删除，事件侦听器现在必须传递给 PendingRecording.start()。此事件侦听器要求旨在鼓励处理在 VideoRecordEvent.Finalize 事件中报告的异步错误。 (I1e71d)
• ActiveRecording 已重命名为 Recording 以减少冗余。 (I77ceb)

错误修复

• 修复了在 Pixel 3a 和 Pixel 3a XL 上，在 FLASH_AUTO 模式下捕获的照片在黑暗条件下曝光不足的问题。 (I13f19，b/205373142)
• 始终使用最新的显示尺寸来确定预览 Resolution。 (I4a694)

• 过滤掉了没有 REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE 的相机。具有 REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE 的相机拥有每个相机设备都支持的最小功能集。没有 REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE 的相机可能是支持特殊功能的相机，并且不支持标准彩色输出。CameraX 无法支持这些相机的 Preview、ImageCapture、ImageAnalysis 或 VideoCapture 用例。因此，应过滤掉这些相机以防止错误使用。（Ib8cda）
• CameraSelector#filter 在结果集为空时不再抛出 IllegalArgumentException。（I27804）
• 现在使用更智能的启发式方法根据 OEM 指定的配置文件选择编码器设置。（Iaeef0）
• 修复了在 Pixel 1 上启动 UHD 视频录制后，预览会出现交错彩色线条的问题。（I833c6，b/205340278）

版本 1.1.0-alpha11

2021 年 11 月 17 日

androidx.camera:camera-*:1.1.0-alpha11 已发布。版本 1.1.0-alpha11 包含这些提交。

API 更改

• 将 CameraSelector#filter 添加到公共 API 中，以便根据 CameraSelector 过滤 CameraInfo 列表。（I105d0）

• 为 ImageAnalysis 配置添加了 setOutputImageRotationEnabled API。用户可以为 YUV/RGB 图像缓冲区启用旋转。旋转角度是基于传感器旋转和目标旋转计算的相对旋转，以保持图像向前。

• 为 ImageAnalysis 配置添加了 setOutputImageRotationEnabled API。用户可以为 YUV/RGB 图像缓冲区启用旋转。旋转角度是基于传感器旋转和目标旋转计算的相对旋转，以保持图像向前。

  在 ImageInfo 中添加了 getSensorToBufferTransformMatrix API。返回的矩阵是从传感器坐标到缓冲区坐标的映射，即从 CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE 的值到 (0, 0, image.getWidth, image.getHeight)。该矩阵可用于将坐标从一个 {UseCase} 映射到另一个。例如，将使用 ImageAnalysis 检测到的面部的坐标映射到 Preview。（I9ff1e）

• 添加了一个新的 API ImageCapture.Builder#setJpegQuality，允许在拍照时更改输出 JPEG 图像的压缩质量。（I8dcf4）

• 将 MediaStoreOutputOptions.getCollection 重命名为 MediaStoreOutputOptions.getCollectionUri。（I16639）

错误修复

• 修复了在弱光环境下，当闪光灯模式为自动或始终开启时，点击对焦（startFocusAndMetering）期间触发闪光灯的问题。（Id4c11）
• 在 MINIMIZE_LATENCY 模式下禁用 Pixel 2 XL/Pixel 3 XL 上的 HDR+ 以降低延迟。（Ib6270，b/203505523）

外部贡献

版本 1.1.0-alpha10

2021 年 10 月 13 日

androidx.camera:camera-*:1.1.0-alpha10 已发布。版本 1.1.0-alpha10 包含这些提交。

新功能

• 发布了 androidx.camera:camera-video:1.1.0-alpha10 作为视频的第一个 alpha 版本。在后续版本中将修复 一些已知问题。

API 更改

• 在所有 CameraX 类中添加了 @RequiresApi(21) 注解，并从 AndroidManifest.xml 中删除了 minSdkVersion。这将允许 camera-core 轻松集成到 minSdkVersion 小于 21 的应用程序中，但希望有条件地使用依赖于 API 21 及更高版本的代码路径。对于任何 minSdkVersion 为 21 或更高的应用程序，此更改无需任何操作。（Ie7f2e，b/200599470）

错误修复

• 抛出一个 InitializationException，使应用程序能够优雅地处理创建 CameraCharacteristics 时发生的 AssertionError。（Ibec79）

版本 1.1.0-alpha09

2021 年 9 月 29 日

androidx.camera:camera-camera2:1.1.0-alpha09、androidx.camera:camera-core:1.1.0-alpha09 和 androidx.camera:camera-lifecycle:1.1.0-alpha09 已发布。版本 1.1.0-alpha09 包含这些提交。

API 更改

• 现在已删除 ExperimentalUseCaseGroup 注解，因为这些 API 已经不再是实验性的。（I01ef5）

错误修复

• 修复了在 MAXIMIZE_QUALITY 模式下拍摄的照片模糊的问题。（I173a9，b/193823892）
• 修复了三星 Galaxy J5 上的一个问题，即在黑暗环境中使用闪光灯打开/自动拍摄照片后，相机卡住的问题。（I3aab9）
• 当 ImageCapture 需要裁剪时，根据设置的捕获模式使用指定的 JPEG 质量级别压缩输出的裁剪图像。如果捕获模式为 CAPTURE_MODE_MINIMIZE_LATENCY，则 JPEG 压缩质量将为 95。如果捕获模式为 CAPTURE_MODE_MAXIMIZE_QUALITY，则 JPEG 压缩质量将为 100。（Ieb37c，b/142856426）

版本 1.1.0-alpha08

2021 年 8 月 18 日

androidx.camera:camera-camera2:1.1.0-alpha08、androidx.camera:camera-core:1.1.0-alpha08 和 androidx.camera:camera-lifecycle:1.1.0-alpha08 已发布。版本 1.1.0-alpha08 包含这些提交。

新功能

• 为 image analysis 配置添加了 setOutputImageFormat API。用户可以选择 ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888 或 ImageAnalysis.OUTPUT_IMAGE_FORMAT_RGBA_8888。默认情况下，将选择 ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888。（I7902d）

API 更改

• 现在已删除 ExperimentalUseCaseGroupLifecycle 注解，因为这些 API 已经不再是实验性的。（I17b85）

错误修复

• 修复了华为 P20 Lite 上预览屏幕过亮的问题。此问题仅在将某些特殊的预览分辨率与较大的缩放值一起使用时才会发生。（Idefce，b/192129158）
• 修复了在某些设备上，将闪光灯模式设置为 FLASH_MODE_ON 后紧接着拍照时，闪光灯无法工作的问题。（Ieb49b）
• 修复了如果 VideoCapture、ImageCapture 和 Preview 绑定，则拍照时 Preview 会暂停一段时间的问题。（I56197，b/193864120）
• 允许 ImageAnalysis 选择大于 1080p 的分辨率。当与 Preview 和 ImageCapture 绑定时，高于 LIMITED 级别的设备可以为 ImageAnalysis 支持 RECORD 大小的分辨率。权衡的是，ImageCapture 选择的分辨率也需要是 RECORD 大小的分辨率。要成功为 ImageAnalysis 选择 RECORD 大小的分辨率，应在 ImageCapture 和 ImageAnalysis 上都设置 RECORD 大小的目标分辨率。这表明应用程序清楚地了解了权衡，并且更倾向于 ImageAnalysis 具有更大的分辨率，而不是 ImageCapture 具有最大的分辨率。有关 RECORD、MAXIMUM 大小的定义以及更多详细信息，请参阅 https://developer.android.com/reference/android/hardware/camera2/CameraDevice#regular-capture。RECORD 大小指的是相机设备根据 CamcorderProfile 确定的最大支持录制分辨率。MAXIMUM 大小指的是相机设备针对该格式或来自 StreamConfigurationMap.getOutputSizes(int) 的目标的最大输出分辨率。（I1ee97，b/192911449）
• 将 Exif 信息添加到拍摄的图像中。（I01ff0，b/193342619）
• 在 ImageCapture 中，如果保存位置是文件，则返回保存图像的 URI。（Ib5b49，b/149241379）
• 修复了许多设备上使用闪光灯拍摄的图像变暗的问题。（I4e510）

版本 1.1.0-alpha07

2021 年 7 月 21 日

androidx.camera:camera-camera2:1.1.0-alpha07、androidx.camera:camera-core:1.1.0-alpha07 和 androidx.camera:camera-lifecycle:1.1.0-alpha07 已发布。版本 1.1.0-alpha07 包含这些提交。

错误修复

• 修复了三星 Galaxy Note 5 上的一个问题，即在黑暗环境中使用闪光灯打开/自动拍摄照片后，相机卡住的问题。（If6871）
• 修复了当启用扩展模式并设置 ImageCapture#CAPTURE_MODE_MAX_QUALITY 模式时，YuvToJpegProcessor 出现 EOFException 问题。（I538bd，b/192017012）

版本 1.1.0-alpha06

2021 年 6 月 30 日

androidx.camera:camera-camera2:1.1.0-alpha06、androidx.camera:camera-core:1.1.0-alpha06 和 androidx.camera:camera-lifecycle:1.1.0-alpha06 已发布。版本 1.1.0-alpha06 包含这些提交。

API 更改

• 将 camera-core 的实验性曝光补偿 API 提升为正式 API。（I08ee8）
• 添加了一个 API isFocusMeteringSupported 到 CameraInfo 中，允许应用程序检查给定的 FocusMeteringAction 是否在当前相机上受支持。（Ib45ae，b/188606490）
• 公开了 getResolutionInfo API 以提供 Preview、ImageCapture 和 ImageAnalysis 的分辨率信息。（I2b613，b/188600718）
• 将以下实验性 API 提升为正式 API：CameraXConfig.Builder#setAvailableCamerasLimiter()、CameraXConfig.Builder#setMinimumLoggingLevel()、CameraXconfig.Builder#setSchedulerHandler()、CameraXConfig#getAvailableCamerasLimiter()、CameraXConfig#getMinimumLoggingLevel()、CameraXConfig#getCameraExecutor()、CameraXConfig#getSchedulerHandler()。（I2ade2）
• 公开了 CameraProvider 接口以提供对一组相机的访问。（I1a7b1）
• 将 camera-core、camera-lifecycle 和 camera-video 的实验性 UseCaseGroup API 提升为正式 API。添加了 ViewPort#getLayoutDirection、ViewPort.Builder#setLayoutDirection 和 ViewPort.Builder#setScaleType 以自定义视口。（I7cee8）

版本 1.1.0-alpha05

2021 年 6 月 2 日

androidx.camera:camera-camera2:1.1.0-alpha05、androidx.camera:camera-core:1.1.0-alpha05 和 androidx.camera:camera-lifecycle:1.1.0-alpha05 已发布。版本 1.1.0-alpha05 包含这些提交。

API 更改

• 已删除 Camera2CameraFilter 类。建议使用 CameraFilter 选择相机，并在需要时通过 Camera2CameraInfo 获取 CameraCharacteristics 或其他与 Camera2 相关的信 息。（Ib887c）
• ExperimentalCameraFilter API 现已脱离实验阶段并成为正式 API。它们可以在没有带注释的 OptIn 的情况下使用。（I4bc94）
• 添加了通过 CameraInfo#getCameraState() 暴露的相机状态 API。（Ia86b4）
• 添加了实验性 API CameraInfo#getCameraSelector()，它返回相机独有的 CameraSelector。（I77f9f）

错误修复

• 修复了在某些 Android 11 设备上，setZoomRatio 和 setLinearZoom 中返回的 ListenableFuture 无法完成的问题。（I716d7）
• 加快了相机切换速度，并降低了相机设备错误发生率。（I34c99）
• 将 ExperimentalUseCaseGroupLifecycle 替换为 ExperimentalUseCaseGroup。（I3b2ef，b/159033688）

版本 1.1.0-alpha04

2021 年 4 月 21 日

androidx.camera:camera-camera2:1.1.0-alpha04、androidx.camera:camera-core:1.1.0-alpha04 和 androidx.camera:camera-lifecycle:1.1.0-alpha04 已发布。版本 1.1.0-alpha04 包含这些提交。

错误修复

• 修复了由多个线程同时访问同一个集合导致的内存泄漏。内存泄漏可能导致 Activity 或 Fragment 被 Preview 实例保留。（I7b4b8）
• 将注释 @Experimental 替换为 @RequiresOptIn 用于实验性 API。要调用实验性 API，请使用 androidx.annotation.OptIn 而不是已弃用的 androidx.annotation.experimental.UseExperimental。（Iff226）
• 修复了在三星 Galaxy S7 上，带有闪光灯开启/自动的 ImageCapture 拍摄的照片颜色变淡的问题。（I30001）
• 添加了一个相机状态 API，它将通过 CameraInfo 暴露。（I75392）

版本 1.1.0-alpha03

2021 年 3 月 24 日

androidx.camera:camera-camera2:1.1.0-alpha03、androidx.camera:camera-core:1.1.0-alpha03 和 androidx.camera:camera-lifecycle:1.1.0-alpha03 已发布。版本 1.1.0-alpha03 包含这些提交。

错误修复

• 当启用扩展模式时，为 ImageCapture#OnImageCapturedCallback 输出 JPEG 格式。（I0d7b1）
• 修复了 UMIDIGI BISON 设备上的初始化失败问题。（I57d9e，b/180818665）
• 修复了 Samsung A3 在 PreviewView 中预览画面拉伸的问题。（Iacb30，b/180121821）

版本 1.1.0-alpha02

2021 年 2 月 24 日

androidx.camera:camera-camera2:1.1.0-alpha02、androidx.camera:camera-core:1.1.0-alpha02 和 androidx.camera:camera-lifecycle:1.1.0-alpha02 已发布。版本 1.1.0-alpha02 包含这些提交。

API 更改

• 添加了一个 API ProcessCameraProvider.getAvailableCameraInfos() 以直接检索有关可用相机的信息，这些信息可以是设备的所有相机，也可以是 CameraXConfig.Builder.setAvailableCamerasLimiter(CameraSelector) 中提供的 CameraSelector 选择的相机。（Ieac08）

错误修复

• CameraX 现在尝试在初始尝试时强制打开相机，这可能导致 CameraX 在其应用具有更高优先级时从其他相机客户端处抢占相机。（Iab069，b/175820568）
• 修复了在 CameraXConfig 中使用 setAvailableCamerasLimiter 时发生的 Robolectric 测试失败问题。（Ice307）
• 此更改捕获了在 ImageAnalysis 中图像队列已满时的异常。因此，您可能会注意到其他用例被冻结或变慢，而不是崩溃。例如，预览冻结/变慢。（Ic12da，b/175851631）
• 修复了仅绑定 Preview 或 ImageCapture 时，ExtensionsErrorListener 报告错误的问题。（I5ae39）
• 通过删除拍摄照片前图像保存位置的验证来修复 ImageCapture 性能下降问题。进行此更改后，如果保存目标无效，则获取失败响应的时间会更长，因为它将在拍摄照片后尝试保存图像。（I1fd4e，b/177061560）
• 修复了使用“文件”类型 OutputFileOptions 时的 ImageCapture 性能下降问题。（I5164a，b/177061560）
• 文档已更新，建议不要从库代码中使用 ProcessCameraProvider.configureInstance(...)。（Ib8a9f）

版本 1.1.0-alpha01

2021 年 1 月 27 日

androidx.camera:camera-camera2:1.1.0-alpha01、androidx.camera:camera-core:1.1.0-alpha01 和 androidx.camera:camera-lifecycle:1.1.0-alpha01 已发布。版本 1.1.0-alpha01 包含这些提交。

错误修复

• 包含了针对 SM-G930T 后置摄像头 JPEG 中间歇性损坏的图像数据的解决方法。（I52001，b/159831206）
• 修复了当所有预览支持的大小都小于 640x480 且显示大小大于 640x480 时发生的 IllegalArgumentException 问题。（I2a63c，b/150506192）
• 库中没有显式声明的公共资源（例如，通过 public.xml）的资源现在默认为私有。（Ia1dcc，b/170882230）

Camera-Camera2、Camera-Core 和 Camera-Lifecycle 版本 1.0.2

版本 1.0.2

2021 年 9 月 29 日

androidx.camera:camera-camera2:1.0.2、androidx.camera:camera-core:1.0.2 和 androidx.camera:camera-lifecycle:1.0.2 已发布。版本 1.0.2 包含这些提交。

错误修复

• 修复了在 MAXIMIZE_QUALITY 模式下拍摄的照片模糊的问题。（I173a9，b/193823892）
• 修复了在许多设备上拍摄带有闪光灯的照片变暗的问题。（I4e510）

Camera-Camera2、Camera-Core 和 Camera-Lifecycle 版本 1.0.1

版本 1.0.1

2021 年 7 月 21 日

androidx.camera:camera-camera2:1.0.1、androidx.camera:camera-core:1.0.1 和 androidx.camera:camera-lifecycle:1.0.1 已发布。版本 1.0.1 包含这些提交。

错误修复

• 修复了在某些 Android 11 设备上，setZoomRatio 和 setLinearZoom 中返回的 ListenableFuture 无法完成的问题。（I716d7）

• 修复了在某些设备上相机卡在关闭相机状态并导致预览变黑的问题。（I34c99）

Camera-Camera2、Camera-Core 和 Camera-Lifecycle 版本 1.0.0

版本 1.0.0

2021 年 5 月 5 日

androidx.camera:camera-camera2:1.0.0、androidx.camera:camera-core:1.0.0 和 androidx.camera:camera-lifecycle:1.0.0 已发布。版本 1.0.0 包含这些提交。

1.0.0 的主要功能

• CameraX 支持 预览、图像捕捉 和 分析
• CameraX 在易于使用的 API 中管理相机的 生命周期
• CameraX 旨在提供一个兼容性层，以修复 Android 相机生态系统中的许多问题

已知问题

• 请参阅 已知问题列表

版本 1.0.0-rc05

2021 年 4 月 21 日

androidx.camera:camera-camera2:1.0.0-rc05、androidx.camera:camera-core:1.0.0-rc05 和 androidx.camera:camera-lifecycle:1.0.0-rc05 已发布。版本 1.0.0-rc05 包含这些提交。

错误修复

• 修复了在三星 Galaxy S7 上，带有闪光灯开启/自动的 ImageCapture 拍摄的照片颜色变淡的问题。（I30001）

版本 1.0.0-rc04

2021 年 3 月 24 日

androidx.camera:camera-camera2:1.0.0-rc04、androidx.camera:camera-core:1.0.0-rc04 和 androidx.camera:camera-lifecycle:1.0.0-rc04 已发布。版本 1.0.0-rc04 包含这些提交。

错误修复

• 修复了 UMIDIGI BISON 设备上的初始化失败问题。（I57d9e，b/180818665）

版本 1.0.0-rc03

2021 年 2 月 24 日

androidx.camera:camera-camera2:1.0.0-rc03、androidx.camera:camera-core:1.0.0-rc03 和 androidx.camera:camera-lifecycle:1.0.0-rc03 已发布。版本 1.0.0-rc03 包含这些提交。

错误修复

• 修复了 ProcessCameraProvider#getInstance 文档中的格式错误
• 修复了在 CameraXConfig 中使用 setAvailableCamerasLimiter 时发生的 Robolectric 测试失败问题。
• 通过删除拍摄照片前图像保存位置的验证来修复 ImageCapture 性能下降问题。进行此更改后，如果保存目标无效，则获取失败响应的时间会更长，因为它将在拍摄照片后尝试保存图像
• 此更改捕获了在 ImageAnalysis 中图像队列已满时的异常。因此，您可能会注意到其他用例被冻结或变慢，而不是崩溃。例如，预览冻结/变慢。
• 包含了针对 SM-G930T 后置摄像头 JPEG 中间歇性损坏的图像数据的解决方法。（I52001，b/159831206）
• 此更改捕获了在 ImageAnalysis 中图像队列已满时的异常。因此，您可能会注意到其他用例被冻结或变慢，而不是崩溃。例如，预览冻结/变慢。（Ic12da，b/175851631）
• 修复了在 CameraXConfig 中使用 setAvailableCamerasLimiter 时发生的 Robolectric 测试失败问题。（Ice307）
• 通过删除拍摄照片前图像保存位置的验证来修复 ImageCapture 性能下降问题。进行此更改后，如果保存目标无效，则获取失败响应的时间会更长，因为它将在拍摄照片后尝试保存图像。（I1fd4e，b/177061560）
• 修复了使用“文件”类型 OutputFileOptions 时的 ImageCapture 性能下降问题。（I5164a，b/177061560）

版本 1.0.0-rc02

2021 年 1 月 27 日

androidx.camera:camera-camera2:1.0.0-rc02、androidx.camera:camera-core:1.0.0-rc02 和 androidx.camera:camera-lifecycle:1.0.0-rc02 已发布。版本 1.0.0-rc02 包含这些提交。

错误修复

• 修复了当所有预览支持的大小都小于 640x480 且显示大小大于 640x480 时发生的 IllegalArgumentException 问题。（b/150506192）

• 限制相机重新打开尝试次数。在尝试恢复打开相机时发生的某些问题时，CameraX 将不再无限期地尝试重新打开相机，而是在重试 10 秒后停止。I435d2

• 修复了当所有预览支持的大小都小于 640x480 且显示大小大于 640x480 时发生的 IllegalArgumentException 问题。（I2a63c，b/150506192）

版本 1.0.0-rc01

2020 年 12 月 16 日

androidx.camera:camera-camera2:1.0.0-rc01、androidx.camera:camera-core:1.0.0-rc01 和 androidx.camera:camera-lifecycle:1.0.0-rc01 已发布。 版本 1.0.0-rc01 包含以下提交。

API 更改

• 将 CameraFilter 和 Camera2Filter 更改为接收 CameraInfo。 (I6883d)
• 添加了实验性类 Camera2CameraControl，以允许动态地与 Camera2 API 交互。 (I45cf3)
• 将 Camera2CameraInfo#fromCameraInfo 重命名为 #from。 (Ia2bd6)
• 在 CameraXConfig 中添加了一个实验性的 setAvailableCamerasLimiter API，允许应用通过避免初始化未使用的摄像头来优化初始化延迟。 (I6cf88)
• 添加了实验性方法 CameraXConfig.Builder#setMinimumLoggingLevel()，以允许设置 CameraX 日志的最小日志级别。如果未设置，则默认为 Log#DEBUG。 (Ic3245)

错误修复

• 包含了针对 SM-G930V 后置摄像头的 JPEG 中间歇性损坏图像数据的解决方法。 (I5aca5、b/159831206)
• 修复了在 Samsung SM-A716 设备上，当闪光灯始终开启/开启且环境黑暗时，拍摄照片无法接收结果的问题。 (If98b2、b/172036589)
• 修复了无法通过调用 Preview.setSurfaceProvider(null) 停止预览的问题。 (I3ac18)
• 修复了某些设备上捕获 4:3 图像时的方向问题。 (I0e3fb、b/171492111)

Camera Camera2、Core 和 Lifecycle 版本 1.0.0-beta12

2020 年 11 月 11 日

androidx.camera:camera-camera2:1.0.0-beta12、androidx.camera:camera-core:1.0.0-beta12 和 androidx.camera:camera-lifecycle:1.0.0-beta12 已发布。 版本 1.0.0-beta12 包含以下提交。

错误修复

• 在 Samsung A3 设备上禁用了自动闪光灯，以修复在 Samsung A3 设备上使用自动闪光灯 AE 模式拍摄照片时发生的崩溃问题。 (Ia5fe3、b/157535165)
• 修复了在运行 Android L（API 级别 21 和 22）的 Nexus 4 设备上预览被拉伸的问题。 (I4d407、b/158749159)
• OnImageCapturedCallback#onCaptureSuccess 基类实现不再关闭图像。这是为了防止开发人员出现意外行为。开发人员不应依赖 super.onCaptureSuccess 来关闭图像。 (Ifbf9c)
• 已弃用 androidx 变体的 Experimental 注解，以提供与 Kotlin 的一致性。它已被 RequiresOptIn 注解替换，并且面向 Java 的 linter 已更新为同时支持新的 Kotlin 注解和新的 androidx 变体。 (I52495、b/151331381)

Camera-Camera2 版本 1.0.0-beta11

2020 年 10 月 14 日

androidx.camera:camera-camera2:1.0.0-beta11 已发布。 版本 1.0.0-beta11 包含以下提交。

新功能

• 支持 Android 11 的 CONTROL_ZOOM_RATIO API，用于在包含有效 CONTROL_ZOOM_RATIO_RANGE 的 Android 11 或更高版本的设备上进行缩放。 (I62cc6)

错误修复

• 修复了当摄像头 ID 为非整数摄像头 ID 时发生的 NumberFormatException 问题。 (Ib2228)
• 改进了 CameraX 初始化和 bindToLifecycle 的延迟。 (I61dc5)
• 创建 UseCases 不需要初始化 CameraX 即可完成。所有实现特定的配置都将在 UseCase 附加到 Camera 实例后设置，对于公共 API 而言，该实例为 ProcessCameraProvider.bindToLifecycle()。 (Ia5411)
• <UseCase>.getTargetRotation() 如果在附加到 Camera 实例之前调用，则会返回 Surface.ROTATION_0，除非在 Builder 或 UseCase 上设置了 targetRotation。 (I80fcd)

Camera-Core 版本 1.0.0-beta11

2020 年 10 月 14 日

androidx.camera:camera-core:1.0.0-beta11 已发布。 版本 1.0.0-beta11 包含以下提交。

**新功能** - 支持 Android 11 的 CONTROL_ZOOM_RATIO API，用于在包含有效 CONTROL_ZOOM_RATIO_RANGE 的 Android 11 或更高版本的设备上进行缩放。 (I62cc6)

错误修复

• 修复了当摄像头 ID 为非整数摄像头 ID 时发生的 NumberFormatException 问题。 (Ib2228)
• 创建 UseCases 不需要初始化 CameraX 即可完成。所有实现特定的配置都将在 UseCase 附加到 Camera 实例后设置，对于公共 API 而言，该实例为 ProcessCameraProvider.bindToLifecycle()。 (Ia5411)
• <UseCase>.getTargetRotation() 如果在附加到 Camera 实例之前调用，则会返回 Surface.ROTATION_0，除非在 Builder 或 UseCase 上设置了 targetRotation。 (I80fcd)

Camera-Core 版本 1.0.0-beta10

2020 年 9 月 23 日

androidx.camera:camera-core:1.0.0-beta10 已发布。 版本 1.0.0-beta10 包含以下提交。

错误修复

• 修复了验证图像捕获的文件保存目标的错误 (I8c565、b/167697553)

Camera-Camera2 版本 1.0.0-beta10

2020 年 9 月 23 日

androidx.camera:camera-camera2:1.0.0-beta10 已发布。 版本 1.0.0-beta10 包含以下提交。

错误修复

• 发布以支持 Camera-Core 1.0.0-beta10

Camera-Camera2 版本 1.0.0-beta09

2020 年 9 月 16 日

androidx.camera:camera-camera2:1.0.0-beta09 已发布。 版本 1.0.0-beta09 包含以下提交。

API 更改

• Camera2CameraInfo 在创建时接收 CameraInfo 实例，而不是提供静态方法，以从中检索与 Camera2 相关的的信息。 (I5b844)

错误修复

• 修复了平板电脑设备上的目标纵横比问题。当目标纵横比设置为 AspectRatio.RATIO_16_9 时，应选择 16:9 大小。 (Ib7fcf、b/151969438)
• 抛出 InitializationException，使应用能够优雅地处理创建 CameraCharacteristics 时发生的 AssertionError。 (I89c8c、b/160524721)
• 添加了用于曝光补偿的实验性接口。 (If96c7)

Camera-Core 版本 1.0.0-beta09

2020 年 9 月 16 日

androidx.camera:camera-core:1.0.0-beta09 已发布。 版本 1.0.0-beta09 包含以下提交。

API 更改

• 修复了在 UseCaseGroup 上将视口标记为非空的错误。开发人员应该能够在不设置视口的情况下创建视口。 (Ie3d2e)
• 添加了用于 ExposureCompensation 的实验性接口。 (If96c7)
• 允许预览具有任意目标旋转。转换信息通过新的 TranformationInfoListener 回调动态计算并返回给用户。 (I21470)

错误修复

• 修复了某些设备上闪光灯无法关闭的问题。当闪光灯模式设置为 FLASH_MODE_ON 拍摄照片，并在闪光灯触发时更改为 FLASH_MODE_OFF 时，就会发生这种情况。症状类似于启用了手电筒模式。 (Ib4451、b/162568128)
• 如果启用了扩展效果并且供应商库实现需要对输出表面进行特殊处理，则强制 PreviewView 使用 TextureView。 (I0c3cc)
• 修复了将活动/片段上下文传递给 ProcessCameraProvider.getInstance(Context) 时发生的活动/片段泄漏问题。

已知问题

• 当设置 ViewPort 时，图像捕获的裁剪矩形在 HAL 中旋转图像缓冲区的设备上可能不正确。这将在下一个版本中修复。

Camera-Camera2 版本 1.0.0-beta08

2020 年 8 月 19 日

androidx.camera:camera-camera2:1.0.0-beta08 已发布。 版本 1.0.0-beta08 包含以下提交。

错误修复

• 优化了 bindToLifecycle，使其能够在主线程上快速运行。 (I1d57e)
• DisplayOrientedMeteringPointFactory 接收 CameraInfo 实例而不是 CameraSelector，因此可以直接映射到工厂将为其生成点的摄像头。所有使用 DisplayOrientedMeteringPointFactory 的类也接收 CameraInfo 实例而不是 CameraSelector。 (I400c1)
• 修复了自动分辨率纵横比大小分组问题，即当目标分辨率设置为 2016x1080 且支持另一个 1920x1080 16:9 大小时，选择 16:9 mod16 大小 (864x480)。 (I53167、b/159363774)
• 修复了 CameraControl 由于竞争条件而无法工作的问题。 (I2279f、b/152333890、b/160714166)

Camera-Core 版本 1.0.0-beta08

2020 年 8 月 19 日

androidx.camera:camera-core:1.0.0-beta08 已发布。 版本 1.0.0-beta08 包含以下提交。

API 更改

• DisplayOrientedMeteringPointFactory 接收 CameraInfo 实例而不是 CameraSelector，因此可以直接映射到工厂将为其生成点的摄像头。所有使用 DisplayOrientedMeteringPointFactory 的类也接收 CameraInfo 实例而不是 CameraSelector。 (I400c1)

错误修复

• 对于图像捕获，根据摄像头方向覆盖元数据中的水平翻转标志。 (I28499)

• 当使用不从Context.getApplicationContext()返回Application对象的Context时，初始化不再崩溃。（I3d3c9，b/160817073）

Camera-Camera2 版本 1.0.0-beta07

2020年7月22日

androidx.camera:camera-camera2:1.0.0-beta07 已发布。 版本 1.0.0-beta07 包含这些提交。

错误修复

• 修复了Android 5.0 Legacy设备上预览被拉伸的问题。（I0c03a）
• 排除了某些会导致某些设备上出现所见即所得问题的JPEG支持尺寸。（Ib5128）

Camera-Core 版本 1.0.0-beta07

2020年7月22日

androidx.camera:camera-core:1.0.0-beta07 已发布。 版本 1.0.0-beta07 包含这些提交。

API 更改

• 将FIT_CENTER、FIT_START和FIT_END适配样式与FIT合并。FIT表示返回的裁剪矩形将是最大可能的传感器矩形。（Ia73c3）
• 预览的裁剪矩形由视口配置。只有裁剪矩形覆盖的区域对最终用户可见。（I142a4）

错误修复

• 修复了Android 5.0 Legacy设备上预览被拉伸的问题。（I0c03a）
• 修复了在解除绑定用例时发生的ConcurrentModificationException异常问题。（I371c0）

Camera-Camera2 版本 1.0.0-beta06

2020年6月24日

androidx.camera:camera-camera2:1.0.0-beta06 已发布。 版本 1.0.0-beta06 包含这些提交。

API 更改

• 添加了通过相机ID和CameraCharacteristics过滤相机的实验性接口。（I28f61）

错误修复

• 修复了在三星Galaxy S7上startFocusAndMetering无法成功聚焦的问题。（If3be7，b/159039233）
• 修复了退出应用程序后无法关闭相机的问题。（I7a7b3）
• 修复了使用SurfaceView实现的PreviewView时，重复切换相机会中断预览的问题。（I920ce）
• 如果指定的测量点均无法生成有效的测量矩形，则CameraControl#startFocusAndMetering将失败。（Id53ce）

Camera-Core 版本 1.0.0-beta06

2020年6月24日

androidx.camera:camera-core:1.0.0-beta06 已发布。 版本 1.0.0-beta06 包含这些提交。

API 更改

• 添加了通过相机ID和CameraCharacteristics过滤相机的实验性接口。（I28f61）

错误修复

• CameraX现在可以在调用ProcessCameraProvider#getInstance()之前使用ProcessCameraProvider#configureInstance()进行配置。这允许自定义CameraXConfig，而无需在应用程序的Application类中实现CameraXConfig.Provider。（Ia1a8d）
• 如果指定的测量点均无法生成有效的测量矩形，则CameraControl#startFocusAndMetering将失败。（Id53ce）

Camera-Camera2 版本 1.0.0-beta05

2020年6月10日

androidx.camera:camera-camera2:1.0.0-beta05 已发布。 版本 1.0.0-beta05 包含这些提交。

错误修复

• 修复了手机处于勿扰模式下初始化CameraX时应用程序启动时崩溃的问题。InitializationException包含一个CameraUnavailableException，它将被设置为初始化结果的ListenableFuture，而不是使应用程序崩溃。（I9909a，b/149413835）
• 修复了在CONTROL_AF_STATE为null的设备上调用startFocusAndMetering时发生的崩溃。（Ife55e，b/157084254）

Camera-Core 版本 1.0.0-beta05

2020年6月10日

androidx.camera:camera-core:1.0.0-beta05 已发布。 版本 1.0.0-beta05 包含这些提交。

API 更改

• 修复了手机处于勿扰模式下初始化CameraX时应用程序启动时崩溃的问题。InitializationException包含一个CameraUnavailableException将被设置为初始化结果的ListenableFuture，而不是使应用程序崩溃。（I9909a，b/149413835）

错误修复

• 更新了setTargetResolution和setTargetRotation的Javadoc。（Iae16f）

Camera-Camera2 版本 1.0.0-beta04

2020年5月27日

androidx.camera:camera-camera2:1.0.0-beta04 已发布。 版本 1.0.0-beta04 包含这些提交。

错误修复

• 允许应用程序通过Camera2Interop设置任何Camera2捕获请求参数，而不会导致崩溃。请注意，如果由于覆盖参数而导致出现问题。覆盖使用Camera2Interop的参数时，不保证稳定性和行为。（Ibe5a1，b/149103700）
• 在使用伪本地化的设备上使用应用程序时，修复了自动初始化问题。（I3bef3，b/154767663）
• 将与分离的用例相关的错误日志转换为Camera2CameraImpl上的调试日志。（I1a565，b/154422490）
• 修复了即使闪光灯已触发，拍摄的图像有时也会太暗的问题。（I5d9fa，b/149729613）
• 修复了来自ImageCapture的ImageProxy中的缓冲区未倒带的错误。（I0c455，b/153249512）
• 修复了仅绑定ImageCapture时出现的问题：（1）无法使用MAX_QUALITY拍摄照片；（2）由于自动曝光不起作用而导致图像质量差。（I17782，b/145326998）
• 提高了当CameraX被另一个进程或代码路径窃取相机断开连接时重新打开相机的可靠性。（I1fbc3，b/153714651）

Camera-Core 版本 1.0.0-beta04

2020年5月27日

androidx.camera:camera-core:1.0.0-beta04 已发布。 版本 1.0.0-beta04 包含这些提交。

API 更改

• 添加了一个实验性API，CameraXConfig.Builder#setSchedulerHandler()，用于设置CameraX相机堆栈内部使用的处理程序。这个新API与CameraXConfig.Builder#setCameraExecutor()一起使用，应该可以完全控制CameraX相机堆栈正在使用的线程。（I7bf32，b/121160431）

错误修复

• 修复了ImageAnalysis中的崩溃，其中在ImageReaderProxy关闭后访问了ImageProxy。这还使得Analyzer接收到的所有ImageProxy都必须在ImageReaderProxy关闭之前关闭。（I4b299，b/145956416，b/154155377，b/156357269）
• 从PreviewView#createSurfaceProvider()中删除了CameraInfo参数，PreviewView现在在内部从SurfaceRequest中检索它。（If18f0，b/154652477）
• 在使用伪本地化的设备上使用应用程序时，修复了自动初始化问题。（I3bef3，b/154767663）
• 修复了即使闪光灯已触发，拍摄的图像有时也会太暗的问题。（I5d9fa，b/149729613）
• 修复了ImageAnalysis中的问题，其中多次调用setAnalyzer/clearAnalyzer导致分析器未收到要分析的图像。（I6169f，b/151605317，b/153514544）
• 修复了来自ImageCapture的ImageProxy中的缓冲区未倒带的错误。（I0c455，b/153249512）
• 修复了CameraManager中支持列表中的第一个相机并不总是被选择使用的问题。（I4c624，b/153418028）
• 修复了由设置Preview.SurfaceProvider未释放先前请求的表面引起的间歇性崩溃。“java.lang.IllegalStateException: Camera surface session should only fail with request cancellation”（I8e4e7，b/155936225）

Camera-Camera2 版本 1.0.0-beta03

2020年4月15日

androidx.camera:camera-camera2:1.0.0-beta03 已发布。 版本 1.0.0-beta03 包含这些提交。

错误修复

• 支持camera-core发布的修复

Camera-Core 版本 1.0.0-beta03

2020年4月15日

androidx.camera:camera-core:1.0.0-beta03 已发布。 版本 1.0.0-beta03 包含这些提交。

错误修复

• 修复了beta03中的回归，其中使用零UseCase调用bindToLifecycle()会导致抛出异常。这阻止了在不绑定UseCase的情况下检索Camera。

Camera-Camera2 版本 1.0.0-beta02

2020年4月1日

androidx.camera:camera-camera2:1.0.0-beta02 已发布。 版本 1.0.0-beta02 包含这些提交。

错误修复

• 修复了ImageCapture生成的ImageProxy中的ImageInfo.getRotationDegrees()，使其与EXIF方向旋转值匹配。（Id4281，b/150802561）
• 不再需要在build.gradle中显式排序CameraX依赖项以使用默认的CameraX/Camera2实现。对于需要声明严格依赖项的情况，现在可以在构建文件中包含所有CameraX依赖项。（I46e88）
• 修复了在显示尺寸小于640x480的设备上发生的IllegalArgumentException问题。（Ife3f2，b/150506192）
• 修复了bindToLifecycle，使其仅在成功绑定时修改UseCase。以前，当调用bindToLifecycle以进行分辨率计算时，UseCase会更新。现在它不再需要更新UseCase来进行计算。（I78d9e）

Camera-Core 版本 1.0.0-beta02

2020年4月1日

androidx.camera:camera-core:1.0.0-beta02 已发布。 版本 1.0.0-beta02 包含这些提交。

错误修复

• 修复了ImageCapture生成的ImageProxy中的ImageInfo.getRotationDegrees()，使其与EXIF方向旋转值匹配。（Id4281，b/150802561）
• 修复了bindToLifecycle，使其仅在成功绑定时修改UseCase。以前，当调用bindToLifecycle以进行分辨率计算时，UseCase会更新。现在它不再需要更新UseCase来进行计算。（I78d9e）
• 修复了在多次调用 Preview.setSurfaceProvider() 后，预览界面发生变化时，Preview 使用案例的捕获会话未更新的问题。

Camera-Camera2 版本 1.0.0-beta01

2020 年 2 月 26 日

androidx.camera:camera-camera2:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含以下提交。

错误修复

• 将 SurfaceRequest.setSurface(Surface) 重命名为 SurfaceRequest.provideSurface(Surface)，并将 SurfaceRequest.setWillNotComplete() 重命名为 SurfaceRequest.willNotProvideSurface()。（I224fe）
• 修复了使用 ImageCapture.setTargetRotation() 更改目标旋转值后，保存图像的纵横比不正确的问题。（I474ea，b/148763432）
• 通过保留设置默认 CameraXConfig 提供程序的标志，修复了启用 ProGuard 的应用程序变体的初始化问题。（I2d6c1）

Camera-Core 版本 1.0.0-beta01

2020 年 2 月 26 日

androidx.camera:camera-core:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含以下提交。

API 更改

• 将 SurfaceRequest.provideSurface() 上的 ListenableFuture 替换为 Executor 和 Callback。这通过不再需要处理 provideSurface() 上的异常来简化 API，并强制执行 provideSurface() 回调不能被取消。这是为了防止旧设备上由于过早释放表面而导致的崩溃。 SurfaceRequest.Result 对象现在用于跟踪 SurfaceRequest 如何使用提供的 Surface。（I7854b）
• 将 SurfaceRequest.setSurface(Surface) 重命名为 SurfaceRequest.provideSurface(Surface)，并将 SurfaceRequest.setWillNotComplete() 重命名为 SurfaceRequest.willNotProvideSurface()。（I224fe）

错误修复

• 修复了使用 ImageCapture.setTargetRotation() 更改目标旋转值后，保存图像的纵横比不正确的问题。（I474ea，b/148763432）
• 通过保留设置默认 CameraXConfig 提供程序的标志，修复了启用 ProGuard 的应用程序变体的初始化问题。（I2d6c1）
• 更新了闪光灯模式 API 的文档，以包含可能的值。（I4a3ec）

Camera-Camera2 版本 1.0.0-alpha10

2020 年 2 月 10 日

androidx.camera:camera-camera2:1.0.0-alpha10 已发布。 版本 1.0.0-alpha10 包含以下提交。

错误修复

• 通过确保仅在 Camera2 使用期间保留 Surface，提高了 INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY 设备上的稳定性。（I9dac2）
• 通过正确调整 CONTROL_AE_TARGET_FPS_RANGE，修复了 LEGACY 设备上的曝光不足的预览问题。（1224638）

Camera-Core 版本 1.0.0-alpha10

2020 年 2 月 10 日

androidx.camera:camera-core:1.0.0-alpha10 已发布。 版本 1.0.0-alpha10 包含以下提交。

API 更改

• 更新了 ImageCapture 以允许将图像保存到 Uri 和 OutputStream。将重载的 takePicture 方法合并为一个。更新了测试应用程序以使用 Uri 作为规范示例。（Ia3bec）
• Preview.PreviewSurfaceProvider 已重命名为 Preview.SurfaceProvider。 SurfaceProvider 不再要求开发人员创建自己的 ListenableFuture，并且现在通过新的 SurfaceRequest 对象提供 Surface。由于在 Preview 与其他类（如 PreviewView）配对时可能被误用，因此已删除 Preview.getPreviewSurfaceProvider() 方法。（I20105）
• 向 Preview 添加了 getTargetRotation() 和 getTargetName()。（Iceee7）
• 在 ImageAnalysis 中添加了 getTargetRotation()、getBackpressureStrategy() 和 getImageQueueDepth()。（I9d6d9）
• 在 ImageCapture() 中添加了 getTargetRotation() 和 getCaptureMode()（I5bc17）
• 先前在 ImageCapture.OnImageSavedCallback.onError() 和 ImageCapture.OnImageCapturedCallback.onError() 中传递的参数现已替换为单个参数 ImageCaptureException，该参数仍然包含先前传递的所有信息。
• 先前在 ImageCapture.OnImageSavedCallback.onImageSaved() 中传递的文件参数已删除。（I750d2）
• Preview 和 ImageCapture 类现在标记为 final。（I2500b）
• API 已更新，CameraInfo 的 getZoomRatio()、getMaxZoomRatio()、getMinZoomRatio() 和 getLinearZoom() 方法合并到 getZoomState() 中，后者返回一个 ZoomState 实例。（Ib19fe）
• 从 CameraXConfig 中删除了 API 字段 OPTION_TARGET_CLASS 和 OPTION_TARGET_NAME，因为它们仅供内部库使用。删除了 CameraXConfig.Builder 的构造函数。（I96912）
• 删除了应用程序必须扩展 Application 才能初始化 CameraX 的要求。只要应用程序的 build.gradle 中包含 camera-camera2 工件，CameraX 现在将使用默认的 Camera2 配置进行初始化。（I58ff5）（b/146923574）

Camera-Camera2 版本 1.0.0-alpha09

2020 年 1 月 22 日

androidx.camera:camera-camera2:1.0.0-alpha09 已发布。 版本 1.0.0-alpha09 包含以下提交。

API 更改

• 添加用于提取 Camera2 摄像机 ID 的 camera2 互操作路径。您可以使用 Camera2CameraInfo.extractCameraId() 从 CameraInfo 中提取摄像机 ID。以下代码示例演示了如何使用它

  Camera camera = provider.bindToLifecycle(...);
  String cameraId =
      Camera2CameraInfo.extractCameraId(camera.getCameraInfo());
  

  Camera2CameraInfo 类需要 ExperimentalCamera2Interop markerClass。

Camera-Core 版本 1.0.0-alpha09

2020 年 1 月 22 日

androidx.camera:camera-core:1.0.0-alpha09 已发布。 版本 1.0.0-alpha09 包含以下提交。

API 更改

• SurfaceOrientedMeteringPointFactory 参数 useCaseForSurface 已重命名为 useCaseForAspectRatio，并且参考文档已扩展。
• FocusMeteringAction.Builder.from() 方法已替换为构造函数 FocusMeteringAction.Builder()。
• 删除了 DisplayOrientedMeteringPointFactory(android.content.Context, androidx.camera.core.CameraSelector, float, float)。应用程序应使用带有 Display 参数的构造函数并传入当前显示。
• 关于 MeteringMode 和 3A 标志以及 Display 参数的使用，改进了焦点和测光 API 的 Javadoc。
• 扩展了 setZoomRatio 和 setLinearZoom 的参考文档。

错误修复

• 修复了关闭然后打开摄像头导致“先决条件”检查失败的问题。
• 修复了使用手电筒和缩放 API 时可能发生的 ConcurrentModificationException。
• 修复了现在在有 mod16 尺寸时选择更接近请求分辨率的分辨率的问题。
• startFocusMetering 和 cancelFocusMetering API 现在按文档说明的行为，具有正确的时序，并且在发生错误时可能会返回错误。
• 修复了在设备不支持此类尺寸的情况下请求特定目标分辨率和裁剪纵横比时出现的问题。现在，如果可用，将选择具有足够分辨率以绑定原始请求的非裁剪尺寸。

Camera-Camera2 版本 1.0.0-alpha08

2019 年 12 月 18 日

androidx.camera:camera-camera2:1.0.0-alpha08 已发布。 版本 1.0.0-alpha08 包含以下提交。

已知问题

• 并非所有 Camera2 捕获请求选项在使用 Camera2 互操作时都能正常工作。如果请求的选项不受支持，则会话将无法启动，并且可能会发生如下错误：09-09 14:04:13.643 10117 26020 26036 E AndroidRuntime: java.lang.IllegalArgumentException: Unsupported session configuration combination

错误修复

• 修复了在旋转或切换 API 级别 21 和 22 的摄像头后出现预览黑屏的问题。

API 更改

• 实验性：添加了用于提取摄像机 ID 的 camera2 互操作路径。

Camera-Core 版本 1.0.0-alpha08

2019 年 12 月 18 日

androidx.camera:camera-core:1.0.0-alpha08 已发布。 版本 1.0.0-alpha08 包含以下提交。

已知问题

• 使用 PreviewView 或 CameraView 的应用程序可能具有错误的纵横比预览。这发生在某些 FULL 设备（例如 Pixel 2）上暂停或恢复之后。

错误修复

• 更新了 FocusMeteringAction 和 CameraControl 的文档。
• 为 enableTorch() 和 getTorchState() 实现了 TorchControl。

API 更改

• 隐藏了 IntDefs 并将 IntDef 常量移到 IntDef 定义之外。
• 将 rotationDegrees 从类 OnImageCaptureCallback 移到 ImageInfo。
• 将 rotationDegrees 从类 Analyzer 移到 ImageInfo。

Camera-Camera2 版本 1.0.0-alpha07

2019 年 12 月 4 日

androidx.camera:camera-camera2:1.0.0-alpha07 已发布。 camera-camera2 的 1.0.0-alpha07 版本包含以下提交

• Camera2Config 现在可用于初始化和配置基于 Camera2 的 CameraX 实现。有关如何在初始化中使用它的更多详细信息，请参阅发行说明的 camera-core 部分。
• camera2 互操作功能现在标记为实验性并移动到单独的包 androidx.camera.camera2.interop. 中。

Camera-Core 版本 1.0.0-alpha07

2019 年 12 月 4 日

androidx.camera:camera-core:1.0.0-alpha07 已发布。 camera-core 的 1.0.0-alpha07 版本包含以下提交

请注意，此 Alpha 版本在为 Beta 做准备的过程中进行了一些重大更改。 我们建议您查看这些更改，并分享您对 CameraX Google 论坛 的任何反馈。对于在 Play 商店中使用 CameraX 的应用开发者，我们建议您等待正式发布 Beta 版本后再升级应用中的库。

API 更改

• 重要：CameraX 初始化已更改。应用应实现 CameraXConfig.Provider，并使用 androidx.camera.camera2 提供的默认 Camera2Config。典型用法如下：

  import androidx.camera.camera2.Camera2Config
  import androidx.camera.core.CameraXConfig
  
  public class MyCameraXApplication : Application(),  CameraXConfig.Provider {
      override fun getCameraXConfig(): CameraXConfig {
              return Camera2Config.defaultConfig(this)
      }
  }
  

• CameraX 类已被移除。以前由 CameraX 类提供的 bindToLifecycle()、unbind()、unbindAll()、isBound() 和 hasCamera() 调用现在可通过 ProcessCameraProvider 使用。

• 每个进程的 ProcessCameraProvider 实例是使用静态方法 ProcessCameraProvider.getInstance() 异步获取的，该方法返回一个可监听的 Future，在完成时提供 ProcessCameraProvider。此处在典型用法中显示在 onCreate() 中。您可以在活动生命周期的后期放置对 getInstance() 的调用，以将初始化延迟推迟到稍后的时间（例如，当用户操作打开相机 UI 时）。

  import androidx.camera.lifecycle.ProcessCameraProvider
  import com.google.common.util.concurrent.ListenableFuture
  
  class MainActivity : AppCompatActivity() {
     private lateinit var cameraProviderFuture : ListenableFuture<ProcessCameraProvider>
     override fun onCreate(savedInstanceState: Bundle?) {
         cameraProviderFuture = ProcessCameraProvider.getInstance(this);
    }
  

• 可以将监听器添加到 getInstance() 返回的 ListenableFuture 中。这确保了可以在不阻塞 Future.get() 的情况下从 Future 中检索相机提供程序。

  cameraProviderFuture.addListener(Runnable {
    val cameraProvider = cameraProviderFuture.get()
    cameraProvider.bindToLifecycle(...)
  }, ContextCompat.getMainExecutor(this))
  

• 相机选择现在由相机选择器完成，而不是每个用例。

  val cameraSelector = CameraSelector.Builder().requireLensFacing(LensFacing.BACK).build()
  

• CameraProvider.bindToLifecycle 获取生命周期所有者、相机选择器和用例，然后将它们绑定到给定的生命周期所有者并为选定的相机运行。

  cameraProvider.bindToLifecycle(this as LifecycleOwner,
         cameraSelector, preview, imageAnalysis)
  

• 用例“配置”类已移除。相反，直接构建用例，在每个用例构建器上设置选项。例如：

  preview = Preview.Builder().setTargetAspectRatio(AspectRatio.RATIO_16_9).build()
  

• 预览用例已更新为接受应用程序创建和管理的 Surface，以确保 Android 最佳实践。强烈建议使用相机视图包中提供的 PreviewView 视图类。

  preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
  

• 请参阅有关附加应用程序管理的 Surface 的文档。在这些情况下，应用程序管理 Surface 的生命周期。

• 重要：ImageAnalysis Analyzer 方法的实现必须在完成对接收到的图像的使用后调用接收到的图像上的 image.close()。否则，新图像可能无法接收或相机可能会停止，具体取决于背压设置。有关详细信息，请参阅 参考文档。

• ImageAnalysis ImageReaderMode 现在已更改为背压策略 intdef。

• ImageProxy.getImage() 被标记为实验性。例如，应用应通过 @androidx.camera.core.ExperimentalGetImage 注释使用情况。

• 已移除 Analyzer 的 UIThread 注释要求。

• 添加了 ImageAnalysis.clearAnalyzer() 函数以移除分析器。

• 具有多个方法的监听器已重命名为回调。

  • ImageCapture.OnImageCapturedListener 现在是 ImageCapture.OnImageCapturedCallback
  • ImageCapture.OnImageSavedListener 现在是 ImageCapture.OnImageSavedCallback
  • VideoCapture.OnVideoSavedListener 现在是 VideoCapture.OnVideoSavedCallback

• 枚举已更改为 IntDef。

• 已添加缩放控件。

  • CameraControl.setLinearZoom()
  • CameraControl.setZoomRatio()
  • CameraInfo.getLinearZoom()
  • CameraInfo.getMaxZoomRatio()
  • CameraInfo.getZoomRatio()

• CameraInfo.hasFlashUnit() 已添加以确定闪光灯/手电筒硬件是否存在。

• CameraInfo.isFlashAvailable() 已移除。手电筒覆盖闪光灯功能。更多详细信息包含在 参考文档 中。

• ImageCapture.Metadata 字段已替换为 get/set/is 访问器。

• startFocusMetering 和 cancelFocusMetering 现在返回 ListenableFutures，它们表示调用的异步操作。

• MeteringPoints 现在充当测光操作的句柄，并由工厂生成。应用应使用现有工厂，而不是自定义工厂。

已修复的问题

• 修复了在恢复时拍摄照片时出现的问题（在之前的暂停已将照片挂起以完成之后）。
• 已知问题：CameraControl.enableTorch() 可用，但返回的 ListenableFuture<Void> 始终是立即完成 (成功) 的 Future，即使没有闪光灯单元也是如此。未来版本将将其修复为最终行为：当没有闪光灯单元时，enableTorch(true) 会立即失败（不会向 CaptureSession 发送请求），并且 TorchState 保持关闭状态。
• 已知问题：startFocusAndMetering 和 cancelFocusAndMetering 启动和取消对焦测光，但返回立即完成 (成功) 的 Future，不代表已记录的行为。ListenableFuture<FocusMeteringResult> CameraControl.startFocusAndMetering() 中的 FocusMeteringResult 是一个伪结果，isFocusSuccessful() 始终为“false”，与预期的记录行为不同。
• 已知问题：正在开发一个用于 PreviewView 触摸事件的测光点工厂。目前，连接自定义管理 Surface 的应用可以使用现有的测光点工厂，否则 PreviewView 将无法使用触摸对焦功能。

Camera-Camera2 和 Camera-Core 版本 1.0.0-alpha06

2019 年 10 月 9 日

androidx.camera:camera-camera2:1.0.0-alpha06 和 androidx.camera:camera-core:1.0.0-alpha06 已发布。这些是 包含在 camera-camera2:1.0.0-alpha06 中的提交，这些是 包含在 camera-core:1.0.0-alpha06 中的提交。

新功能

设置纵横比的更改

• setTargetAspectRatioMode() 已添加，并接受枚举参数。这将设置纵横比模式，选项为 RATIO_4_3 或 RATIO_16_9，而不是任意纵横比。这更准确地反映了这样一个事实，即相机只提供某些纵横比，而不是任何任意比例。
  • 目前，唯一可用的比例为 16:9 和 4:3。在 1:1 的情况下，只有某些设备的相机提供此比例，并且仅限于有限的分辨率。设计 1:1 界面或处理的应用应使用更灵活的 16:9 或 4:3 选择，并裁剪显示或处理子区域。
  • 这些纵横比的方向是为了使用最大的传感器区域。
• getTargetAspectRatio() 已添加到用例配置 API 中，返回用例输出的目标纵横比。
• ImageCapture 的方法 setTargetAspectRatio(Rational aspectRatio) 已更改为 setTargetAspectRatioCustom(Rational aspectRatio)。设置后，ImageCapture 输出会相应地裁剪。

执行器 API

• 以下函数接受执行器参数，允许应用控制函数在哪个执行器上运行。
  • Preview.setOnPreviewOutputUpdateListener() API。如果该函数没有执行器，它将在主线程上执行。
  • Preview.setOnPreviewOutputUpdateListener
  • FocusMeteringAction.Builder.setAutoFocusCallback
  • ImageAnalysis.setAnalyzer
  • ImageCapture.takePicture
  • CameraView.takePicture
  • CameraView.startRecording
  • VideoCapture.startRecording

CameraInfo 添加了检查闪光灯可用性和传感器旋转 API

• 添加了 CameraInfo 和 getCameraInfo 方法，允许应用检查镜头朝向的 CameraInfo 是否可用，以及该相机上闪光灯是否可用。例如：

  try {
      CameraInfo cameraInfo = CameraX.getCameraInfo(currentCameraLensFacing);
      LiveData<Boolean> isFlashAvailable = cameraInfo.isFlashAvailable();
      flashToggle.setVisibility(isFlashAvailable.getValue() ? View.VISIBLE : View.INVISIBLE);
  } catch (CameraInfoUnavailableException e) {
      Log.w(TAG, "Cannot get flash available information", e);
      flashToggle.setVisibility(View.VISIBLE);
  }
  

• CameraInfo.getSensorRotationDegrees() 已添加。它提供了相机传感器相对于设备自然方向的方向，或者为了方便起见，相对于 Surface 旋转描述的方向（描述了相对于自然方向的方向）。

API 更改和错误修复

• 纵横比：对于每个用例，应用应仅调用 setTargetResolution() 或 setTargetAspectRatio() 中的一个。在同一个构建器上调用两者都会返回错误。
  • 通常建议根据应用的 UI 设计使用 setTargetAspectRatio()。特定分辨率基于用例。例如，预览接近屏幕分辨率，图像捕获提供高分辨率静止图像。有关更多信息，请参阅 自动分辨率表。
  • 在需要最小（以节省计算量）或最大（以处理详细信息）分辨率等更具体的情况下，使用 setTargetResolution()。
• 执行器 API：已从用例配置 API 中移除 setCallbackHandler() 调用。相反，应用可以在设置回调的其他各种 API 中将执行器设置为参数。
• 更新了各种函数的空注释。
• 修复了在打开相机时导致抛出 java.lang.IllegalStateException at Camera$StateCallback.onError 的问题。
• 修复了当应用请求更大或默认分辨率时，选择的分辨率过小（小于 640x480），导致预览图像出现块状或模糊的问题。需要较小分辨率的应用可以显式请求它们。
• 修复了从启动另一个相机应用的 Intent 返回后，相机显示黑屏（无法启动相机）的问题。
• 修复了当应用重复启动或停止时抛出以下错误的错误：java.lang.IllegalArgumentException: CaptureRequest contains unconfigured Input/Output Surface!
• 修复了在禁用 ImageAnalysis 时发生的以下错误：java.lang.IllegalStateException: maxImages (4) has already been acquired, call #close before acquiring more.
• 为相机断开连接流程添加了更多测试。
• 改进了在连续运行相机测试时的测试系统鲁棒性。

Camera-Camera2 和 Camera-Core 版本 1.0.0-alpha05

2019 年 9 月 5 日

androidx.camera:camera-camera2:1.0.0-alpha05 和 androidx.camera:camera-core:1.0.0-alpha05 已发布。这些是 包含在 camera-camera2:1.0.0-alpha05 中的提交，这些是 包含在 camera-core:1.0.0-alpha05 中的提交。

• API 更改：重命名用例错误变量

  • ImageCapture.UseCaseError 重命名为 ImageCapture.ImageCaptureError
  • VideoCapture.UseCaseError 重命名为 VideoCapture.VideoCaptureError

• 添加了 CameraControl API，并带有点按对焦 API

  • 添加了 API 以从 CameraX 获取相机的 CameraControl，该相机由镜头朝向选择。

    CameraX.getCameraControl(LensFacing lensFacing)

  • 添加了 MeteringPointFactory、MeteringPoint、MeteringMode 和 FocusMeteringAction 以运行点按对焦。

    MeteringPointFactory factory = new SensorOrientedMeteringPointFactory(width, height);
    MeteringPoint point = factory.createPoint(x, y);
    FocusMeteringAction action = FocusMeteringAction.Builder.from(point,
                                     MeteringMode.AF_ONLY)
        .addPoint(point2, MeteringMode.AE_ONLY) // could have many
        .setAutoFocusCallback(new OnAutoFocusListener(){
            public void onFocusCompleted(boolean isSuccess) {
            }
        })
        // auto calling cancelFocusAndMetering in 5 sec.
        .setAutoCancelDuration(5, TimeUnit.Second)
        .build();
    

  • 添加了 API 以供 CameraControl 启动和取消对焦测光。

    getCameraControl(lensFacing).startFocusAndMetering(action); getCameraControl(lensFacing).cancelFocusAndMetering();

  • 添加了用于计量点工厂的 API，这些 API 可根据视图类辅助将点击坐标转换为传感器坐标。

    MeteringPointFactory factory = new TextureViewMeteringPointFactory(textureView); MeteringPointFactory factory = new DisplayOrientedMeteringPointFactory(context, lensFacing, viewWidth, viewHeight);

• 强制在主（UI）线程上调用以下方法，并在未调用时抛出 IllegalStateException 异常。未来的版本将允许在其他线程上使用并确保序列化。

  • CameraX.bindToLifecycle()
  • CameraX.unbind()
  • CameraX.unbindAll()
  • ImageAnalysis.setAnalyzer()
  • ImageAnalysis.getAnalyzer()
  • ImageAnalysis.removeAnalyzer()
  • Preview.removePreviewOutputListener()
  • Preview.getOnPreviewOutputUpdateListener()
  • Preview.setOnPreviewOutputUpdateListener()

• 各种配置设置现在接受空参数，相应的 getter 方法可能会返回 null。

• 修复了在不支持 AF/AE/AWB 设置的模拟器上进行测试时出现的问题。

• 修复了在分析图像期间旋转时发生的崩溃错误。

• 修复了旋转或在前后摄像头之间切换后，预览在启动时（没有摄像头数据）出现黑色的错误。

• 删除了对多个并发图像分析用例的测试。为了确保兼容性，应用程序应仅附加单个图像分析用例。

• 为相机测试套件中的模拟相机添加了初始 Robolectric 测试（正在开发中）。

• Camera2Inititalizer 测试已删除，因为其覆盖范围不清楚/具有误导性。

Camera-Camera2 和 Camera-Core 版本 1.0.0-alpha04

2019 年 8 月 7 日

androidx.camera:camera-camera2:1.0.0-alpha04 和 androidx.camera:camera-core:1.0.0-alpha04 已发布。 版本 1.0.0-alpha04 包含这些提交。

新功能

纵横比和分辨率选择的更改

CameraX 的目标是成功初始化相机会话。这意味着 CameraX 会根据设备功能对分辨率/纵横比进行折衷，以便将启动捕获会话作为其首要目标，因此可能无法满足精确请求。这可能是由于

• 设备不支持请求的分辨率
• 兼容性问题，例如在 LEGACY 设备上，必须使用某些分辨率才能正确运行
• 在某些设备上，某些格式仅在某些纵横比下可用
• 更倾向于 JPEG 或视频编码的“最接近 16 的倍数”。请参阅 CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP

尽管 CameraX 创建并管理会话，但您始终应检查代码中用例输出的返回图像大小并进行相应调整。

对设置分辨率和纵横比进行了一些更改，旨在使 API 更清晰

• 预览用例现在被认为在未设置时具有默认的 4:3 纵横比。
• 当 CameraX 基于设备功能在内部考虑对请求的分辨率和纵横比进行更改时，它首先尝试保持相同的纵横比（由任何 setTargetAspectRatio 或 setTargetResolution 调用确定）。
• 分辨率的“最接近 16 的倍数”版本被视为相同的纵横比。

ImageAnalysis 非阻塞模式

• ImageReaderMode.ACQUIRE_LATEST_IMAGE 的行为现在是非阻塞的。它获取队列中的最新图像，但会连续丢弃未使用的图像，以允许相机管道避免阻塞。
• 分析器可以无限期地保存单个图像，而不会使管道停顿。
• 如果应用程序提供的执行程序随后被阻塞，则 ImageAnalysis 用例将被阻塞。
• 内部设置的默认执行程序的行为类似于非阻塞执行程序。

错误修复

• 修复了在没有自动对焦、自动曝光和自动白平衡的设备上捕获图像时，等待 3A 收敛的超时问题。
• 修复了使用 ImageCapture 快速拍摄照片时发生的错误：java.lang.IllegalStateException: maxImages (2) has already been acquired。
• 修复了在未为用例调用 setLensFacing 时导致 java.lang.IllegalArgumentException: Unable to get camera ID for use case 的问题。
• 修复了 LEGACY 设备需要特定纵横比作为最大 JPEG 分辨率的问题。
• 修复了在相机打开时将应用程序置于后台的问题。
• 修复了 API < 25 上的问题，删除了错误 checkAndUpdateEglState: invalid current EGLDisplay。
• 修复了启用并启动扩展后取消绑定预览的问题。
• camera-view 和 camera-extensions 的构建工件现在发布为 alpha 版本。

Camera-Camera2 和 Camera-Core 版本 1.0.0-alpha03

2019 年 7 月 2 日

androidx.camera:camera-core:1.0.0-alpha03 和 androidx.camera:camera-camera2:1.0.0-alpha03 已发布。 版本 1.0.0-alpha03 包含这些提交。

API 更改

• 添加了 setTarget 配置调用中“target”的 Javadoc 说明。

Camera-Core

• 修复了在快速打开/关闭或绑定/取消绑定时未配置的输入/输出表面崩溃。
• 迁移到新的 Futures 实现。
• 测试修复，以实现更强大的测试。
• 核心集成测试现在显示照片的捕获时间。
• 为 Executor 开发了内部兼容类。
• 计时测试应用程序捕获图像等待先前完成并提高了稳定性。

扩展

• 添加了版本检查。
• 其他测试覆盖范围 - 扩展事件回调。
• 内部对应图像和元数据的改进。
• 测试应用程序中模式切换的修复。

Camera-Camera2 和 Camera-Core 版本 1.0.0-alpha02

2019 年 6 月 5 日

androidx.camera:camera-core:1.0.0-alpha02 和 androidx.camera:camera-camera2:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含这些提交。

错误修复

• 修复了使用模拟器时出现的除以零错误。
• 修复了在某些设备上快速拍摄照片并快速取消绑定和重新绑定用例时发生的 NullPointerException/Surface Abandoned 错误。
• 修复了内部问题，以确保捕获请求更新始终一致地影响所有表面。
• 在新的应用程序实例中重新启动用例时的稳定性改进。
• 内部架构更改，为在 API 中支持执行程序做准备。
• 关于 CameraX 类和生命周期管理的其他 Javadoc 说明。
• 为 Antelope 性能测试应用程序添加了仪器化测试。
• 删除了应用程序 Proguard 配置中对 '-keepattributes Signature' 的需求。

Camera-Camera2 和 Camera-Core 1.0.0-alpha01

2019 年 5 月 7 日

androidx.camera:camera-core:1.0.0-alpha01 和 androidx.camera:camera-camera2:1.0.0-alpha01 已发布。 版本 1.0.0-alpha01 包含这些提交。

Camera-Lifecycle 版本 1.0.0-beta11

2020 年 10 月 14 日

androidx.camera:camera-lifecycle:1.0.0-beta11 已发布。 版本 1.0.0-beta11 包含这些提交。

错误修复

• <UseCase>.getTargetRotation() 如果在附加到 Camera 实例之前调用，则会返回 Surface.ROTATION_0，除非在 Builder 或 UseCase 上设置了 targetRotation。 (I80fcd)

Camera-Lifecycle 版本 1.0.0-beta10

2020 年 9 月 23 日

androidx.camera:camera-lifecycle:1.0.0-beta10 已发布。 版本 1.0.0-beta10 包含这些提交。

错误修复

• 发布以支持 Camera-Core 1.0.0-beta10

Camera-Lifecycle 版本 1.0.0-beta09

2020 年 9 月 16 日

androidx.camera:camera-lifecycle:1.0.0-beta09 已发布。 版本 1.0.0-beta09 包含这些提交。

Camera-Lifecycle 版本 1.0.0-beta08

2020 年 8 月 19 日

androidx.camera:camera-lifecycle:1.0.0-beta08 已发布。 版本 1.0.0-beta08 包含这些提交。

错误修复

• 当使用不从Context.getApplicationContext()返回Application对象的Context时，初始化不再崩溃。（I3d3c9，b/160817073）

Camera-Lifecycle 版本 1.0.0-beta07

2020年7月22日

androidx.camera:camera-lifecycle:1.0.0-beta07 已发布。 版本 1.0.0-beta07 包含这些提交。

Camera-Lifecycle 版本 1.0.0-beta06

2020年6月24日

androidx.camera:camera-lifecycle:1.0.0-beta06 已发布。 版本 1.0.0-beta06 包含这些提交。

API 更改

• 现在可以在调用 ProcessCameraProvider#getInstance() 之前使用 ProcessCameraProvider#configureInstance() 配置 CameraX。这允许自定义 CameraXConfig，而无需在应用程序的 Application 类中实现 CameraXConfig.Provider。（Ia1a8d）

Camera-Lifecycle 版本 1.0.0-beta05

2020年6月10日

androidx.camera:camera-lifecycle:1.0.0-beta05 已发布。 版本 1.0.0-beta05 包含这些提交。

错误修复

• 修复了手机处于勿扰模式下初始化CameraX时应用程序启动时崩溃的问题。InitializationException包含一个CameraUnavailableException将被设置为初始化结果的ListenableFuture，而不是使应用程序崩溃。（I9909a，b/149413835）

Camera-Lifecycle 版本 1.0.0-beta04

2020年5月27日

androidx.camera:camera-lifecycle:1.0.0-beta04 已发布。 版本 1.0.0-beta04 包含这些提交。

Camera-Lifecycle 版本 1.0.0-beta03

2020年4月15日

androidx.camera:camera-lifecycle:1.0.0-beta03 已发布。 版本 1.0.0-beta03 包含这些提交。

错误修复

• 修复了beta03中的回归，其中使用零UseCase调用bindToLifecycle()会导致抛出异常。这阻止了在不绑定UseCase的情况下检索Camera。
• 支持camera-core发布的修复

Camera-Lifecycle 版本 1.0.0-beta01

2020 年 2 月 26 日

androidx.camera:camera-lifecycle:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含这些提交。

错误修复

• 修复了文档，以说明在初始化期间获取 ProcessCameraProvider 时，将使用默认配置，并且扩展 Application 是可选的。（I5e395）

Camera-Lifecycle 版本 1.0.0-beta02

2020年4月1日

androidx.camera:camera-lifecycle:1.0.0-beta02 已发布。 版本 1.0.0-beta02 包含这些提交。

错误修复

• 更新为支持 camera-camera2:1.0.0-beta02 和 camera-core:1.0.0-beta02 工件中的错误修复。

Camera-Lifecycle 版本 1.0.0-alpha10

2020 年 2 月 10 日

androidx.camera:camera-lifecycle:1.0.0-alpha10 已发布。 版本 1.0.0-alpha10 包含这些提交。

API 更改

• 向 BindToLifecycle、unbind 和 unbindAll 方法添加了 @MainThread 注解。（I990d2）

Camera-Lifecycle 版本 1.0.0-alpha03

2020 年 1 月 22 日

androidx.camera:camera-lifecycle:1.0.0-alpha03 已发布。 版本 1.0.0-alpha03 包含这些提交。

更新

• 各种修复和更新，以支持 Camera Core 和 Camera2 的更改。

Camera-Lifecycle 版本 1.0.0-alpha02

2019 年 12 月 18 日

androidx.camera:camera-lifecycle:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含这些提交。

依赖项更改

• 更新为使用 androidx.camera:camera-core:1.0.0-alpha08。

Camera-Lifecycle 版本 1.0.0-alpha01

2019 年 12 月 4 日

androidx.camera:camera-lifecycle:1.0.0-alpha01 已发布。 camera-lifecycle 的 1.0.0-alpha01 版本包含这些提交

API 说明

• 添加了 camera-lifecycle 工件，提供了 LifeCycleCameraProvider 接口，以及一个名为 ProcessCameraProvider 的实现，它提供了核心代码中先前 CameraX 类的许多功能，并可以通过 getInstance() 方法获取。
• 应用程序应包含 camera-lifecycle 库以使用 CameraX。
• 有关如何使用ProcessCameraProvider初始化 CameraX 的说明，请参阅camera-core 部分。

Camera-Extensions 和 Camera-View 版本 1.0.0

版本 1.0.0-alpha32

2021 年 12 月 15 日

androidx.camera:camera-extensions:1.0.0-alpha32 和 androidx.camera:camera-view:1.0.0-alpha32 已发布。版本 1.0.0-alpha32 包含这些提交。

API 更改

• 从内部类/接口中删除了不必要的 @RequiresApi(21) 注释。 (I8e286，b/204917951)
• 更新 camera-extensions 工件的 api 文件。（If683a，b/161377155）

错误修复

• 绑定 VideoCapture 时禁止应用启用扩展模式。CameraX 扩展仅支持 ImageCapture 和 Preview。VideoCapture 暂不支持。如果应用绑定 VideoCapture 并启用任何扩展模式，则会抛出 IllegalArgumentException。（I0d87b）
• CameraSelector#filter 在结果集为空时不再抛出 IllegalArgumentException。（I27804）
• 将 ExtensionsManager#getInstance API 重命名为 getInstanceAsync，因为它返回 ListenableFuture。函数名称的后缀 Async 可以清楚地表明它是一个异步函数。（I279d2）
• 从 ExtensionsManager#getEstimatedCaptureLatencyRange API 中删除分辨率参数，因为用户无法知道哪些尺寸受 ImageCapture 使用案例支持，也无法区分返回的延迟信息是针对最大捕获输出尺寸还是输入分辨率参数。（I74bb2）
• 将 ExtensionsManager 函数的 CameraProvider 参数移动到 getInstance() API。这样，用户在调用 ExtensionsManager 函数时就不需要每次都输入 CameraProvider 参数。（Ic7e48）

版本 1.0.0-alpha31

2021 年 11 月 17 日

androidx.camera:camera-extensions:1.0.0-alpha31 和 androidx.camera:camera-view:1.0.0-alpha31 已发布。版本 1.0.0-alpha31 包含这些提交。

API 更改

• 将 CameraSelector#filter 添加到公共 API 中，以便根据 CameraSelector 过滤 CameraInfo 列表。（I105d0）

错误修复

• 修复了在某些设备上快速切换扩展模式时发生的崩溃。（Iebbef）

版本 1.0.0-alpha30

2021 年 10 月 13 日

androidx.camera:camera-extensions:1.0.0-alpha30 和 androidx.camera:camera-view:1.0.0-alpha30 已发布。版本 1.0.0-alpha30 包含这些提交。

API 更改

• 向所有 CameraX 类添加了 @RequiresApi(21) 注解，并从 AndroidManifest.xml 中删除了 minSdkVersion。这将允许 camera-core 轻松集成到 minSdkVersion 小于 21 的应用程序中，但希望有条件地使用依赖于 API 21 及更高版本的代码路径。对于任何 minSdkVersion 为 21 或更高的应用程序，此更改无需任何操作。（Ie7f2e，b/200599470）

错误修复

• 修复了启用 Proguard 时发生的 AbstractMethodError 问题。（Iae468，b/201177844）

版本 1.0.0-alpha29

2021 年 9 月 29 日

androidx.camera:camera-extensions:1.0.0-alpha29 和 androidx.camera:camera-view:1.0.0-alpha29 已发布。版本 1.0.0-alpha29 包含这些提交。

API 更改

• 现在已删除 ExperimentalUseCaseGroup 注解，因为这些 API 已经不再是实验性的。（I01ef5）
• 删除 RotationProvider#removeAllListeners()。请改用 RotationProvider#removeListener(...)。（Id9d4a）
• 更新了 RotationReceiver 类：将 set/clear Listener 更改为 add/remove/removeAll，删除默认使用主线程的 setListener 变体，并添加了方法注解。（Ib1669）

错误修复

• 将 ExtensionMode#BEAUTY 重命名为 FACE_RETOUCH 以正确表示扩展模式的功能。（I61f54，b/198515274）
• 修复了在一个 Activity 中使用多个 CameraController 和 PreviewView 时相机意外关闭的问题。（Ibfd18，b/197539358）

版本 1.0.0-alpha28

2021 年 8 月 18 日

androidx.camera:camera-extensions:1.0.0-alpha28 和 androidx.camera:camera-view:1.0.0-alpha28 已发布。版本 1.0.0-alpha28 包含这些提交。

API 更改

• 现在已删除 ExperimentalUseCaseGroupLifecycle 注解，因为这些 API 已经不再是实验性的。（I17b85）
• 重构了 RotationListener 并将其重命名为 RotationProvider。它继续提供相同的功能，但 API 略有不同。（Idffc5）
• 将 TAP_TO_FOCUS_UNSUCCESSFUL 重命名为 TAP_TO_FOCUS_NOT_FOCUSED，将 TAP_TO_FOCUS_SUCCESSFUL 重命名为 TAP_TO_FOCUS_FOCUSED。将 OutputSize 设为 final。（I099fa）

错误修复

• 删除了已弃用的 <EffectName><UseCase>Extender 类、ExtensionsErrorListener 和相关的 ExtensionsManager API。（I3b8c3）

版本 1.0.0-alpha27

2021 年 7 月 21 日

androidx.camera:camera-extensions:1.0.0-alpha27 和 androidx.camera:camera-view:1.0.0-alpha27 已发布。版本 1.0.0-alpha27 包含这些提交。

API 更改

• 将视口 API 从实验阶段提升到正式阶段。删除 API 的实验注解。（I717ea）
• 将 CoordinateTransform#getTransform 重命名为 CoordinateTransform#transform 并更新 JavaDoc。（I864ae）

错误修复

• 修复了与 Compose UI 一起使用时 PreviewView PERFORMANCE 模式拉伸问题。（Ie1137，b/183864890）

版本 1.0.0-alpha26

2021 年 6 月 30 日

androidx.camera:camera-extensions:1.0.0-alpha26 和 androidx.camera:camera-view:1.0.0-alpha26 已发布。版本 1.0.0-alpha26 包含这些提交。

API 更改

• 添加了一个新方法 CameraController#getTapToFocusState()，该方法公开最新的点触对焦结果。（Iaccb0）
• 向 CameraController 添加更多 camera-core 功能：目标纵横比、目标分辨率、捕获模式、CameraControl 和自定义执行器的 getter/setter。（Iea8f2）
• 添加了一个 RotationReceiver 类，该类接收 Surface 旋转更改。这可用于在设备处于固定纵向/横向模式时设置目标旋转。（Ib278f）
• 在 ExtensionsManager 类中公开了新的 getEstimatedCaptureLatencyRange 公共 API。（I6a8ec）
• 已弃用 ExtensionsErrorListener。目前，此接口仅用于监视启用扩展模式时 Preview 或 ImageCapture 是否缺少。CameraX 会自动添加额外的 Preview 或 ImageCapture 以使扩展功能正常工作。之后，不会通过此接口报告任何错误。（I47d9e）
• 公开了新的 ExtensionsManager getInstance、isExtensionAvailable 和 getExtensionEnabledCameraSelector 公共 API，并弃用了旧的 <EffectName><UseCase>Extender 类和相关 API。（I329e6）

版本 1.0.0-alpha25

2021 年 6 月 2 日

androidx.camera:camera-extensions:1.0.0-alpha25 和 androidx.camera:camera-view:1.0.0-alpha25 已发布。版本 1.0.0-alpha25 包含这些提交。

API 更改

• ExperimentalCameraFilter API 现已脱离实验阶段并成为正式 API。它们可以在没有注释 OptIn 的情况下使用。（I4bc94）
• 添加了一个实用程序，用于在用例之间转换坐标。例如：转换在 ImageAnalysis 用例中检测到的坐标并在预览中突出显示检测到的对象。（I63ab1，b/137515129）
• 删除了 CameraView。CameraView 已被 CameraController 替换。有关如何迁移的说明，请参阅 迁移指南。（Id5005）

错误修复

• 将 ExperimentalUseCaseGroupLifecycle 替换为 ExperimentalUseCaseGroup。（I3b2ef，b/159033688）

版本 1.0.0-alpha24

2021 年 4 月 21 日

androidx.camera:camera-extensions:1.0.0-alpha24 和 androidx.camera:camera-view:1.0.0-alpha24 已发布。版本 1.0.0-alpha24 包含这些提交。

错误修复

• 将注释 @Experimental 替换为 @RequiresOptIn 用于实验性 API。要调用实验性 API，请使用 androidx.annotation.OptIn 而不是已弃用的 androidx.annotation.experimental.UseExperimental。（Iff226）
• 修复了 Samsung J5 Prime 上的 PreviewView 拉伸问题。（Ib10b6）

Camera Extensions & View 版本 1.0.0-alpha23

2021 年 3 月 24 日

androidx.camera:camera-extensions:1.0.0-alpha23 和 androidx.camera:camera-view:1.0.0-alpha23 已发布。版本 1.0.0-alpha23 包含这些提交。

API 更改

• CameraView 即将弃用。请改用 LifecycleCameraController。请参阅 迁移指南。（Idac2c）
• 向 setLinearZoom() 添加了 FloatRange 注解。（I69971）

错误修复

• 固定 camera-view 依赖项以依赖于 1.0.0 工件。依赖于 camera-view 将不再导致 Gradle 的依赖项解析自动将 camera-core、camera-camera2 和 camera-lifecycle 升级到最新的 1.1.0 工件，尽管如果显式设置为使用 1.1.0，camera-view 仍然与这些工件兼容。（Ic8fa1，b/181599852）
• 修复了 Samsung A3 在 PreviewView 中预览画面拉伸的问题。（Iacb30，b/180121821）
• 修复了在初始化相机之前无法设置相机选择器的问题。（Ic8bd0）

Camera Extensions & View 版本 1.0.0-alpha22

2021 年 2 月 24 日

androidx.camera:camera-extensions:1.0.0-alpha22 和 androidx.camera:camera-view:1.0.0-alpha22 已发布。版本 1.0.0-alpha22 包含这些提交。

API 更改

• 向 CameraController 添加了一个 CameraInfo getter。（Ib8138，b/178251727）

错误修复

• 修复了仅绑定 Preview 或 ImageCapture 时，ExtensionsErrorListener 报告错误的问题。（I5ae39）

Camera Extensions & View 版本 1.0.0-alpha21

2021 年 1 月 27 日

androidx.camera:camera-extensions:1.0.0-alpha21 和 androidx.camera:camera-view:1.0.0-alpha21 已发布。版本 1.0.0-alpha21 包含这些提交。

发布以支持其他相机库工件。

Camera Extensions & View 版本 1.0.0-alpha20

2020 年 12 月 16 日

androidx.camera:camera-extensions:1.0.0-alpha20 和 androidx.camera:camera-view:1.0.0-alpha20 已发布。 版本 1.0.0-alpha20 包含以下提交。

发布以支持其他相机库工件。

Camera-Extensions & Camera-View 版本 1.0.0-alpha19

2020 年 11 月 11 日

androidx.camera:camera-extensions:1.0.0-alpha19 和 androidx.camera:camera-view:1.0.0-alpha19 已发布。 版本 1.0.0-alpha19 包含以下提交。

错误修复

• 为 camera-view 引入了 @ExperimentalVideo 注解。此注解标记公开实验性视频功能的 API，这些功能在功能完全开发之前可能会发生变化。使用这些 API 的任何方法都应使用 @UseExperimental 注解，并将 ExperimentalVideo 作为 markerClass。（I6d729）

Camera-Extensions 版本 1.0.0-alpha18

2020 年 10 月 14 日

androidx.camera:camera-extensions:1.0.0-alpha18 已发布。 版本 1.0.0-alpha18 包含以下提交。

错误修复

• 改进了 CameraX 初始化和 bindToLifecycle 的延迟。 (I61dc5)
• <UseCase>.getTargetRotation() 如果在附加到 Camera 实例之前调用，则会返回 Surface.ROTATION_0，除非在 Builder 或 UseCase 上设置了 targetRotation。 (I80fcd)

Camera-View 版本 1.0.0-alpha18

2020 年 10 月 14 日

androidx.camera:camera-view:1.0.0-alpha18 已发布。 版本 1.0.0-alpha18 包含以下提交。

发布以支持其他相机库工件。

Camera-Extensions 版本 1.0.0-alpha17

2020 年 9 月 23 日

androidx.camera:camera-extensions:1.0.0-alpha17 已发布。 版本 1.0.0-alpha17 包含以下提交。

错误修复

• 发布以支持 Camera-Core 1.0.0-beta10

Camera-View 版本 1.0.0-alpha17

2020 年 9 月 23 日

androidx.camera:camera-view:1.0.0-alpha17 已发布。 版本 1.0.0-alpha17 包含以下提交。

错误修复

• 发布以支持 Camera-Core 1.0.0-beta10

Camera-Extensions 版本 1.0.0-alpha16

2020 年 9 月 16 日

androidx.camera:camera-extensions:1.0.0-alpha16 已发布。 版本 1.0.0-alpha16 包含以下提交。

错误修复

• 在 ExtensionsManager 中添加了用于获取 Extensions 对象的方法，该对象用于在 Camera 实例上启用和查询扩展。（I4fb7e）

Camera-View 版本 1.0.0-alpha16

2020 年 9 月 16 日

androidx.camera:camera-view:1.0.0-alpha16 已发布。 版本 1.0.0-alpha16 包含以下提交。

API 更改

• 已删除 PreviewView#setDeviceRotationForRemoteDisplayMode() 和 PreviewView#getDeviceRotationForRemoteDisplayMode()。这两个方法用于自定义预览旋转，当所需的旋转不是显示旋转时，例如远程显示。现在要处理非显示预览旋转，请使用 Preview#setTargetRotation() 和新添加的 PreviewView#getViewPort(targetRotation) 设置所需的旋转。（Ib62cc）
• 将 createSurfaceProvider() 重命名为 getSurfaceProvider()。该方法将始终返回 Preview.SurfaceProvider 的相同实例。（Iff83c）

错误修复

• 如果启用了扩展效果并且供应商库实现需要对输出表面进行特殊处理，则强制 PreviewView 使用 TextureView。 (I0c3cc)
• 允许预览具有任意目标旋转。转换信息通过新的 TranformationInfoListener 回调动态计算并返回给用户。 (I21470)

已知问题

• 在 PreviewView 中，当最终用户点击 PreviewView 时，不会调用 OnClickListener#onClick()。触摸事件被 PreviewView#onTouchEvent() 错误地消耗了。此问题将在下一个版本中修复。
• 如果将 ViewPort 与 PreviewView 一起使用，则从 PreviewView#getMeteringPointFactory() 获取的 MeteringPoint 可能不正确。

Camera-Extensions 版本 1.0.0-alpha15

2020 年 8 月 19 日

androidx.camera:camera-extensions:1.0.0-alpha15 已发布。 版本 1.0.0-alpha15 包含以下提交。

错误修复

• ExtensionsManager.init() 方法现在接收 Context 作为参数，而不是没有参数。（Ife754）

• 当使用不从Context.getApplicationContext()返回Application对象的Context时，初始化不再崩溃。（I3d3c9，b/160817073）

  Camera-View 版本 1.0.0-alpha15

  2020 年 8 月 19 日

androidx.camera:camera-view:1.0.0-alpha15 已发布。 版本 1.0.0-alpha15 包含以下提交。

错误修复

• DisplayOrientedMeteringPointFactory 接收 CameraInfo 实例而不是 CameraSelector，因此可以直接映射到工厂将为其生成点的摄像头。所有使用 DisplayOrientedMeteringPointFactory 的类也接收 CameraInfo 实例而不是 CameraSelector。 (I400c1)
• 已删除 TextureViewMeteringPointFactory。PreviewView 提供了一个公共 API（createMeteringPointFactory()）来创建测光点工厂，而不管它是否使用 TextureView 或 SurfaceView。（Ide693）
• 将 PreviewView 的 SURFACE_VIEW/TEXTURE_VIEW 实现模式重命名为 PERFORMANCE/COMPATIBLE。PERFORMANCE 是旧的 SURFACE_VIEW 模式，COMPATIBLE 是旧的 TEXTURE_VIEW 模式。（I0edc2）
• 对于图像捕获，根据摄像头方向覆盖元数据中的水平翻转标志。 (I28499)

Camera-Extensions 版本 1.0.0-alpha14

2020年7月22日

androidx.camera:camera-extensions:1.0.0-alpha14 已发布。 版本 1.0.0-alpha14 包含以下提交。

Camera-View 版本 1.0.0-alpha14

2020年7月22日

androidx.camera:camera-view:1.0.0-alpha14 已发布。 版本 1.0.0-alpha14 包含以下提交。

Camera-Extensions 版本 1.0.0-alpha13

2020年6月24日

androidx.camera:camera-extensions:1.0.0-alpha13 已发布。 版本 1.0.0-alpha13 包含以下提交。

错误修复

• 添加了通过相机ID和CameraCharacteristics过滤相机的实验性接口。（I28f61）

Camera-View 版本 1.0.0-alpha13

2020年6月24日

androidx.camera:camera-view:1.0.0-alpha13 已发布。 版本 1.0.0-alpha13 包含以下提交。

错误修复

• 当绑定到 LifecycleOwner 时，CameraView 不会再因 IllegalArgumentException 而崩溃，该 LifecycleOwner 的 Lifecycle 在绑定后不久会转换到 DESTROYED 状态。绑定处于 DESTROYED 状态的 Lifecycles 将不会尝试打开相机。（I7c2b8）
• 现在可以通过 CameraView.getPreviewStreamState() 获取 PreviewView StreamState。（I21a2b）

Camera-Extensions 版本 1.0.0-alpha12

2020年6月10日

androidx.camera:camera-extensions:1.0.0-alpha12 已发布。 版本 1.0.0-alpha12 包含以下提交。

错误修复

• 修复了手机处于勿扰模式下初始化CameraX时应用程序启动时崩溃的问题。InitializationException包含一个CameraUnavailableException将被设置为初始化结果的ListenableFuture，而不是使应用程序崩溃。（I9909a，b/149413835）

Camera-View 版本 1.0.0-alpha12

2020年6月10日

androidx.camera:camera-view:1.0.0-alpha12 已发布。 版本 1.0.0-alpha12 包含以下提交。

错误修复

• 添加了 PreviewView#getBitmap() API，该 API 返回预览表面上显示的内容的 Bitmap 表示。（I9b500，b/157659818）

Camera-Extensions 版本 1.0.0-alpha11

2020年5月27日

androidx.camera:camera-extensions:1.0.0-alpha11 已发布。 版本 1.0.0-alpha11 包含以下提交。

Camera-View 版本 1.0.0-alpha12

2020年6月10日

androidx.camera:camera-view:1.0.0-alpha12 已发布。 版本 1.0.0-alpha12 包含以下提交。

新功能

API 更改

错误修复

• 添加了 PreviewView#getBitmap() API，该 API 返回预览表面上显示的内容的 Bitmap 表示。（I9b500，b/157659818）

Camera-View 版本 1.0.0-alpha11

2020年5月27日

androidx.camera:camera-view:1.0.0-alpha11 已发布。 版本 1.0.0-alpha11 包含以下提交。

API 更改

• 添加了 PreviewView#getPreviewStreamState API，允许应用观察预览是否正在流式传输。当 PreviewView 处于 TEXTURE_VIEW 模式时，STREAMING 状态也保证预览图像可见。（Ic0906，b/154652477）
• 添加了 PreviewView#setDeviceRotationForRemoteDisplayMode() API，如果应用程序在远程显示模式下运行，则提供用于转换计算的设备旋转。（I59b95，b/153514525）

错误修复

• 修复了在运行 Android 7.0 及以下版本的 FULL/LIMITED/LEVEL_3 相机上的预览失真问题。当 Android 版本为 7.0 或以下时，强制使用 ImplementationMode#TEXTURE_VIEW 模式。（I83e30，b/155085307）
• 从PreviewView#createSurfaceProvider()中删除了CameraInfo参数，PreviewView现在在内部从SurfaceRequest中检索它。（If18f0，b/154652477）
• 将 VideoCapture 的默认纵横比在 CameraView 中设置为 16:9。（Ie6a7b，b/153237864）
• 修复了在 ViewPager2 中滑动出 Preview 片段然后滑回时 PreviewView 黑屏的问题。还修复了 removeView(previewview) 然后 addView(previewView) 时的错误。（Iab555，b/149877652，b/147354615）
• 更新了 CameraView#takePicture() API 以允许将图像保存到 Uri 和 OutputStream。更新测试应用程序以使用 Uri 作为规范示例。（Ia2459，b/153607583）
• 您可以通过设置 ScaleType 属性从 XML 布局设置 PreviewView 的缩放类型。（I08565，b/153015659）
• CameraView.ScaleType 已被删除。请改用 PreviewView.ScaleType 使用 CameraView 设置/获取缩放类型。（Ia8974，b/153014831）
• 如果 PreviewView 还没有背景颜色，则默认提供一个背景颜色。这可以防止预览流开始之前其后面的内容可见。（I09fad）

Camera-Extensions 版本 1.0.0-alpha10

2020年4月15日

androidx.camera:camera-extensions:1.0.0-alpha10 已发布。 版本 1.0.0-alpha10 包含以下提交。

错误修复

• 支持 Camera-Core 发布的修复程序

Camera-View 版本 1.0.0-alpha10

2020年4月15日

androidx.camera:camera-view:1.0.0-alpha010 已发布。 版本 1.0.0-alpha010 包含以下提交。

错误修复

• 修复了之前已知的一个问题，即 PreviewView 的 surfaceView 实现某些设备上运行不佳，并在恢复预览后导致应用程序崩溃。（I5ed6b）

Camera-Extensions 版本 1.0.0-alpha09

2020年4月1日

androidx.camera:camera-extensions:1.0.0-alpha09 已发布。 版本 1.0.0-alpha09 包含以下提交。

错误修复

• 更新以支持 camera-camera2:1.0.0-beta02、camera-core:1.0.0-beta02 和 camera-lifecycle:1.0.0-beta02 工件中的错误修复

Camera-View 版本 1.0.0-alpha09

2020年4月1日 发布了 androidx.camera:camera-view:1.0.0-alpha09。 版本 1.0.0-alpha09 包含以下提交。

已知问题

• 在某些设备上，使用 PreviewView 结合 ImplementationMode.SURFACE_VIEW 可能无法正常工作。这是因为用于预览的 SurfaceView 在其所在窗口的生命周期停止时会使自身的表面失效。当窗口重新启动时，相机将重新打开，并且可能在 SurfaceView 的表面再次有效之前尝试恢复预览。目前，您应该使用 ImplementationMode.TEXTURE_VIEW。

API 更改

• 将 PreviewView.setImplementationMode() 重命名为 PreviewView.setPreferredImplementationMode()。
• 将 PreviewView.getImplementationMode() 重命名为 PreviewView.getPreferredImplementationMode()。
• 用 PreviewView.createSurfaceProvider(CameraInfo) 替换了 PreviewView.getSurfaceProvider()，它接受一个可为空的 CameraInfo 实例，用于通过尽可能使用 ImplementationMode.SURFACE_VIEW 来优化预览。如果传递了空实例，或者将首选实现模式设置为 ImplementationMode.TEXTURE_VIEW，则内部使用 ImplementationMode.TEXTURE_VIEW。

• 以下代码示例演示了以前如何将预览用例与 PreviewView 一起使用。

  preview.setSurfaceProvider(previewView.previewSurfaceProvider)
  cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)
  

  现在，您可以编写以下代码

  val camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)
  previewView.preferredImplementationMode = ImplementationMode.TEXTURE_VIEW
  preview.setSurfaceProvider(previewView.createSurfaceProvider(camera.cameraInfo))
  

• 已在 PreviewView.getSurfaceProvider() 中添加了 @UiThread 注解，这意味着必须从主线程调用它。（I192f3）

• 添加了 PreviewView.setScaleType()，它允许设置预览的缩放类型。它接受 PreviewView.ScaleType 中的一个值，默认为 PreviewView.ScaleType.FILL_CENTER。

• 添加了 PreviewView.getScaleType()。

• 删除了在 XML 布局中使用 implementationMode 属性设置 PreviewView 实现模式的支持。

• 向 PreviewView 添加了 createMeteringPointFactory() API，以支持将 PreviewView 中的 (x, y) 转换为 MeteringPoint。（Ib36d7）

错误修复

• 修复了 PreviewView 大小更改后显示不正确预览的情况。（I71101）

Camera-Extensions 版本 1.0.0-alpha08

2020 年 2 月 26 日

androidx.camera:camera-extensions:1.0.0-alpha08 已发布。 版本 1.0.0-alpha08 包含以下提交。

Camera-View 版本 1.0.0-alpha08

2020 年 2 月 26 日

androidx.camera:camera-view:1.0.0-alpha08 已发布。 版本 1.0.0-alpha08 包含以下提交。

错误修复

• 将 SurfaceRequest.provideSurface() 上的 ListenableFuture 替换为 Executor 和 Callback。这通过不再需要处理 provideSurface() 上的异常来简化 API，并强制执行 provideSurface() 回调不能被取消。这是为了防止旧设备上由于过早释放表面而导致的崩溃。 SurfaceRequest.Result 对象现在用于跟踪 SurfaceRequest 如何使用提供的 Surface。（I7854b）
• 将 SurfaceRequest.setSurface(Surface) 重命名为 SurfaceRequest.provideSurface(Surface)，并将 SurfaceRequest.setWillNotComplete() 重命名为 SurfaceRequest.willNotProvideSurface()。（I224fe）
• 通过保留设置默认 CameraXConfig 提供程序的标志，修复了启用 ProGuard 的应用程序变体的初始化问题。（I2d6c1）

Camera-Extensions 版本 1.0.0-alpha07

2020 年 2 月 10 日

androidx.camera:camera-extensions:1.0.0-alpha07 已发布。 版本 1.0.0-alpha07 包含以下提交。

错误修复

• 先前在 ImageCapture.OnImageSavedCallback.onError() 和 ImageCapture.OnImageCapturedCallback.onError() 中传递的参数现已替换为单个参数 ImageCaptureException，该参数仍然包含先前传递的所有信息。
• 先前在 ImageCapture.OnImageSavedCallback.onImageSaved() 中传递的文件参数已删除。（I750d2）

Camera-View 版本 1.0.0-alpha07

2020 年 2 月 10 日

androidx.camera:camera-view:1.0.0-alpha07 已发布。 版本 1.0.0-alpha07 包含以下提交。

API 更改

• PreviewView 的 TextureView 实现现在会将 TextureView 的大小设置为相机传感器输出大小，然后再将其缩放以填充其父级 PreviewView。如果您希望相机预览填充 UI 的一部分（例如整个屏幕），则不应将 PreviewView 的大小设置为固定值，也不应使其包裹其内容（例如使用属性“wrap_content”），这可能导致相机预览仅填充 PreviewView 的一部分（如果相机传感器输出大小较小）。相反，您应该将 PreviewView 设置为与其父级一样大（例如使用属性“match_parent”）。(1204869)

错误修复

• 更新了 ImageCapture 以允许将图像保存到 Uri 和 OutputStream。将重载的 takePicture 方法合并为一个。更新了测试应用程序以使用 Uri 作为规范示例。（Ia3bec）
• Preview.PreviewSurfaceProvider 已重命名为 Preview.SurfaceProvider。 SurfaceProvider 不再要求开发人员创建自己的 ListenableFuture，并且现在通过新的 SurfaceRequest 对象提供 Surface。由于在 Preview 与其他类（如 PreviewView）配对时可能被误用，因此已删除 Preview.getPreviewSurfaceProvider() 方法。（I20105）
• 先前在 ImageCapture.OnImageSavedCallback.onError() 和 ImageCapture.OnImageCapturedCallback.onError() 中传递的参数现已替换为单个参数 ImageCaptureException，该参数仍然包含先前传递的所有信息。
• 先前在 ImageCapture.OnImageSavedCallback.onImageSaved() 中传递的文件参数已删除。（I750d2）
• API 已更新，CameraInfo 的 getZoomRatio()、getMaxZoomRatio()、getMinZoomRatio() 和 getLinearZoom() 方法合并到 getZoomState() 中，后者返回一个 ZoomState 实例。（Ib19fe）

Camera-Extensions 版本 1.0.0-alpha06

2020 年 1 月 22 日

androidx.camera:camera-extensions:1.0.0-alpha06 已发布。 版本 1.0.0-alpha06 包含以下提交。

更新

• 各种修复和更新，以支持 Camera Core 和 Camera2 的更改。

Camera-View 版本 1.0.0-alpha06

2020 年 1 月 22 日

androidx.camera:camera-view:1.0.0-alpha06 已发布。 版本 1.0.0-alpha06 包含以下提交。

更新

• 各种修复和更新，以支持 Camera Core 和 Camera2 的更改。

Camera-Extensions 版本 1.0.0-alpha05

2019 年 12 月 18 日

androidx.camera:camera-extensions:1.0.0-alpha05 已发布。 版本 1.0.0-alpha05 包含以下提交。

错误修复

• 更新以匹配内部 Camera Core API。

Camera-View 版本 1.0.0-alpha05

2019 年 12 月 18 日

androidx.camera:camera-view:1.0.0-alpha05 已发布。 版本 1.0.0-alpha05 包含以下提交。

已知问题

• 使用 PreviewView 时，纵横比可能不正确 (b/146215202)。

新功能

• 实现了一个名为 PreviewView.TextureViewImplementation 的新类，它将 SurfaceTexture 的生命周期与相机对 TextureView 表面的使用同步。

Camera-Extensions 版本 1.0.0-alpha04

2019 年 12 月 4 日

androidx.camera:camera-extensions:1.0.0-alpha04 已发布。 camera-extensions 版本 1.0.0-alpha04 包含以下提交

API 更改

• 现在，检查扩展的可用性和启用情况需要传入 CameraSelector 作为输入参数。这需要与用于绑定用例的 CameraSelector 相同。

  val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
  val builder = ImageCapture.Builder()
  val bokehImageCaptureExtender = BokehImageCaptureExtender.create(builder)
  if (bokehImageCaptureExtender.isExtensionAvailable(cameraSelector)) {
      bokehImageCaptureExtender.enableExtension(cameraSelector)
  }
  val imageCapture = builder.build()
  mCameraProvider?.bindToLifecycle(this, cameraSelector, imageCapture)
  

• 在使用扩展库之前，必须先初始化扩展。

  val availability = ExtensionsManager.init()
  Futures.addCallback<ExtensionsManager.ExtensionsAvailability>(
     availability,
     object : FutureCallback<ExtensionsManager.ExtensionsAvailability> {
         override fun onSuccess(availability: ExtensionsManager.ExtensionsAvailability?) {
             // Ready to make extensions calls
         }
         override fun onFailure(throwable: Throwable) {
             // Extensions could not be initialized
         }
     },
     Executors.newSingleThreadExecutor()
  )
  

Camera-View 版本 1.0.0-alpha04

2019 年 12 月 4 日

androidx.camera:camera-view:1.0.0-alpha04 已发布。 camera-view 版本 1.0.0-alpha04 包含以下提交

API 更改

• 提供了一个 PreviewView 类，用于在应用程序中轻松显示来自预览用例的输出。

• PreviewView 可以包含在布局中

  <androidx.camera.view.PreviewView
    android:id="@+id/preview_view"
    … />
  

• PreviewView 提供了一个 PreviewSurfaceProvider，以便轻松连接预览用例

  preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
  

• API 命名中，“ZoomLevel” 现在称为 “ZoomRatio”

• 某些方法参数的可空性已更改

Camera-Extensions 和 Camera-View 版本 1.0.0-alpha03

2019 年 10 月 9 日

androidx.camera:camera-extensions:1.0.0-alpha03 和 androidx.camera:camera-view:1.0.0-alpha03 已发布。这些是 camera-extensions:1.0.0-alpha03 中包含的提交，这些是 camera-view:1.0.0-alpha03 中包含的提交。

新功能

• 为扩展添加了 Context 初始化器。扩展版本增加到 1.1.0

Camera-Extensions 和 Camera-View 版本 1.0.0-alpha02

2019 年 9 月 5 日

androidx.camera:camera-extensions:1.0.0-alpha02 和 androidx.camera:camera-view:1.0.0-alpha02 已发布。这些是 camera-extensions:1.0.0-alpha02 中包含的提交，这些是 camera-view:1.0.0-alpha02 中包含的提交。

• 添加了测试以验证 PreviewImageProcessorImpl 是否已正确实现时间戳。
• 修复 Nexus 5（API 级别 21）上的 ExtensionTest 测试失败，并确保预览可用。

Camera-Extensions 和 Camera-View 版本 1.0.0-alpha01

2019 年 8 月 7 日

androidx.camera:camera-extensions:1.0.0-alpha01 和 androidx.camera:camera-view:1.0.0-alpha01 已发布。这些是 camera-extensions:1.0.0-alpha01 中包含的提交，这些是 camera-view:1.0.0-alpha01 中包含的提交

• 用于访问受支持设备上的效果的未来相机扩展的新库。此库尚在开发中。
• 新的相机视图类。此库尚在开发中。