多线程 Worker

对于游戏来说,每帧 16ms 是极其宝贵的,如果有一些可以异步处理的任务,可以放置于 Worker) 中运行,待运行结束后,再把结果返回到主线程。Worker) 运行于一个单独的全局上下文与线程中,不能直接调用主线程的方法,Worker) 也不具备渲染的能力。Worker) 与主线程之间的数据传输,双方使用 Worker.postMessage() 来发送数据,Worker.onMessage() 来接收数据,传输的数据并不是直接共享,而是被复制的。

步骤

1. 配置 Worker 信息

game.json 中可配置 Worker) 代码放置的目录,目录下的代码将被打包成一个文件:

配置示例:

  1. {
  2. "workers": "workers"
  3. }
2. 添加 Worker 代码文件

根据步骤 1 中的配置,在代码目录下新建以下两个入口文件:

  1. workers/request/index.js
  2. workers/request/utils.js
  3. workers/response/index.js

添加后,目录结构如下:

  1. ├── game.js
  2. ├── game.json
  3. ├── project.config.json
  4. └── workers
  5. ├── request
  6. ├── index.js
  7. └── utils.js
  8. └── response
  9. └── index.js

3. 编写 Worker 代码

workers/request/index.js 编写 Worker 响应代码

  1. const utils = require('./utils')
  2. // 在 Worker 线程执行上下文会全局暴露一个 `worker` 对象,直接调用 worker.onMeesage/postMessage 即可
  3. worker.onMessage(function (res) {
  4. console.log(res)
  5. })

4. 在主线程中初始化 Worker

在主线程的代码 game.js 中初始化 Worker

  1. const worker = qq.createWorker('workers/request/index.js') // 文件名指定 worker 的入口文件路径,绝对路径

5. 主线程向 Worker 发送消息

  1. worker.postMessage({
  2. msg: 'hello worker'
  3. })

worker 对象的其它接口请看 worker接口说明)

Tips

  • Worker 最大并发数量限制为 1 个,创建下一个前请用 Worker.terminate() 结束当前 Worker
  • Worker 内代码只能 require 指定 Worker 路径内的文件,无法引用其它路径
  • Worker 的入口文件由 qq.createWorker()时指定,开发者可动态指定 Worker 入口文件
  • Worker 内不支持 qq 系列的 API
  • Workers 之间不支持发送消息