即玩 Unity&UE 小游戏接入指南

一、了解即玩 Unity&UE 小游戏

即玩 Unity&UE 小游戏指由 Unity&UE 开发的原生游戏在字节系 APP 中可以免安装、即玩的游戏。即玩 Unity&UE 小游戏在免安装的同时拥有原生游戏的体验。并且能够连接字节系 APP,使用开放能力,帮助游戏获得较强的内容分发能力,更快速推广与变现。

二、接入指引

2.1 限制条件

方案类型

支持平台

支持宿主

包体大小

原生方案

Android

抖音、抖音极速版、头条、头条极速版、火山视频

首包包体需小于60M

Wasm 方案

Android;

IOS (需要找运营开通白名单)

抖音、抖音极速版

首包包体需小于30M

如果您的游戏首包不满足要求,可以选择我们提供的解决方案:StarkMini 小包化方案

注意:若选择使用了 StarkMini 游戏小包化方案,那么游戏平台上线之日起 3 个月内,不得在任何其他平台(包括你或你关联公司自有的平台、小程序等)上线该小游戏,否则巨量引擎有权不予结算该小游戏所获得的任何收益。

2.2 注册登录账号

1.在开发者平台中点击右上角的「快捷登录」进行帐号注册。

2.当前小游戏平台仍采取申请开发制,故开发者在登陆后需要通过【申请创建】提示完成申请流程。

小游戏申请发出后,字节小游戏将在两个工作日内通过您注册时的手机号或邮箱给予您答复。若您收到邀请信息,说明您的开发权限已获批,可通过平台接入。

注意事项:

1.审批通过后,该账号方有创建小游戏的权限。

2.手机号等信息请如实填写。

3.企业主体开发者请填写企业全称,个人主体开发者请填写个人姓名。

4.小游戏体验路径为必填项目 。请填写提交可体验的测试链接 url 链接,无法体验的游戏申请将一律驳回。

2.3 主体认证

主体认证包含主体资质提交和对公打款验证,开发者需要先完成主体资质提交,再完成对公打款验证,认证成功后才能进行小游戏管理操作。

目前支持的主体身份类型:

  • 企业开发者:适用于企业,个体工商户,政府组织,海外机构等其他机构。每个企业主体可以创建 50 个小游戏。
  • 个人开发者:个人主体验证适用于由个人运营的小游戏,每个个人主体可以创建 25 个小游戏。

特别提醒:

1.企业主体开发者请勿选择“个人开发者”,否则未来将产生无法结算等问题。

2.平台暂不支持主体变更,只支持工商更名

(1)资质提交:

请根据主体类型提交对应资质:

主体类型

所需信息

注意事项

个人主体

包括但不限于个人身份证、手机号等

验证类型支持【手机号实名认证】或【银行账户实名认证】,认证方式二选一即可:

1.手机号实名认证:校验用户的姓名、身份证号、手机号。手机三要素实名认证指的是通过三网手机实名认证数据接口,来检验个人的姓名、身份证、手机号码是否一致,支持支持移动、电信、联通号码。

2.银行账户实名认证:校验银行卡持卡人的姓名、 银行卡号、 预留手机号、 身份证号的真实性,是对银行卡用户资料真实性进行的验证审核,以便建立完善可靠的互联网信用基础。

企业主体

包括但不限于企业营业执照、经营者信息等

证件类型:优先选择填写“营业执照统一社会信用代码”,若无则按照实际证件的真实情况进行填写。

证件照片:营业执照上加盖的公章需清晰可见,营业执照请勿带有不相关的水印(如有需求可带有“仅供申请巨量引擎数字证书使用”的水印), 若为营业执照复印件,需标注“与原件一致”并加盖公司公章,营业执照资质需清晰可见。

(2)对公验证:

对公验证共有 4 种方式:

验证方式

须知

填报指引

银行账户实名认证

(无需等待打款)

1.仅限个体工商户,且营业执照证件类型为“统一社会信用代码”的账户。

1.验证类型、公司名称、资质编号、经营者姓名默认拉取资质提交页面的信息;

2.申请人需填写经营者的身份证号码、个人银行卡号、银行卡预留手机号,短信验证码

平台向客户打款验证

1.平台向客户打款验证有两次打款机会,若平台向客户两次打款失败,请选择其他方式进行对公验证(系统打款失败不占用机会)

2.从发起验证之时起,48 小时内未输入验证金额的,会显示超时,本次打款验证失效,需重新验证

1.验证类型、公司名称默认填写资质页面信息

开户行:通过关键字搜索,准确填写开户行信息。如“中国工商银行北京海淀支行”,尝试搜索“海淀支行”或“工商 海淀”即可;

2.银行卡号:请认真填写,保证信息准确。若验证类型为个体工商户,银行卡号应根据所选的银行卡类型

(对公银行卡或个人银行卡进行填写,且个体工商户营业执照资质类型不是“统一社会信用代码”的,只能使用对公银行卡

客户向平台打款验证

1.若客户向头条打款验证失败,可重新验证,无次数限制

2.从发起验证之时起,48 小时内平台没有收到打款,本次验证失效,需要客户重新验证

1.验证类型、公司名称默认填写资质页面信息;

2.银行卡号:请认真填写,确保信息准确

(若个体工商户营业执照资质类型是非“统一社会信用代码”,只能使用对公银行卡。)

申请验证授权

1.相同营业执照的公司若已开通巨量引擎的商业化账号,并完成对公验证,可向该账号发起验证授权。

2.如果在 B 游戏中申请 A 游戏进行验证授权,请在 1 小时内登陆 A 游戏“认证中心-对公打款验证”中,进行授权确认,否则授权申请将失败。 (A 游戏“认证中心-对公打款验证”地址如下,请将“appid”替换成实际appid:https://microapp.bytedance.com/app/appid/crt_mmm

1.授权账户必须是已完成对公验证,待授权账户必须是待对公验证状态;

2.授权账户与待授权账户公司名称、验证类型必须一致,如个体工商户,经营者姓名也必须一致

3.如果您在可授权列表里没有找到特定的账户,可能有以下原因:

(1)该账户还未通过对公验证

(2)该账户不是正常打款通过的对公验证,不能给别的账户授权

(3)该账户离有效期只有不到 30 天,不允许给别的账户授权

三、创建游戏

3.1 登录小程序开发平台

登录小程序开发平台

3.2 创建即玩 Unity&UE 小游戏

点击“进入开发者平台”。

右上角的“创建应用”,选择“创建小游戏”。

选择"即玩 Unity&UE 小游戏"。

填写基本信息。

四、游戏接入与构建

4.1 原生游戏准备

如果使用 natvie 方案:确认游戏工程运行在 Unity 2019.4.8f1 或者 Unity 2019.4.35f1

如果使用 wasm 方案:建议使用 unity 最新版,比如 2021.2 之后的版本,在 wasm 方面做了很多优化

可以用 2019.4.8 构建 native 版本,用 2021.x 构建 wasm,一起发布。

重要: editor 和 Android Target Support 都需要从网页进行下载,不要通过 hub 进行下载,否则无法进行发布

下载链接:

Unity 2019.4.8f1:https://unity3d.com/unity/whats-new/2019.4.8

Unity 2019.4.35f1:https://unity3d.com/unity/whats-new/2019.4.35

注意:

  1. 若游戏工程所使用的 Unity 版本不是所支持的版本,则需要先将游戏工程的 Unity 版本改变为所支持的版本。
  2. 安全性考虑,不允许在项目中加入原生 java 代码库。

注:Unreal 引擎支持将于近期开放,请保持关注字节小游戏官方网站

4.2 安装 SC 插件

首先你需要在 Unity 中安装 BGDT点此下载 BGDT

接着从 BGDT 中安装以下插件:

Stark SDK :提供连接宿主、开放能力功能

StarkSDKUnityTools : 本地调试工具,及版本发布工具

4.3 游戏接入

总览:

功能

广告

录屏

绑定抖音号

创建快捷方式

分享

登录

支付

自定义事件

必要性

可选

必须

可选

可选

必须

可选

可选

可选

说明

如有广告则必须接

UCG分发需要有录屏




如需登录则必须接

接入字节小程序担保支付,需要版号


须仔细阅读:小游戏自审,根据要求和自身需求选择接入。

Stark SDK 的接口通过 StarkSDKSpace.StarkSDK.API 来调用

StarkSDKSpace.StarkSDK.API.GetStarkAdManager();

每个接口导航过去会有详细的注释,类似下图

4.4 构建

入口

Unity 菜单栏选择:ByteGame => StarkSDKTools => Build Tool

填写参数

基本参数

游戏 AppId:当前游戏的 AppId(可在小程序开发者平台 中查询),不可为空。

注意,AppId 的数字结尾必须是 07,且长度是 20 位。如果不满足条件,需要重新申请

宿主选择:头条、抖音、抖音 Lite(单选:在哪个宿主下运行)

运行版本选择:当前只有Lastest (测试版) 环境(单选,且只能选这个)

基本参数填写完毕后已具备构建条件。如有需要可进行高级参数配置

高级参数

Apk 文件名:构建 Apk 的文件名前缀。

Apk 输出目录:构建 Apk 的输出目录路径,若目录不存在会构建 Apk 时尝试创建目录。

运行本地 Apk:选择本地 Apk 在真机宿主中运行调试。(需连手机,且开启 USB 调试)

清除版本缓存:清除手机上的 SC 游戏缓存文件,可选择Latest 版本所有版本(需连手机,且开启 USB 调试)

上线前参数确认:主要用于发布 Apk 时需要确认的构建参数(可以点击一键设置,自动设置为发布 Apk 时需要的构建参数。)

  • 脚本实现:需要为 IL2CPP
  • CPU 架构:需要为 All
  • 最低安卓版本:根据实际情况选择
  • Strip Engine Code:不能勾选

其它设置(仅调试用):

  • Dev 版本:是否构建 Development 版本
  • 压缩方法:可选择,None(不压缩)、LZ4LZ4HC

进行构建

根据实际需求进行构建

仅构建 APK:不运行游戏,仅构建 Apk(在 Asset/Build/Apk 下生成类似 projectname-All-20201130051501.apk的文件)。

构建并真机运行:构建 Apk 成功后,自动拉起宿主游戏(需连手机)。

发布 APK:打开发布界面。

4.5 提测

入口

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

填写参数

根据实际情况填写参数

Uid:请使用小程序开发平台的 Uid

Uid 获取方法

  1. 登录字节跳动小程序开发者平台
  2. 确保登陆的开发者账号,在对应的项目中有管理员权限
  3. 登录之后,打开链接https://microapp.bytedance.com/api/v1/user,应该返回类似这样的信息:{"error":0,"uid":"1234567890123456","email":"****",...}
  4. 上面的 uid 即为需要的 uid
  5. 使用的 uid 对应的账号,一定要在对应项目加上版本管理的权限

Apk 路径:需选择同时带有 32 位和 64 位动态库的 Apk。

通常是前面勾选了“上线前参数确认”构建出来的 Apk。(如果构建过 Apk,这个路径会自动填充

游戏 AppId:当前游戏的 AppId(可在小程序开发者平台 中查询)

发布类型:默认,不可改动。

屏幕方向:根据游戏实际情况选择。

版本号:点击『自动版本号』按钮,可以获取 线上版、测试版 的版本号。

  • 自动版本号:当前测试版本号自动+1 为作新的版本号填充。
  • 手动填写:版本号应大于当前测试版本的版本号。

发布描述:游戏发布的描述

发起提测

在发布界面上点击 [ 发布 ] 按钮来进行提测

信息确认

在弹出信息确认框内需确认以下元素:

文件名:确认是否正确。

文件大小:最大不能超过 60M。

版本号:如版本号是手动填写,建议检查版本号是否在上次基础上+1。*

确认无误后点击 “发布” 按钮,否则取消返回修改。

发布成功及发起提审,可进行测试

进行测试

登录 小程序开发者平台跳转至 【版本管理 】进行测试。

生成二维码

发布成功后,可以生成二维码

刚发布的 Apk 生成的二维码建议等待 2-5 分钟后再扫码

五、审核

5.1 提审小游戏

1.完成上传后,可以在后台的版本管理中查看上传的测试版本,提审前可以点击右侧二维码进行扫码体验。

2.点击【提交审核】,自行选择希望上架的字节系 APP,审核将会在 1-2 个工作日完成。

注意: 在上传时系统将提示上传三张图,图片必须包含如下内容:一张游戏标题、一张游戏内主要游戏画面。(若游戏内没有含有游戏标题的页面,亦可使用加载页面、海报图等含有游戏标题的页面)

3.另外,可以在「审核版本」中看到正在审核的小游戏版本及审核状态: 若审核不通过,会显示未通过原因,请点击【查看详情】按照指引进行修改后再次提审。

相关审核标准具体可参考:小游戏审核标准

待审核通过方可点击发布上线。

注意事项:

  • 小游戏在提审前,为了保证通过率,请开发者提审前可自测环节进行自查:开发者自审自查
  • 小游戏首次上线前的审核都需进行 QA 回归,预计在 1-2 个工作日;
  • 如果使用了网络相关功能,务必于后台配置 " 安全域名 " 的白名单,否则将影响游戏上线和正常功能。安全域名必须为 https:// 及 wss://协议,非加密传输的请修改伺服器域名。

(1)request 合法域名

(2)socket 合法域名

(3)uploadFile 合法域名

(4)downloadFile 合法域名

六、发布小游戏

6.1 发布小游戏

版本审核通过后,开发者点击“发布”,小游戏即可发布上线。

6.2 注意事项

设置搜索关键词与分享

(1)当发布未配置搜索关键词与分享内容版本时,会弹出提示与跳转地址,点击【前往配置】,建议上线前完成该配置。

(2)如果已有搜索关键词和分享内容,想要查看或进行修改:

可以在后台【设置】中的【基础设置】进行分享设置:分享标题、分享文案、分享图案

可以在后台【流量配置】中的【搜索】进行搜索标签配置,另提交的搜索关键词应符合 小游戏关键词搜索

选择开通虚拟支付/广告能力

1.开通内购能力:在开发者后台的功能管理-支付(注意通过主体认证,且资质提交完全,例如版号必须提交),按流程操作申请。

2.开通广告服务:开发者在完成相关主体资质认证和对公验证后,即可在后台的广告中心-流量主对已上架的小游戏进行申请开通操作。

七、运营指引

7.1 用户获取

同一小游戏可以同步上线多个宿主端(宿主:即小游戏可上线的字节 APP),为开发者节省大量的人力和时间。目前已经逐步开放今日头条、抖音、火山、西瓜视频、头条极速版,更多字节系产品在陆续接入中。新游上线,字节小游戏平台均会给到冷启动量,后期会根据产品数据,转化率等数据,通过去中心化算法模块精准匹配、直接触达用户,为游戏持续给量,更多内容可见《用户获取》

7.2 日常管理

平台同时为开发者提供了大量自运营工具用于拉新和留存,并为达到条件的小游戏提供支持。关于小游戏运营效果的数据分析,可以通过平台提供的数据分析看板进行查看,更多内容可见《数据基础介绍》

7.3 买量推广

对于有推广需求的开发者,平台也开放了相应的买量机制,详情可见《小游戏发行人计划》《小游戏微端 X 巨量引擎信息流投放 操作指南》

7.4 终止运营

如需停止对外运营小游戏,可进入开发后台基础设置管理页面点击下架。 注意:内购小游戏下架需提前 60 天。

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助