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文件。
添加编译模式
在抖音开发者工具（ 4.2.8 及以上版本支持）中，开发者可通过添加编译模式，模拟设置启动参数和启动场景值：
设置完毕后，点击预览按钮，填写相关配置并扫码，即可模拟获取启动参数和场景值。
IDE 命令行工具
查看文档
注意事项
- 1.当出现以下几种情况时，手机端会提示加载失败。
- a.若勾选局域网快速调试，请确保手机和运行抖音开发者工具的PC同处于同一局域网下。若两个设备不在同一局域网下，开启局域网快速调试手机端扫描预览调试二维码后，手机端会提示加载失败。请开发者确认手机和运行抖音开发者工具的PC是否同处于同一局域网下。
- b.当选择仅安卓的发布方案（仅安卓native，仅安卓webgl，仅instant game）时，然后使用iOS设备扫描二维码，手机端会提示加载失败。请开发者选择iOS相关的发布方案或者使用安卓设备扫码预览调试。
iOS
安卓
