SDK接入(重要)
最后更新于
这有帮助吗?
最后更新于
这有帮助吗?
在接入天幕SDK前请做好以下准备:
是否有天幕账号,若无,请先,已有账号请登录;
添加游戏,在控制台页面可见当前账号已加入的主体,请进入对应主体中的【游戏管理】后台进行添加。
下面对接入流程进行详细说明,共有两个步骤,十分钟左右即可搞定SDK接入。
在【游戏管理】页面,点击操作中的【下载/接入SDK】开始接入。
请按要求配置QQ的域名白名单,非常重要,务必添加,确认添加完毕后,点击下一步。
请勿多个游戏使用同一个SDK,每个游戏会对应一个单独的SDK文件;
微信小游戏转为qq小游戏时,请将其视为接入一个新游戏,创建一个QQ平台类型的主体,加入到该主体中下载SDK文件。
如果接入时报错:小程序session解析错误
请检查接入的SDK与小游戏本身是否对应(SDK及SDK所在项目的appid/appsecret,与小游戏实际是否一致)
小游戏引入SDK时请务必注意如下事项:
SDK必须放在主包中加载,切勿分包加载(在game.js 中第一行引入sdk文件)
在laya引擎中,文件名必须为.min.js结尾,否则会导致编译报错
将下载的sdk文件放置到小游戏工程中,在小游戏game.js中引入SDK,并在需要使用sdk功能的地方调用。
TypeScript或ES6 JavaScript语法植入方式:import 'tm_sdk_qq.min.js';
ES5 JavaScript使用commonJs规范的植入方式:require('tm_sdk_qq.min.js');
植入SDK后,复制屏幕上的检测码,在小程序开发工具中将启动参数设为检测码,开始编译;
设置好参数并完成了编译,请点击“开始检测”按钮进行检测接入状态;
天幕将自动检测您的接入是否正常,即可了解SDK接入是否正常;
以下流程仅使用了无登录版SDK的开发者需要阅读。
下载无登录版本的SDK,在接入该SDK后,开发者需要自行接入QQ登录流程并获取openid
开发者通过自己的服务端接口获取到openid后调用SDK接口,发送openid。(若不发送openid将导致天幕功能无法使用)
【注意事项】
1、无登录版本SDK,以下接口或功能无法使用
2、无openid无法使用数据统计功能、买量助手功能,请接入SDK后及时发送openid避免数据统计、买量助手等功能无法使用或功能异常。
无登录功能版SDK需要由开发者自行接入QQ登录并发送openid提供给天幕方可使用天幕的功能。蓝色按钮下方的文字按钮即可下载此版本SDK。
(天幕-更新用户信息)
(天幕-登录/获取用户信息)