QQ小游戏引擎插件

小游戏引擎插件接入

一、概述

为了提升小游戏的打开速度，提高用户体验，开发者可接入引擎插件能力。

引擎插件会单独在客户端进行缓存。当小游戏首次启动时，如果本地已经存在同类别游戏引擎插件，可直接复用引擎插件或可通过增量下载的方式快速下载，从而提升启动速度。

二、引擎插件配置

使用新版引擎IDE 或引擎工具重导出QQ小游戏即可。

使用新版引擎IDE或引擎工具重导出后，会有三个变化。

(1) 引擎IDE选择使用插件分离后代码包中将不包含引擎插件相关代码。

(2) game.json中添加通用插件配置。

如图片描述

(3) 使用引擎的方式变更为requirePlugin。

如图片描述

注意事项：

目前一个APPID，只支持引用一个插件。
目前支持整包小游戏引用插件，和分包小游戏的主包引用插件。
如果需要本地调试引擎代码建议不使用插件分离能力。

三、使用QQ小程序开发者工具调试插件

1.调试引擎插件的ide版本为0.1.29。

2.调试引擎插件的基础库版本为1.8.0。

3.在代码调试过程中,ide会直接下载game.json中配置的全量的 provider 的 version 版本的文件作为引用的插件代码。如果配置错误，ide会提示:"获取插件文件错误"。

如

图片描述

4.上传/预览时，系统会直接使用线上已发布的全量的 provider 的 version 版本的文件作为引用的插件代码。

开发者工具下载地址：

四、在QQ客户端中体验插件分离功能

在QQ客户端中可直接体验到插件分离功能.(QQ版本为8.1.8及以上)

使用了插件分离的小游戏，在console日志中会输出

plugin ***** inject success/fail!

小游戏引擎插件开发

开发小游戏插件需要一个appid，申请步骤同小游戏一致。

开发者工具从 1.29.0 开始支持小游戏插件的开发。

基础库从 1.8.0 开始支持小游戏插件的运行。

# 小游戏插件目录结构

project
├── minigame
│   ├── game.json       // 插件提供的自定义组件（可以有多个）
├── plugin
│   ├── index.js        // 插件的 js 入口
│   ├── code.js         // 插件的 js 代码
│   ├── plugin.json     // 插件配置文件
├── project.config.json // 项目配置文件

小游戏插件目录一般包括以下两个：

minigame 目录：放置一个小游戏项目，用于调试插件
plugin 目录：插件源码

minigame 目录内容可以当成普通小游戏来编写，用于小游戏插件调试和预览。

在项目的project.config.json中配置

{
    "compileType": "gamePlugin",
    "miniprogramRoot": "minigame/",
    "pluginRoot": "plugin/",
}

在 minigame 目录中的game.json中配置插件信息

{
    "plugins": {
      "layaPlugin": {
        "version": "dev",
        "provider": "your plugin appid"
      }
    }
}

插件代码目录 plugin 中需要有插件配置文件 plugin.json，插件的入口须配置在该文件中。

{
    "main": "index.js"
}

预览、上传和发布

插件可以像小游戏一样预览和上传，但插件没有体验版。

插件上传后需要去QQ小程序开放平台管理端操作上线后方可被使用。

插件会同时有多个线上版本，由使用插件的小游戏决定具体使用的版本号。

QQ小游戏 引擎插件