虎牙开放平台文档

终端小游戏开发指南

终端小游戏注册、管理、发布流程与小程序完全一致,全部在虎牙小程序开发者中心进行。

终端小游戏能使用所有小程序提供的能力,也支持在 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 打包小游戏代码,然后上传到虎牙小程序平台。 参考程序配置进行测试

版本发布

与小程序一致,参考版本发布


附录