Observed Signal · May 28, 2026 · Technical Release · Source: https://developers.tiktok.com/doc/changelog · Impact: 4/5 · Sentiment: Neutral
TikTok Mini Games: Developer Troubleshooting Guide
This is TikTok's developer troubleshooting guide for Mini Games, detailing debugging workflows, required account and platform configurations, capability integrations, payment/IAP handling, and platform preview diagnostics. It explains CLI commands (ttmg login, ttmg dev), test user and Client Key setup, domain whitelists, package/subpackage rules, Unity-specific requirements, OAuth/token exchange flows (frontend gets code, backend exchanges via Open API), IAP sandboxing and Webhook handling, and API/version compatibility checks using TTMinis.game.canIUse. The document provides ordered troubleshooting steps, escalation triggers, required diagnostic data to collect, and recommendations for remote debugging, real device preview, and platform preview scenarios.
Technical documentation from a major platform (TikTok) affects developer workflows, monetization (IAP), SDK integration, and ad/capability usage for Mini Games—impacting publishers and ad monetization on the platform.
Track Unity Signals & Market Shifts in Real-Time
Polaris7 autonomous intelligence agents track regulatory filings, primary sources, executive changes, and deal flow 24/7. Create your free Explorer workspace to monitor these entities.
Key Takeaways & Evidence Grounding
- TikTok Mini Games debugging uses the ttmg CLI with primary commands `ttmg login` and `ttmg dev`.
- Unity mini games require TikTok client version ≥ 43.1.0, Unity 2021–2022, Unity build output directory `tt-minigame`, and total package size ≤ 60 MB.
- OAuth login flow: frontend calls `TTMinis.game.login` to get a code; backend must exchange the code (grant_type=authorization_code) via TikTok Open API to obtain access_token and open_id.
- IAP supports a Sandbox/Mock mode; when Mock is enabled the backend receives Webhook callbacks with `is_sandbox: true` and backends must verify the flag.
- DevTool expects `subpackages` (all lowercase) in game.json; using `subPackages` may cause files to be counted in the main package and break size checks.
Connected Companies & Entities
1 Entity mappedOntology Mapping & Concepts
Related Market Signals & Shifts
Recent verified developments and strategic activity across this market segment.
TikTok Mini Games Technical Overview
TikTok's developer documentation describes the technical architecture, integration paths, build outputs, and debugging/upload flow for TikTok Mini Games — lightweight games that run inside the TikTok client rather than as standalone apps. Supported engines include Cocos, Unity and Laya; Unity projects compile C# via IL2CPP to WebAssembly. The guide details required package directory structures, strict package-size limits (different for Unity vs non‑Unity), runtime layers (game, platform capability, native runtime, client host), platform capability integration via built-in runtime APIs or the TikTok Unity SDK, and developer tooling (DevTool and @ttmg/cli) with remote, real-device and platform preview modes. It also notes Unity-specific constraints (client version >= 43.1.0, bulk memory and Wasm split guidance) and recommends following provided templates and DevTool pre-checks before submission.
TikTok Mini Game Debugging Guide Released
TikTok for Developers publishes a detailed guide for debugging Mini Games using DevTool (ttmg CLI). The documentation explains prerequisites (Node.js >= v20, Google Chrome, TikTok app, test users, single Wi‑Fi network), how to install and log in to the DevTool (npm install @ttmg/cli -g; ttmg login), and how to start a local debug session (ttmg dev). It describes pre-compilation checks, package size limits (total ≤30 MB; main package ≤4 MB; independent subpackage ≤4 MB), two debug modes (mobile device with in‑app vConsole and remote browser using Chrome DevTools), QR-code scanning flow, domain allowlisting, ad and payment mock debugging modes, custom startup packages and launch parameter handling (TTMinis.game.getLaunchOptionsSync), and how to upload debugged code packages to the Developer Portal for preview and release.
TikTok Developer Guide: Mini Games Preparation
TikTok’s developer documentation explains how to prepare a TikTok for Developers account for Mini Game integration. Developers must create an organization representing their business (organization name is immutable), invite members with Admin or Member roles, and complete business verification (admin-only and required for monetization). They must also register an app of type “Mini game” in the Developer Portal to represent the mini game, which is used to configure settings, upload code packages and manage operations. As described in related TikTok Minis guidance, developers may need to provide App ID, Client Key and Client Secret to a TikTok contact, access is limited to approved partners, and preparation steps support later development, testing (sandbox) and publication workflows.
Track Real-Time Market Signals & Shifts
Set up custom watchlists to receive automated, evidence-grounded executive digests whenever material signals or shifts occur across your tracked landscape.