pub trait ThreadActor: ActorCore {
// Required method
fn run(self, ctx: ActorContext<Self>);
// Provided method
fn spawn_thread(self, name: &str) -> ActorHandle<Self>
where Self: Send + 'static { ... }
}Expand description
actor 的线程壳。允许 !Send 的资源(GPU 句柄、Rc<RefCell<_>>、阻塞式第三方库)。
不用 Send:整个 actor 只会被搬到一条新线程的栈上,从不跨线程移动。
Required Methods§
Sourcefn run(self, ctx: ActorContext<Self>)
fn run(self, ctx: ActorContext<Self>)
actor 的主循环,阻塞签名。
典型写法:
impl ThreadActor for Player {
fn run(self, mut ctx: ActorContext<Self>) {
loop {
match ctx.recv_cmd_timeout(Duration::from_millis(8)) {
Ok(_cmd) => { /* 处理命令 */ }
Err(CmdWait::Timeout) => { /* 周期性工作:出帧 / 上报进度 */ }
Err(CmdWait::Closed) => break, // stop() 或所有 handle 都没了
_ => break, // CmdWait 是 non_exhaustive,留个兜底
}
}
}
}Provided Methods§
Sourcefn spawn_thread(self, name: &str) -> ActorHandle<Self>where
Self: Send + 'static,
fn spawn_thread(self, name: &str) -> ActorHandle<Self>where
Self: Send + 'static,
在一条新线程上启动 actor,返回控制端。
只对 Send 的 actor 可用。 !Send 的 actor(Rc<...>、GPU 句柄、
阻塞式第三方运行时)不能这样起 —— 实例没法搬进 std::thread 的闭包
(error[E0277]: cannot be sent between threads safely),
请改用 spawn_thread 传工厂,让 actor 在新线程内部构造。
// Worker 是 Send(没有 Rc 之类)→ 可以直接用方法形式
let handle = Worker.spawn_thread("worker");
handle.stop();Dyn Compatibility§
This trait is not dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety".