终端小游戏开发指南
终端小游戏注册、管理、发布流程与小程序完全一致,全部在虎牙小程序开发者中心进行。
终端小游戏能使用所有小程序提供的能力,也支持在 Web、PC、Mobile 多终端下运行。
终端小游戏工程创建
参考小程序的快速开始搭建开发环境
创建一个空<project-name>目录,在里面创建<h5game-name>二级子目录
在<project-name>目录下面执行命令:
npm install -g @hyext/cli
hyext init -b webview
选择终端类型的过程参考快速开始
最后一步需要输入
h5Dir,即 H5 游戏发布代码的相对路径,本例为:<h5game-name>
创建完成之后的目录结构类似如下:
├── <h5game-name>
├── package.json
├── node_modules
└── project.config.json
其中<h5game-name> 是 H5 游戏发布代码的目录。
游戏项目源码经过编译后必须导出成 H5 格式,并放到<h5game-name> 目录下面。支持的游戏引擎参考: 游戏引擎支持
终端小游戏开发测试过程
本地开发调试
在 H5 游戏开发过程中,为了提高效率,可先按照独立 H5 游戏的方式来开发调试,先不集成到虎牙终端中,涉及到虎牙小程序 SDK 调用的部分,可采用 mock 的方式来模拟。
在游戏主要逻辑开发完成之后,需要集成到虎牙终端中运行测试时,先在虎牙小程序平台创建版本,参考版本管理
然后在项目根目录下面执行:hyext start 开启小游戏本地开发模式。
小游戏本地开发模式与小程序的开发调试流程一致。
本地目录<h5game-name>的相关文件的内容将直接下发到直播间进行展示, 默认显示的文件为 <h5game-name>/index.html, 如需更改请设置 project.config.json 中的 html 字段:
{
"extType": "web_video_com",
"platform": "web",
"html": "project-1/index.html"
},
如果目录<h5game-name>下的发布代码如果有变更,退出并重进直播间 可以生效。
同时,小游戏本地开发模式 不支持游戏 H5 代码断点调试。
版本测试
小游戏版本开发完毕后,可提交测试。
执行 hyext release 打包小游戏代码,然后上传到虎牙小程序平台。
参考程序配置进行测试
版本发布
与小程序一致,参考版本发布