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