Unity 之 发布字节抖音小游戏_unity 抖音小游戏

字节抖音小游戏是一种基于字节跳动产品生态开发且无需下载安装即可使用的全新游戏应用，实现了客户端“点开即玩”的优质用户体验。小游戏拥有开发轻便快捷，发布流程简单的特点，同时依托字节跳动生态优势，让小游戏天然具备较强的内容分发能力，支持小游戏开发者快速推广与变现。

一，准备工作

1.1 注册字节开发者后台

进入字节小程序开发者后台，在开发者平台中点击右上角的「快捷登录」进行帐号注册。在登录后需要通过【申请创建】提示完成申请流程即可。

然后等着字节小游戏通过注册时的手机号或邮箱给予的答复。工作日提交的话一般在几个小时之内就有答复，最长时间为两个工作日之内。

注册后按照要求填写资质信息：公司就写企业全称，个人开发者填写个人姓名，然后其他内容根据要求填写。

其中需要注意的是小游戏体验路径：一般是一个可用的测试链接或者是一个网盘地址里面放一个可以玩的apk。（我们写过苹果商店地址审核失败了，应该是IOS的不行）

---

1.2 Unity版本说明

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

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

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

我前几天测试了2019.4.35f1c1，2019.4.8f1，Unity2021.3.3f1c1版本都是可以使用的，

不过在7月26号看到有开发者反馈说2019.4.8f1不好用了，官方回复：最近因为Android 12 的普及新增崩溃太多了，所以发新版需要升级了。

因为插件本身也在开发中，所以建议在开发是加入意见反馈群（在官方文档文末），及时关注动态，以免重复趟坑。

我这里用的是Unity2021.3.3f1c1版本：

发布Android就在下载时添加：Android Build Support 模块:

发布WebGL的话就在下载时添加：WebGL Build Support 模块:
（想上线IOS的话只能使用WebGL的方式进行发布）

1.3 检查AppID是否有效

审核通过后就可以在应用中心看一个以07结尾且长度是20位AppID，若不是需要重新申请（后面打包时用）

---

二，开始集成

2.1 创建项目

下载字节SDK：开发者后台，建议先读一遍文档，因为当你看的时候有可能有更新：

导入后在工具栏选：ByteGame --> ByteGame Develop Tools

打开后下载：StarkSDK和StarkSDKUnityTools两个包：

下载完成后目录大致如下：

---

2.2 接入SDK

发布抖音小游戏，只需要一个录屏分享功能即可上线。所以这里只提供录屏和分享功能示例，其他功能可按需接入，官方文档地址。

逻辑也非常简单，创建三个按钮分别为开始游戏，游戏结束，分享录屏来模拟游戏过程中的功能实现；带有详细注释的接入代码如下：

using System.Collections;
using System.Collections.Generic;
using StarkSDKSpace;
using UnityEngine;
using UnityEngine.UI;

public class StarkSDKTest : MonoBehaviour
{
    public Button startBtn;
    public Button endBtn;
    public Button shareBtn;
 
    void Start()
    {
        startBtn.onClick.AddListener(StartVideo);
        endBtn.onClick.AddListener(StopVideo);
        shareBtn.onClick.AddListener(ShareVideo);
    }

    void StartVideo()
    {
        Debug.Log("抖音 开启录制视频 ...");
        // <param name="isRecordAudio">是否录制声音，默认为录制声音</param>
        // <param name="maxRecordTimeSec">最大录制时长，单位 s。小于等于 0 则无限制。默认为10分钟</param>
        // <param name="startCallback">视频录制开始回调</param>
        // <param name="errorCallback">视频录制失败回调</param>
        bool isStart = StarkSDK.API.GetStarkGameRecorder().StartRecord(true, 200,
            StartCallback, FailedCallback, SuccessCallback);
        Debug.Log("视频开启录制结果 ..." + isStart);
    }

    void StopVideo()
    {
        Debug.Log("抖音 停止录制视频 ...");
        bool isStop = StarkSDK.API.GetStarkGameRecorder().StopRecord(SuccessCallback, FailedCallback, null, false);
        Debug.Log("停止录制视频状态 ..." + isStop);
    }

    void StartCallback()
    {
        Debug.Log("视频开始录制回调执行 ...");
        // 开始回调逻辑，比如：显示录屏中按钮
    }

    void FailedCallback(int errCode, string errMsg)
    {
        Debug.Log("录制视频失败回调执行 ... 错误码是：" + errCode + " ，错误消息是：" + errMsg);
        // 失败回调逻辑，比如：隐藏录屏中按钮
    }

    void SuccessCallback(string videoPath)
    {
        Debug.Log("视频录制完成实际路径：" + videoPath);
        // 成功回调逻辑，比如：隐藏录屏中按钮
    }

    void ShareVideo()
    {
        Debug.Log("ShareVideo ShareVideo ...");
        // 只有回调，不带预定义标题和话题
        StarkSDK.API.GetStarkGameRecorder().ShareVideo(SuccessCallback, FailedCallback, CancelledCallback);

        // <param name="successCallback">分享成功回调</param>
        // <param name="failedCallback">分享失败回调</param>
        // <param name="cancelledCallback">分享取消回调</param>
        // <param name="title">分享视频的标题，如不需要设置标题，可以传null或空字符串</param>
        // <param name="topics">分享视频的话题，如不需要设置话题，可以传null或空列表</param>
        //StarkSDK.API.GetStarkGameRecorder().ShareVideoWithTitleTopics(SuccessCallback, FailedCallback,
        //    CancelledCallback, "自定义标题", new List<string>() {"自定义话题1", "自定义话题2"});

        void SuccessCallback(Dictionary<string, object> dictionary)
        {
            Debug.Log("视频分享成功回调 ...");
            // 成功回调逻辑，比如：弹窗提示并发放奖励
        }

        void CancelledCallback()
        {
            Debug.Log("取消分享回调 ...");
            // 取消回调逻辑，比如：弹窗提示
        }

        void FailedCallback(string errMsg)
        {
            Debug.Log("分享视频失败回调执行 ... " + " ，错误消息是：" + errMsg);
            // 失败回调逻辑，比如：弹窗提示
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

最后将代码挂载到游戏场景中并将上面创建的三个按钮赋值给代码中预留的公开变量。

然后运行：点击开始游戏按钮 -——> 调用录屏逻辑 -——> 游戏中出现：开发阶段…文字提示，-——> SDK接入成功 -——> 进入真机测试阶段。

2.3 排行榜

【2023.02.22更新~】看到很多同学想问排行榜相关问题。在stark sdk版本5.38.4之后，开始支持排行榜
支持宿主版本：抖音/抖音lite 23.8版本
官方参考文档：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/open-capacity/game-rank/ImRankIntroduce

2.4 侧边栏复访

2023.11.23更新
小游戏侧边栏复访能力 - 官方文档

开发者您好，「小游戏侧边栏复访能力」已上线近2周，经验证接入能力对次日&7日留存率均有正向影响。
为协助提升小游戏用户留存，平台将「侧边栏复访能力」升级为必接能力，并于11月24日起开启「必接审核」，届时未接入该能力的小游戏在「首发」&「版本更新」环节可能有「拒审」风险，为避免影响游戏上线&更新节奏，请合理规划接入，感谢您的配合！
必接审核执行日期：2023年11月24日起

#region 侧边栏复访
void CheckSideBarScene()
{
    StarkSideBar starkSideBar = StarkSDK.API.GetStarkSideBarManager();
        
    starkSideBar.CheckScene(StarkSideBar.SceneEnum.SideBar, SuccessCallBack, CompleteCallBack, ErrorCallBack);
    
    void SuccessCallBack(bool IsSuccess)
    {
        // todo... 显示侧边栏进入按钮
        Debug.Log($"是否宿主支持侧边栏进入：{IsSuccess}");
    }
    
    void CompleteCallBack()
    {
        Debug.Log($"是否宿主支持侧边栏 CompleteCallBack");
    }
    void ErrorCallBack(int errCode, string errMsg)
    {
        Debug.Log($"是否宿主支持侧边栏 错误id：{errCode}，错误信息：{errMsg}");
    }
}
void OnNavigateToScene()
{
    StarkSideBar starkSideBar = StarkSDK.API.GetStarkSideBarManager();
        
    starkSideBar.NavigateToScene(StarkSideBar.SceneEnum.SideBar, SuccessCallBack, CompleteCallBack, ErrorCallBack);
    
    void SuccessCallBack()
    {
        // todo... 从侧边栏进入，发放奖励
        Debug.Log($"从侧边栏进入：navigateToScene:ok");
    }
    
    void CompleteCallBack()
    {
        Debug.Log($"从侧边栏进入 判断完成：CompleteCallBack");
    }
    void ErrorCallBack(int errCode, string errMsg)
    {
        Debug.Log($"从侧边栏进入 错误id：{errCode}，错误信息：{errMsg}");
    }
}
#endregion
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

---

三，发布游戏

在工具栏选择 ByteGame --> StarkSDKTools --> Build Tool 即可打开打包的工具面板

3.1 发布安卓Apk

在面板的运行框架选择Native，然后按照需求填写，构建即可。

---

3.2 发布双端WebGL

在面板的运行框架选择WebGL，然后选择构建WebGL：

构建完成后，会在指定目录生成 --> 一个webgl的目录和一个压缩包，如下图：

然后在3.1图1中选择发布WebGl：

最后按需填写完成后，选择发布，等待发布完成即可在弹出二维码，使用抖音扫描就可以进行测试了。

---

3.3 IOS15.4版本问题

测试IOS时发现，使用IOS15.4版本的测试机，不能成功加载出游戏场景，报错如下：

报错原文：

10:08:30.703 exception thrown: RuntimeError: Out of bounds memory access (evaluating ‘dynCall_ii(index,a1)’),<?>.wasm-function[59627]@[wasm code]
.wasm-function[146029]@[wasm code]
.wasm-function[83839]@[wasm code]
wasm-stub@[native code]
invoke_ii@blob:file:///ce3cf2cf-9cb3-4723-a499-98a7b0c93a71:3:413696
.wasm-function[83839]@[wasm code]
.wasm-function[19042]@[wasm code]
.wasm-function[1057]@[wasm code]
.wasm-function[66513]@[wasm code]
.wasm-function[4560]@[wasm code]
.wasm-function[118584]@[wasm code]
wasm-stub@[native code]
invoke_iii@blob:file:///ce3cf2cf-9cb3-4723-a499-98a7b0c93a71:3:411844
.wasm-function[118584]@[wasm code]
.wasm-function[2239]@[wasm code]
.wasm-function[63653]@[wasm code]
.wasm-function[18940]@[wasm code]
.wasm-function[541]@[wasm code]
.wasm-function[540]@[wasm code]
.wasm-function[111580]@[wasm code]
.wasm-function[134747]@[wasm code]
.wasm-function[18950]@[wasm code]
.wasm-function[118583]@[wasm code]
wasm-stub@[native code]
invoke_iiii@blob:file:///ce3cf2cf-9cb3-4723-a499-98a7b0c93a71:3:412366

应该unity引擎有些代码变动导致，一个相关说明

解决方法：升级IOS版本就不会有问题啦。

---