QuickSDK
  • 首页
  • 产品与服务
    聚合SDK工具

    聚合2000余家渠道的SDK出包工具,一次接入,批量出包,全渠道上架

    QuickSDK部署版

    本地化部署,数据独立存储,渠道资源共享公共版更新

    国内发行工具

    QuickGame SDK国内版助力手游开发商快速拥有自主发行的能力。

    海外发行工具

    QuickGame SDK海外版帮助发行商快速搭建海外自主发行平台。

    QuickAD+ 广告追踪工具

    检测广告效果,提供结算依据,优化投放策略为用户提供真实的广告监测数据

    玩家维护系统

    游戏客服服务、重度玩家跟踪、玩家情感分析、提升玩家忠诚度和参与度。

  • 开发者中心
    文档中心 下载中心 渠道列表 功能索引
  • 资讯动态
  • 商务合作
  • 关于我们
    公司介绍 人才招聘
  • 隐私政策
简体中文
简体中文 繁體中文 English
登录 注册
SDK聚合工具
  • 新手指南
  • 后台使用手册
  • SDK接入文档
    • 服务器接入文档
    • Java(Android)接入文档
    • Objective-C(iOS)接入文档
    • Unity3D接入文档
    • Unreal Engine(Android)接入文档
    • H5游戏接入文档(微端和网页)
    • QuickSDK开放平台接入文档
    • 隐私协议及权限说明
    • 登录、支付流程图
  • 母包自测用例
    • 母包自测用例 - Android
    • 母包自测用例 - iOS
  • 渠道配置说明
    • 五大渠道
    • 硬核渠道
    • 其他渠道
    • Quickgame(官方SDK)渠道
  • H5和工具使用手册
    • Android打包工具
    • iOS打包工具
    • 渠道插件使用说明
    • H5游戏上架Android或越狱渠道后台配置流程
    • H5游戏上架H5渠道后台配置流程
    • Android签名证书的创建方法
    • iOS证书和通用签名的创建方法
    • iOS如何创建推送证书以及生成pem证书
  • 关键指标说明
    • 运营数据术语定义及说明
    • 运营数据平台使用手册
    • 深度挖掘服务使用手册
  • FAQ
    • 接入问题
    • 打包问题
    • 上架测试
    • 出包错误

更新日期: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,则标示信息有误,游戏应给出登录失败的提示


接入流程

1.引用JS类库


https://qkh5api.quickapi.net/static/lib/libQuickSDK_v2.js


注意: 游戏应原样引入此JS,不能随意变更协议为http或在后面附加时间戳(如是要转出安卓或越狱渠道的包,则js必须在html的script里进行引用,不能动态加载)


2.初始化QuickSDK

游戏应调用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"); //初始成功之后可以调用登录接口
})



3.调用QuickSDK的login方法示例如下:

通常登录方法需要在初始化回调中调用

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时,应再次调用登录接口.