半屏小程序对接开发
半屏小程序对接开发
一、乐橙半屏小程序简介
在开发者主体小程序页面中，以半屏形式唤起乐橙开放平台小程序，快速进行设备预览、录像回放、云台控制等操作。 此时开发者主体小程序无需额外申请微信组件（如live-pusher、live-player等）的使用资质权限，直接复用乐橙小程序的资质。
半屏小程序优势：
1、无需申请组件资质，节省对接周期及人力；
2、一行代码实现设备预览及录像回放，快速对接；
3、在开发者小程序中，以半屏形式直接使用乐橙小程序功能，包括设备预览、本地录像及云录像回放、设备对讲、云台控制、截图功能，无需跳转切换。
微信官方文档：打开半屏小程序
乐橙半屏小程序效果：
二、半屏接入流程
前提条件
1、提交乐橙开放平台小程序（appId：wx26dd070c090dfbdf）的调用申请。开发者可在小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请，待乐橙后台审批；
2、若开发者小程序使用的是2.23.1版本以下基础库，需要在app.json的embeddedAppIdList字段中声明乐橙小程序（appId：wx26dd070c090dfbdf）；
3、开发者小程序需为竖屏。
若不符合以上所有条件，调用半屏接口时将被自动切换为跳转竖屏小程序，非半屏形式。
1、打开乐橙半屏小程序
appSecret 仅用于服务端签名，不得写入小程序 path 或前端。token 由后台 accessToken 换取（与 安装与初始化 一致）。
开发者通过调用微信接口 wx.openEmbeddedMiniProgram 打开半屏。
打开实时预览半屏：
wx.openEmbeddedMiniProgram({
appId: 'wx26dd070c090dfbdf',
path: '/pages/selfDevice/openvideoplay/openvideoplay?token={token}&appId={appId}&deviceId={deviceId}&channelId={channelId}'
})
打开录像回放半屏：
wx.openEmbeddedMiniProgram({
appId: 'wx26dd070c090dfbdf',
path: '/pages/playBackRedirect/index?token={token}&appId={appId}&deviceId={deviceId}&channelId={channelId}&recordType={recordType}'
})
参数说明：
| 参数名 | 是否必填 | 参数说明 |
|---|---|---|
| token | 是 | 管理员 accessToken（后台换取） |
| appId | 是 | 开放平台账号 appId |
| deviceId | 是 | 设备序列号 |
| channelId | 是 | 设备通道号 |
| recordType | 设备回放时必填 | 回放录像类型，local：本地录像；cloud：云录像 |
wx.openEmbeddedMiniProgram({
appId: 'wx26dd070c090dfbdf',
path: '/pages/playBackRedirect/index?token={TOKEN}&appId={APP_ID}&deviceId={DEVICE_ID}&channelId=0&recordType=local'
})