Kwai Game

# 快手海外小游戏开发流程

快手海外小游戏是指在快手海外App（Kwai、SnackVideo）上运行的小游戏，在开发流程上主要分为游戏逻辑开发阶段和代码调试阶段。在游戏逻辑开发阶段，开发者可以使用原有游戏开发工具链，比如 CocosCreator, LayaAirIDE 等游戏引擎提供的 IDE。 在代码调试阶段，需要使用快手提供的桌面 APP 快手海外小游戏开发者工具。

快手海外小游戏开发者工具的使用请参考：快手小游戏开发者工具使用指南

# 编写游戏代码

快手海外小游戏目前支持市面上大多数小游戏引擎，如 CocosCreator, Layabox , Egret 等。开发者可以直接使用这些游戏引擎提供的开发工具编写游戏代码，当需要使用快手海外小游戏平台 JS API 时请参考： 快手小游戏 JS API，当前JS API规范与快手国内和微信小游戏API兼容。

注： 快手小游戏最新的 JS API 均在 ks 命名空间下

# 导出快手海外小游戏

使用游戏引擎 IDE 提供的小游戏导出功能，导出快手小游戏兼容游戏包，一般是微信小游戏。更多细节请参考：快手小游戏导出指南 (opens new window)

# 预览，调试

在游戏引擎IDE成功导出小游戏工程后，可以通过以下步骤体验游戏在真实设备上的运行效果。

  1. 登录开发者工具
    • 点击开发者工具菜单栏 -> 登录， 使用快手海外小游戏开发者平台（ https://game.kwai.com/platform ） 注册的对应开发者邮箱账号登录
    • 后续导入的游戏必须是该开发者账号下创建的游戏
  2. 导入项目
    • 使用开发者工具“新建工程->导入项目”导入上述从游戏引擎导出的小游戏工程，导入时必须填写开发者从快手海外小游戏开发者平台申请的appid
    • 在“设置->本地配置”中勾选“主动适配微信小游戏”选项，检查游戏根目录下是否自动生成kwaiadapter.js文件
  3. 生成真机预览二维码
    • 在开发者工具中点击左上角“真机预览”按钮可生成真机预览二维码
    • 如提示上传失败可尝试重新登录一下账号
    • 真机预览下拉菜单中勾选或取消“显示VConsole”可以显示或隐藏运行预览小游戏时的调试窗口
  4. 下载Kwai App
    • 在快手海外开发者平台的“资源中心”页面下载安装快手海外Android客户端Kwai App，网站不定时更新App新版本，调试时请使用最新版本（注：海外应用市场下载的正式Kwai App可能无法在国内环境正常调试）
  5. 扫码预览
    • 快手海外App没有扫码入口，需在安装了快手海外App的Android手机上用手机浏览器或者相机【扫一扫】功能扫描生成的预览二维码即可自动跳转Kwai App并启动小游戏
    • 某些手机浏览器会拦截schema跳转链接，可使用其他支持schema跳转的扫码工具
  6. 其他注意事项
    • 小游戏需要进行网络通信的域名需要在开发者平台“管理中心”->“开发设置”中指定，否则无法访问该域名
    • 目前登录、分享、广告等开放接口没有必须接入的限制，厂商可按需接入

# 上传游戏至开发者平台

  1. 开发者在完成游戏开发及调试后，可以在快手海外小游戏开发者工具中点击上传 button，填写版本号之后可将当前游戏上传至快手海外开发者平台
  2. 上传整体包体限制30M以内，包体超过5M建议使用分包加载，保障游戏体验的同时尽量缩小首包大小
  3. 包体上传后，快手服务器会根据项目配置拆分主包和分包，所有上传的游戏包体资源都会通过快手海外CDN网络进行分发
  4. 上传之后可以在开发者平台"管理中心"->“版本管理“菜单看到对应开发版本的体验二维码，确认无误后可以继续在开发者平台完成提交审核操作。

快手海外小游戏开发者工具 →