实现预览

预览用例会生成一个流式传输相机输入的 SurfaceTexture。它还提供对 View 进行剪裁、缩放或旋转以确保其正常显示所需的其他信息。

当相机处于活动状态时，图片预览就会流式传输到此 SurfaceTexture。SurfaceTexture 可以连接到 TextureView 或 GLSurfaceView。

实现

以下示例显示了如何使用 PreviewOutput：

Kotlin

    val previewConfig = PreviewConfig.Builder().build()
    val preview = Preview(previewConfig)

    preview.setOnPreviewOutputUpdateListener {
        previewOutput: Preview.PreviewOutput? ->
            // Your code here. For example, use previewOutput?.getSurfaceTexture()
            // and post to a GL renderer.
    }

    CameraX.bindToLifecycle(this as LifecycleOwner, preview)

Java

    PreviewConfig config = new PreviewConfig.Builder().build();
    Preview preview = new Preview(config);

    preview.setOnPreviewOutputUpdateListener(
        new Preview.OnPreviewOutputUpdateListener() {
            @Override
            public void onUpdated(Preview.PreviewOutput previewOutput) {
                // Your code here. For example, use previewOutput.getSurfaceTexture()
                // and post to a GL renderer.
            };
    });

    CameraX.bindToLifecycle((LifecycleOwner) this, preview);

使用 CameraView

CameraX 提供了 CameraView 类，该类使用 Preview 实现更方便的 View API。View API 会自动缩放、剪裁和旋转图片数据。

此预览中实现了火炬模式、对焦和缩放控件。与在创建时设置配置的用例不同，您可以在用例运行时动态设置这些控件。

其他资源

要详细了解 CameraX，请参阅下面列出的其他资源。

Codelab

  • CameraX 使用入门

    • 代码示例

  • 官方 CameraX 示例应用

    •