打开 App
此功能需要用户主动触发才能打开 APP,所以不由 API 来调用,需要用 open-type
的值设置为 launchApp
的 <button>
组件的点击来触发。
当小程序从 APP 分享消息卡片的场景打开(场景值 1036),小程序会获得打开 APP 的能力,此时用户点击按钮可以打开分享该小程序卡片/拉起该小程序的 APP。即小程序不能打开任意 APP,只能 跳回
APP。
在一个小程序的生命周期内,只有在特定条件下,才具有打开 APP 的能力。
使用方法
小程序端
需要将 <button>
组件 open-type
的值设置为 launchApp
。如果需要在打开 APP 时向 APP 传递参数,可以设置 app-parameter
为要传递的参数。通过 binderror
可以监听打开 APP 的错误事件。
开发者需要在button组件中填充下列参数,才能正常使用:
- app-packagename:应用的包名 (安卓)
- app-bundleid:应用的bundleid (iOS)
- app-connect-id:QQ互联中的AppID
app 端
APP 需要接入 互联sdk。 文档请参考 (https://wiki.connect.qq.com)
代码示例
<button open-type="launchApp" app-packagename="com.tencent.qq" app-bundleid="com.tencent.qq" app-connect-id="101010101" binderror="launchAppError">
打开APP
</button>
Page({
launchAppError(e) {
console.log(e.detail.errMsg)
}
})
error 事件参数说明
值 | 说明 |
---|---|
invalid scene | 调用场景不正确,即此时的小程序不具备打开 APP 的能力。 |