接入指南

更新时间 2023-12-22 16:27:35

收藏

我的收藏

​

💡

文档说明：本文档对游戏接入抖音 Unity 小游戏进行整体描述。 ​

​

背景说明 ​

抖音 Unity 小游戏是一种即玩游戏解决方案。该方案的特点是可以在抖音/头条等字节系 App 中无需安装，即可运行商业游戏引擎（Unity/UE）开发的游戏。该方案包含两种核心能力，一个是 免安装沙盒运行 技术，一个是 小包化技术 。目前接入游戏超过 5000+，有多款 DAU 破百万。 ​

效果参考： 演示视频 ​

​

​

​

​ ​ ​

​

​

图1：字节流量矩阵 ​

抖音Unity小游戏为您提供以下解决方案： ​

• 在字节系App中，运行基于商业引擎（U nity/UE 引擎 ）的 原生 游戏（ 仅Android，apk格式 ）方案。 ​

• 在字节系App中，运行Unity WebGL 及其他引擎导出的 wasm （ android/ios ）能力。 抖音Unity小游戏WebGL方案说明 ​

• 调用字节系App中的商业化能力，如 广告、录屏、分享等。 ​

• 调用字节系App中的分发能力，基于视频、feed流、直播、微端等。 ​

• 额外提供unity 游戏的 微端化 改造方案 StarkMini 小包化文档索引 。 ​

​

项目接入实施步骤 ​

​

​

​ ​ ​

​

【阶段一】可行性及方案评估： ​

相关手册 ​

抖音Unity小游戏使用方案及引擎选择建议 ​

抖音Unity小游戏转换案例 ​

初步确认游戏项目是否可改造，适合用哪种方案； native方案 是字节独有的能力，其他平台不曾提供。通过搜索引擎搜索问题有可能结果不准确，应以本文档为主。遇到问题在 反馈群 中搜索有更多有效信息 ​

​ ​

【阶段二】简单验证：先运行起来 ​

相关手册 ​

抖音Unity小游戏WebGL方案说明 ​

抖音Unity小游戏发布 ​

对于没有接触过抖音Unity小游戏的开发者来说，在动手改造之前，可以通过此步骤，先确定一下当前项目是否能在抖音下正常运行，提前暴露问题。 ​

抖音小游戏平台提供了商业化及数据分析能力，能满足大部分项目的运营需求。并且 不支持 接入其他平台的商业化sdk。 ​

验证步骤很简单： ​

1.
删除其他平台的sdk，如广告sdk，登录sdk，支付sdk等。也降低了包体的大小。 ​

2.
如果使用 Native方案 ：安全考虑，C++代码的插件需要以源码形式放在工程内，会对插件中的so会做安全扫描；不支持任何Java代码的执行或者对jni的调用， 需删除项目中的Assets/Plugins/Android下的java代码及jar包或aar包。如对抖音有破坏性行为，会封停账号，保留追究司法责任的权利。 ​

3.
连上手机，使用本地调试功能即可运行在抖音中进行效果验证 抖音Unity小游戏发布 ​

​ ​

【阶段三】抖音平台能力接入：接入更多平台能力 ​

相关手册 ​

抖音Unity C# SDK接入文档 ​

抖音Unity小游戏发布 ​

抖音Unity C# SDK发版记录 ​

Step1 - 账号准备 ​

• 申请开发者账号并注册游戏 ​

首先您得有一个 抖音 小 游戏 开发者平台 的开发者账号，需进行注册。 ​

接下来您得创建一个自己的游戏 -- 看到如下选项， 请选择即玩Unity&UE小游戏 。注意：这里创建的游戏方案一旦选择，后续无法在普通小游戏和Unity即玩小游戏的方案之间进行转换。 ​

​

​ ​

​

​

​

​

图2：游戏类型选择 ​

Step2 - 了解SDK能力，接入SDK ​

• 下载 接入Demo ，了解相关能力及接入代码 ​

• 安装 抖音Unity C# SDK ( 视频讲解 ） ​

• 接入所需能力，完成所有接口的回调处理 并在Editor下测试完成 ​

​

​ ​

​

【阶段四】体验调优：达到可上线标准的小游戏体验 ​

相关手册 StarkMini 小包化文档索引 StarkAssetAnalyser工具指南 Wasm分包工具说明 ​

• 首场景启动优化；用户启动游戏的时间，一般来说，启动越快，取消率越低，转化率越高。为保证用户体验，在小游戏平台上线，我们对首包大小有如下约束: ​

• 使用 原生 方案，首包包体需 小于100M ​

• 使用 WebGL 方案，首包包体需 小于100M ​

这是一个较为宽松的标准，目的在于让接入方能早点拿到线上数据，再考虑优化。但显然，包体越小，下载，加载的速度会越快，取消率会越低。 ​

优秀数据参考：Native方案，包体20M，WebGL方案，包体10M ​

如果您的游戏首包 不满足要求 ，可以选择(option)我们提供的框架及工具： 对资源进行小包化工具文档：↗ StarkMini 小包化文档索引 ​

​

对于WebGL方案 ​

• 优化可以参考相关优化文档 抖音小游戏 Unity WebGL 适配方案 ​

• 提供了分包工具，可优化首包代码大小 Wasm分包工具说明 ​

• 从Unity2021版本开始，可以使用ASTC纹理压缩，能够使得运行内存减少，提升一定的运行时性能。 ​

• 对于ab加载，尽可能早使用Unload，避免内存过大导致反复崩溃。 ​

其他加快启动速度的可选优化 ​

• 减少MonoBehaviour脚本中Start/Awake的逻辑 ​

• 减少初始场景的内容 ​

• 采取分帧策略，延迟加载等 ​

​

​ ​

​

【阶段五】发布上线与运营 ​

发布 -> 送审 -> 上线 -> 运营 ​

构建及发布 ​

请参考文档： 抖音Unity小游戏发布 ​

需要使用CI来构建发布请参文档中的 FAQ 部分 ​

运营 ​

在抖音运营小游戏和在微信/其他平台有 很大不同 ​

• 视频是分发载体，游戏入口挂载在视频的锚点上，没有视频，就没有用户。 ​

• 游戏数据的好坏，会影响视频在推荐系统的评分（如果性能没有优化好，使用wasm方案上ios会带来整体的负向效果，所以建议前期不要考虑上ios，先理清运营思路，优化好产品再上） ​

• 用户看到视频后进入，对内容有一定期待，所以相对于图文广告，相对可容忍更多一点的首包下载时间，但更小的首包，肯定转化率更好 ​

​

在这之前请先阅读： 字节小游戏介绍&发行攻略 ， 视频分发 场景有其独特的特性，下面介绍几个案例，各位可以先去体验学习一下他们的游戏版本节奏和运营方式（可安卓抖音搜索体验游戏和查看官号） ​

• 案例1：击倒一切 ​

• 案例2：豆豆探险闯关 ​

• 案例3：叶罗丽彩妆公主 ​

​

​ ​

​

​

​

游戏二维码 ​

​

​

​ ​

​

​

​

官号二维码 ​

​

​ ​ ​

​

​

游戏二维码 ​

其他注意事项 ​

• 抖音Unity小游戏目录说明与缓存策略 ​

• WebGL方案优化建议 ​

​

关于抖音普通小游戏能力 ​

抖音Unity小游戏提供的解决方案与抖音普通小游戏不同，抖音普通小游戏提供的平台能力对于Unity C# SDK也有一定的开发工作量，我们目前同步支持了大多数抖音普通小游戏提供的平台能力，例如排行榜、loading加载背景图、插屏广告、banner广告等，现在在Unity C# SDK上你都可以找到对应的api；普通小游戏更新的平台能力在多数情况下，Unity C# SDK也会在短期内同步支持，当然，如果你想要更快的在Unity C# SDK上使用普通小游戏的某个平台能力，可以前往抖音Unity小游戏意见和反馈群中催更 ​

​

问题反馈 ​

问题反馈与联系我们 ​

其他参考资料 ​

抖音Unity小游戏FAQ ​

字节小游戏开发者常见问题FAQ ​

关注【抖音创作者学院】官方账号 ​

上一篇：小游戏开发流程

下一篇：使用方案及引擎选择建议

文档评论

登录 后可参与评论

该文档是否有帮助？

本页导读

背景说明

抖音Unity小游戏为您提供以下解决方案：

项目接入实施步骤

【阶段一】可行性及方案评估：

【阶段二】简单验证：先运行起来

【阶段三】抖音平台能力接入：接入更多平台能力

Step1 - 账号准备

Step2 - 了解SDK能力，接入SDK

【阶段四】体验调优：达到可上线标准的小游戏体验

【阶段五】发布上线与运营

构建及发布

运营

其他注意事项

关于抖音普通小游戏能力

问题反馈

其他参考资料

点击纠错