跳到主要内容

版本更新记录

版本更新记录​

如果您之前查看过旧版本(0.0.1)的 SDK 指南，请在此部分确认变更内容。

v0.1.5 (2026-03-30) — 当前版本​

新功能​

  1. 新增 shareForReward API: 新增了完成分享后发放奖励的 API。

    TudadaSDK.shareForReward({
      url: 'https://example.com/share',  // 可选
      success: (res) => {
        if (res.rewarded) console.log('分享完成 — 发放奖励');
      },
      fail: (err) => console.error('分享失败:', err.errMsg),
    });

    // Promise 方式
    const result = await TudadaSDK.shareForRewardAsync({ url: 'https://example.com/share' });
    if (result.rewarded) console.log('发放奖励');
    • shareForReward(): 回调模式 (success/fail/complete)
    • shareForRewardAsync(): Promise 模式
    • 分享处理由平台自动执行

v0.1.4 (2026-03-18)​

新功能​

  1. 新增 showRewardedAd API: 一次调用即可完成激励广告的加载到展示。

    TudadaSDK.showRewardedAd({
      adUnitId: 'your-ad-unit-id',
      success: (res) => {
        if (res.isEnded) console.log('观看完成 — 发放奖励');
      },
      fail: (err) => console.error('广告失败:', err.errMsg),
    });

    // Promise 模式
    const result = await TudadaSDK.showRewardedAdAsync({ adUnitId: 'your-ad-unit-id' });
    • showRewardedAd(): 回调模式 (success/fail/complete) — 推荐
    • showRewardedAdAsync(): Promise 模式
    • 广告加载、展示、重试、加载 UI、失败弹窗由平台统一处理
    • createRewardedVideoAd 保留为旧版 (@deprecated)

  2. 新增 CheckFeature API: 可以提前检查特定 API 在当前平台是否受支持。

    TudadaSDK.checkFeature({
      apiName: 'startAccelerometerSensor',
      success: (res) => console.log('支持:', res.apiName),
      fail: (res) => console.log('不支持:', res.status),
    });

    // Promise 模式
    const result = await TudadaSDK.checkFeatureAsync('startAccelerometerSensor');
    • checkFeature(): 基于回调 — success(支持) / fail(不支持)
    • checkFeatureAsync(): 基于 Promise — 支持/不支持均 resolve
    • 不支持原因: unknown_api | version_required | platform_unsupported | device_unsupported | permission_denied

  3. 新增 LaunchOptions API: 可以查询游戏启动时传入的查询参数及来源信息。

    const options = TudadaSDK.getLaunchOptions();
    console.log('查询参数:', options.query);
    • getLaunchOptions(): 同步 — 返回预缓存的启动选项
    • getLaunchOptionsAsync(): 异步 — 查询最新启动选项

变更​

  • wx 对象旧版化正式声明: 通过 wx 对象的 API 调用已正式归类为现有 WeChat 移植游戏的旧版兼容功能。
    • wx 对象仅暴露 v0.1.2 之前注册的现有 API。
    • v0.1.3 起新增的 API（加速度计、checkFeature、getLaunchOptions 等）仅限 TudadaSDK，无法通过 wx 对象使用。
    • 移植完成后建议逐步转换为直接调用 TudadaSDK。

v0.1.3 (2026-02-26)​

新功能​

  1. 新增 Accelerometer API: 添加了加速度计传感器扁平 API。这是与 wx API（wx.startAccelerometer 等）不兼容的 TudadaSDK 独立接口，API 名称和参数结构不同。无法通过 wx 对象使用，必须通过 TudadaSDK 直接调用。

    TudadaSDK.onAccelerometerChange((res) => {
      console.log(`X: ${res.x}, Y: ${res.y}, Z: ${res.z}`);
    });

    TudadaSDK.startAccelerometerSensor({
      sensitivity: 'normal',
      success: () => console.log('开始传感'),
    });

    TudadaSDK.stopAccelerometerSensor();
    • startAccelerometerSensor()、stopAccelerometerSensor()、onAccelerometerChange()、offAccelerometerChange()
    • 与 wx API 不同的独立接口（例如: startAccelerometerSensor vs wx.startAccelerometer）
    • 基于 XYZ 轴的加速度数据接收
    • 基于灵敏度控制: 'sensitive' | 'normal' | 'insensitive'

v0.1.2 (2026-02-26)​

新功能​

  1. SystemInfo、AppBaseInfo 新增 environment 字段

    添加了表示当前访问环境的字段。

    const info = TudadaSDK.getSystemInfoSync();
    console.log(info.environment); // 'prod' 或 'dev'

    const appInfo = TudadaSDK.getAppBaseInfo();
    console.log(appInfo.environment); // 'prod' 或 'dev'
    值说明
    'prod'生产环境
    'dev'开发环境

    可用于根据环境切换资源 CDN 地址等场景。

    const info = TudadaSDK.getSystemInfoSync();
    const cdnBase = info.environment === 'prod'
      ? 'https://cdn.example.com/prod'
      : 'https://cdn.example.com/dev';

v0.1.1 (2026-02-20)​

  • 应用内部改进（无需修改游戏代码）

v0.1.0 (2026-02-06)​

新功能​

  1. login() 响应新增 userId 字段

    TudadaSDK.login({
      success: (res) => {
        console.log(res.code);    // 已有
        console.log(res.userId);  // 新增
      },
    });

  2. SystemInfo.wifiEnabled 改为返回实际值

    之前返回固定值，现在返回实际 Wi-Fi 启用状态。

变更（需要迁移）​

  1. checkSession() success 回调结果类型变更

    // 0.0.1 — success 回调包含登录信息
    TudadaSDK.checkSession({
      success: (res) => {
        // res 包含 code、userId 等
      },
    });

    // 0.1.0 之后 — success 回调仅包含通用结果
    TudadaSDK.checkSession({
      success: (res) => {
        // 仅包含 res.errMsg (GeneralCallbackResult)
        // 如需登录信息，请单独调用 login()
      },
    });

v0.0.2​

新功能​

  1. 新增 Audio API: 添加了 createInnerAudioContext() 方法。

    const audio = TudadaSDK.createInnerAudioContext();
    audio.src = './bgm.mp3';
    audio.loop = true;
    audio.play();
    • 音频播放/暂停/停止/跳转
    • 音量及播放速度控制
    • 多种事件监听器 (onPlay、onEnded、onError 等)

v0.0.1 (2026-02-02) — 首次发布​

首次发布版本。包含以下 API:

  • Auth API (login、checkSession、getUserInfo)
  • Storage API (set/get/remove/clear + Sync 版本)
  • TudadaStore API (云存储)
  • System API (getSystemInfo、getWindowInfo、getDeviceInfo 等)
  • UI API (getMenuButtonBoundingClientRect)
  • Device API (振动、键盘)
  • Clipboard API
  • Ad API (激励视频广告)
  • Lifecycle API (onShow、onHide、exitMiniProgram、restartMiniProgram)