模块 4：Unity → 抖音小游戏
完整发布管线

4.3 WebGL 构建设置详解

Player Settings 配置

1. Edit → Project Settings → Player
2. 选择 WebGL 标签页
3. 按以下配置：

使用 TTSDK (原 StarkSDK) 构建

1. TTSDK (原 StarkSDK) → Build（或 Window → TTSDK (原 StarkSDK) → Build）
2. 选择输出目录（建议 Builds/DouyinMiniGame）
3. 点击 Build，TTSDK (原 StarkSDK) Unity Tools 会自动：
   • 执行 WebGL 构建
   • 生成 WASM 代码和 Brotli 压缩包
   • 注入 JS 胶水层代码
   • 打包资源
   • 生成符合抖音小游戏格式的产物目录

产物目录结构

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 包

4.4 抖音开发者工具使用

导入项目

1. 打开抖音开发者工具
2. 点击「导入项目」或「+」按钮
3. 选择构建产物目录（Builds/DouyinMiniGame）
4. 填写 AppID（与 TTSDK (原 StarkSDK) 配置的一致）
5. 点击「导入」

模拟器预览

1. 导入后自动在模拟器中运行
2. 左侧面板选择设备型号（iPhone / Android）
3. 模拟器支持触摸、摇一摇、横竖屏切换
4. 底部 Console 查看 JS 日志和错误

真机预览

1. 点击工具栏「预览」按钮
2. 生成二维码
3. 用抖音 App 扫描二维码
4. 在真机上运行小游戏

上传与审核

1. 点击工具栏「上传」按钮
2. 填写版本号（如 1.0.0）
3. 上传完成后，在抖音开放平台控制台 → 版本管理 中提交审核
4. 审核通过后即可发布上线

4.5 分包方案完整做法

抖音小游戏体积限制

分包策略

Wasm 分包工具

TTSDK (原 StarkSDK) 提供了 Wasm 分包工具，将大的 .wasm 文件拆分为多个小文件：

1. TTSDK (原 StarkSDK) → Build 面板中找到 Wasm 分包选项
2. 设置每个分包的最大大小（建议 3~4 MB）
3. 构建后产物中 WASM 文件被拆分为多个子包
4. 首个子包随首包下载，其余在需要时加载

资源按需加载（Addressables）

游戏资源（模型、贴图、音频）不应该打进首包，而是通过 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("下载完成");
    }
}

AssetBundle 方案（替代 Addressables）

如果不使用 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);
    }
}

4.6 内存优化手段

纹理优化

Mesh 优化

• LOD（Level of Detail）：远处物体用低面数模型
• Mesh 压缩：Import Settings → 勾选 Mesh Compression
• 减少顶点数：农场场景中复杂建筑考虑烘焙为低模
• Instancing：相同材质的重复物体用 GPU Instancing

代码优化

// 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 防止反射代码被裁剪

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>

4.7 不支持/受限功能清单

4.8 平台 API 桥接（登录/支付/分享/录屏）

登录

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);
    }
}

4.9 避坑大全

4.10 上手当天必须真机跑通的最小流程