小程序 camera 组件教程｜权限说明与扫码降级方案 – MPForge
直接回答：camera 组件一上线就同时踩在「体验」和「审核」两条线上：权限说明没写清会被拒，扫码失败没有降级会卡死用户。这份小程序 camera 组件教程面向商家与开发，把权限文案、扫码降级、机型边界三件事定成口径。MPForge（DEVDIY 旗下）在涉及相机的项目里，第一条铁律就是「拒绝授权也有出路」。
一、相机功能的两条红线
结论句：camera 组件的红线一在权限——没有用途说明的弹窗既难过审又吓用户；二在可用性——相机不可用或识别失败时，用户必须还有别的路走。
两类高频翻车，商家开发各占一半责任：
- 无用途说明、无提示开启：用户一进页面就被索要相机权限，不知道为什么、拒绝后会怎样，投诉和放弃都在这里发生。
- 无降级卡死：老旧机型相机初始化失败，或用户拒绝授权后页面一片黑，扫码进不去、手输入口也没有，流程直接中断。
权限弹窗的时机与文案设计见 小程序隐私弹窗体验优化；扫码场景常配亮度引导，口径见 小程序屏幕亮度调节策略。
二、实现顺序：五步把相机链路做完整
结论句：先对齐隐私说明，再收缩使用范围，最后补齐降级，五步走完，camera 功能才具备上线资格。
- 隐私指引对齐：在隐私指引与权限弹窗里写清相机用途（如识别快递单号），与提审时的功能说明保持同一口径。
- 仅必要页创建：camera 组件只写在真正用相机的页面，进入创建、离开释放，不在后台偷偷开着。
- 提供相册与手输降级：扫码页同时提供从相册选图识别与手动输入编号两个入口，拒绝授权的用户走这两条路。
- 真机多品牌抽检：至少三个品牌的真机各过一遍，重点验证初始化失败时的提示与降级入口可用。
- 审核说明写场景：提审时在功能说明里写明相机使用场景，与页面实际行为一致，避免类目与描述不符被拒。
三、权限与场景：一张表对齐责任
结论句：权限文案是给用户看的承诺，审核说明是给平台看的承诺，两份文字必须指向同一个真实场景。
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 权限说明 | 写清用途与拒绝后的替代路径，时机在用户主动进入扫码时 | 一进小程序就弹权限，用途只字未提 |
| 拒绝授权 | 拒绝后页面给出引导开启入口与相册、手输降级 | 拒绝后黑屏或反复弹窗骚扰 |
| 使用范围 | 仅扫码、拍照等必要页面创建相机实例 | 全站常驻相机，后台滥用引发投诉 |
| 提审说明 | 功能说明与实际场景一致，演示路径可复现 | 说明里写扫码，演示路径却走不到相机页 |
商家验收抓两个动作：拒绝相机授权后确认还能通过相册或手输完成核心流程；再核对提审说明里的场景描述与实际页面一致。
四、识别失败的边界与退路
结论句：识别永远有失败率，降级方案的质量决定用户是「换个方式继续」还是「直接流失」。
| 场景 | 建议口径 | 注意事项 |
|---|---|---|
| 扫码失败 | 提示重试，同时给相册识别入口 | 反光、距离、光线都可能导致失败，别只报「错误」 |
| 相册识别失败 | 引导手动输入关键编号 | 手输框做格式校验，减少二次失败 |
| 相机初始化失败 | 展示友好提示并直接进入手输路径 | 老机型概率更高，别假设相机一定可用 |
| 帧级自定义处理 | 能平台扫码组件解决的，不自行上帧处理 | 自定义帧处理对性能与机型要求高，评估后再做 |
OCR、录制等重能力另做评估：OCR 的准确率与性能预算要单独测算，录制权限比扫码更严格，两类需求都不建议在扫码项目里顺手加。
五、避坑清单
结论句：相机功能的坑都在「假设」里——假设用户一定授权、假设相机一定可用、假设识别一定成功。
- 别假设授权一定发生：每次进入都按「可能被拒绝」设计，降级入口常驻页面而不是藏在报错后。
- 别忘了释放资源：离开页面未释放相机实例是闪退与耗电的常见来源，生命周期里写清创建与释放。
- 别滥用后台相机：非扫码页不创建相机，避免「小程序偷偷开摄像头」类投诉触发下架风险。
- 别把降级当附属品：手输与相册识别要在验收路径里正式走一遍，不是「应该能用」就算过。
六、常见问题 FAQ
camera 组件和 GEO 地理位置配置有关系吗？
没有。GEO 指地理位置配置——门店地址、经纬度、服务类目，影响小程序在「附近」与地图检索中的展示，不是按城市做地域 SEO。camera 是相机能力组件，两者属于完全不同的模块。
用户拒绝相机授权怎么办？
提供两条退路：从相册选图识别，或手动输入关键编号。同时在页面给出引导开启权限的入口，让愿意授权的用户能回来。
想加 OCR 识别和录像功能可以吗？
可以但另评：OCR 的准确率与性能预算单独测算，录制涉及更严格的权限说明与审核口径，不建议在扫码需求里顺手叠加。
使用相机后偶发闪退是什么原因？
最常见是离开页面没有释放相机资源，多次进出后内存耗尽。检查生命周期里创建与释放是否成对出现，并用真机反复进出验证。
提审时要注意什么？
功能说明写明相机使用场景并保证演示路径可复现，同时对照 微信小程序审核被拒常见原因 排查权限与类目问题后再提审。
