stateroom-wasm

stateroom-wasm 是 stateroom 的配套包，可以帮助您将服务打包并导出为 WebAssembly 模块。

#[stateroom_wasm] 宏

为了使 Stateroom 服务器能够理解它们，WebAssembly 模块必须导入和导出某些命名的函数。 stateroom_wasm 提供了 #[stateroom_wasm] 模块，该模块应应用于实现 SimpleStateroomService 的项（结构体、枚举或类型别名）。

一个兼容 Stateroom 的 WebAssembly 模块必须恰好包含一个服务。如果您需要为您的应用程序生成多个服务，目前最好的方法是为每个服务创建一个包。

可以使用类型别名生成属于另一个模块的服务绑定

use stateroom_wasm::stateroom_wasm;
use some_module::SomeService;

#[stateroom_wasm]
type Service = SomeService;

执行模型

在初始化时，生成的模型通过调用其 new(room_id, context) 构造函数来创建您的 SimpleStateroomService 实例。在构造函数和后续函数调用中传递的上下文对象是一个全局静态对象，它绑定到从宿主环境导入的函数（如 send_message）。

编译

如果您使用 Stateroom 命令行界面，stateroom dev 将使用 wasm32-wasi 目标构建当前包，然后加载和提供生成的 WebAssembly 模块。

如果您想手动构建，请确保已安装 wasm32-wasi 目标，并将其作为目标传递给 cargo build

$ rustup target add wasm32-wasi
$ cargo build --release --target=wasm32-wasi

嵌入

此包有一个对应的包，stateroom-wasm-host，它可以接受使用此包生成的模块，并通过 StateroomService 接口公开它。