音视频
音视频
本主题覆盖实时预览、录像回放、语音对讲、抓图与录像下载/转存。按任务表进入分步页；协议与延迟对比见 选择集成方式，概念见 视频与流。
本主题任务
| 任务 | 说明与入口 |
|---|---|
| 实时预览 | 选择集成方式四种对接；云直播开发指南；轻应用组件；应用开发 视频预览一节 |
| 创建设备直播地址 | 直播地址 API；零代码直播；自定义直播 |
| 录像回放：本地录像与云录像 | 录像查询 API；轻应用回放；录像的 HLS / FLV 地址 |
| 语音对讲 | 对比表里的支持情况；轻应用组件 的对讲方法与错误码 |
| 抓图与封面 | 设备抓图、设备抓图（升级版）；直播视频封面 |
| 录像下载与云转存 | 云转存产品、云转存 API |
| 码流与告警图片解密 | 轻应用 code、客户端 decryptPic、平台 图片解密组件 |
| 排障：预览失败、卡顿与高延迟 | 预览与卡顿常见原因 |
四种对接
选择集成方式写了四种方式：
- 移动应用对接：开发者 APP 通过集成移动端的 OpenSDK，可以实现设备配网、设备控制、视频预览、录像回放、语音对讲等。案例：智能家居。
- 云直播对接：开发者基于绑定的设备创建出 hls 直播地址，可以放入 web、微信公众号、h5 页面中，完成设备视频实时预览。案例：现场直播。
- 轻应用对接：开发者使用轻应用组件，在自己的 web、h5、微信小程序中，完成设备实时预览、录像回放功能。案例：园区监控。
- 桌面应用对接：开发者基于 PC 版本的 OpenSDK 组件，开发自己的桌面 PC 应用，可以实现设备控制、视频预览、录像回放、语音对讲等。案例：安防监控。
轻应用对比表支持语音对讲，集成见 语音对讲。
协议与延迟
下表摘自 选择集成方式；各端实现见各任务页中的平台分段。
| 移动应用对接 | 云直播对接 | 轻应用对接 | 桌面应用对接 | |
|---|---|---|---|---|
| 支持协议 | 私有协议 | hls | hls/rtsp | 私有协议 |
| 出流速度 | 1-2秒 | 3-8秒 | 1-3秒 | 1-2秒 |
| 实时延迟 | 1-2秒 | 8-10秒 | 2-3秒 | 1-2秒 |
| 实时预览 | 支持 | 支持 | 支持 | 支持 |
| 录像回放 | 支持 | 支持 | 支持 | 支持 |
| 语音对讲 | 支持 | 不支持 | 支持 | 支持 |
对比表未覆盖的能力（抓图、云转存、解密等）不在此表重复，请直接进任务页：抓图与封面、录像下载与云转存、码流与告警图片解密。
云直播出流编码：设备侧优先 H.264 + AAC（见 创建设备直播地址）。轻应用 Web 另支持 H.265（见 轻应用使用说明）。延迟与协议以对比表为准。
服务端做什么 / 客户端做什么
| 对接方式 | 谁拉流 / 谁调 HTTP |
|---|---|
| 移动 / 桌面 SDK | 客户端 OpenSDK 播放；绑定与列表等多为服务端 HTTP，见 应用开发 与 通过接口绑定 / App 配网 |
| 云直播 | 服务端创建 HLS 等地址，见 创建设备直播地址 或 控制台预览 |
| 轻应用 / 小程序 | 浏览器或 web-view 内组件；步骤见 轻应用组件 与 实时预览 |
录像查询、抓图、云转存等以 OpenAPI 为准，索引见上表任务链。
前提
创建设备直播或云录像前，须先把设备加到开发者账号（控制台、乐橙 App 或 SDK Demo 配网绑定）。在 我的资源 关注直播流量/带宽，不足时先充值。