抖音开放平台Logo
控制台

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.jsongame.json文件。当生成以上两个文件后,开发者就可以将Unity游戏项目导入到抖音开发者工具,并通过抖音开发者工具进行预览调试和上传。​
构建webgl​
导入开发者工具后的项目目录​

操作引导​

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

扫码调试预览​

操作引导​

    1.点击扫码调试按钮。​
    2.选择调试方案,并选择相应的构建产物以及屏幕方向和胶囊按钮深浅色。​
    3.点击确定按钮后,会进行构建产物文件的上传和编译,最后获得扫码预览调试二维码。​
    4.当构建新的产物并需要重新生成预览二维码,开发者可点击返回设置按钮,重新选择选择、填写配置。​

局域网快速调试​

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

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
安卓