Day 3 ⏱ 预计阅读 6~8 小时
本模块基于 2025~2026 年的抖音小游戏平台和 TTSDK (原 StarkSDK) 编写。抖音平台更新频繁，发布前请务必对照官方最新文档确认细节。
| 工具 | 版本要求 | 说明 |
|---|---|---|
| Unity Editor | Unity 6 LTS（推荐 6000.0.40f1+） | 国际版，非团结引擎 |
| WebGL Build Support | 与 Unity 同版本 | Unity Hub → Installs → Add Module |
| Android Build Support | 与 Unity 同版本 | 真机调试需要（IL2CPP） |
| Node.js | 16+ | 抖音开发者工具依赖 |
| 抖音开发者工具 | 最新版 | 从抖音开放平台下载 |
| TTSDK (原 StarkSDK) Unity Plugin | 最新版 | 从抖音开发者控制台下载（搜索 BGDT 或 TTSDK） |
| 能力 | C# API |
|---|---|
| 登录 | TTSDK (原 StarkSDK).Login() |
| 分享 | StarkShare.ShareAppMessage() |
| 支付 | StarkPay.RequestPayment() |
| 广告（激励视频） | StarkAd.ShowRewardedVideoAd() |
| 录屏 | StarkRecorder.Start/Stop() |
| 存储 | StarkStorage.SetStorageSync() |
| 关注 | StarkFollow.FollowOfficialAccount() |
| 客服 | StarkService.OpenCustomerService() |
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| Color Space | Linear | URP 用 Linear；Built-in 可用 Gamma |
| Auto Graphics API | WebGL 2.0 | 取消勾选 Auto，手动只保留 WebGL 2.0 |
| Compression Format | Brotli | 压缩率最高，抖音运行时支持 |
| Code Optimization | Disk Size | 减小产物体积 |
| IL2CPP Code Generation | Size (LTO) | 优化产物大小 |
| Strip Engine Code | ✅ 勾选 | 裁剪未使用的引擎代码 |
| Strip Managed Assemblies | Strip Assemblies | 裁剪未使用的 .NET 程序集 |
Builds/DouyinMiniGame）Builds/DouyinMiniGame/
├── game.js # 入口 JS 文件
├── game.json # 小游戏配置文件
├── project.config.json # 项目配置
├── index.html # WebGL 入口页（调试用）
├── Build/
│ ├── *.wasm.code.unityweb # WASM 代码（Brotli 压缩）
│ ├── *.wasm.framework.unityweb # 框架代码
│ └── *.data.unityweb # 资源数据包
├── TemplateData/ # 启动封面等资源
└── StreamingAssets/ # Addressables/AB 包Builds/DouyinMiniGame）预览需要你的抖音账号已添加为该小游戏的开发者/体验成员。在抖音开放平台控制台 → 成员管理 中添加。
| 类型 | 限制 | 说明 |
|---|---|---|
| 首包体积 | < 100 MB | 超过无法上传；推荐 WebGL 方案控制在 10~20 MB 以内 |
| 推荐目标 | < 60 MB | Native 32+64 位合计；WebGL 实际体验标杆约 10 MB |
| 总包体积 | 分包后无硬性上限 | 但单次下载建议 < 50 MB，超出部分走 CDN 按需加载 |
| 引擎版本 | TTSDK ≥ 6.2.0 | 开发者工具 ≥ 4.2.2 |
虽然首包上限已放宽到 100 MB，但用户首次加载时间才是真正的瓶颈。WebGL 方案构建产物（WASM + 框架 + 数据）通常 10~30 MB，Brotli 压缩后仍有数 MB。建议通过 Wasm 分包 + 资源按需加载将首包控制在 10~20 MB 以内，确保弱网环境下 5 秒内可交互。
TTSDK (原 StarkSDK) 提供了 Wasm 分包工具，将大的 .wasm 文件拆分为多个小文件：
游戏资源（模型、贴图、音频）不应该打进首包，而是通过 Addressables 部署到 CDN：
// 配置 Addressables 远程加载路径
// Window → Asset Management → Addressables → Profiles
// RemoteLoadPath 设置为你的 CDN 地址
// 例如: https://cdn.yourgame.com/assets/StandaloneWindows64/
// 在游戏中按需加载远程资源
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;
public class ResourceLoader : MonoBehaviour
{
// 加载远程 Prefab
public void LoadCropModel(string cropKey)
{
Addressables.LoadAssetAsync<GameObject>(cropKey).Completed += handle =>
{
if (handle.Status == AsyncOperationStatus.Succeeded)
{
Instantiate(handle.Result, transform.position, Quaternion.identity);
}
else
{
Debug.LogError($"加载失败: {cropKey}");
}
};
}
// 带进度的加载
public void LoadWithProgress(string key)
{
var handle = Addressables.DownloadDependenciesAsync(key);
StartCoroutine(MonitorProgress(handle));
}
private System.Collections.IEnumerator MonitorProgress(
AsyncOperationHandle handle)
{
while (!handle.IsDone)
{
Debug.Log($"下载进度: {handle.PercentComplete:P0}");
yield return null;
}
Debug.Log("下载完成");
}
}如果不使用 Addressables，也可以直接用 AssetBundle：
// AssetBundle 加载（更底层，需要手动管理）
public class ABLoader : MonoBehaviour
{
private AssetBundle _bundle;
public IEnumerator LoadBundle(string url)
{
using UnityWebRequest request = UnityWebRequestAssetBundle.GetAssetBundle(url);
yield return request.SendWebRequest();
if (request.result == UnityWebRequest.Result.Success)
{
_bundle = DownloadHandlerAssetBundle.GetContent(request);
GameObject prefab = _bundle.LoadAsset<GameObject>("CropWheat");
Instantiate(prefab);
}
}
void OnDestroy()
{
_bundle?.Unload(false);
}
}抖音小游戏的内存建议上限：iOS 约 1GB，Android 约 1~2GB（因设备而异）。Unity WebGL 默认会占用较多内存，必须优化。
| 策略 | 操作 | 节省 |
|---|---|---|
| 纹理压缩 | 使用 ASTC 4x4（移动端推荐格式） | 4~8x |
| 减小 Max Size | UI 贴图用 512，场景贴图用 1024 | 2~4x |
| Mipmap | 3D 物体开启，UI 贴图关闭 | 33% 内存 |
| Read/Write | 取消勾选 Read/Write Enabled | 2x 内存 |
| 图集 | 小图合并为 Sprite Atlas | 减少 Draw Call |
// 1. 避免 Update 中每帧分配（GC 压力）
// ❌ 错误
void Update() {
var list = new List<CropData>(allCrops.Where(c => c.IsReady)); // 每帧 new List！
}
// ✅ 正确：缓存引用
private List<CropData> _readyCrops = new List<CropData>();
void Update() {
_readyCrops.Clear();
foreach (var c in allCrops)
if (c.IsReady) _readyCrops.Add(c);
}
// 2. 避免字符串拼接（使用 StringBuilder 或缓存）
// ❌ 每帧 GC
Debug.Log("Gold: " + gold + " Day: " + day);
// ✅ 使用插值（编译器优化）或关闭日志
Debug.Log($"Gold: {gold} Day: {day}");
// 3. 对象池替代 Instantiate/Destroy
// 见模块 3 的 SimplePool 实现
// 4. 裁剪未使用的代码
// Project Settings → Player → Strip Engine Code ✅
// 添加 link.xml 防止反射代码被裁剪<!-- 文件: Assets/link.xml -->
<!-- 防止 IL2CPP 裁剪掉反射或序列化使用的类型 -->
<linker>
<assembly fullname="UnityEngine" preserve="all"/>
<assembly fullname="TTSDK (原 StarkSDK)" preserve="all"/>
<assembly fullname="Assembly-CSharp">
<type fullname="YourNamespace.SaveData" preserve="all"/>
</assembly>
</linker>| 功能 | 状态 | 替代方案 |
|---|---|---|
| System.Threading | ❌ 完全不支持 | 用 Coroutine 或 async/await |
| 多线程 | ❌ 不支持 | 所有逻辑在主线程 |
| System.IO.File | ❌ 不支持 | 用 PlayerPrefs 或 JS 存储 API |
| Socket（原生） | ❌ 不支持 | 用 WebSocket |
| Sqlite | ❌ 不支持 | JSON 文件 + PlayerPrefs |
| VideoPlayer | ⚠️ 受限 | 用平台原生视频 API |
| WebCamTexture | ❌ 不支持 | — |
| MovieTexture | ❌ 不支持 | — |
| 动态加载 DLL | ❌ 不支持 | 所有代码编译时确定 |
| 反射（部分） | ⚠️ 受限 | link.xml 保留必要类型 |
| MonoBehaviour.OnGUI | ⚠️ 低效 | 用 UGUI 或新 UI Toolkit |
| MeshCollider（动态） | ⚠️ 性能差 | 用基本 Collider 组合 |
| HDRP 渲染管线 | ❌ 不支持 | 用 URP 或 Built-in |
| 实时阴影（多灯） | ⚠️ 性能差 | 只用 1 个主光阴影 |
| 后处理特效 | ⚠️ 受限 | 最少化使用，Bloom 可用 |
Unity WebGL 不支持任何多线程。如果你的农场工程中使用了 Task.Run、Thread、ConcurrentQueue 等，必须改为单线程方案（协程/异步）。第三方库如果内部用了线程也会报错。
using StarkSDKSpace; // TTSDK 保持向后兼容命名空间
public class DouyinLogin : MonoBehaviour
{
public void Login()
{
// 调用抖音登录
StarkSDK.API.GetAccountManager().Login(
success: (string code, string anonymousCode, string encryptedData) =>
{
Debug.Log($"登录成功! code={code}");
// 把 code 发送到你的后端服务器换取用户信息
StartCoroutine(SendCodeToServer(code));
},
fail: (string errMsg) =>
{
Debug.LogError($"登录失败: {errMsg}");
}
);
}
private System.Collections.IEnumerator SendCodeToServer(string code)
{
string url = "https://your-api.com/auth/douyin";
string json = JsonUtility.ToJson(new LoginRequest { code = code });
using UnityWebRequest req = new UnityWebRequest(url, "POST");
req.uploadHandler = new UploadHandlerRaw(System.Text.Encoding.UTF8.GetBytes(json));
req.downloadHandler = new DownloadHandlerBuffer();
req.SetRequestHeader("Content-Type", "application/json");
yield return req.SendWebRequest();
Debug.Log(req.downloadHandler.text);
}
}
[System.Serializable]
class LoginRequest { public string code; }public class DouyinShare : MonoBehaviour
{
public void ShareToFriend()
{
StarkSDK.API.GetShareManager().ShareAppMessage(
title: "来我的农场看看！",
imageUrl: "https://cdn.yourgame.com/share.jpg",
query: "from=share&farmId=123", // 自定义参数
success: () => Debug.Log("分享成功"),
fail: (string err) => Debug.Log($"分享失败: {err}")
);
}
}public class DouyinAd : MonoBehaviour
{
private string _adUnitId = "your_ad_unit_id";
public void ShowRewardedAd()
{
var ad = StarkSDK.API.GetAdManager().CreateRewardedVideoAd(_adUnitId);
ad.OnClose += (bool isReward) =>
{
if (isReward)
{
Debug.Log("用户看完广告，发放奖励！");
GameManager.Instance.AddGold(50);
}
else
{
Debug.Log("用户中途关闭");
}
};
ad.OnError += (int code, string msg) =>
{
Debug.LogError($"广告错误: {code} - {msg}");
};
ad.Show();
}
}public class DouyinRecorder : MonoBehaviour
{
private bool _isRecording = false;
public void ToggleRecording()
{
if (!_isRecording)
{
StarkSDK.API.GetGameRecorder().Start();
_isRecording = true;
}
else
{
StarkSDK.API.GetGameRecorder().Stop();
_isRecording = false;
}
}
public void ShareRecording()
{
// 录屏结束后分享
StarkSDK.API.GetGameRecorder().Share((success) =>
{
if (success) Debug.Log("录屏分享成功");
});
}
}// 替代 PlayerPrefs 的跨平台存储
public class StorageHelper
{
public static void SetString(string key, string value)
{
#if UNITY_WEBGL && !UNITY_EDITOR
StarkSDK.API.GetStorageManager().SetStorageSync(key, value);
#else
PlayerPrefs.SetString(key, value);
#endif
}
public static string GetString(string key, string defaultValue = "")
{
#if UNITY_WEBGL && !UNITY_EDITOR
return StarkSDK.API.GetStorageManager().GetStorageSync(key) ?? defaultValue;
#else
return PlayerPrefs.GetString(key, defaultValue);
#endif
}
public static void SetInt(string key, int value)
{
SetString(key, value.ToString());
}
public static int GetInt(string key, int defaultValue = 0)
{
string val = GetString(key);
return string.IsNullOrEmpty(val) ? defaultValue : int.Parse(val);
}
}症状：构建产物 > 4MB，上传时报错。
解决：
症状：PlatformNotSupportedException: Operation is not supported on this platform.
解决：
new Thread、Task.Run、ThreadPool，改为 Coroutine#if !UNITY_WEBGL || UNITY_EDITOR 包裹线程代码症状：真机运行一段时间后闪退。
解决：
症状：导入抖音开发者工具后显示黑屏。
解决：
症状：构建或加载资源时莫名其妙报错。
解决：所有文件路径、资源名、场景名只用英文和数字和下划线。
症状：Editor 中正常，小游戏里加载资源失败。
解决：
症状：物体显示为粉红色/紫色。
解决：
#pragma target 4.0 或更高，改为 #pragma target 3.0症状：小游戏启动要等 10 秒以上。
解决：
症状：新 Input System 包在 WebGL 中触屏不工作。
解决：
Input.GetMouseButton、Input.GetKey）症状：构建时或运行时报各种奇怪错误。
解决：
#if UNITY_WEBGL && !UNITY_EDITOR 条件编译隔离不兼容代码按以下清单逐项打勾，确保当天真机可跑：
| # | 步骤 | 验证标准 | ✅ |
|---|---|---|---|
| 1 | 安装 Unity 6 + WebGL 模块 | Unity Hub 显示 WebGL Build Support 已安装 | ☐ |
| 2 | 注册抖音开放平台，创建小游戏应用 | 获得 AppID | ☐ |
| 3 | 下载并导入 TTSDK (原 StarkSDK) | Unity 菜单栏出现 TTSDK (原 StarkSDK) | ☐ |
| 4 | 配置 TTSDK (原 StarkSDK)（填 AppID） | Settings 面板无报错 | ☐ |
| 5 | 创建最小测试场景（一个 Cube + 旋转脚本） | Unity Editor 中 Play 正常 | ☐ |
| 6 | TTSDK (原 StarkSDK) → Build | 产物目录生成，无报错 | ☐ |
| 7 | 安装并打开抖音开发者工具 | 工具启动正常 | ☐ |
| 8 | 导入构建产物到开发者工具 | 模拟器中看到旋转的 Cube | ☐ |
| 9 | 真机预览（扫码） | 手机上看到旋转的 Cube | ☐ |
| 10 | 检查产物体积 | 首包体积达标（推荐 ≤ 20MB）（或已配置分包） | ☐ |
| 11 | 导入实际农场工程，重复 6~9 | 真机上能看到游戏画面 | ☐ |
| 12 | 如有功能异常，查 Console 报错逐一修复 | 核心玩法可运行 | ☐ |
第 1 天的目标不是把所有功能都跑通，而是把最小可运行的构建传到真机上。先确认工具链跑通，再逐步处理兼容性问题。具体优先级：
你已经掌握了从 Cocos → Unity 迁移、Unity 编辑器和 C# 编程、3D 游戏开发基础、工程二开方法、以及完整的抖音小游戏发布管线。
接下来就是动手实践了。按照 Day 3 Checklist 一步步操作，遇到问题回到对应章节查找解决方案。
祝你发布顺利！🚀