# QQ/WX互联方案

# 适用场景

适用于以QQ互联或微信互联方式登录的网页

# 创建绑定实例

 var instance = new LivelinkManager()
1

# 示例

var instance = new LivelinkManager();

instance.init({
  actId: 475, // 活动ID
  gameId: 'lol', // 游戏ID
  appId: 'xxx', // 游戏appid
  openId: 'xxx', // 游戏账号openid
  accessToken: 'xxx', // 游戏账号access token
  loginType: 'link', // 登录方式 
  closeAfterBind: true, // 绑定成功后是否关闭弹窗
  gameAuthScene: '{场景ID}', // 授权场景值
  areaId: 123, // 大区ID(渠道),没有则不传
  platId: 123, // 终端操作系统ID,没有则不传
  partition: 123, // 子区ID,没有则不传
  roleId: '123', // 角色ID,没有则不传
  onBoundSuccess(data) { // 绑定账号成功的回调
    console.log('onBoundSuccess', data);
  },
  onBoundError(errData) { // 绑定账号失败的回调
    console.log('onBoundError', errData);
  },
  initialedEvent(data) { // 初始化成功的回调
    console.log('initialedEvent', data);
  },
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# init传参详解

参数 类型 是否必填 描述
actId int 工具化平台 (opens new window)申请的活动ID
gameId string 游戏ID, 例如lol, cf ...
appId string 游戏appid
openId string 游戏账号openid
accessToken string 游戏账号access token
loginType string link , 用来标识接入sdk的登录方式
onBoundSuccess function 账号绑定成功之后的回调,返回用户绑定成功后的状态信息data
onBoundError function 账号绑定失败之后的回调,返回用户绑定失败后的错误信息errData
initialedEvent function 初始化完成之后的回调,返回当前用户的状态信息data,或者返回初始化失败的错误信息errData
closeAfterBind boolean 绑定完成后是否需要关闭sdk弹窗,不传默认为true,关闭弹窗
gameAuthScene string 绑定所需授权与活动配置授权不一致时,同时传入活动id和授权场景值,优先使用授权场景值下的授权配置,参数格式为act_{活动ID}、custom_{自定义授权ID}、gamedata_v1_{数据场景V1版本ID}、gamedata_v2_{数据场景V2版本ID}
areaId int 大区ID(渠道),没有则不传
platId int 终端操作系统ID,没有则不传
partition int 子区ID,没有则不传
roleId string 角色ID,没有则不传

# 回调详解

1.onBoundSuccess / initialedEvent回调返回的data,包含的字段如下

{
          //当前活动相关信息
  	      "act": {
	            "livePlatId": "xxx",
	            "livePlatName": "xxx",
              "gameId": "cfm",
              "gameName":"穿越火线"
	        },
  				//当前游戏账号
	        "currAccount": {
	            "type": "wx",
	            "gameOpenId": "L3NjMTNRcEc1eldCK3VLdHVJM0I3V2hkRGxvcmMwRHlHM3V0dElPYUpocz0=",
	            "nickName": "太白Mo",
	            "headImg": "http://thirdwx.qlogo.cn/mmopen/vi_32/DYAIOgq83epZ1G0Eic2dj5xyciboLPHe9Wdz418krwhXkwwlVR4WRPCV7pBKtEHYfLBnaJpiaAtPA9b4jdmlhWqeg/132"
	        },
  				//当前游戏角色
	        "currRole": {
	            "roleId": "oMtbqt-Anyc5K7td9h1k0QN4hUzY",
	            "roleName": "太白Mo",
	            "area": "1",
	            "areaName": "微信",
	            "platId": "1",
	            "platName": "安卓(android)",
	            "partition": "0",
	            "partitionName": "",
	            "gameOpenId": null
	        },
					//当前绑定的平台账号(未绑定则为null)
	        "platAccount" : {
	            "uid": "123111213",
	            "nickName": "平台昵称",
	            "headImg": "http://thirdwx.qlogo.cn/mmopen/vi_32/DYAIOgq83epZ1G0Eic2dj5xyciboLPHe",
	            "livePlatId": "egame"
	        }
	    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

2.onBoundError回调返回的errData,包含的字段如下

{ "msg": "绑定账号失败", "code": 10002 }
1

# 工具函数

参见SDK工具函数

# 原型方法

参见SDK原型方法

# SDK调试

调试地址: https://livelink.qq.com/sdk/livelink-manager-sdk/index.html (opens new window)

lastUpdate: 4/15/2024, 9:55:03 AM