花椒直播推流SDK合规使用指南
生效日期：2026-06-09
一、前言
本指南用于帮助开发者合规接入 花椒直播推流SDK。开发者应遵循合法、正当、必要和最小必要原则，在向终端用户充分告知并取得必要授权后，再调用摄像头、麦克风、网络推流、录制、语音数据、人脸检测、FaceU 和图节点等能力。
二、SDK基本信息
| 项目 | 内容 |
|---|---|
| SDK名称 | 花椒直播推流SDK |
| SDK包名 | @hj-live/hjpusher |
| SDK版本 | 1.0.13 |
| SDK类型 | 按 T/GIIC0005—2025 附录A划分：实时音视频类 |
| SDK形态 | HarmonyOS HAR 包 |
| 开发者 | 北京密境和风科技有限公司 |
| 声明权限 | ohos.permission.CAMERA、ohos.permission.MICROPHONE、ohos.permission.INTERNET |
| 联系方式 | kefu@huajiao.tv，400-6768-666 |
三、基本业务功能与扩展业务功能
| 功能类型 | 功能名称 | 开启/配置/关闭示例 |
|---|---|---|
| 基本业务功能 | 摄像头预览、麦克风采集、音视频编码、直播推流、状态回调 | 用户主动进入预览/推流流程并完成 CAMERA、MICROPHONE 授权后，通过 openPreview、CameraKit startPreview、openPusher 调用。 |
| 扩展业务功能 | 本地录制 | openRecorder({ recordUrl }) 开启，closeRecorder() 关闭；不配置 recordUrl 或不调用即不启用。 |
| 扩展业务功能 | PNG 序列/礼物叠加 | openPngSeq(url) 加载资源，setGiftPusher(true) 开启推礼物，setGiftPusher(false) 关闭。 |
| 扩展业务功能 | 双屏推流 | setDoubleScreen(true) 开启，setDoubleScreen(false) 关闭。 |
| 扩展业务功能 | 静音 | setMute(true) 静音并停止把麦克风音频用于推流，setMute(false) 恢复。 |
| 扩展业务功能 | 预览旋转 | setPreviewRotation(rotation) 配置；关闭预览后停止调用。 |
| 扩展业务功能 | 语音数据获取 | openSpeechRecognizer(cb) 回调音频数据，closeSpeechRecognizer() 关闭。 |
| 扩展业务功能 | 人脸检测联动 | HJFaceDetectMgr.openFaceDetect() 开启，closeFaceDetect() 与 nativeSourceClose() 关闭。 |
| 扩展业务功能 | FaceU/人脸保护 | openFaceu(url) 或 nodeEnable(..., true, ...) 开启，closeFaceu() 或 nodeEnable(..., false, ...) 关闭；人脸保护用 setFaceProtected(false) 关闭。 |
| 扩展业务功能 | RTE 图节点控制 | nodeCreate/nodeConnect/nodeSetParam/nodeEnable 配置；nodeEnable(false)/nodeDisconnect/nodeDelete 关闭或移除。 |
四、可选个人信息使用目的和关闭方式
| 可选个人信息 | 属性 | 使用目的 | 关闭/撤回方式 |
|---|---|---|---|
| 视频信息 | 可选个人信息 | 摄像头预览、视频编码、直播推流、本地录制、特效处理 | 拒绝或撤回 CAMERA；不调用 openPreview/openPusher；停止时调用 closePusher/closePreview 并释放相机。 |
| 音频信息 | 可选个人信息 | 麦克风采集、AAC 编码、直播推流、本地录制、语音数据获取 | 拒绝或撤回 MICROPHONE；setMute(true)；closeSpeechRecognizer/closeRecorder/closePusher。 |
| 人脸信息 | 可选个人信息，敏感场景建议单独同意 | 人脸检测、FaceU、人脸保护、关键点联动效果 | 不调用 openFaceDetect；调用 closeFaceDetect/nativeSourceClose；关闭 FaceU 和人脸保护；撤回 CAMERA 后不得继续处理。 |
五、接入流程合规建议
1. 应用首次启动或进入直播功能前，应先展示应用隐私政策和第三方 SDK 清单。
2. 用户点击开始预览或开始直播后，再申请 CAMERA/MICROPHONE 权限；用户拒绝时，不得继续调用采集或推流接口。
3. 本地录制、语音数据获取、人脸检测、FaceU、人脸保护和礼物叠加应设置独立开关，用户关闭后立即调用对应关闭 API。
4. 人脸信息涉及敏感场景，建议在开启人脸检测、FaceU 或人脸保护前以弹窗或专项页面进行显著提示并取得单独同意。
六、向终端用户披露条款示例
| 披露项 | 示例文案 |
|---|---|
| SDK名称 | 花椒直播推流SDK |
| SDK提供方 | 北京密境和风科技有限公司 |
| SDK包名和版本 | @hj-live/hjpusher，1.0.13 |
| 使用目的 | 用于实现摄像头预览、麦克风音频输入、音视频编码、直播推流、状态回调，以及可选的录制、语音数据、人脸检测、FaceU、礼物叠加和图节点效果。 |
| 处理个人信息 | 视频信息、音频信息、人脸信息（仅在用户主动开启相关功能时处理）。 |
| 权限 | CAMERA、MICROPHONE、INTERNET |
| 规则链接 | 个人信息处理规则：https://web.huajiao.com/web/share/banner/2026/sdkPrivacy/hjpusher/index.html；合规使用说明：https://web.huajiao.com/web/share/banner/2026/sdkPrivacy/hjpusher/compliance.html |
七、授权同意建议与单独同意示例
基础预览/推流示例：“为实现直播推流，我们需要调用摄像头和麦克风，处理您的视频信息和音频信息。拒绝后将无法开始预览和直播。”
人脸单独同意示例：“为实现 FaceU 特效、人脸保护或人脸关键点效果，需要在本地处理视频画面中的人脸信息，包括人脸位置、角度、置信度和关键点。你可选择不开启，或随时关闭该功能。”
八、禁止行为与材料维护
不得在用户未授权或无感知的情况下开启摄像头、麦克风、录制、推流、语音数据获取、人脸检测、FaceU 或后台长时运行。当 SDK 功能、权限或接口变化时，应同步更新隐私政策、权限提示、第三方 SDK 清单、合规使用指南和 SDK 下载页。
上述表格即为 SDK 扩展业务功能和可选个人信息的配置选项与关闭示例；接入方应在产品界面提供同等含义的开关或撤回入口。