128 lines
4.4 KiB
TypeScript
128 lines
4.4 KiB
TypeScript
|
/**
|
|||
|
|
* WasmLoader 使用示例
|
|||
|
|
*
|
|||
|
|
* 这个文件展示如何使用 WasmLoader 来加载 WASM 模块
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
import { wasmLoader } from './WasmLoader';
|
|||
|
|
|
|||
|
|
// 假设我们有一个 WASM 工厂函数（需要从 JS 胶水代码中导入）
|
|||
|
|
// import wasmFactory from '../path/to/your-wasm-module.js';
|
|||
|
|
|
|||
|
|
export class WasmLoaderExample {
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 示例1: 加载简单的 WASM 模块
|
|||
|
|
*/
|
|||
|
|
async loadSimpleWasmExample(wasmFactory: any) {
|
|||
|
|
try {
|
|||
|
|
// 首先需要初始化加载器（通常在应用启动时执行一次）
|
|||
|
|
wasmLoader.initialize();
|
|||
|
|
|
|||
|
|
// 假设你有一个 WASM 工厂函数
|
|||
|
|
// const wasmFactory = (await import('../wasm/pinball_physics.js')).default;
|
|||
|
|
|
|||
|
|
// 加载 WASM 模块
|
|||
|
|
const instance = await wasmLoader.loadSimpleWasm(
|
|||
|
|
wasmFactory, // WASM 工厂函数
|
|||
|
|
'pinball_physics.wasm', // WASM 文件名
|
|||
|
|
'44cacb3c-e901-455d-b3e1-1c38a69718e1', // 编辑器中的 UUID（可选）
|
|||
|
|
'wasmFiles' // Bundle 名称（可选）
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 现在可以使用 WASM 模块的函数
|
|||
|
|
console.log('WASM 模块加载成功:', instance);
|
|||
|
|
|
|||
|
|
return instance;
|
|||
|
|
} catch (error) {
|
|||
|
|
console.error('WASM 加载失败:', error);
|
|||
|
|
throw error;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 示例2: 加载支持 ASM 回退的 WASM 模块
|
|||
|
|
*/
|
|||
|
|
async loadWasmWithFallbackExample(wasmFactory: any, asmFactory: any) {
|
|||
|
|
try {
|
|||
|
|
wasmLoader.initialize();
|
|||
|
|
|
|||
|
|
// 假设你有 WASM 和 ASM 工厂函数
|
|||
|
|
// const wasmFactory = (await import('../wasm/pinball_physics.js')).default;
|
|||
|
|
// const asmFactory = (await import('../wasm/pinball_physics.asm.js')).default;
|
|||
|
|
|
|||
|
|
const result = await wasmLoader.loadWasmWithAsmFallback(
|
|||
|
|
wasmFactory, // WASM 工厂函数
|
|||
|
|
asmFactory, // ASM 工厂函数
|
|||
|
|
'pinball_physics.wasm', // WASM 文件名
|
|||
|
|
'pinball_physics.asm.mem', // ASM 内存文件名
|
|||
|
|
'44cacb3c-e901-455d-b3e1-1c38a69718e1', // WASM UUID
|
|||
|
|
'3400003e-dc3c-43c1-8757-3e082429125a', // ASM UUID
|
|||
|
|
'wasmFiles' // Bundle 名称
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
console.log('模块加载成功，使用的是:', result.isWasm ? 'WASM' : 'ASM');
|
|||
|
|
console.log('模块实例:', result.instance);
|
|||
|
|
|
|||
|
|
return result;
|
|||
|
|
} catch (error) {
|
|||
|
|
console.error('模块加载失败:', error);
|
|||
|
|
throw error;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 示例3: 检查平台支持情况
|
|||
|
|
*/
|
|||
|
|
checkPlatformSupport() {
|
|||
|
|
const isWasmSupported = wasmLoader.isWasmSupported();
|
|||
|
|
const strategy = wasmLoader.getRecommendedStrategy();
|
|||
|
|
|
|||
|
|
console.log('WASM 支持:', isWasmSupported);
|
|||
|
|
console.log('推荐策略:', strategy);
|
|||
|
|
|
|||
|
|
return { isWasmSupported, strategy };
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 示例4: 高级用法 - 自定义配置
|
|||
|
|
*/
|
|||
|
|
async loadCustomWasm(wasmFactory: any, asmFactory: any) {
|
|||
|
|
try {
|
|||
|
|
wasmLoader.initialize();
|
|||
|
|
|
|||
|
|
// 使用完整配置
|
|||
|
|
const result = await wasmLoader.loadWasmModule({
|
|||
|
|
fileName: 'pinball_physics.wasm',
|
|||
|
|
bundleName: 'wasmFiles',
|
|||
|
|
editorUuid: '44cacb3c-e901-455d-b3e1-1c38a69718e1',
|
|||
|
|
supportAsm: true,
|
|||
|
|
asmFileName: 'pinball_physics.asm.mem',
|
|||
|
|
asmEditorUuid: '3400003e-dc3c-43c1-8757-3e082429125a',
|
|||
|
|
wasmFactory: wasmFactory,
|
|||
|
|
asmFactory: asmFactory
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
return result;
|
|||
|
|
} catch (error) {
|
|||
|
|
console.error('自定义 WASM 加载失败:', error);
|
|||
|
|
throw error;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 使用说明:
|
|||
|
|
*
|
|||
|
|
* 1. 首先将 WASM 文件和对应的 JS 胶水代码放到项目中
|
|||
|
|
* 2. 将 .wasm 文件导入到编辑器的资源管理器中
|
|||
|
|
* 3. 在编辑器中获取 .wasm 文件的 UUID
|
|||
|
|
* 4. 导入 JS 胶水代码并获取工厂函数
|
|||
|
|
* 5. 调用 wasmLoader 的方法加载 WASM 模块
|
|||
|
|
*
|
|||
|
|
* 注意事项:
|
|||
|
|
* - 在编辑器环境下需要提供资源的 UUID
|
|||
|
|
* - 在运行时环境下需要提供 Bundle 名称和文件名
|
|||
|
|
* - iOS 平台不支持 WASM，需要提供 ASM 回退
|
|||
|
|
* - 确保在使用前调用 initialize() 方法
|
|||
|
|
*/
|