docs: clarify API request phases and native input ordering
This commit is contained in:
@@ -5,6 +5,10 @@
|
||||
//! shell::app 建立 Client 并发送捕获到的 Input;Client 后台 relay 经 api::RuntimeControl::dispatch_native 交给 worker。
|
||||
//! HTTP 路由也反序列化同一 Input 并调用 validate,但不会走原生 relay 的连续输入版本刷新。
|
||||
//! 这里只合并同目标相邻 pointermove 的绝对采样;滚动/相机的增量逐条保留,不能用最后一个覆盖累计移动。
|
||||
//!
|
||||
//! 队列合并和版本追随是两个独立规则:仅 pointermove 能覆盖队尾采样;原始 pointerdown/up/leave/cancel 也可追随版本,
|
||||
//! 但仍逐条保持顺序。高层 click 不追随,必须用捕获时的按下/释放与几何版本重新确认目标。
|
||||
//! 版本追随只确认原 window/session/Mount 及其能力仍有效,不做重新命中,也不把旧目标换成当前光标下的新对象。
|
||||
use serde::{Deserialize, Serialize};
|
||||
use std::{
|
||||
collections::VecDeque,
|
||||
@@ -277,6 +281,7 @@ impl Inbox {
|
||||
// wait 原子放锁并等待;GUI 生产者可入队,通知后重新取得同一状态锁。
|
||||
q = self.ready.wait(q).ok()?;
|
||||
}
|
||||
// 关闭优先于残留项;正常唤醒后只取队首一个事件,relay 完成这条 worker 回执后才会再次 receive。
|
||||
if q.closed { None } else { q.items.pop_front() }
|
||||
}
|
||||
}
|
||||
@@ -304,6 +309,7 @@ impl Client {
|
||||
while let Some(mut input) = receiver.receive() {
|
||||
// 每条输入出队时再看最新权威发布帧,连续采样不沿用排队前已经过时的布局版本。
|
||||
if let Ok(current) = namespace.read() {
|
||||
// 这里只更新允许类别的 layout_version;下面 worker 接纳输入时还会再次读取权威帧,覆盖 relay 排队期间的新变化。
|
||||
if !refresh_continuous_input(&mut input, ¤t) {
|
||||
// 目标消失/换会话时丢弃,不能把旧手势重定向到同位置的新出现。
|
||||
continue;
|
||||
@@ -329,6 +335,7 @@ impl Client {
|
||||
return false;
|
||||
};
|
||||
if q.closed {
|
||||
// 最后一个生产者已关闭队列,不能因新的 send 再唤醒 relay 并恢复过期输入流。
|
||||
return false;
|
||||
}
|
||||
// enqueue 的覆盖合并也算接收成功,relay 会读取最终最新样本。
|
||||
|
||||
Reference in New Issue
Block a user