抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 概览
  • 下载
  • 设置
  • Lite模式
  • 代码编辑
  • 代码编译
  • 开发辅助
  • 命令行调用
  • 代码片段
  • Unity小游戏预览调试
  • Unity Webgl 模拟器
  • 游戏深度保护
  • 版本管理
  • 小游戏调试
  • 抖音云
  • 火山引擎·AI生态
  • Unity小游戏预览调试
    收藏
    我的收藏

    功能概述

    使用抖音开发者工具扫码调试 Unity 小游戏,相比于使用 SC StarkTool 工具先上传 Unity 项目,再扫描测试版二维码来说更加便捷:
      1.统一鉴权登录:抖音开发者工具使用统一的鉴权登录,无需开发者手动获取uid;同时开发者工具能自动获取开发者名下的应用列表,无需手动填充 appid。
      2.无需重复发布:扫码预览调试无需开发者输入版本号和上传日志,避免了调试次数过多导致的无用版本号较多和版本号较大问题。
      3.速度更快的局域网调试:扫码预览调试提供了本地局域网调试的模式,相对于走线上远程编译,局域网编译有着更快的速度,能够更快地获取预览二维码。
      4.无需连接真机:当选择 Android Native 相关方案时,扫码预览调试无需使用数据线连接安卓真机,通过抖音客户端扫码的方式即可完成调试。
      5.项目协作更友好:同一游戏的多位开发者可以使用不同版本同时进行预览,互不影响。

    支持版本

    抖音开发者工具需要 4.2.7 及以上版本,SC StarkTool 需要 3.30.7 及以上版本,Android & iOS 抖音客户端需要 27.3.0 及以上版本。

    导入Unity项目

    当开发者使用 SC StarkTool 构建Android Native 游戏或者 WebGL 游戏后,构建工具会在项目根目录下生成project.config.json和game.json文件。当生成以上两个文件后,开发者就可以将Unity游戏项目导入到抖音开发者工具,并通过抖音开发者工具进行预览调试和上传。
    构建webgl
    导入开发者工具后的项目目录

    操作引导

      1.打开抖音开发者工具,选择小游戏tab,然后点击导入
      2.选择经过 SC StarkTool 构建后的 Unity 项目目录路径(路径下存在project.config.json和game.json文件),然后点击导入按钮。此时便已完成导入工作。

    扫码调试预览

    操作引导

      1.点击扫码调试按钮。
      2.点击右上方【详情】按钮,可选方案、产物文件位置、屏幕方向和胶囊按钮颜色。
      a.Android Native 方案,需要传入完整 APK 文件,具体构建方法请见下文。
      b.Webgl 方案需要传入 starkSDK Unity 调试工具构建的 zip 产物文件。
      c.Instant Game 需要传入构建的 json 文件。
      3.点击【预览调试】按钮后,会进行构建产物文件的上传和编译,最后获得扫码预览调试二维码。
    ​
    ​
    ​
    ​
      4.当构建新的产物并需要重新生成预览二维码,开发者可点击返回设置按钮,重新选择、填写配置。
    ​
    ​
    ​
    ​

    局域网快速调试

    设备和开发者工具在同一局域网中时,可使用局域网快速调试。开启后可显著提高出码速度。有多个本地网卡时,可手动切换IP,确保局域网设备可访问。
    注:
      •开发者若首次使用扫码预览调试功能时,请先使用广域网调试(即不勾选局域网快速调试)。否则可能出现获取不到二维码的情况。
      •Android Native 方案不支持局域网快速调试。

    Android Native方案

    当开发者在预览时选择了Android Native相关方案时,需要使用SC StarkTool 3.30.7 及以上版本构建一个完整的apk文件,apk产物文件也需要选择对应的完整apk文件,无需上传il2cpp文件。

    添加编译模式

    C# SDK 提供接口获取 Unity 小游戏的启动参数:
    在抖音开发者工具( 4.2.8 及以上版本支持)中,开发者可通过添加编译模式,模拟设置启动参数和启动场景值:
    ​
    ​
    ​
    ​
    设置完毕后,点击预览按钮,填写相关配置并扫码,即可模拟获取启动参数和场景值。

    IDE 命令行工具

    注意事项

      1.当出现以下几种情况时,手机端会提示加载失败。
      a.若勾选局域网快速调试,请确保手机和运行抖音开发者工具的 PC 处于同一局域网下。若两个设备不在同一局域网下,开启局域网快速调试手机端扫描预览调试二维码后,手机端会提示加载失败。请开发者确认手机和运行抖音开发者工具的 PC 是否处于同一局域网下。
      b.当选择仅安卓的发布方案(仅安卓 native,仅安卓 webgl,仅 instant game)时,使用 iOS 设备扫描二维码,手机端会提示加载失败。请开发者选择 iOS 相关的发布方案或者使用安卓设备扫码预览调试。
    iOS
    安卓
    ​
    ​