# 客户端app跳转QQ小程序
# 接入示例
使用活动测试工具快速测试
# 安卓版调用代码示例
int ret = MiniApp.MINIAPP_UNKNOWN_TYPE;
ret=mTencent.startMiniApp(this,getTargetMiniAppId(),mEtTargetMiniAppPath.getText().toString(), mEtTargetMiniAppVersion.getText().toString());
1
2
2
# 调用小程序相关参数
# livelink QQ小程序 APP ID
1111906964
# 基础路径
basePath: /pages/gameAccountBind/index
# 调用的 queryString 参数
字段 | 字段说明 | 是否需要加入签名(sig) | 参数是否必填 |
---|---|---|---|
appPackageName | 应用的包名 (安卓),示例:com.tencent.qq | 否 | 是 |
appBundleId | 应用的 bundleid (iOS),示例:com.tencent.qq | 否 | 是 |
appQQConnectId | 拉取小程序的app应用在QQ 互联中配置的 APPID,示例:101010101。可于QQ互联 (opens new window)"应用管理-移动应用"中,获取应用APPID配置 | 否 | 是 |
gameIdList | 游戏 id 列表,参考已接入业务 示例:cf,lol,yxzj | 是 | 是 |
livePlatId | 平台 id | 是 | 是 |
code | 包含 uid 的加密串,参考 平台侧构建code | 是 | 是 |
t | 时间戳 | 是 | 是 |
sig | 签名,参考《小程序绑定:生成拉起签名》 | 否 | 是 |
actId | 指活动 ID,在平台综合绑定中心入口不需要传该参数。但活动场景下为必传 | 否 | 是 |
faceUrl | 用户所在平台头像地址 | 否 | 是 |
nickName | 用户所在平台昵称 | 否 | 是 |
livePlatName | 对应小程序中返回 app 的按钮名称,不传的话显示默认名称(需要通知 腾讯游戏来联 侧添加相关映射) | 否 | 否 |
type | 跳转小程序的具体功能场景,如qqCoinDeliver,表示进入到Q币发放页面。详细类型参照《type类型》 | 否 | 否 |
nextFlow | 为发放真实Q币的流程id。若需引导用户到小程序内完成QB兑换,则此参数为必传参数, nextFlow参数中的值来自上一步发货接口的返回(注意:只有type为qqCoinDeliver时,此参数才有效。) | 否 | 否 |
gameAuthScene | 授权场景(对应不同的授权字段,活动场景为act_${actId} ,其他场景可咨询对接人员) | 是 | 否 |
fromId | 来源Id, 后续会在后台回调中带上该信息,长度限制为32,超过则丢弃 | 否 | 否 |
*注意1:不应传入多余的参数,最终生成的路径与参数的总长度不可超过1024,超过会被小程序底层逻辑截断 *注意2:所有参数均需 encode(编码)一次,编码规范参见encodeURIComponent (opens new window)。go语言中应使用url.PathEscape
方法**,其他语言类似。注意生成的参数其中不包含;,/?:@&=+$#
等参数,可以使用对应语言方法调用试下 注意3: appPackageName
, appBundleId
, appQQConnectId
三个参数为QQ小程序相对于微信小程序额外需要的参数
# type类型
qqCoinDeliver
: 跳转到Q币发放页面newGamePreorder
: 跳转到新游预约页面loginLauncherWithBind
: 跳转云游戏登录页面
# 返回 APP
用户完成角色绑定后,点击返回 APP 按钮,即可返回 APP,接入详情请参考返回说明 (opens new window)
返回时会将传递到小程序的 queryString 透传到 app
# 回调示例
private class BaseUiListener implements IUiListener {
@Override
public void onComplete(JSONObject response) {
mBaseMessageText.setText("onComplete:");
mMessageText.setText(response.toString());
doComplete(response);
}
protected void doComplete(JSONObject values) {
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 绑定测试
绑定测试工具地址: https://livelink.qq.com/activities/#/testTool?activeName=bindCenter (opens new window)
隐私授权工具地址: https://livelink.qq.com/activities/#/testTool?activeName=gameDataAuth (opens new window)