CameraX 视频录制完成后如何安全获取保存的 Uri

本文详解 CameraX VideoCapture 在视频录制结束（VideoRecordEvent.Finalize）时正确提取保存文件 URI 的标准方式，包括核心 API 调用、类型安全转换及生产环境注意事项。

本文详解 camerax `videocapture` 在视频录制结束（`videorecordevent.finalize`）时正确提取保存文件 uri 的标准方式，包括核心 api 调用、类型安全转换及生产环境注意事项。

在使用 CameraX 的 VideoCapture 进行视频录制时，开发者常需在录制完成后续处理生成的视频文件（如上传、缩略图生成、媒体库刷新等），而关键前提就是准确获取该视频的保存路径 URI。CameraX 并未在 Recording 实例中直接暴露 outputUri，而是将该信息封装在 VideoRecordEvent.Finalize 事件的 OutputResults 中——这是官方推荐且唯一可靠的访问途径。

✅ 正确获取 URI 的方式

当 VideoRecordEvent 实例为 VideoRecordEvent.Finalize 类型时，需先进行安全类型转换，再调用 getOutputResults().getOutputUri() 获取 Uri：

recording = videoCapture.getOutput()
    .prepareRecording(this, mediaStoreOutput)
    .start(ContextCompat.getMainExecutor(this), new Consumer<VideoRecordEvent>() {
        @Override
        public void accept(VideoRecordEvent event) {
            if (event instanceof VideoRecordEvent.Start) {
                // 录制开始：更新 UI，例如启用停止按钮
                setBackgroundBtn(R.drawable.recoding);
            } else if (event instanceof VideoRecordEvent.Finalize) {
                VideoRecordEvent.Finalize finalizeEvent = (VideoRecordEvent.Finalize) event;

                // ✅ 安全获取保存 URI（注意：可能为 null）
                Uri outputUri = finalizeEvent.getOutputResults().getOutputUri();

                if (outputUri != null) {
                    Toast.makeText(CameraActivity.this, 
                        "视频已保存至: " + outputUri.toString(), 
                        Toast.LENGTH_LONG).show();

                    // ✅ 建议：触发媒体扫描以同步至系统图库（尤其对 MediaStoreOutput）
                    sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, outputUri));
                } else {
                    Toast.makeText(CameraActivity.this, 
                        "警告：录制完成但未获取到输出 URI", 
                        Toast.LENGTH_LONG).show();
                }
            }
        }
    });

? 提示：getOutputResults().getOutputUri() 返回的 Uri 类型取决于你使用的 OutputOptions：

天工大模型

中国首个对标ChatGPT的双千亿级大语言模型

下载

• 若使用 MediaStoreOutputOptions（推荐用于 Android 10+），URI 通常为 content:// 协议（如 content://media/external/video/media/12345），具备跨应用权限与生命周期管理优势；
• 若使用 FileOutputOptions，则返回 file:// URI（仅限调试或私有目录场景，不建议用于共享）。

⚠️ 关键注意事项

• 不可通过反射或内部字段访问：如 recording.mRecorder.mOutputUri.uriString 属于私有实现细节，极易因 CameraX 版本升级而失效，严禁在生产代码中使用。
• URI 可能为 null：当录制异常终止（如磁盘满、权限丢失、IO 错误）时，getOutputUri() 可能返回 null，务必做空值判断。
• 权限与作用域适配：
  • 使用 MediaStoreOutputOptions 时，无需 WRITE_EXTERNAL_STORAGE 权限（Android 10+ 强制作用域存储）；
  • 若使用 FileOutputOptions，需确保目标目录可写（如应用私有目录 getExternalFilesDir()），并避免向公共目录写入（Android 11+ 限制）。
• 线程安全：Consumer<VideoRecordEvent> 回调默认在主线程执行（由 ContextCompat.getMainExecutor() 指定），可安全更新 UI；如需耗时操作（如视频转码），请切换至后台线程。

✅ 最佳实践总结

掌握这一模式，即可稳定、安全、符合 Android 架构演进方向地获取 CameraX 视频录制结果 URI，为后续多媒体处理奠定坚实基础。