轻松实现相机预览 | Camera Viewfinder 全新上线

作者 / Android 开发者关系工程师 Francesco Romano

经过多年的不断发展，Android 设备现在具有各种尺寸和形状，并且屏幕大小和功能也大不相同。但无论如何变化，手机拍照从一开始便一直是 Android 设备最重要的使用场景之一。如今，相机功能仍然是消费者购买手机的首要考虑因素之一。

作为开发者，您希望在您的应用中利用相机功能，因此决定采用 Android 相机框架。首先要实现的是预览 (Preview) 用例，它会在屏幕上显示相机传感器的输出。

接下来，您可以使用与屏幕尺寸一样大的界面创建 CaptureSession。只要屏幕的宽高比与相机传感器输出的宽高比相同，并且设备保持自然的纵向方向，那么一切便能顺利进行。

但是，当您调整窗口大小、展开设备、更改屏幕或改变方向时会发生什么呢？大多数情况下，预览画面可能会被拉伸、上下颠倒或错误地旋转。如果处于多窗口模式中，您的应用甚至可能会崩溃。

为什么会出现这种情况呢？因为您在创建 CaptureSession 时做了隐含假设。

过去，应用在其整个生命周期中可能一直会在同一个窗口中运行，但是，随着新的外形规格 (例如可折叠设备) 和新的显示模式 (例如多窗口模式和多屏幕模式) 面市，这种情况已经发生变化。

让我们具体了解一下在开发针对各种外形规格的应用时需要考虑的一些重要因素，以及要避免的一些常见陷阱:

不要假定应用将一直在纵向窗口中运行 。Android 13 仍然支持应用固定屏幕方向的请求，但现在设备制造商可以选择覆盖应用的首选屏幕方向请求。
不要假定应用有任何固定尺寸或宽高比 。即使您设置了 resizableActivity = false，您的应用仍然可以在大屏幕设备 (>=600dp) 上以多窗口模式使用。
不要假定屏幕方向和相机方向之间存在固定关系 。《Android 兼容性定义文档》中明确了相机图像传感器必须朝向正确方向，以便相机的长度方向与屏幕的长度方向对齐。从 API 级别 32 开始，查询可折叠设备方向的相机客户端可以收到一个根据设备/折叠状态动态变化的值。
不要假定边衬区的大小无法更改 。新的任务栏会作为边衬区报告给应用，且当任务栏与手势导航一起使用时，任务栏可以动态隐藏和显示。
不要假定您的应用享有专属的相机访问权限 。当您的应用处于多窗口模式时，其他应用也可以获得对相机和麦克风等共享资源的访问权限。

虽然 CameraX 已经能处理上述大多数情况，但使用 Camera2 API 实现适用于不同场景的预览可能会很复杂。我们在在您的相机应用中支持可调整大小的 Surface Codelab 中介绍了这一点。

如果有一个简单的组件可以处理这些细节，并让您专注于特定的应用逻辑，会不会更好？

话不多说，敬请通过下文了解 CameraViewfinder……

隆重推出 CameraViewfinder

CameraViewfinder 是 Jetpack 库的一个新组件，帮助您更轻松地快速实现相机预览。它在内部使用 TextureView 或 SurfaceView 来显示相机画面，并对其应用进行必要的转换以正确显示取景器。比如校正宽高比、比例和旋转方向。它与您现有的 Camera2 代码库完全兼容，并已在多种设备上持续进行测试。

下面就让我们对其用法一探究竟！

首先，在您的应用级 build.gradle 文件中添加依赖项:

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

同步您的项目。现在，您应该可以像使用任何其他 View 一样直接使用 CameraViewfinder。例如，您可以将它添加到您的布局文件中:

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

如您所见，CameraViewfinder 的控件与 PreviewView 上可用的控件相同，所以您可以选择不同的实现模式和缩放类型。

现在该组件是布局的一部分，您仍然可以创建 CameraCaptureSession，但不提供 TextureView 或 SurfaceView 作为目标界面，而是使用 requestSurfaceAsync() 的结果。

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

    Futures.addCallback(surfaceListenableFuture, object :FutureCallback<Surface> {
        override fun onSuccess(surface:Surface) {
            //像往常一样使用这个界面创建 CaptureSession
        }
        override fun onFailure(t:Throwable) { /* 出错了 */}
    }, ContextCompat.getMainExecutor(context))
}