tiktok小游戏接入流程

tiktok小游戏接入流程

背景

最近一段时间，由于tiktok开始在海外上线了一些国家/地区的小游戏功能（截止2026年3月，已经上线了美国、印尼以及小鬼子三个国家），公司也开始对tiktok小游戏接入流程进行研究，主要是想要跑通整个流程，而我就负责了SDK的接入工作，这里记录下接入流程。
另外由于公司只是想试水一下流程，并没有真的开发一款游戏，我找了一个自己几年前用cocos写的小游戏，直接接入tiktok的SDK来提审上线的。

需求

一个小游戏，能多简单就多简单。
能使用tiktok登录，能拉起广告，接入tiktok小游戏上线的必接功能（登录以及留存能力 – 桌面快捷方式、复访）。

准备工作

下面这个应该是字节官方提供的一份接入流程文档，权威以及完善，非常详细，优先参考。
TikTok小游戏一站式接入指南2.0

关于创建项目，获取参数，这里不介绍了，接入指南中有很详细的介绍，而且我作为技术，也是直接拿到参数而已，项目的创建这些前置流程，也是商务全权搞定的。
你需要拿到Client key、Client secret、APP ID三个参数，用来登录以及其他服务端接口使用。

你需要一个tiktok开发者账号，最好是日本或者美国的账号；并且要在后台添加测试用户。

你要下载tiktok应用，并且使用测试用户账号成功登录它。
拔掉手机卡！拔掉手机卡！拔掉手机卡！
系统语言设置为英语（美国）！系统语言设置为英语（美国）！系统语言设置为英语（美国）！
VPN选择固定节点，日本或者美国。

前置流程说明

tiktok的文档上说，他们是支持微信小游戏工程和抖音小游戏工程的。也就是说，你可以使用cocos或者unity直接导出微信/抖音小游戏工程，然后在其中接入tiktok的SDK（实际上如果是cocos，你可以直接在cocos层面接入）。

tiktok要求必接的功能：
登录 – TikTok 小游戏静默登录（login）接入指南
留存能力 – 桌面快捷方式、复访（侧边栏）

一些文档记录

TikTok Mini Games JS API Reference
TikTok 小游戏静默登录（login）接入指南
TikTok 小游戏广告（IAA）接入指南

出工程，开始接入SDK

tiktok的客户端实例TTMinis是挂载在了全局变量window上的，所以在接入接口时非常方便，直接在cocos中就如下调用：

1
2
3
4
5
6
7
8
9
10
11
window.TTMinis.game.addShortcut({
  success: () => {
    console.log("success");
  },
  fail: () => {
    console.log("fail");
  },
  complete: () => {
    console.log("complete");
  },
});

你按照文档接入login接口，将拿到的code传给服务端，由服务端去换取openid，这和微信小游戏的流程如出一辙。我这里因为就是个纯单机游戏，甚至直接将这个换取openid的接口放到了cloudflare的workers上去，也没有做账号系统进行存储。其实我也不确定是否一定要去”换“一下openid，我甚至怀疑不去换，也不影响后续的功能，毕竟我并不需要下单支付，只需要拉起广告。如果不是tiktok要求强制接入留存能力，什么桌面快捷方式、复访都是不接的。

在我接入好了登录之后，官方推荐的是使用命令行工具进行调试，我也推荐你这样子调试，因为这肯定更方便。但当我开始尝试使用ttmg命令行工具进行调试（这个安装过程文档写的很详细，需要注意的是nodejs版本，我前后尝试过三个版本，一个太旧，一个太新。。最后使用v22.12.0版本，不报错），就遇到各种网络问题。
参照文档进行处理吧，TikTok 小游戏开发者调试指南

我要提的是，我按照文档的方式处理过后，工具能ttmg login和ttmg dev调试启动都能运行，也能弹出二维码进行扫码真机调试，但是！却一直连不上调试。我一直未能解决这个问题，所以相当于命令行工具白安装了。我也不确定是不是因为公司网络层级的问题，也没有在家里的简单点的网络环境试过。我最终选择了另外一种麻烦一点的方式。直接把包体上传到开发者后台，使用测试版本扫码进行测试。

虽然这个方法比较繁琐，但是也确实是一条路子，前提条件是我仅仅是一个测试游戏，它很小，也不存在分包什么的。

1
2
3
4
5
6
7
window.TTMinis.game.login(); // 登录
window.TTMinis.game.canIUse("addShortcut"); // 判断是否支持桌面快捷方式
window.TTMinis.game.getShortcutMissionReward(); // 获取桌面快捷方式奖励
window.TTMinis.game.addShortcut(); // 添加桌面快捷方式
window.TTMinis.game.canIUse("getEntranceMissionReward"); // 判断是否支持侧边栏(复访)查询奖励方法
window.TTMinis.game.getEntranceMissionReward(); // 获取侧边栏奖励
window.TTMinis.game.startEntranceMission(); // 添加侧边栏（复访）  --- 它会直接退出游戏，并拉出侧边栏，游戏上线后，能够在最近玩的游戏列表中，看到你的游戏

上面是一些接口的例子，登录没什么好说的，广告也很常规，不多说。

只有桌面快捷方式和复访需要说两句，整个的流程就是：
能否使用（有没有）这个方法？->调用这个方法->这个奖励能不能发了？->发奖励。
canIUse(“addShortcut”) -> addShortcut() -> canIUse(“getShortcutMissionReward”) -> getShortcutMissionReward()

总结

其实tiktok小游戏和国内微信、抖音这些小游戏平台并没有什么很大的区别，在我看来，关键的难点就是网络问题！！！还有tiktok对于国内的封禁，让人调试起来非常麻烦，到了蛋疼的地步，我每次调试的时候，都要给家里人说：现在手机打不通了。如果你有专门一台测试机的话，那还好，但是我这样子，真是。。一言难尽。