# 准备工作
# 下载SDK文件
请前往前文《更新日志》章节中查看SDK版本更新日志,点击相应版本号链接下载SDK文件;建议新接入游戏始终下载并使用最新版本,以确保可以使用当前SDK集成的所有功能!
# 添加安全域名
请登录《淘宝开放平台控制台》 (opens new window)后台,进入“云托管 > 开放环境”,新建空应用(命名格式可参考:DHMiniSDK_游戏英文简称_CLOUD
,游戏英文简称可使用在SDK开放平台注册时填写的英文简称),选择需要关联的小游戏AppKey
后保存,在空应用的“域名白名单”栏目中添加如下安全域名:
注意事项
请注意,新建空应用需要管理员账号或权限;空应用新建成功后会生成相应的cloudAppId
,该参数将用于SDK初始化!
- 登录服务:请联系运营人员提供
- 支付服务:请联系运营人员提供
- 数据上报服务:请联系运营人员提供
- 日志上报服务:请联系运营人员提供
注意事项
添加安全域名时请务必注意区分发行主体,切勿擅自使用!另,以上安全域名对应SDK初始化参数中的 requests
选项,请提前添加好,否则SDK相关的服务端接口请求将不被淘宝允许!
# 用户隐私保护指引设置
请登录《淘宝开放平台控制台》 (opens new window)后台,进入“开发 > 应用管理 > 我的应用 > 游戏互动创意 > 应用管理 > 消费者端小游戏应用 > 小游戏开发 > 开发设置 > 小程序隐私政策”,填写并披露用户隐私保护指引。
# 基础库最低可用版本
为了确保SDK所有功能可用,避免出现低版本淘宝不支持的情况,开发者需登录《淘宝开放平台控制台》 (opens new window)后台,进入“开发 > 应用管理 > 我的应用 > 游戏互动创意 > 应用管理 > 消费者端小游戏应用 > 小游戏开发 > 开发设置 > 设置基础库版本号”设置基础库最低可用版本,目前后台支持选择的最低版本为1.18.1
;若用户的基础库版本低于设置的最低版本要求,则会强制更新至基础库最新版本,预计耗时1秒;设置版本号后,需要重新发版才会生效。
当前SDK已针对自身使用的淘宝小游戏API做了基础库版本兼容处理,在用户的基础库版本不支持时,将主动向用户弹出升级提示;若游戏客户端有直接使用淘宝小游戏API的场景,应当且务必做好相应的兼容处理 (opens new window),在合适的时机调用 sdkInstance.showUpgradeMessage("暂不支持XXXX功能")
向用户弹出相应提示,也可自行实现提示框!
# 提供淘宝小游戏的 AppID 和 AppSecret 等信息
请登录《淘宝开放平台控制台》 (opens new window)后台获取游戏的 AppID
、AppKey
和 AppSecret
,并提供给SDK开放平台相关对接人员(可在相关对接沟通群咨询)。请注意保管 AppID
、AppKey
和 AppSecret
等信息,如果秘钥发生变更,务必通知平台进行替换!
# 向SDK开放平台索要游戏的 AppID 等信息
向SDK开放平台索要游戏的 appId
、channel
、mainChannel
和 secondChannel
等信息(可在相关对接沟通群咨询)。