feat(console,admin): kiosk 不再点击穿透 + 压住任务栏;大屏控制页新增「局域网大屏」(链接/复制/二维码)dev_0.4.0
## ① 现场问题:kiosk 窗口点击穿透(原设计方向反了) `displays.js` 原来对多屏 kiosk 调 `setIgnoreMouseEvents(true)`,注释写的是 「防止现场误触」——但该 API 的语义是「本窗口忽略鼠标」,点击会**落到它后面的 窗口或桌面**,现场想防的误触正好变成误点别的东西;被忽略鼠标的窗口也点不活。 现在窗口**默认吞掉鼠标、不穿透**。 配置项**改名**为 `display.allowClickThrough`(缺省 false;显式 true 才穿透)。 **旧键 `display.ignoreMouse` 完全不读**——老机器的配置文件里还写着旧版模板留下的 `ignoreMouse: true`,而配置策略是「已存在不覆盖」,只改默认值等于老机器升级后 照样穿透;改名才能让默认值真正生效。启动时若发现旧键会记一条中文提示(只记一次), 并在合并后的配置里把它剥掉,防止将来有人再读到那个陈年 true。 (不是自动改写用户配置文件:无法区分「操作员刻意写的 true」与「旧模板留下的 true」。) ## ② 现场问题:任务栏盖住 kiosk 窗口、被盖住后抢不回前台 原顺序是 `setKiosk(true)` 之后又 `setBounds(...)`,在 Windows 上会把窗口从真正的 全屏态拽回「恰好铺满该屏的无边框窗口」→ 不是 topmost,任务栏与拖过去的窗口都盖得住。 现在固定为 **先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后 `setAlwaysOnTop(true, 'screen-saver')`**(默认层级 `floating` 在 Windows 上仍画在任务栏下面),并加了 「已达标就不重复进出 kiosk」的守卫避免重排白闪;非 kiosk 分支会摘掉置顶。 Win 真机行为需现场复核,代码/桩级已验(含顺序与层级的断言)。 ## ③ 新功能:大屏控制页「局域网大屏」卡片 - 服务端新增 `GET /api/system/network`(recorder 及以上):回本机可用局域网 IPv4 (排除回环/link-local/IPv6,去重,按 192.168/10/172.16-31 优先排序)+ 真实监听端口 + 路径;无地址回 `[]` 不报错。 - 卡片:每个地址一条可点击链接 + 复制按钮,第一个地址配二维码(148px)。 - **二维码是离线自实现的纯 TS 编码器**(版本 1–40 自动、ECC L/M/Q/H、8 种掩码择优), 正确性用 **Python OpenCV 真解码**验收:29/29 条解出原文(含中文与边界), SVG 渲染后再解码 4/4,并把验证过的矩阵冻结成仓库参照用例。 - 复制按**非安全上下文**处理:面板常从 `http://192.168.x.x` 打开,那里 `navigator.clipboard` 是 undefined,自动回退 `execCommand('copy')`。 ## ④ 真机联调抓出并修掉一个时序缺陷(真浏览器 + 真服务端) `DisplayPage` 的 `refreshLan()` 在挂载时跑,而 `auth` 是异步加载的——那一刻 `auth.readOnly` 必然为 true,卡片把「当前为只读访客」写进一个**普通 ref** 就返回了, 身份落定后没有任何东西再触发它:**管理员登录后卡片永远停在访客态, `/api/system/network` 一次都没被请求**。 改为「gate 由 computed 直接渲染 + watch gate 变 null 时重跑加载」,并补回归钉子。 (同时修正了一条把该错误结构当成正确行为的源码断言用例。) 端到端证据:真服务 + 局域网 IP(真非安全上下文)→ 卡片列出两个地址、点击复制变 「已复制」(走 execCommand 回退)→ 浏览器渲染的二维码截图经 cv2 解出 `http://10.50.101.85:19861/display`。 ## 文档 部署指南配置表与多屏行为、使用手册「大屏控制」与局域网设备段、devdocs 05/07/10/13、 升级说明新增 dev_0.4.0(含旧键废弃与启动提示)。**无数据迁移**,旧赛事包照常导入。 自检:服务端 13 包 ×2;前端 vue-tsc + 645 例 ×2 + build;Console 20 文件 + 68 例。
This commit is contained in:
1 parent
ed2c0b3f3c
commit
9ef68c2589
33 files changed
+2923
-95
No files matched your search
@@ -11,6 +11,11 @@ const SELECTION = {
|
||||
SPECIFIED: 'specified'
|
||||
}
|
||||
|
||||
// 只比窗口矩形本身:getBounds() 在真实 Electron 里会多带几个键,比整对象会永远判不等
|
||||
function sameBounds(a, b) {
|
||||
return Boolean(a) && a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height
|
||||
}
|
||||
|
||||
// 大屏窗口管理:按显示器枚举结果开窗,绝不写死坐标。
|
||||
// 坐标一律用 DIP(display.bounds),页面内部再用 CSS 缩放适配,两边互不干扰。
|
||||
class DisplayManager {
|
||||
@@ -137,7 +142,9 @@ class DisplayManager {
|
||||
frame: false,
|
||||
// 与 Console 主窗口同一套兜底:个别平台会忽略 frame:false
|
||||
titleBarStyle: 'hidden',
|
||||
kiosk: !single && this.display.kiosk !== false,
|
||||
// 这里刻意不给 kiosk:进 kiosk 必须发生在 setBounds 之后,而 setBounds 与 kiosk
|
||||
// 的先后顺序是「压不压得住任务栏」的关键,只留 applyGeometry 一处去管,
|
||||
// 免得构造函数和 applyGeometry 各设一遍、顺序互相打架
|
||||
autoHideMenuBar: true,
|
||||
backgroundColor: this.display.backgroundColor || '#000000',
|
||||
title: `大屏 · ${page}`,
|
||||
@@ -152,8 +159,17 @@ class DisplayManager {
|
||||
}
|
||||
})
|
||||
|
||||
// 大屏页零交互控件;窗口层再兜一道,防止现场误触鼠标
|
||||
if (!single && this.display.ignoreMouse !== false) {
|
||||
// 大屏页没有可点的控件,但窗口**默认仍然吞掉鼠标**(不穿透)。
|
||||
// 这里原来是「默认 setIgnoreMouseEvents(true)」,方向恰好反了:
|
||||
// setIgnoreMouseEvents(true) 的语义不是「本窗口不吃误触」,而是「本窗口完全忽略鼠标」,
|
||||
// 点击会落到它后面的窗口或桌面上——现场想防的误触反而变成了误点别的东西;
|
||||
// 而且被忽略鼠标的窗口点不活、被盖住后也抢不回前台。
|
||||
// 只有确实要穿透(把大屏当纯展示层、同一块屏上还要操作别的窗口)才显式配
|
||||
// display.allowClickThrough: true,代价见 README。
|
||||
// 旧键 display.ignoreMouse 在这里**完全不读**:老机器的配置文件里还被旧版模板写着
|
||||
// ignoreMouse: true,读它就等于老机器升级后继续穿透(详见 config.js 的 DEFAULTS 注释);
|
||||
// 旧键的存在与否由 config.js 在启动时提示一次,这里不掺和。
|
||||
if (!single && this.display.allowClickThrough === true) {
|
||||
win.setIgnoreMouseEvents(true)
|
||||
}
|
||||
|
||||
@@ -233,15 +249,46 @@ class DisplayManager {
|
||||
}
|
||||
}
|
||||
|
||||
// 把窗口摆到目标屏、并把窗口态调到目标模式。**这里的调用顺序是「大屏能不能压住任务栏」
|
||||
// 的全部理由**,动它之前先读下面 kiosk 分支的注释。
|
||||
applyGeometry(win, display, single) {
|
||||
if (!win || win.isDestroyed()) return
|
||||
if (single) {
|
||||
const bounds = this.geometryFor(display, single)
|
||||
const wantKiosk = !single && this.display.kiosk !== false
|
||||
|
||||
if (!wantKiosk) {
|
||||
// 窗口化(单屏调试态)与「多屏但 display.kiosk=false」:一律不置顶。
|
||||
// 单屏窗口化的 F11 全屏由用户自己控制,置顶会把它变成一块收不掉、盖住一切的覆盖层;
|
||||
// 从 kiosk 退回来的窗口也必须在这里把置顶摘掉,否则会带着 WS_EX_TOPMOST 留在窗口化态
|
||||
if (win.isKiosk()) win.setKiosk(false)
|
||||
if (win.isFullScreen()) win.setFullScreen(false)
|
||||
} else if (this.display.kiosk !== false) {
|
||||
win.setKiosk(true)
|
||||
win.setBounds(bounds)
|
||||
win.setAlwaysOnTop(false)
|
||||
return
|
||||
}
|
||||
win.setBounds(this.geometryFor(display, single))
|
||||
|
||||
// layout() 会因为插拔屏幕/改分辨率/改缩放在运行期反复调用;已经是对的状态就直接返回,
|
||||
// 否则每次重排都要退出再进入一次 kiosk,现场大屏会白闪一下
|
||||
if (win.isKiosk() && win.isAlwaysOnTop() && sameBounds(win.getBounds(), bounds)) return
|
||||
|
||||
// 顺序不能反,三条各自都是一次现场事故:
|
||||
// ① 已经在 kiosk 里就先退出。Windows 上对全屏窗口调 setBounds 会把它从真正的全屏态
|
||||
// 拽回「恰好铺满该屏的无边框窗口」;此时再 setKiosk(true),Electron 侧会因为内部
|
||||
// 仍认为是 kiosk 而直接返回、什么都不做,窗口就永远停在那个假全屏态——它不是
|
||||
// topmost,任务栏(topmost)和任何拖到这块屏上的窗口都能画在它上面;
|
||||
// ② 先 setBounds 定位,后 setKiosk(true) 进全屏。这样窗口进 kiosk 时已经在正确的屏上,
|
||||
// 真正处于全屏态的窗口既压住任务栏,也不会被拖过来的窗口盖住;
|
||||
// ③ 置顶放最后,之后不许再有任何改动窗口几何/窗口态的调用,否则 topmost 可能又丢。
|
||||
if (win.isKiosk()) win.setKiosk(false)
|
||||
if (win.isFullScreen()) win.setFullScreen(false)
|
||||
win.setBounds(bounds)
|
||||
win.setKiosk(true)
|
||||
// 层级必须给 'screen-saver':Windows 上只有 pop-up-menu 及以上才画在任务栏之上,
|
||||
// setAlwaysOnTop(true) 的默认层级 'floating' 仍然在任务栏下面。置顶之后别的窗口
|
||||
// 拖到这块屏上也盖不住它,点一下就能回到最前——大屏没有键盘,这是唯一的抢回前台手段。
|
||||
// 这里不需要再监听 blur 或起定时器补偿:topmost 是 z 序属性、与焦点无关,
|
||||
// 定时重设只会白白抢焦点,属于无因之果
|
||||
win.setAlwaysOnTop(true, 'screen-saver')
|
||||
}
|
||||
|
||||
loadPage(entry, display, page, single) {
|
||||
@@ -357,7 +404,7 @@ class DisplayManager {
|
||||
return { created: true, mode: this.modeOf(entry) }
|
||||
}
|
||||
|
||||
// 关掉某块屏上的大屏窗口:kiosk 窗口刻意忽略鼠标,误开后只能从这里收
|
||||
// 关掉某块屏上的大屏窗口:窗口默认置顶且压住任务栏,误开/要收场时只能从这里收
|
||||
closeDisplay(displayId) {
|
||||
const entry = this.windows.get(displayId)
|
||||
if (!entry) return false
|
||||
|
||||
Reference in new issue
Block a user