# 准备工作
# 下载SDK文件
请前往前文《更新日志》章节中查看SDK版本更新日志,点击相应版本号链接下载SDK文件;建议新接入游戏始终下载并使用最新版本,以确保可以使用当前SDK集成的所有功能!
# 添加安全域名
请登录《抖音开放平台控制台》 (opens new window)后台,进入“开发 > 开发设置”,在“服务器域名(request
合法域名)”一栏中添加如下安全域名:
- 登录服务:请联系运营人员提供
- 支付服务:请联系运营人员提供
- 数据上报服务:请联系运营人员提供
- 日志上报服务:请联系运营人员提供
- 热云SDK数据上报服务(仅在启用热云数据上报时添加):https://log.reyun.com、https://openid.reyun.com
- 引力引擎SDK数据上报服务(仅在启用引力引擎数据上报时添加):https://backend.gravity-engine.com
注意事项
添加安全域名时请务必注意区分发行主体,切勿擅自使用!另,以上安全域名对应SDK初始化参数中的 requests
选项,请提前添加好,否则SDK相关的服务端接口请求将不被抖音允许!
# 用户隐私保护指引设置
请登录《抖音开放平台控制台》 (opens new window)后台,进入“设置 > 基础设置 > 功能信息 > 小游戏隐私政策”,填写并披露用户隐私保护指引,否则将导致获取用户抖音昵称、头像/剪切板等接口无权被调用,可参考《XXXX小程序隐私保护指引》 (opens new window)模板进行填写。
# 基础库最低可用版本
为了确保SDK所有功能可用,避免出现低版本抖音不支持的情况,开发者需登录《抖音开放平台控制台》 (opens new window)后台,进入“设置 > 基础设置 > 功能信息 > 基础库最低版本号”,需设置的最低版本为 2.74.0
;若用户的基础库版本低于最低版本要求,则无法正常打开游戏,且提示用户更新抖音客户端版本。
这一操作可能会导致部分用户在该环节流失,为优化这一问题,可调整策略,降低后台设置的基础库最低可用版本,例如设置为1.83.1
,让部分版本较低的用户也能正常进入游戏并完成注册、登录及创角;
但该策略调整会导致SDK的部分对版本要求较高的接口异常(例如,会出现调用后不会触发相应回调函数,或无返回值),针对这种异常情况,请游戏客户端参考《抖音小游戏API版本支持说明》 (opens new window),配合进行兼容处理!
当前SDK已针对自身使用的抖音小游戏API做了基础库版本兼容处理,在用户的基础库版本不支持时,将主动向用户弹出升级提示;若游戏客户端有直接使用抖音小游戏API的场景,应当且务必做好相应的兼容处理 (opens new window),在合适的时机调用 sdkInstance.showUpgradeMessage("暂不支持XXXX功能")
向用户弹出相应提示,也可自行实现提示框!
# 提供抖音小游戏的 AppID 和 AppSecret 等信息
请登录《抖音开放平台控制台》 (opens new window)后台获取游戏的 AppID
和 AppSecret
,并提供给SDK开放平台相关对接人员(可在相关对接沟通群咨询)。请注意保管 AppID
和 AppSecret
等信息,如果秘钥发生变更,务必通知平台进行替换!
# 向SDK开放平台索要游戏的 AppID 等信息
向SDK开放平台索要游戏的 appId
、channel
、mainChannel
和 secondChannel
等信息(可在相关对接沟通群咨询)。