半屏小程序对接开发

一、乐橙半屏小程序简介

在开发者主体小程序页面中，以半屏形式唤起乐橙开放平台小程序，快速进行设备预览、录像回放、云台控制等操作。 此时开发者主体小程序无需额外申请微信组件（如live-pusher、live-player等）的使用资质权限，直接复用乐橙小程序的资质。

半屏小程序优势：

1、无需申请组件资质，节省对接周期及人力；
2、一行代码实现设备预览及录像回放，快速对接；
3、在开发者小程序中，以半屏形式直接使用乐橙小程序功能，包括设备预览、本地录像及云录像回放、设备对讲、云台控制、截图功能，无需跳转切换。

微信官方文档：打开半屏小程序

乐橙半屏小程序效果：

二、半屏接入流程

前提条件

1、提交乐橙开放平台小程序（appId：wx26dd070c090dfbdf）的调用申请。开发者可在小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请，待乐橙后台审批；
2、若开发者小程序使用的是2.23.1版本以下基础库，需要在app.json的embeddedAppIdList字段中声明乐橙小程序（appId：wx26dd070c090dfbdf）；
3、开发者小程序需为竖屏。
若不符合以上所有条件，调用半屏接口时将被自动切换为跳转竖屏小程序，非半屏形式。

1、打开乐橙半屏小程序

开发者通过调用微信接口wx.openEmbeddedMiniProgram(Object object)，按照接口要求输入参数实现半屏跳转小程序。

打开实时预览半屏：

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}' })

参数说明：

半屏设备回放参数示例：

wx.openEmbeddedMiniProgram({ appId: 'wx26dd070c090dfbdf', path: '/pages/playBackRedirect/index?token=At_0000wqeqweqwxxxxxxxxxx&appId=lcaedestxxxxxxxxxxxx&appSecret=testtesttestxxxxxxxxxxxxxxxxx&deviceId=QWERASDF1234&channelId=0&recordType=local' })