tencent cloud

腾讯云超级应用服务

动态与公告
【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
产品简介
产品概述
产品优势
应用场景
购买指南
计费概述
按量计费(后付费)
续费指引
停服说明
快速入门
套餐管理
概述
控制台账号管理
存储配置
加速配置
品牌化配置
平台功能
控制台登录
用户和权限体系
小程序管理
小游戏管理
应用管理
商业化
平台管理
用户管理
团队管理
运营管理
安全中心
代码接入指引
Demo 及 SDK 获取
Android
iOS
Flutter
App 服务端接入指南
GUID 生成规则
小程序开发指南
小程序介绍与开发环境
小程序代码组成
指南
框架
组件
API
服务端
JS SDK
基础库
IDE 使用指南
小游戏开发指南
指南
API
服务端
实践教程
小程序登录实践教程
小程序订阅消息实践教程
支付相关实践教程
广告接入实践教程
小游戏订阅消息实践教程
相关协议
数据处理和安全协议

多进程 Worker

PDF
聚焦模式
字号
最后更新时间: 2025-02-24 17:10:41
对于游戏来说,每帧 16ms 是极其宝贵的,如果有一些可以异步处理的任务,可以放置于 Worker 中运行,待运行结束后,再把结果返回到主线程。
Worker 运行于一个单独的全局上下文与线程中,不能直接调用主线程的方法。
Worker 与主线程之间的数据传输,双方使用 Worker.postMessage() 来发送数据,Worker.onMessage() 来接收数据,传输的数据并不是直接共享,而是被复制的。

使用流程

步骤1. 配置 Worker 信息

game.json 中可配置 Worker 代码放置的目录,目录下的所有 JS 代码最终将被打包成一个 JS 文件:
配置示例:
{
"workers": "workers"
}
通过以上方式配置,workers 目录下的所有 JS 文件会被打包为一个 JS 文件,并作为小游戏首包的一部分。
小游戏首包体积是有上限的(目前为4M),为了使 worker 代码不占用首包体积,从基础库 v2.0.10 开始支持将 worker 代码打包为一个分包。(需要更新开发者工具至最新版本)
worker 代码配置为分包示例:
{
"workers": {
"path": "workers",
"isSubpackage": true // true 表示把 worker 打包为分包。默认 false。填 false 时等同于 { "workers": "workers" }
}
}

步骤2. 添加 Worker 代码文件

根据步骤1中的配置,在代码目录下新建以下两个入口文件:
workers/request/index.js
workers/request/utils.js
workers/response/index.js
添加后,目录结构如下:
├── game.js
├── game.json
├── project.config.json
└── workers
├── request
│ ├── index.js
│ └── utils.js
└── response
└── index.js

步骤3. 编写 Worker 代码

workers/request/index.js 编写 Worker 响应代码。
const utils = require('./utils')
// 在 Worker 线程执行上下文会全局暴露一个 worker 对象,直接调用 worker.onMessage/postMessage 即可
worker.onMessage(function (res) {
console.log(res)
})

步骤4. 在主线程中初始化 Worker

在主线程的代码 game.js 中初始化 Worker。
const worker = wx.createWorker('workers/request/index.js') // 文件名指定 worker 的入口文件路径,绝对路径
从基础库 v2.0.10 开始,如果 worker 代码配置为了分包,则需要先通过 wx.preDownloadSubpackage 接口下载好 worker 代码,再初始化 Worker:
var task = wx.preDownloadSubpackage({
packageType: "workers",
success(res) {
console.log("load worker success", res)
var worker = wx.createWorker("workers/request/index.js") // 创建 worker。 如果 worker 分包没下载完就调 createWorker 的话将报错
},
fail(res) {
console.log("load worker fail", res)
}
})

task.onProgressUpdate(res => {
console.log(res.progress) // 可通过 onProgressUpdate 接口监听下载进度
console.log(res.totalBytesWritten)
console.log(res.totalBytesExpectedToWrite)
})

步骤5. 主线程向 Worker 发送消息

worker.postMessage({
msg: 'hello worker'
})
worker 对象的其它接口请查看 worker接口说明

注意事项

Worker 最大并发数量限制为 1 个,创建下一个前请用 Worker.terminate() 结束当前 Worker;
Worker 内代码只能 require 指定 Worker 路径内的文件,无法引用其它路径;
Worker 的入口文件由 wx.createWorker() 时指定,开发者可动态指定 Worker 入口文件;
Worker 内不支持 wx 系列的 API;
Workers 之间不支持发送消息;
Worker 目录内只支持放置 JS 文件,其他类型的静态文件需要放在 Worker 目录外。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈