跳到主要内容

常见问题

open 返回 unavailable​

确保 useCamera() 返回的 holder 已在稳定 React 树中挂载,再执行 open()。缺少宿主会明确失败。宿主真实卸载取消所属调用。也应读取 error.message,确认原生相机是否无法维持交互。

权限拒绝或没有设备​

failed / permission_denied 表示相机权限拒绝;按系统设置恢复权限后再调用。failed / no_device 表示没有可用相机。相机和麦克风声明见安装。麦克风仅在实际开始录像时请求;其局部失败留在相机内提示。

Web 与模拟器​

Web 的真实入口隔离原生模块,返回 failed / unsupported。模拟器不能替代真实拍摄设备;Jest 使用官方 mock。

水印未出现​

确认当前模式是照片,且 watermark.lines 非空。录像不烧录水印。检查原生照片处理模块是否已重新编译,以及 Skia 等依赖是否完整。处理失败会在相机内提示,不返回未加水印的原图。

模块找不到或原生符号缺失​

按完整依赖清单安装并重新构建。VisionCamera 的 worklets 包需要一起安装;文件系统使用 @dr.pogodin/react-native-fs。iOS 原生依赖变化后执行 pod install,重新编译 App。

处理结果​

switch (result.status) {
case 'success':
console.log(result.media);
break;
case 'cancelled':
break;
case 'failed':
console.error(result.error.reason, result.error.message);
break;
}

取消不会作为成功返回,失败也没有媒体集合。invalid_input 不会关闭当前有效交互。取消某次调用应使用它自己的 AbortController。

成功后文件是否永久保存​

文件仍在临时目录。成功交付后由消费者负责保存或上传以及后续释放,不能把拍摄成功当作上传完成。库仅清理仍属于本轮的未交付文件。

录像时长与码率​

输入 maxDurationSeconds 单位为秒,输出 durationMs 单位为毫秒;没有真实时长时字段缺省。bitRate 放在 video 模式项中。显式能力按 SDK 真实支持处理,局部录制错误会在相机内显示。