跳到主要内容

版本更新记录

版本更新记录​

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

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

新功能​

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

    TudadaSDK.Instance.ShareForReward(
        url: "https://example.com/share",  // 可选
        onSuccess: (result) => {
            if (result.rewarded) Debug.Log("分享完成 — 发放奖励");
        },
        onFail: (error) => Debug.LogError($"分享失败: {error}")
    );
    • ShareForReward(url, onSuccess, onFail): 分享 + 奖励处理
    • 分享处理由平台自动执行

所需文件:

  • Game SDK: tudadaGameSDK.0.1.5.js
  • Unity Client: tudada-unity-client-v0.1.5-hotfix0420.unitypackage

v0.1.4 (2026-03-18)​

新功能​

  1. 新增 ShowRewardedAd API: 通过一次调用即可完成激励广告的加载到展示全流程。

    TudadaSDK.Instance.ShowRewardedAd("your-ad-unit-id",
        onSuccess: (result) => {
            if (result.isEnded) Debug.Log("观看完成 - 发放奖励");
        },
        onFail: (error) => Debug.LogError($"广告失败: {error.errMsg}")
    );
    • ShowRewardedAd(adUnitId, onSuccess, onFail): 加载 + 展示一体化处理
    • 加载 UI、重试、失败弹窗由平台自动处理
    • CreateRewardedVideoAd 作为旧版保留

  2. 新增 CheckFeature API: 可以预先确认特定 API 在当前平台是否受支持。

    TudadaSDK.Instance.CheckFeature("startAccelerometerSensor",
        onSuccess: (result) => Debug.Log($"支持: {result.apiName}"),
        onFail: (result) => Debug.Log($"不支持: {result.status}")
    );
    • CheckFeature(apiName, onSuccess, onFail): 检查 API 支持情况
    • CheckFeatureStatus: supported, unknown_api, version_required, platform_unsupported, device_unsupported, permission_denied

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

    TudadaLaunchOptions options = TudadaSDK.Instance.GetLaunchOptions();
    Debug.Log("查询JSON: " + options.query);
    • GetLaunchOptions(): 同步查询启动选项
    • query 为 JSON 字符串（需使用第三方 JSON 库解析）

所需文件:

  • Game SDK: tudadaGameSDK.0.1.4.js
  • Unity Client: tudada-unity-client-v0.1.4.unitypackage

v0.1.3 (2026-02-26)​

新功能​

  1. 新增 Accelerometer API: 添加了 StartAccelerometerSensor()、StopAccelerometerSensor()、OnAccelerometerChange 事件。

    TudadaSDK.Instance.OnAccelerometerChange += (res) => {
        Debug.Log($"X: {res.x}, Y: {res.y}, Z: {res.z}");
    };

    TudadaSDK.Instance.StartAccelerometerSensor(
        sensitivity: AccelerometerSensitivity.normal,
        onSuccess: (result) => Debug.Log("传感器启动完成")
    );

    TudadaSDK.Instance.StopAccelerometerSensor();
    • 基于 XYZ 轴的加速度数据接收
    • 灵敏度控制: sensitive | normal | insensitive
    • 扁平 API 模式: StartAccelerometerSensor(), StopAccelerometerSensor(), OnAccelerometerChange
    • 支持 Unity Editor 中的 Input.acceleration 模拟

所需文件:

  • Game SDK: tudadaGameSDK.0.1.4.js
  • Unity Client: tudada-unity-client-v0.1.4.unitypackage

v0.1.2 (2026-02-26)​

新功能​

  1. SystemInfo、AppBaseInfo 新增 environment 字段

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

    SystemInfo info = TudadaSDK.Instance.GetSystemInfoSync();
    Debug.Log(info.environment); // "prod" 或 "dev"

    AppBaseInfo appInfo = TudadaSDK.Instance.GetAppBaseInfo();
    Debug.Log(appInfo.environment); // "prod" 或 "dev"
    值说明
    "prod"生产环境
    "dev"开发环境

所需文件:

  • Game SDK: tudadaGameSDK.0.1.2.js
  • Unity Client: tudada-unity-client-v0.1.2.unitypackage

v0.1.1 (2026-02-20)​

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

v0.1.0 (2026-02-06)​

新功能​

  1. Login 结果新增 userId 字段

    TudadaSDK.Instance.Login(
        onSuccess: (result) => {
            Debug.Log("码: " + result.code);     // 已有
            Debug.Log("用户ID: " + result.userId); // 新增
        }
    );

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

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

变更事项（需要迁移）​

  1. 需要更新 Unity Client 包

    需要重新导入 tudada-unity-client-v0.1.0.unitypackage 及以上版本。请删除旧包后导入新包。

  2. CheckSession 回调结果类型变更

    // 0.0.1 — onSuccess中包含了登录信息
    TudadaSDK.Instance.CheckSession(
        onSuccess: (result) => {
            // result中包含code、userId等
        }
    );

    // 0.1.0之后 — onSuccess仅包含一般结果
    TudadaSDK.Instance.CheckSession(
        onSuccess: (result) => {
            // 仅包含result.errMsg
            // 如需登录信息请单独调用Login()
        }
    );

更新步骤​

  1. 导入新的 .unitypackage 文件（覆盖现有文件）
  2. 更新 index.html 中的 SDK 脚本版本： 
    <script src="tudadaGameSDK.0.1.0.js"></script>
  3. 如果 CheckSession 回调中使用了登录信息，请将其分离到 Login 中

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

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

  • Auth API (Login, CheckSession, GetUserInfo)
  • Storage API (Set/Get/Remove/Clear Storage + Sync 版本)
  • TudadaStore API (云存储)
  • System API (GetSystemInfoSync, GetWindowInfo, GetDeviceInfo 等)
  • Device API (振动、键盘、剪贴板)
  • Ad API (激励视频广告)
  • Lifecycle API (OnShow, OnHide, ExitMiniProgram, RestartMiniProgram)

Copyright 2026 Tudada. All rights reserved.