抖音开放平台Logo
开发者文档
控制台

发布

收藏
我的收藏
文档说明:本文档描述抖音 Unity 小游戏的构建,本地测试及发布各环节。​

使用必读

    为了体验更好,提供的首包(32位+64位)尽量要小于60M(关闭StripEngineCode)​
    安全性考虑,不允许在项目中加入原生java代码库。​
    有限支持部分开源的,著名的第三方库的so库。​
    会做安全性扫描,如对抖音有破坏性行为,会封停账号,保留追究司法责任的权利。

如何发布抖音Unity小游戏

发布需要以下流程,前面已经讲过如何进行构建,本章将重点介绍如何进行送测:
    1.构建:通过 StarkSDKTools 构建(Build)构建与调试。​
    2.送测:通过 【StarkSDKTools】或【抖音开发者工具】 发布latest 版本,到测试环节。​
    3.提审:登录 小程序开发者平台跳转至 【版本管理 】,进行测试,完毕后点击【提交审核】。​
    4.发布:审核通过之后,登录 小程序开发者平台跳转至 【版本管理 】,点击【发布】。​
送测版本统一称为 latest 版本,后续将不再赘述​

使用抖音开发者工具发布​

需要提前下载好抖音开发者工具,版本不低于4.2.2,StarkSDKTool 不低于3.2.0
开发者可使用抖音开放平台账号登录抖音开发者工具,在上传时开发者工具可自动获取对应开发者账号下的 uid,开发者无需手动填入。同时,开发者工具也可自动获取对应开发者账号下的小游戏 AppID 列表,开发者无需手动填入 AppID。​

入口​

在构建工具界面的开发者发布按钮,如图所示:​

跳转至抖音开发者工具​

跳转至抖音开发者工具前,需要配置开发者工具路径,windows下是以exe结尾的,Mac下是以app结尾的路径。如下图所示:​
Windows:​
Mac:​
抖音开发者工具将自动将Unity工程导入。​

登录开发者工具​

开发者可选择使用在抖音开放平台注册的邮箱或者手机账号登录抖音开发者工具。​

进行发布​

    点击左上方的【上传】按钮即可进行发布操作。​
    选择右上方【详情】按钮,可选择发布方案、产物、胶囊按钮颜色和屏幕方向等信息。​
    为满足开发者多项目并行测试的需求,支持最多同时上传 25 个测试版本,上传时分为“默认通道”和“通道1-24”​
    a.未开启“选择测试通道”时,上传成功后,覆盖“默认通道”已有的测试版本​
    b.开发者如需同时保留多个测试版本,可以开启“选择测试通道” ,并根据需求选择 默认通道 或 通道1 - 24 进行上传。上传成功后,将覆盖所选通道的测试版本。 默认通道 和 通道1 - 24 通道的测试版本互不影响。​
    c.除开发者工具外,CLI 也支持指定测试通道进行上传。​
    d.如果当前版本号 + 通道号已经上传过小游戏,则无法被覆盖。例如,1.3.20-通道1 已经上传成功,那么无法再次上传1.3.20-通道1 版本,可上传 1.3.20-通道2/3/...等版本。​
    e.多测试版本能力只支持抖音、抖音极速版、抖音火山版(>=31.6.0)。如想在其他宿主上测试:​
    需要保证默认通道上有上传测试版本。​
    无论扫哪个测试通道的二维码,最终都只会打开默认通道上的测试版本,故请将要扫码体验的测试版本上传到默认通道。​

其他​

    如何修改AppID​
    可在项目文件中的project.config.json以及项目详情中进行修改。​
    也可点击抖音开发者工具右上方的详情按钮,选择当前登录的开发者账号下有权限的AppID​
    获取测试二维码​
    可点击抖音开发者工具工具栏的测试二维码按钮获取最近一次发布的Unity小游戏二维码,开发者可使用抖音客户端扫码查看效果​

使用StarkSDKTool发布

在版本4.0.2之后,StarkSDKTool将不再支持发布能力,开发者请尽早将发布能力迁移至抖音开发者工具​

入口

菜单栏选择 ByteGame => StarkSDKTools => Publishing Tool​

发布界面​

Uid:

请使用抖音开发者工具,打开项目后,在右上角点击详情后获取。​

游戏AppId:

在开发者平台申请的小游戏 AppId(检查:AppId 的数字结尾必须是 07,且长度是 20 位。如果不满足条件,需要重新申请。)​

版本号:

    1.点击『获取可发布版本号』按钮,可以获取 线上测试版 的版本号并+1作为新的版本号进行填充。​
    2.自动版本号:勾选自动版本号后,会隐藏『获取可发布版本号』按钮,版本号填充区域将不可编辑,在打开此发布界面或者后续的提交发布时,会自动的获取当前测试版本号并自动+1为作新的版本号填充。​
第一次选自动版本号会遇到以下问题,不要慌,版本号会自动补充 0.0.1 ​
    1.手动填写:版本号应大于当前测试版本的版本号。​

方案类型:

此选项代表可发布的方案类型,共提供了 6 种发布方案的类型供开发者选择。选择不同的方案类型,下方出现的文件选择框也将不同。​
    Android Native Only(仅Android Native方案)​
    Android Native + iOS WebGL(Android Native + iOS WebGL方案)​
    Android WebGL + iOS WebGL(Android + iOS WebGL方案)​
    Android WebGL Only(仅Android WebGL方案)​
    Unity Instant Game Only(仅Instant Game方案)​
    Unity Instant Game + iOS WebGL(Instant Game + iOS WebGL方案)​
其中文件选择框将会包含以下几种:​
IL2CPP 文件:前面构建章节讲到的【导出小游戏包】生成的il2cppOutput.zip文件​
Apk文件:前面构建章节讲到的【导出小游戏包】生成的illauncher-release.apk文件​
WebGL文件:前面构建章节讲到的【构建WebGL】或【转换WebGL包】生成的WebGL相关的zip文件​
IG文件:只能选择Json。​
注意事项:
Unity发布工具支持仅发布Android端,或支持发布Android+iOS双端。但请注意,如果游戏支持双端,每次发布时,不论iOS或Android游戏包是否有更新,都需要上传游戏包(即,Android与iOS的包都需要包含),否则会导致iOS端游戏被下线。​
举例:如果之前线上支持Android、iOS双端,本次发布仅选择了Android端(比如Native方案的apk),则在审核时就不会有iOS端的游戏版本,审核通过后也就没有了iOS端的入口​
原因:Android和iOS是作为一个“游戏版本”来发布的,线上只能有一个游戏版本,每次发布是一个原子操作。​

屏幕方向:

根据游戏实际情况选择。​

胶囊深浅色:

主要是指游戏运行时,小游戏的框架按钮的颜色​
浅色:​
深色​
游戏开发者可以根据自己的游戏选择胶囊的深浅色来让用户获得沉浸式的体验。​
其配置相当于小游戏配置中的MenuButtonStyle字段​

发布描述:

游戏发布的描述​

进行发布

需要解决红色警告后提交发布按钮才会可用​

提交发布:

信息确认
在弹出信息确认框内需确认以下元素:​
文件名:确认是否正确。​
文件大小:Native方案最大不能超过100M, WebGL方案最大不能超过 100M。​
版本号:如版本号是手动填写,建议检查版本号是否在上次基础上+1。
确认无误后点击 “发布” 按钮,否则取消返回修改。​
发布成功后将进入测试环节。​
发布方案中包含Android Native方案时将会比较慢,会逐步显示发布状态。最终发布成功将出现以下信息展示​

生成二维码:

发布成功后,可以生成二维码,然后使用抖音等App扫码测试​
刚发布的Apk生成的二维码建议等待2-5分钟后再扫码

查询状态:​

查询发布状态。点击该按钮会向服务器端请求当前发布状态,并将结果显示到界面上。​

测试环节

发布成功之后,被发布的游戏版本会自动进入测试环节。​
图9:测试版本
    测试完毕后,点击【提交审核】来进入审核环节。具体请参考:审核指引

审核环节

提交审核后,进入审核环节。​
图10:审核中
    审核通过后可进入发布环节。​

发布环节

版本审核通过后,开发者点击“发布”,小游戏即可发布上线。​
图11:发布
    登录 小程序开发者平台跳转至 【版本管理 】,找到审核通过的游戏,点击【发布】​
请参考 发布指南

FAQ

    Q:首次接入的游戏,本地调试的时候出现扫码白屏『游戏加载失败』现象​
    A:先发布到测试环境,然后扫码调试​
    Q:是否支持CI构建?​
    A:Native方案可以调用 StarkSDKTool.API.BuildMananger.Build,WebGL方案可以调用StarkSDKTool.Builder.BuildWebGL,详情更多可查看CI自动化
    Q: 只是做一个简单的方案验证,还没有创建应用,AppId怎么填?​
    A: Native方案可以暂用tt9a4aecf7057074ae,Webgl方案可以暂用tt41883735deb36a55仅用于本地调试!