SDK对接文档

主题

WARNING

💡 Unity 快手小游戏

CAUTION

注意



准备工作： ​

下载快手开发者工具 ​

https://ks-game-docs.kuaishou.com/minigame/start/devtool.html

  1. 切换并安装快手插件



导入配置 ​

WARNING

💡 需要切 WebGL 平台

并需要将webgl选择为webgl 1.0 版本


导入游戏配置




设置项目 ​

Debug 模式的开启或关闭

发最后一个正式包时，一定要取消 DebugMode



功能组件 ​

快手 WEBGL 下面的输入 InputField 会失效 ​

可以动态添加组件

XYX.InputFieldAdapter(inputField.gameObject);

快手平台必须接入功能 ​

侧边栏复访能力 ​

完整流程见小游戏侧边栏和复访。快手需打包上传后使用真机验证跳转、返回领奖和每日刷新。

是否支持侧边栏

c#
//有些旧版本的抖音不支持侧边栏，所以需要先检查是否支持，再决定是否跳转
XYX.CheckSupportSide(CheckCallback);
void CheckCallback(bool isSupportSide)
{
    UnityEngine.Debug.Log($"是否支持侧边栏  {isSupportSide}");
}

是否是侧边栏启动

c#
//这里先判断是否支持侧边栏，回调里面再判断是否是侧边栏启动
bool isOn = XYX.CheckLaunchFormSide();
UnityEngine.Debug.Log($"是否是侧边栏启动  {isOn}");

跳转到侧边栏

c#
XYX.JumpToSide();

构建与调试 ​

构建 ​

Unity 菜单栏选择：快手小玩法 => 打开WebGL打包界面



打包后产物


导出的miniPlay使用快手小游戏开发者工具打开


点真机预览，扫码进入游戏调试

快手 QA ​

1.加载问题排查 AssetBundle the URI is empty ​


解决办法：使用该办法绕过一下

UnityWebRequestAssetBundle.GetAssetBundle(new Uri("xxxxx"));

MissingMethodException

MissingMethodException: Default constructor not found for type xxxxxx 问题处理

增加一个link.xml文件：

xml
<linker>
  <assembly fullname="LitJson" preserve="all"/>
  <assembly fullname="ks-runtime" preserve="all"/>
</linker>

放到Unity工程Assets目录下

2.问题排查 WebAssembly.instantiate():expected magic ​

游戏暂时没适配br，暂时选择Disabled