← 返回实时预览录制组件参考 · 全部使用指导

实时预览录制使用指导

• 实时预览录制使用指导
  • 快速上手：预览模式
  • 快速上手：后台录制模式
  • 搭建与测试
  • 属性、方法与事件速查
  • 常见问题与验收
  • 完整 .aia 源码与操作指导
    • 相机预览录制与回放

不可见组件：在 App 内用摄像头录制视频（不跳转到系统相机），有两种模式，由后台录制（BackgroundMode）属性决定：

两种模式都支持画质/码率/帧率设置、暂停录制（PauseRecording） / 恢复录制（ResumeRecording）、取消录制（CancelRecording）， 结束后都触发录制完成（视频路径）（VideoRecorded）返回视频路径。下面每个属性、事件、方法都注明了适用的模式，没注明的两种模式都可用。

使用前先用屏幕的「请求权限」申请相机权限；录制声音（RecordAudio）为真时还需要录音权限。 录好的视频保存在应用专属目录（不需要存储权限），录制期间屏幕保持常亮。原 VideoRecorder 拓展的前台、后台两个组件已合并内置为本组件。

鸿蒙上只能用预览模式：系统不允许应用在后台使用摄像头，勾选后台录制（BackgroundMode）会报错；录制中也不能静音（MuteRecording），要不录声音请在开始前把录制声音（RecordAudio）设为假。画面一律等比居中显示。

快速上手：预览模式

1. 拖一个实时预览录制、一个垂直布局（改名 垂直布局_预览，宽「充满」、高 400 像素）当预览区， 再放 按钮_录制、按钮_停止、一个视频播放器；
2. 搭下面的代码块：

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when Screen1.Initialize() {
  Screen1.AskForPermission("android.permission.CAMERA")
  Screen1.AskForPermission("android.permission.RECORD_AUDIO")
}

when Screen1.PermissionGranted(权限名称) {
  if 权限名称 == "android.permission.CAMERA" {
    实时预览录制1.InitializeCamera(垂直布局_预览)
  }
}

when 按钮_录制.Click() {
  实时预览录制1.StartRecording()
}

when 按钮_停止.Click() {
  实时预览录制1.StopRecording()
}

when 实时预览录制1.VideoRecorded(视频路径) {
  视频播放器1.Source = 视频路径
  视频播放器1.Start()
}

when 实时预览录制1.ErrorOccurred(错误信息) {
  对话框1.ShowAlert(错误信息)
}

运行后同意权限，预览区出现摄像头画面；点「录制」开始，点「停止」保存并在视频播放器里播放。

自定义拍照界面：不录像也能用。在上面的基础上加一个 按钮_拍照 和一个图像，点按钮拍下完整分辨率的照片：

when 按钮_拍照.Click() {
  实时预览录制1.CapturePhoto()
}

when 实时预览录制1.PhotoCaptured(文件路径) {
  图像1.Picture = 文件路径
}

when 实时预览录制1.PhotoCaptureError(消息) {
  对话框1.ShowAlert(消息)
}

快速上手：后台录制模式

1. 拖一个实时预览录制，在属性面板勾选后台录制；不需要预览布局。 再放 按钮_开始、按钮_停止、按钮_拍照、一个图像、一个标签；
2. 搭下面的代码块：

when Screen1.Initialize() {
  Screen1.AskForPermission("android.permission.CAMERA")
}

when 按钮_开始.Click() {
  实时预览录制1.RecordAudio = false
  实时预览录制1.StartRecording()
}

when 按钮_停止.Click() {
  实时预览录制1.StopRecording()
}

when 按钮_拍照.Click() {
  实时预览录制1.CapturePhoto()
}

when 实时预览录制1.PhotoCaptured(文件路径) {
  图像1.Picture = 文件路径
}

when 实时预览录制1.VideoRecorded(视频路径) {
  标签1.Text = join("已保存：", 视频路径)
}

when 实时预览录制1.ErrorOccurred(错误信息) {
  标签1.Text = 错误信息
}

点「开始」后按 Home 键把 App 切到后台，录制继续；回来点「停止」保存。 这里关掉了录制声音，所以只需要相机权限。录制中点「拍照」不会打断录制。

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

常见问题与验收

完整 .aia 源码与操作指导

下载 .aia 源码

真实相机预览→录制→暂停／恢复→保存视频→应用内回放，并可拍照预览、测试相机特性、前后镜头、补光和权限恢复。默认前台模式，须用户点击才开启相机。鸿蒙不支持后台相机和录制中静音，FillCenter按等比居中显示；案例明确展示实际错误，不以编译通过代替设备验证。

导入 VideoRecorderAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。

相机预览录制与回放

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 真实相机预览→录制→暂停／恢复→保存视频→应用内回放，并可拍照预览、测试相机特性、前后镜头、补光和权限恢复。默认前台模式，须用户点击才开启相机。鸿蒙不支持后台相机和录制中静音，FillCenter按等比居中显示；案例明确展示实际错误，不以编译通过代替设备验证。 覆盖检查 67/67。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。