esengine/wasm-release/README.md

ECS Framework WASM 支持包

这个包包含了 @esengine/ecs-framework 的 WASM 加速模块。

包含文件

• ecs_wasm_core.js - WASM胶水代码
• ecs_wasm_core.d.ts - TypeScript类型定义
• ecs_wasm_core_bg.wasm - WASM二进制文件
• ecs_wasm_core_bg.wasm.d.ts - WASM类型定义
• package.json - 包信息

使用方法

1. Cocos Creator 3.8+

import { ecsCore } from '@esengine/ecs-framework';

// 1. 将WASM文件导入到项目资源中
// 2. 导入胶水代码
import('./ecs_wasm_core.js').then(({ default: wasmFactory }) => {
    // 3. 使用Cocos API加载WASM文件
    this.loadWasmOrAsm("wasmFiles", "ecs_wasm_core", "your-wasm-uuid").then((wasmFile) => {
        // 4. 初始化WASM支持
        ecsCore.initializeWasm(wasmFactory, wasmFile).then((success) => {
            if (success) {
                console.log("ECS WASM加速已启用");
            } else {
                console.log("回退到JavaScript实现");
            }
        });
    });
});

2. 其他环境（浏览器/Node.js）

import { ecsCore } from '@esengine/ecs-framework';

// 1. 导入胶水代码
import('./ecs_wasm_core.js').then(({ default: wasmFactory }) => {
    // 2. 加载WASM文件
    fetch('./ecs_wasm_core_bg.wasm').then(response => response.arrayBuffer()).then((wasmFile) => {
        // 3. 初始化WASM支持
        ecsCore.initializeWasm(wasmFactory, wasmFile).then((success) => {
            if (success) {
                console.log("ECS WASM加速已启用");
            } else {
                console.log("回退到JavaScript实现");
            }
        });
    });
});

注意事项

1. 如果不使用此WASM包，框架会自动使用JavaScript实现，功能完全正常
2. WASM主要提供查询性能优化，对于大多数应用场景JavaScript实现已足够
3. 确保在ECS系统初始化之前调用initializeWasm方法

技术支持

如遇问题，请访问：

• GitHub Issues
• 主项目文档