微信小程序半屏小程序的使用方法

目录

一、微信拉起半屏API：

二、使用限制

 三、解决使用限制

---

一、微信拉起半屏API：

wx.openEmbeddedMiniProgram({
  appId: '',// 你要打开的小程序appid
  path: 'page/index/index', // 打开的页面路径，如果为空则打开首页
  extraData: {},// 需要传递给目标小程序的数据
  envVersion: 'develop',// 要打开的小程序版本 develop 开发版 trial 体验版 release 正式版
  success(res) {
    // 打开成功
  },
  fail(e) {
    // 打开失败
  },
})

二、使用限制

微信有规定的使用限制！！！！！！！

使用过程有以下限制，若不符合以下所有条件将被自动切换为普通的小程序跳转小程序，不影响用户使用：

1. 被半屏跳转的小程序需要通过来源小程序的调用申请，开发者可在 小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请，最多可以申请10个小程序
2. 2.23.1版本以下基础库，被半屏打开的小程序需要在app.json的embeddedAppIdList字段中声明；
3. 当前小程序需为竖屏；
4. 被半屏跳转的小程序需为非个人主体小程序（不含小游戏）。

 三、解决使用限制

1、半屏跳转的小程序要去微信后台授权申请。

实例

2、2.23.1以下版本基础库，开发者需要在全局配置app.json的embeddedAppIdList字段中声明需要半屏跳转的小程序，若不配置将切换为普通的小程序跳转小程序。2.23.1及以上版本起无需配置。

配置示例：

{
  "embeddedAppIdList": ["wxe5f52902cf4de896"]
}

官方文档：打开半屏小程序 | 微信开放文档，wx.openEmbeddedMiniProgram(Object object) | 微信开放文档