开发总览
本文介绍如何使用乐橙云开放平台快速接入设备并使用相关视频能力。
# 1. 准备工作
登录开放平台官网 (opens new window)后，只需要简单的注册与信息填写，即可快速成为乐橙云开放平台的开发者。
注意
请妥善保存您的账户信息，后续您的设备绑定于开发流程都需要基于此账号进行，增值服务的相关购买也绑定于此账号上。
该账号同样作为超级管理员用于创建子账号与开发者关联的应用账户体系，从而实现应用内的权限分配与管理。 整体对接流程和示意图如下：
对接步骤：
- 设备添加到开发者账户下。
- 开发者创建子账户A。
- 开发者账号授权设备权限给子账户A。
- 开发者应用的用户A通过子账户A的权限来操作设备。
# 2. 创建应用
在您第一次登录乐橙云开放平台时，您便可快速填写信息创建自己的应用，涵盖H5、移动应用、WEB应用、PC应用多种类型。
创建的应用于您的开发者账号相关联，请认真按照实际情况填写，运营人员将会根据您填写的信息与您联系，进行深入的合作与交流。
创建完成后，您可在控制台-我的应用-应用信息中获取到相应的Appid与AppSecret，该参数用于获取开发者访问令牌AccessToken善保管。
# 3. 试用设备
创建应用后，您即可使用控制台添加您的设备进行拉流试用，点击”控制台-我的资源“ (opens new window)进入我的资源服务页面，查看开发者当前剩余流量，个人版账号提供10路接入与1M带宽资源。
将设备添加到开发者账号下（即乐橙账号下），一共有两种方式添加设备：
方式一：乐橙app登录开发者账号，并添加相应设备；
方式二：参考开放平台SDK DEMO添加设备；
注：若您的乐橙账号下面还没有设备，请前往乐橙官方商城mall.imou.com (opens new window)购买设备，并且下载乐橙APP添加购买的设备；
通过控制台-产品与服务-直播服务 (opens new window)可以获取设备创建的直播地址，对直播设置直播时间段，以及配置自定义H5页面。
通过测试直播地址查看您的设备直播是否能够正常拉流以完成试用。
# 4. 集成APP
根据应用场景区分以下几种集成方式：
移动应用对接：开发者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秒 |
| 实时预览 | 支持 | 支持 | 支持 | 支持 |
| 录像回放 | 支持 | 支持 | 支持 | 支持 |
| 语音对讲 | 支持 | 不支持 | 支持 | 支持 |
| 设备配网 | 支持 | 不支持 | 不支持 | 不支持 |
| 对接成本 | 高 | 极低 | 低 | 高 |
| 对接耗时 | 1-3月 | 1-8小时 | 1-7日 | 1-3月 |
# 5. 联调测试
App开发完成后，与设备联调测试之前，请先完成以下工作：
设备先在本地配置，或者安装到易拆卸的位置
开放平台直播地址播放测试是否正常
然后进行联调测试，测试过程中返回的错误码请在官网文档中搜索错误码信息。
可通过SDK日志打印来查看检查问题所在，日志打印方法：
可打印日志查看传递的参数来检查问题所在，日志打印方法：
iOS：通过方法：- (void)setLogInfo:(LCOpenSDK_LogInfo *)logInfo;可以打开日志开关，然后拷贝完整的打印日志。
Android：通过调用LCOpenSDK_Utils.enableLogPrint()来控制SDK内部日志的打印，然后拷贝完整的打印日志。
若仍有困难可以在工单系统 (opens new window)中与我们联系。
若您有紧急项目且设备数量较大，可以发送邮件到cloud_openteam@imou.com报备项目，详细描述业务场景与需求的设备型号，审核通过后会有运营人员与你联系，进行商务沟通。
# 6. 设备部署
根据自己需求部署设备，主要考虑设备点位，设备数量，设备型号与并发需要的网络带宽情况。
设备选型可在乐橙官网 (opens new window)进行，如需咨询可联系商城客服。
通道数：绑定的前端ipc数量总和（NVR接入只计算NVR上报的通道总数）。
并发数计算：并发数是按账号下的所有设备所有播放端的累计，若打开多个播放器看同一个设备，计为多个并发；一个播放器看多个设备同样计为多个并发。
接口次计算：包括HTTP与SDK使用的全部接口次数，每步与平台交互的操作都是一次接口调用。
若您的设备大量增加，推荐更改企业套餐 (opens new window)来获取能力，企业套餐充值的消耗是其所包含的基础费用的抵扣，当超出套餐基本能力时会自动扩展服务，将收取一定的费用，收费方式为每日扣费。当您充值企业套餐后（270起充），将每日扣除企业套餐中包含的基本费用+当日所用的扩展服务费用。
# 7. 服务运营
控制台为开发者提供了我的应用、我的资源、账号信息、资源消耗明细、账单明细、数据分析、视频云存储服务、工单系统等功能，登录账号后可进行查看。
若您有其他需求，可通过企业微信联系运营人员进行商务对接与问题解答。
