camera
相机预览与拍摄组件,提供拍照和录像能力。
扫码预览
Props
Ref 方法
前端库版本不低于 0.2.0。
基本用法
共享采集会话与焦点
全局共享一个原生采集会话和预览层,只有前台 AppletFullPageContainer 中的实例可以获得
焦点,同页后创建的实例默认抢占。
- 页面隐藏时解绑预览;没有前台相机时停止采集。返回页面后自动恢复该页最近获得焦点的实例,
并触发
onReady。 - 后台页面调用
requestFocus()会失败。切页或同页抢占会结束原实例的录制,被抢占的实例 会收到onError并停止预览。 - 收到
onReady后再拍照或录像;失焦的实例可以调用requestFocus()重新抢占,然后等待onReady。 - 非焦点实例修改
devicePosition只保存自身设置,在该实例下次获得焦点时生效。 - 录像期间不能切换前后摄像头。
临时文件
takePhoto 和 stopRecord 返回的 path 是 appletfile://temp/... 虚拟路径。临时文件位于
当前应用插件隔离的缓存目录,在退出时清理;如需长期保存,用
getFileSystemManager().saveFile({ tempFilePath: path }) 转存到用户目录
appletfile://user/...,保存后的路径由返回值的 savedFilePath 给出。
错误码
注意事项
- 授权分两层。应用级:需要在 manifest 的
permissions中声明scope.camera,录像还要 声明scope.record,未声明时校验不通过。系统级:由客户端弹窗向用户申请,拍照只申请 相机权限,录像会同时申请相机和麦克风权限。 - 任一层未通过都通过
onError返回errCode: 2,需要据此引导用户到系统设置开启。 - Web 模拟器不渲染相机画面,
ref上的方法也不可用,需要在真机验收。