Douyin Mini Game Unity

Comprehensive skill reference for Douyin (TikTok China) mini-game Unity C# API. Covers the full TT.* C# SDK for Unity game engine developers porting to Douyin mini-games — initialization (TT.InitSDK), account/login (TT.Login/CheckSession/GetUserInfo), payment (TT.RequestGamePayment/OpenAwemeCustomerService), ads (CreateRewardedVideoAd/BannerAd/InterstitialAd), device capabilities, file system, network, storage, UI, rendering, open-platform features, and all C# equivalents of JavaScript `tt.*` APIs. Use when developing Unity games for Douyin, working with C# TT.* APIs, integrating Unity with Douyin mini-game platform, or debugging Unity-to-Douyin adapter issues.

基于抖音小游戏 Unity C# API 官方文档生成，生成时间 2026-06-24 官方文档: https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/api/c-api/api-overview C# API 版本: TTSDK >= 6.0.0

抖音小游戏 Unity C# API 是专为 Unity 游戏引擎开发者提供的平台桥接层。通过 TT.* 命名空间（PascalCase 风格）将 JavaScript tt.* API 的能力以 C# 接口暴露给 Unity 代码，使已有 Unity 项目可直接适配发布为抖音小游戏。覆盖 200+ 个 API 方法，涵盖初始化、账号、支付、广告、设备、网络、文件、UI、渲染、开放能力等全模块。

核心框架

模块	描述	参考文件
API 概览与初始化	完整 API 索引（200+ 方法）、TT.InitSDK 初始化、ContainerEnv 环境信息、HostEnum 宿主枚举、LaunchOption 启动参数	unity-core

功能 API

账号与开放能力

模块	描述	参考文件
账号服务	TT.Login/CheckSession/GetUserInfo/GetSetting/OpenSetting、实名认证、抖音授权	unity-account
开放能力	侧边栏、收藏、群聊、关注抖音号、直玩、游戏互推、排行榜、直播、公会群、订阅消息、客服、数据分析	unity-open

商业化

模块	描述	参考文件
支付	TT.RequestGamePayment（游戏币/道具直购）、TT.OpenAwemeCustomerService（钻石支付）、游戏金币(Lite)、支付错误码、签名算法、服务端回调	unity-payment
广告	TT.CreateRewardedVideoAd（激励视频含再得模式）、TT.CreateBannerAd、TT.CreateInterstitialAd	unity-ads

系统与设备

模块	描述	参考文件
系统	TTAppLifeCycle(OnShow/OnHide)、重启/退出、启动参数、版本号、系统信息、触摸事件	unity-system
设备	加速度计、剪贴板、屏幕亮度、震动、陀螺仪、设备方向、键盘、鼠标、滚轮、网络状态	unity-device

数据与文件

模块	描述	参考文件
存储与文件	TTFileSystemManager（32个方法：Access/CopyFile/Mkdir/ReadFile/WriteFile 等）、数据缓存（Save/LoadSaving/DeleteSaving）、PlayerPrefs（10个方法）	unity-storage

媒体与交互

模块	描述	参考文件
媒体	TTGameRecorderManager（录屏：Start/Stop/GetRecordDuration 等）、游戏分享（ShareAppMessage/ShowShareMenu）、邀请模块	unity-media
界面与渲染	TT.ShowKeyboard/HideKeyboard、敏感词检测、光标样式、帧率设置	unity-ui

快速参考

C# 与 JavaScript API 命名对照

JavaScript (tt.*)	C# (TT.*)	说明
tt.login()	TT.Login()	登录获取 code
tt.checkSession()	TT.CheckSession()	校验 session
tt.getUserInfo()	TT.GetUserInfo()	获取用户信息
tt.request()	TT.Request()	HTTP 请求
tt.getSystemInfo()	TT.GetSystemInfo()	系统信息
tt.requestGamePayment()	TT.RequestGamePayment()	发起支付
tt.createRewardedVideoAd()	TT.CreateRewardedVideoAd()	激励视频广告
tt.onShow()	TT.GetAppLifeCycle().OnShow	生命周期-前台
tt.onHide()	TT.GetAppLifeCycle().OnHide	生命周期-后台
tt.setStorage()	TT.Save()	数据缓存

初始化最小示例

csharp

using UnityEngine;

public class GameEntry : MonoBehaviour
{
    void Start()
    {
        // 1. 初始化 SDK
        TT.InitSDK((code, env) =>
        {
            Debug.Log($"SDK Init: code={code}, Host={env.m_HostEnum}");
            Debug.Log($"AppId: {env.GameAppId}");
        });

        // 2. 判断是否在真机环境
        if (TT.InContainerEnv)
        {
            // 3. 监听生命周期
            TT.GetAppLifeCycle().OnShow += (param) => Debug.Log("游戏进入前台");
            TT.GetAppLifeCycle().OnHide += () => Debug.Log("游戏进入后台");

            // 4. 登录
            TT.Login(
                (code, anonymousCode, isLogin) => Debug.Log($"登录成功: code={code}"),
                (errMsg) => Debug.Log($"登录失败: {errMsg}"),
                forceLogin: true
            );
        }
    }
}

支付完整流程

csharp

// 钻石支付（通过客服页面）
var param = new OpenAwemeCustomerServiceParam
{
    BuyQuantity = 10,           // 购买数量
    CustomId = Guid.NewGuid().ToString(), // 唯一订单号
    CurrencyType = "DIAMOND",
    ZoneId = "1",
    ExtraInfo = "order_extra_info",
    Success = (result) => Debug.Log($"支付成功: {result.ErrMsg}"),
    Fail = (error) => Debug.Log($"支付失败: {error.ErrorCode} {error.ErrMsg}"),
    Complete = () => Debug.Log("支付流程完成")
};
TT.OpenAwemeCustomerService(param);

// 游戏币支付
var gamePayParam = new RequestGamePaymentParam
{
    Mode = "game",
    Env = 0,
    CurrencyType = "CNY",
    Platform = "android",
    BuyQuantity = 10,
    CustomId = Guid.NewGuid().ToString(),
    Success = (result) => Debug.Log($"支付回调: {result.ErrMsg}"),
    Fail = (error) => Debug.Log($"支付失败: {error.ErrorCode}")
};
TT.RequestGamePayment(gamePayParam);

激励视频广告

csharp

var param = new CreateRewardedVideoAdParam
{
    AdUnitId = "your_ad_unit_id",
    Multiton = false    // 普通模式
};
var videoAd = TT.CreateRewardedVideoAd(param);
videoAd.OnLoad += () => Debug.Log("广告加载完成");
videoAd.OnClose += (ended, count) =>
{
    if (ended) { /* 发奖励 */ }
};
videoAd.OnError += (code, msg) => Debug.Log($"广告错误: {code}");
videoAd.Load();
videoAd.Show();  // 展示广告

最佳实践

1. 初始化优先：游戏启动时首先调用 TT.InitSDK，在回调中获取宿主环境信息后再初始化游戏逻辑
2. 环境判断：使用 TT.InContainerEnv 区分 Unity Editor 和真机环境，Editor 下做 Mock 处理
3. 登录前置：支付、获取用户信息等操作前必须确保用户已登录，用 TT.CheckSession 校验
4. 生命周期管理：监听 OnShow/OnHide，前台恢复游戏循环、后台暂停渲染节省性能
5. 订单唯一性：支付必须使用唯一的 CustomId，建议用 UUID + 时间戳组合
6. 广告实例管理：激励视频广告只支持单实例，创建一次后复用；及时 Destroy 释放资源
7. 文件操作：优先使用 TTFileSystemManager 的异步方法（非 Sync 后缀），避免阻塞主线程
8. PlayerPrefs 替代：Unity 原生的 PlayerPrefs 在小游戏环境不可用，使用 TT.PlayerPrefs 替代
9. API 版本兼容：使用 CanIUse 判断 API 是否可用，做好版本兼容降级处理
10. TTSDK 版本：注意 SDK 版本的 API 变更（如 6.1.1 引入 Param 类替代旧版参数格式），及时更新