开放平台V2文档

# 更新日志

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

重要提醒

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

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

# 2.2.4 (2026-05-20)

更新内容

  • 检测 uploadRoleInfo 接口接入位置，若在 pay 接口回调函数中同步调用 uploadRoleInfo 上报 PAY_SUCCESS 事件，将于开发版/体验版弹窗提示

# 2.2.3 (2026-05-19)

更新内容

  • 升级引力引擎SDK至6.0.8版本（修复版），解决其SDK内部$flush_time字段读取报错的问题

# 2.2.2 (2026-05-14)

更新内容

  • 升级引力引擎SDK至6.0.8版本（适配腾讯激励直玩能力）
  • 流程统计上报API内置新增扩展参数，用于上报小游戏启动参数

# 2.2.1 (2026-05-13)

更新内容

  • 升级引力引擎SDK至6.0.7版本（适配腾讯激励直玩能力）

# 2.2.0 (2026-05-12)

更新内容

  • 升级引力引擎SDK至6.0.6版本（适配腾讯激励直玩能力）
  • 升级腾讯广告SDK至1.5.7版本（适配腾讯激励直玩能力）
  • 新增腾讯激励直玩能力相关API，并在该场景下自动启用相关数据上报延迟机制
  • 优化部分已知问题

# 2.1.8 (2026-03-10)

更新内容

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

# 2.1.7 (2026-02-04)

更新内容

  • 升级引力引擎SDK至6.0.2版本（若升级到此版本或以上，并配置了引力引擎参数，请务必将 https://backend.gravity-engine.com 和 https://api.gravity-engine.com 配置到微信开放平台后台的 request 合法域名列表中）

# 2.1.6 (2026-01-20)

更新内容

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

# 2.1.5 (2026-01-08)

更新内容

  • 完善 消息订阅 功能，当用户勾选了订阅面板中的 总是保持以上选择，不再询问 时，模板消息会被添加到用户的小游戏设置页，设置完返回游戏后会把最新订阅状态同步给服务端

# 2.1.4 (2026-01-07)

更新内容

  • 新增 openSvip 接口，用于从游戏内跳转至通用SVIP会员中心

# 2.1.3 (2025-12-25)

更新内容

  • 升级腾讯广告SDK至1.5.6版本

# 2.1.2 (2025-12-18)

更新内容

  • 优化游戏圈按钮点击事件回调函数返回值的判断逻辑

# 2.1.1 (2025-12-16)

更新内容

  • SDK初始化新增 requests.subscribe 参数，用于记录用户的一次性订阅消息记录
  • 支持由SDK开放平台记录用户一次性订阅消息记录并下发相应通知
  • 获取游戏圈数据时，返回值新增sign签名，用于游戏服务器数据校验

# 2.1.0 (2025-12-05)

更新内容

  • 新增收藏相关功能接口
  • 登录、支付等核心流程内置日志新增 workflowId 参数，用于关联同一次流程的不同节点日志
  • 获取游戏圈数据接口内置新增主次渠道号参数

# 2.0.8 (2025-10-16)

更新内容

  • 修复由 v1 版本升级至 v2 版本后，可能存在登录后 openId 丢失的问题

# 2.0.7 (2025-09-08)

更新内容

  • H5客服交互优化：跳转至微信客服会话时，以发送卡片形式触发回复H5客服链接

# 2.0.6 (2025-06-17)

更新内容

  • 增加绑定第三方平台方法(bindThirdPlatform)

# 2.0.5 (2025-05-27)

更新内容

  • 支付接口适配鸿蒙设备（仅支持米大师支付）
  • 第三方广告平台数据上报环节新增log日志

# 2.0.4 (2025-03-03)

更新内容

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

# 2.0.3 (2025-02-12)

更新内容

  • 接入冰柠乐渠道SDK
  • SDK初始化参数新增 requests.order 支付下单服务接口地址， requests.dyb 冰柠乐渠道服务接口地址配置
  • 新增 getUserData 接口，用于获取玩家基础信息（openId、adFlag等）
  • 新增 checkMsgSecurity、checkImgSecurity、checkMediaSecurity 接口，用于内容安全识别

# 2.0.2 (2025-01-21)

更新内容

  • 激励视频广告相关API内置新增流程统计日志
  • 新增requirePrivacyAuthorize接口，用于模拟隐私接口调用，并触发微信隐私保护指引弹窗；见后文《其它接口》章节说明
  • 新增exit接口，用于退出当前游戏；见后文《其它接口》章节说明

# 2.0.1 (2025-01-03)

更新内容

  • 优化引力引擎付费事件的支付原因、支付方式的上报内容

# 2.0.0 (2024-12-05)

更新内容

  • 统一字段优化修改，涉及所有API
  • 集成腾讯广告SDK数据上报，包括 小游戏启动(START_APP)、付费(PURCHASE)、注册(REGISTER)、分享(SHARE)、创建角色(CREATE_ROLE)、游戏等级提升(UPDATE_LEVEL) 等核心数据上报
  • 初始化新增腾讯广告上报必要字段
  • 上报角色信息新增付费上报类型
Last Updated: 2026/5/21 11:09:53

← 准备工作 →