# 初始化
# 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>