# 更新日志

以下内容为SDK版本更新日志，点击或右键另存为下载相应版本的SDK文件，并放入游戏项目工程目录中；建议新接入游戏始终下载并使用最新版本，以确保可以使用当前SDK集成的所有功能。

重要提醒

已接入SDK的游戏如需使用新版本中新增或优化的功能，请不要仅下载最新SDK文件后直接覆盖原版本。由于SDK版本会持续迭代，任意两个版本之间可能包含初始化配置、接口参数、回调返回值、数据上报逻辑、第三方SDK、平台能力适配等多项变更；跨版本替换前，请先从当前游戏正在使用的版本开始，逐项阅读后续所有版本的更新内容，并结合游戏内已接入的相关能力完成影响评估和回归验证。

存量项目升级时，请将“下载最新SDK文件”视为一次正式的SDK版本升级，而不是单个功能文件替换。确认升级前，建议先对照本页历史更新日志梳理涉及的业务模块，并在开发版/体验版中完成登录、支付、订阅、广告、数据上报等已接入能力的验证；如无法确认某个历史变更是否会影响当前项目，请先在对接群中与SDK对接人员确认后再升级！

# 2.2.2 (2026-05-26)

更新内容

扩展支付能力，支持道具直购（含小额支付）场景
优化支付模块架构，新增支付环境检测层，统一环境判断与链路分发逻辑

# 2.2.1 (2026-05-21)

更新内容

检测 uploadRoleInfo 接口接入位置，若在 pay 接口回调函数中同步调用 uploadRoleInfo 上报 PAY_SUCCESS 事件，将于开发版/体验版弹窗提示
适配 OpenHarmony 平台标识，将抖音返回的 openharmony 统一映射为 ohos
修复 pay 接口在安卓设备中回调异常的问题

# 2.2.0 (2026-05-18)

更新内容

优化推荐流直玩预启动场景下的数据上报处理，延迟 SDK 内部业务数据上报至用户真实进入小游戏后执行
升级内置引力引擎 SDK 至 6.0.8，并调整引力引擎初始化与启动时机

# 2.1.3 (2026-05-14)

更新内容

流程统计上报API内置新增扩展参数，用于上报小游戏启动参数

# 2.1.2 (2026-05-08)

更新内容

优化部分已知问题

# 2.1.1 (2026-03-10)

更新内容

全面升级优化内置流程统计埋点

# 2.1.0 (2026-01-20)

更新内容

完善 消息订阅 功能，在调用 一次性订阅、长期订阅 方法时，回调函数返回值有做变更，如下：
- code: 0 订阅成功
- code: ban 表示被微信临时性禁用，过几天会自动解除，可以提示 该订阅功能暂时受限，请稍后再试
- code: reject 表示用户拒绝，需引导用户右上角开启
- code 其他 其他值均表示错误

# 2.0.9 (2026-01-08)

更新内容

openCustomerServiceConversation 接口的 type 参数新增类型 3，并在用户客户端基础库版本较低时弹出升级提示
优化推荐流游戏直出能力-复访版接入文档说明

# 2.0.8 (2025-12-16)

更新内容

SDK初始化新增 requests.subscribe 参数，用于记录用户的订阅消息记录
新增 subscribeLongestMessage 接口，用于在游戏内打开长期订阅消息界面，返回用户订阅消息的操作结果
支持由SDK开放平台记录用户一次性订阅消息、长期订阅消息记录并下发相应通知

# 2.0.7 (2025-12-08)

更新内容

# 2.0.6 (2025-11-21)

更新内容

新增推荐流游戏直出能力-获客版

# 2.0.5 (2025-09-29)

更新内容

适配抖音 Unity 引擎，把 SDK 实例挂在了 globalThis.dhMiniSDK 下面，即 globalThis.dhMiniSDK(options)

# 2.0.4 (2025-05-29)

更新内容

第三方广告平台数据上报环节新增log日志

# 2.0.3 (2025-03-20)

更新内容

新增添加到桌面相关API
新增推荐流游戏直出能力相关API
新增订阅消息相关API

# 2.0.2 (2025-03-18)

更新内容

修复引力引擎付费数据上报缺少支付方式中文映射配置的问题

# 2.0.1 (2025-03-03)

更新内容

优化数据上报相关API参数缺失时的提示方式

# 2.0.0 (2024-11-10)

更新内容

统一字段以及其他功能优化