English · 中文

📦 Get the SDK

⬇️ Download com.tiktok.minigame@1.1.1-Release.unitypackage (1.6 MB)

The complete TikTok Mini Game SDK is shipped in this repo as a single Unity package. Drag-and-drop it into any Unity 2022.3 project, or follow Integrating the SDK for the full step-by-step.

A reference Unity project that integrates the TikTok Mini Game SDK (TTSDK) and exposes every public TT.* API through clickable buttons grouped by category. The log panel mirrors every callback so you can see exactly what each API returns, both inside Unity Editor and inside the real Douyin (TikTok) mini-game container.

Collapsed home	After Init SDK + a few calls

• Unity 2022.3.34f1 (any 2022.3.x LTS should work). Do not use the Tuanjie / 团结引擎 fork — the SDK's asmdef will collide.
• TTSDK 1.1.1 or newer. v1.1.1 ships a separate ttsdk-editor.dll so the Mock implementation runs inside Unity Editor without throwing.
• Build target: WebGL (IL2CPP). Other platforms are not supported by the container.

git clone <this repo>
cd tiktok-minigame-unity-demo
# Open the folder via Unity Hub → Add project → 2022.3.34f1

Inside Unity:

1. Wait for the initial asset import to finish.
2. Open Assets/Demo/Scenes/MainMenu.unity (or just press Play — it's the default scene).
3. Press Init SDK. Status flips to a green SDK inited.
4. Tap any category header (▶) to expand it, then tap a sub-button to hit the matching TT.* API. Results stream into the log panel at the bottom.

If anything looks off, you can rebuild the scene at any time via menu: TikTok Demo → Rebuild MainMenu Scene.

You can grab the SDK package directly from this repo:

./com.tiktok.minigame@1.1.1-Release.unitypackage

In your project:

1. Drag-and-drop the .unitypackage into the Unity Editor Project window, or use Assets → Import Package → Custom Package… and select the file.
2. Accept all items in the import dialog.
3. After import you should have:

   Assets/Plugins/com.tiktok.minigame/
     TTSDK/ttsdk.dll          ← runtime (WebGL only)
     TTSDK/ttsdk-editor.dll   ← editor mock (Editor only)
     Editor/ttsdk_tools.dll   ← build tool
     WebGL/                   ← platform glue
     LitJson/, DefaultTemplate/
   

4. Configure Player Settings:
   • Build target: WebGL
   • Scripting backend: IL2CPP (Mono is not supported)
   • Company / product name as you wish — they're surfaced in the container UI
5. Confirm the WebGL platform-specific dll filters in PluginImporter (Unity should do this automatically from .meta): ttsdk.dll ticked only for WebGL, ttsdk-editor.dll ticked only for Editor.

That's it — using TTSDK; becomes available.

Initialization is a single async call. Every container-dependent API (Login / Pay / Ads / Share / …) requires this to succeed first.

using TTSDK;
using UnityEngine;

public class Boot : MonoBehaviour
{
    void Start()
    {
        TT.InitSDK((code, env) =>
        {
            if (code == 0)
            {
                Debug.Log($"[TT] InitSDK ok, containerEnv={env?.GetType().Name}");
                // Safe to call TT.Login / TT.Pay / TT.CreateRewardedVideoAd / …
            }
            else
            {
                Debug.LogError($"[TT] InitSDK failed, code={code}");
            }
        });
    }
}

In this demo the same flow lives in DemoMainMenu.InitSdk().

You must use SDK ≥ 1.1.1 for Editor mock to work — earlier versions only shipped the WebGL-target dll and would throw NotSupportedException: 不支持的平台 in Editor.

The demo covers every public TT.* API in v1.1.1. Buttons are grouped under collapsible category headers; each row below is one button.

For the exact field shape of each Param type, see the SDK source under Assets/Plugins/com.tiktok.minigame/TTSDK/Modules/Interface/*, or open the com.tiktok.minigame package in your IDE for IntelliSense.

The SDK ships its own build pipeline that produces the WebGL bundle plus the metadata files the Douyin developer tools expect.

1. Open menu: Window → TTSDK → Build Tool.
2. Fill in your AppID, game version, etc.
3. Click Build — the bundle lands in ./tt-minigame/webgl/ along with a game.json that includes the sdkVersion field (auto-injected by SDK 1.1.1).
4. Upload tt-minigame/ to the Douyin developer back-end for preview / review.

Plain Unity File → Build Settings → WebGL also works for a smoke test, but it won't produce the tt-minigame/ layout the container expects.

• TT.InitSDK succeeds in Editor via Mock (with SDK ≥ 1.1.1). Most callbacks return reasonable demo defaults — they are not representative of production behaviour.
• For real device behaviour (haptics, share sheet, payments, ads, real openid), you must build to WebGL and run inside Douyin Developer Tools or production.
• If Init SDK throws NotSupportedException: 不支持的平台, you are most likely using an older SDK that lacks ttsdk-editor.dll. Re-import the package shipped with this repo.

.
├── com.tiktok.minigame@1.1.1-Release.unitypackage   # SDK package, drop into other projects
├── Assets/
│   ├── Demo/
│   │   ├── Editor/
│   │   │   ├── DemoSceneBuilder.cs                  # Code-driven scene rebuild
│   │   │   └── DemoSetup.cs                         # One-click setup pipeline
│   │   ├── Scenes/MainMenu.unity                    # Entry scene (built scene 0)
│   │   └── Scripts/DemoMainMenu.cs                  # Runtime menu + API wiring
│   └── Plugins/com.tiktok.minigame/                 # Imported SDK (do not edit)
├── docs/screenshots/                                # README assets
├── Packages/manifest.json                           # Unity package list
├── ProjectSettings/                                 # Unity project settings
└── README.md / README.zh.md

This demo is provided as a reference for external developers. The TTSDK plugin under Assets/Plugins/com.tiktok.minigame/ is governed by its own license — see the SDK's package.json and the agreement on the Douyin open platform.