# 客户端app跳转QQ小程序

# 接入示例

使用活动测试工具快速测试

# 安卓版调用代码示例

int ret = MiniApp.MINIAPP_UNKNOWN_TYPE;
ret=mTencent.startMiniApp(this,getTargetMiniAppId(),mEtTargetMiniAppPath.getText().toString(), mEtTargetMiniAppVersion.getText().toString());
1
2

# 调用小程序相关参数

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类型

  1. qqCoinDeliver: 跳转到Q币发放页面
  2. newGamePreorder: 跳转到新游预约页面
  3. 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

# 绑定测试

绑定测试工具地址: https://livelink.qq.com/activities/#/testTool?activeName=bindCenter (opens new window)

隐私授权工具地址: https://livelink.qq.com/activities/#/testTool?activeName=gameDataAuth (opens new window)

lastUpdate: 11/12/2024, 3:43:23 PM