# 初始化

# 1、接口调用

首先,需要引入JS-SDK文件,并使用 new DHH5SDK(options) 进行初始化,初始化完成后将返回一个实例对象,可通过该实例对象访问相关属性和方法,如:用于创角的账号ID accountId 等。

new DHH5SDK(options);

注意事项

  • 请在 HTML 页面 head 标签内优先引入 JS-SDK 文件并进行初始化,尽早完成SDK初始化,方可使用SDK的数据统计接口,在游戏的初始化或资源加载环节完成部分日志上报,以便更加细粒度的分析用户的转化行为和流失情况。
  • 以下示例中引用的 JS-SDK 文件请替换成相关运营人员提供的地址。
  • 初始化SDK需要的必要参数请联系相关运营人员获取。

# 2、参数说明

注:以下参数请联系相关运营获取。

参数 类型 必填 默认值 说明
gamePartCode string - 游戏主体Code码
gamePackageId number - 游戏分包ID
appId number - 游戏的应用ID,即游戏ID,若不填,则由SDK自行获取,如 1347111768
packageName string - 游戏的应用包名,如 com.game.abc
appVersion string - 游戏的版本号,如 2.0.4.10
heartbeatEnable boolean true 是否开启心跳数据上报,用于统计用户在线时长,SDK内部自动上报,默认为 true

# 3、示例代码

注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!

<!DOCTYPE html>
<html lang="en">
<head>
  <title>官方H5小游戏</title>
  <meta charset="UTF-8" />
  <script type="text/javascript" src="https://sdk.xxx.com/h5sdk/dh-h5-sdk-3.0.0.js"></script>
  <script type="text/javascript">
    window.sdk = new DHH5SDK({
      gamePartCode: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // 游戏主体Code
      gamePackageId: "xxxx", // 游戏分包ID
      appId: "xxxxxxxxx", // 游戏ID
      packageName: "xxx.xxxxxxx.xxx", // 游戏的应用包名
      appVersion: "x.x.x.xx" // 游戏的版本号
    });
    
    console.log(sdk.name); // 表示所在的宿主环境,详情请查看后续章节说明
    console.log(sdk.channel); // 渠道ID,于SDK开放平台配置游戏时生成的一级渠道号
    console.log(sdk.mainChannel); // 推广主渠道ID,于SDK开放平台配置游戏时生成的二级渠道号
    console.log(sdk.secondChannel); // 推广次渠道ID,于SDK开放平台配置游戏时生成的三级渠道号
    console.log(sdk.userInfo); // 用户信息,仅在 sdk.login 调用成功后可读
    console.log(sdk.userInfo.userExtraInfo); // 用户拓展信息,用于存储用户于第三方渠道侧的信息
  </script>
</head>

<body>
  <h1>欢迎来到官方H5小游戏</h1>
</body>
</html>
Last Updated: 2024/11/12 10:54:24