更新日期:2025-12-23H5游戏接入文档(微端和网页)
1.H5游戏通过js API接入QuickSDK后,可直接用于上架H5、Android、iOS全平台渠道。需要注意的是,接完QuickSDKH5文档后的母链地址不能直接进行测试,需要配置好渠道,用渠道提供的链接或者包来测试。H5渠道最终是使用渠道给出的URL地址进行测试;Android、iOS渠道则需使用QuickSDK提供的打包工具打出apk或ipa渠道包进行测试
2.上架H5渠道需要将游戏地址配置到QuickSDK后台渠道参数列表上方的"H5游戏地址"里,其后QuickSDK将附带一些参数生成一个新的游戏地址(此地址可通过QuickSDK后台"渠道回调地址"栏目查看),运营需将此地址配置到渠道后台,然后使用渠道给出的地址测试。渠道给出的游戏地址会以iFrame加载游戏真实地址,若加载游戏地址后,游戏地址发生跳转或重定向,则新地址需原样保存被iframe加载的游戏地址上渠道所附加的URL参数
3.Android、iOS渠道需将游戏地址配置到QuickSDK后台对应渠道参数"H5GameUrl"里,启用打包工具,工具识别到游戏平台为H5时不需要提供母包,直接出包即可,然后用打出的渠道包进行测试
注意:开发者应仔细阅读以上3点内容,若游戏不按照此步骤配置测试,在调用SDK时将出现跨域错误
1.游戏开发者在游戏主页引入QuickSDK js类库
2.引入类库后 调用类库中的初始化方法
3.在初始化完成的回调中,调用登录方法,从登录方法的回调中获取用户uid和token
4.将js端取到的uid和token传回游戏服务器,游戏服务器调用QuickSDK用户验证的服务器API,验证用户
5.验证结果返回1,标示信息通过,游戏使用此uid完成登录。验证结果为0,则标示信息有误,游戏应给出登录失败的提示
https://qkh5api.quickapi.net/static/lib/libQuickSDK_v2.js
注意: 游戏应原样引入此JS,不能随意变更协议为http或在后面附加时间戳(如是要转出安卓或越狱渠道的包,则js必须在html的script里进行引用,不能动态加载)
游戏应调用QuickSDK的init接口,同时传入QuickSDK后台分配给游戏的参数.
var productCode = '05425578266356246482673853629430'; //QuickSDK后台自动分配
var productKey = '98253036'; //QuickSDK后台自动分配
QuickSDK.init(productCode,productKey,true,function(){
console.log("init success"); //初始成功之后可以调用登录接口
})
注意如果是要转出安卓渠道的包,游戏需要按如下方式进行初始化:
//申请权限 第3个参数 传true
QuickSDK.init(productCode,productKey,true,function(){
console.log("init success"); //初始成功之后可以调用登录接口
})
//不申请权限 第3个参数 传false
QuickSDK.init(productCode,productKey,false,function(){
console.log("init success"); //初始成功之后可以调用登录接口
})
QuickSDK.login(function(callbackData){
var message;
if(callbackData.status){
console.log('GameDemo:QuickSDK登录成功: uid=>' + callbackData.data.uid);
}else{
console.log('GameDemo:QuickSDK登录失败:' + callbackData.message);
}
})
从回调函数中可获取用户关键信息
注意:若游戏收到失败回调,判断message为cancel时,应再次调用登录接口.