From c057cbdad26be698d13c05aa9814e5e57577fa7e Mon Sep 17 00:00:00 2001 From: zm2000 <18386612143@163.com> Date: Wed, 23 Sep 2026 17:11:34 +0800 Subject: [PATCH] =?UTF-8?q?feat(packaging):=20=E6=89=93=E5=8C=85=E9=A1=B5?= =?UTF-8?q?=E8=AF=AD=E9=9F=B3=E6=92=AD=E6=8A=A5=E5=8E=BB=E9=87=8D=E4=B8=8E?= =?UTF-8?q?=E4=B8=B2=E8=A1=8C=E9=98=9F=E5=88=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 全局 showToast 拦截器支持 silentVoice 标志,跳过重复播报 - 打包页新增语音串行队列,连扫时不打断、只保留最新待播 - speak() 重构,非 HTTP 通道按语速估时取下一条 - 工牌码支持重复扫码切换上线/下线 - 绑定成功播报带上操作员姓名,核实类 toast 统一为「数据一致」 - 新增 docs/packaging-voice-flow.md 播报流程说明 --- docs/packaging-voice-flow.md | 210 ++++++++++++++++++++++++++++++++++ src/main.js | 6 +- src/pages/packaging/index.vue | 116 ++++++++++++++----- 3 files changed, 301 insertions(+), 31 deletions(-) create mode 100644 docs/packaging-voice-flow.md diff --git a/docs/packaging-voice-flow.md b/docs/packaging-voice-flow.md new file mode 100644 index 0000000..2c06e3b --- /dev/null +++ b/docs/packaging-voice-flow.md @@ -0,0 +1,210 @@ +# 打包业务语音播报流程说明 + +> 范围:仓库打包业务页 `src/pages/packaging/index.vue`(工作台打包模式)。 +> 说明:行号为当前版本(1.0.28)源码位置,随代码变更可能漂移,以方法名为准。 + +--- + +## 一、播报架构总览 + +打包业务存在 **两条互相独立的语音播报链路**,叠加生效: + +1. **页面主动播报链路** `speak()`:打包页在关键业务节点主动调用 `this.speak(文案)`,自带 HTTP 语音接口 / 原生 TTS / Web Speech 三级降级。 +2. **全局 toast 拦截播报链路**:`src/main.js` 在应用启动时接管了全局 `uni.showToast`,任何 toast 都会同步调用 `getVoice().play(title)`(`src/core/voice.js`)做一次语音播报。 + +```mermaid +flowchart LR + A[打包业务节点] --> B[this.speak 文案] + A --> C[uni.showToast 文案
silentVoice: true] + B --> D[speak 链路
HTTP → 原生TTS → WebSpeech] + C --> E[main.js 全局拦截器] + E -- silentVoice 跳过 --> X[不再重复播报] +``` + +> **双重播报已去重**:打包页所有「`speak(x)` + `showToast(x)`」成对节点,toast 均带 `silentVoice: true`,全局拦截器检测到该标志后跳过播报,同一文案只由 `speak()` 播一遍。 + +--- + +## 二、主动播报链路 `speak()` + +定义于 `packaging/index.vue` 的 `methods.speak`(约 1185 行)。 + +### 2.1 入口与文案截断 + +``` +speak(text) + ├─ 空文本 → 直接 return + └─ str.length > 12 → 截断为「前 12 字 + 等」 +``` + +- 截断规则:`str.slice(0, 12) + '等'`,防止长文案播报啰嗦。 +- 当前所有业务文案均在 12 字以内(最长「绑定失败,请点击绑定重试」「已结束打包并下线全部成员」正好 12 字),暂不触发截断。 + +### 2.2 平台分支 + +```mermaid +flowchart TD + S[speak text] --> P{编译平台} + P -- APP-PLUS 安卓App --> H[speakViaHttp HTTP 语音接口] + P -- H5 / Electron --> W[speakViaTtsOrWebSpeech] + H -- 成功 --> END[播放完成] + H -- 失败 --> W + W --> T{ttsEngine 且 ttsReady} + T -- 是 --> N[speakNativeTts 原生 TTS] + T -- 否 --> WS[speakViaWebSpeech Web Speech] +``` + +### 2.3 各子方法职责 + +| 方法 | 职责 | 关键实现 | +| --- | --- | --- | +| `speak(text)` | 播报总入口 | 文本清洗 + 12 字截断 + 平台分流 | +| `speakViaHttp(msg)` | HTTP 语音接口(APP 首选) | GET `VOICE_API_URL + encodeURIComponent(msg)`,返回 `{audio}` 后用 `playVoiceAudio` 播放 | +| `playVoiceAudio(src, onEnd)` | 音频播放 | `uni.createInnerAudioContext`,销毁旧实例再播,`onEnded`/`onError` 回调 | +| `speakViaTtsOrWebSpeech(text)` | TTS 兜底 | 有引擎且就绪→原生 TTS;引擎未就绪→暂存到 `ttsPendingText`;无引擎→Web Speech | +| `speakNativeTts(text)` | Android 原生 TTS | `TextToSpeech.QUEUE_FLUSH=0` 清队列后播报 | +| `speakViaWebSpeech(text)` | Web Speech 降级 | `window.speechSynthesis`,`lang='zh-CN'` | +| `initNativeTts()` | 初始化原生 TTS | `plus.android.importClass('android.speech.tts.TextToSpeech')` + `OnInitListener` | +| `shutdownNativeTts()` | 释放 TTS | `stop()` + `shutdown()` + 清空字段 | +| `destroyVoiceAudio()` | 释放音频实例 | `stop()` + `destroy()` | + +### 2.4 HTTP 语音接口(解决平板缺中文语音包) + +- 常量(约 358 行): + - `VOICE_API_URL = 'http://tbdata.gztbyc.com/voice/'` + - `VOICE_API_PATH = 'http://tbdata.gztbyc.com'` +- 请求:`uni.request`,GET `VOICE_API_URL + encodeURIComponent(msg)`,`timeout: 3000`,header `content-type: text/xml; charset=utf-8`。 +- 响应:`res.data.audio` 为音频相对路径,拼 `VOICE_API_PATH + audio` 得完整 src。 +- 兜底:5 秒超时定时器,播放未结束也视为完成,避免一直等待。 +- 失败判定:请求 fail / 未返回 `audio` 字段 / 音频播放 error → `finish(false)` → 触发 TTS 降级。 + +### 2.5 Android 原生 TTS(HTTP 失败后的兜底) + +- 初始化:`initNativeTts()` 在 `mounted` 调用;`TextToSpeech(activity, OnInitListener)`。 +- 就绪条件:`onInit` 回调 `status===0` 且 `setLanguage(Locale.CHINA)` 返回值 `>= 0` 才置 `ttsReady=true`。 +- 关键坑:**平板缺中文语音包时 `setLanguage` 返回 -2(不支持)→ `ttsReady=false`**,只能依赖 HTTP 接口发声;引擎未就绪期间只保留最后一条文案到 `ttsPendingText`,就绪后补播。 +- 释放:`beforeUnmount` 调 `shutdownNativeTts()`。 + +### 2.6 Web Speech(最终兜底) + +- 仅 `typeof window !== 'undefined' && window.speechSynthesis` 可用。 +- Android App WebView 内 `window.speechSynthesis` 通常不可用 → 真机主要依赖 HTTP 接口 / 原生 TTS。 + +### 2.7 生命周期 + +| 时机 | 动作 | +| --- | --- | +| `mounted` | `initNativeTts()` 初始化 TTS | +| `beforeUnmount` | `shutdownNativeTts()` + `destroyVoiceAudio()` 释放 | + +--- + +## 三、全局 toast 播报链路 + +### 3.1 机制(`src/main.js` + `src/core/voice.js`) + +- `main.js` 在应用启动时覆盖 `uni.showToast`:每次 toast 取 `title`,调用 `getVoice().play(title)`。 +- `core/voice.js` 的 `Voice` 类(单例): + - 请求 `GET http://tbdata.gztbyc.com/voice/{msg}`(注意:**msg 未 encodeURIComponent**,与打包页 `speakViaHttp` 的 `encodeURIComponent(msg)` 不同)。 + - 返回 `{audio}` → `VOICE_BASE + audio` → `uni.createInnerAudioContext().play()`。 +- 注释明确其用途:「仅播放语音,不弹 toast,避免与全局 showToast 拦截器互相递归」。 + +### 3.2 与 `speak()` 的关系 + +| 对比项 | 打包页 `speak()` | 全局拦截器 `getVoice().play()` | +| --- | --- | --- | +| 触发方式 | 业务节点显式调用 | 任何 `uni.showToast` 自动触发 | +| 文案编码 | `encodeURIComponent(msg)` | 未编码 | +| 降级链 | HTTP → 原生 TTS → Web Speech | 仅 HTTP,失败静默 | +| 适用范围 | 仅打包页 | 全应用所有页面 | + +--- + +## 四、业务触发点全景 + +> 每个节点均为「语音文案 + 伴随 toast 文案」。`speakText` 表示来自 `checkOrderBlocked()` 返回的动态文案。 + +### 4.1 操作员绑定 / 下线 + +| # | 触发方法(行) | 触发条件 | 语音文案 | 伴随 toast | +| --- | --- | --- | --- | --- | +| 1 | `handlePackSearch`(683) | 扫码且无在线成员、非工牌码,拦截 | 需要先登录 | 需要先登录 | +| 2 | `queryPackOrderByCode`(706) | 未绑定操作员时禁止查询订单 | 未绑定操作员 | 请先绑定操作员 | +| 3 | `handleBadgeScan`(2482) | 工牌查询失败(failure/404 未找到用户) | 未绑定操作员 | 未找到该用户 | +| 4 | `doBindOperator`(2552) | 绑定接口 flag=failure | 绑定失败,请点击绑定重试 | 后端失败文案/绑定失败 | +| 5 | `doBindOperator`(2574) | 绑定成功 | 操作员姓名+绑定成功 | 绑定成功 | +| 6 | `doRemoveOperator`(2652) | 下线接口 flag=failure | 下线失败 | 后端失败文案/下线失败 | +| 7 | `doRemoveOperator`(2676) | 下线成功 | 操作员姓名+下线成功 | 操作员已下线 | +| 8 | `doRemoveOperator`(2684) | 下线返回 removed=0(未找到成员) | 下线失败 | 未找到该成员 | +| 9 | `doRemoveOperator`(2690) | 下线接口异常 | 下线失败 | 网络异常,请稍后重试 | + +### 4.2 运单查询与预检 + +| # | 触发方法(行) | 触发条件 | 语音文案 | 伴随 toast | +| --- | --- | --- | --- | --- | +| 10 | `applyQueryResult`(817) | 工作台已解绑(401/403) | 无记录 | — | +| 11 | `applyQueryResult`(821) | 查询 flag=failure(未找到订单) | 无记录 | 未找到对应订单(>24 字则截断) | +| 12 | `applyQueryResult`(935) | 预检未通过 | `precheck.speakText`(见下) | `precheck.reason` | +| 13 | `applyQueryResult`(942) | 重复查询正在打包的同一单 | 正在打包 | 正在打包 | + +**预检文案来源 `checkOrderBlocked()`**: + +| 场景 | `speakText`(语音) | `reason`(toast) | +| --- | --- | --- | +| 团单/散单 未复核 | 订单未复核,禁止打包 | 订单未复核,禁止打包 | +| 团单/散单 已打包(非重复查询) | 已打包 | 订单已打包,禁止打包 | +| 散单 已拦截 | 订单已拦截,禁止打包 | 订单已拦截,禁止打包 | + +### 4.3 团单商品核实 + +| # | 触发方法(行) | 触发条件 | 语音文案 | 伴随 toast | +| --- | --- | --- | --- | --- | +| 14 | `matchProductBarcode`(965) | 条码匹配但该商品已核实(重复扫) | 数据一致 | `xxx 已核实` | +| 15 | `matchProductBarcode`(973) | 条码匹配、标记已核实 | 数据一致 | `xxx 已核实` | +| 16 | `matchProductBarcode`(978) | 条码与待核实商品不匹配 | 无记录 | 条码与待核实商品不匹配 | +| 17 | `handleLongPressProduct`(1003) | 长按免验通过 | 免验通过 | `「xxx」免验通过` | +| 18 | `confirmCancelVerify`(1029) | 取消核实 | 已取消核实 | 已取消核实 | + +### 4.4 开始打包与自动登出 + +| # | 触发方法(行) | 触发条件 | 语音文案 | 伴随 toast | +| --- | --- | --- | --- | --- | +| 19 | `startPack`(1136) | 上报开始打包成功(`reportPackOrder(1)` 成功) | 开始打包 | 开始打包 | +| 20 | `autoLogoutForIdle`(2946) | 30 分钟无新任务自动登出全部成员 | 已结束打包并下线全部成员 | 长时间无新打包任务,已自动下线 | + +--- + +## 五、播报文案汇总(去重后) + +| 文案 | 出现节点 | 语义 | +| --- | --- | --- | +| 需要先登录 | 1 | 未绑定且扫码非工牌 | +| 未绑定操作员 | 2、3 | 未绑定即查单 / 工牌未找到用户 | +| 操作员姓名+绑定成功 | 5 | 操作员绑定成功 | +| 绑定失败,请点击绑定重试 | 4 | 绑定失败 | +| 操作员姓名+下线成功 | 7 | 操作员下线成功 | +| 下线失败 | 6、8、9 | 下线失败 | +| 无记录 | 10、11、16 | 查无订单 / 条码不匹配 | +| 订单未复核,禁止打包 | 12 | 预检:未复核 | +| 已打包 | 12 | 预检:已打包 | +| 订单已拦截,禁止打包 | 12 | 预检:散单已拦截 | +| 正在打包 | 13 | 重复查询同一单 | +| 数据一致 | 14、15 | 商品核实一致 | +| 免验通过 | 17 | 长按免验 | +| 已取消核实 | 18 | 取消团单核实 | +| 开始打包 | 19 | 开始打包上报成功 | +| 已结束打包并下线全部成员 | 20 | 空闲自动登出 | + +--- + +## 六、注意事项与已知问题 + +1. **双重播报(已修复,2026-09-23)**:业务节点原本 `speak(x)` + `showToast(x)` 成对出现,而 `showToast` 被 `main.js` 全局接管会再次播报 → 同一文案播两遍。 + - 修复方案:`main.js` 拦截器新增 `silentVoice` 跳过标志;打包页 19 处成对 toast 均加 `silentVoice: true`,语音统一由 `speak()` 三级降级链路播报。 + - 保留的独立 toast(无 `silentVoice`)仍走全局 `getVoice().play()` 播报。 +2. **平板缺中文语音包**:原生 TTS `setLanguage(Locale.CHINA)` 返回 -2,`ttsReady=false`,必须依赖 HTTP 语音接口 `tbdata.gztbyc.com` 才能发声(实测结论,见仓库记忆)。 +3. **URL 编码不一致**:打包页 `speakViaHttp` 对文案做 `encodeURIComponent`,而 `core/voice.js` 的 `play()` 未编码,含中文/特殊字符文案在两链路下的请求 URL 不同,后端需同时兼容。 +4. **长文本截断**:`speak()` 对 >12 字文案截断为「前 12 字 + 等」;当前所有文案均 ≤12 字,未触发。 +5. **HTTP 接口超时**:请求 timeout 3000ms + 播放 5s 兜底;接口不可达时自动降级 TTS/Web Speech,不影响业务流程。 +6. **资源释放**:页面卸载时 `shutdownNativeTts()` + `destroyVoiceAudio()`,避免音频实例泄漏。 +7. **APP-PLUS 与 H5 差异**:Electron/H5 端跳过 HTTP 接口直接走 TTS/Web Speech(`#ifdef APP-PLUS` 条件编译)。 diff --git a/src/main.js b/src/main.js index 1773750..5bae81d 100644 --- a/src/main.js +++ b/src/main.js @@ -50,14 +50,16 @@ try { // 全局提示语音:所有 uni.showToast 同时语音播报(仓库作业场景,语音提示来自散单项目方案) const originalShowToast = uni.showToast uni.showToast = function (options) { - const title = typeof options === 'string' ? options : options && options.title + const isObj = options && typeof options === 'object' + const title = typeof options === 'string' ? options : isObj ? options.title : '' let result try { result = originalShowToast.call(uni, options) } catch (error) { // toast 异常时保持原行为 } - if (title) { + // silentVoice: true 表示调用方已主动语音播报(如打包页 speak),此处不再重复播报 + if (title && !(isObj && options.silentVoice)) { try { getVoice().play(title) } catch (error) { diff --git a/src/pages/packaging/index.vue b/src/pages/packaging/index.vue index 50351c3..7867f3f 100644 --- a/src/pages/packaging/index.vue +++ b/src/pages/packaging/index.vue @@ -464,6 +464,10 @@ export default { ttsReady: false, ttsPendingText: '', voiceAudioContext: null, + // 语音播报串行队列状态 + voicePlaying: false, + voicePendingText: '', + voiceNextTimer: null, } }, computed: { @@ -681,7 +685,7 @@ export default { this.keyword = '' this.lastScannedCode = '' this.speak('需要先登录') - uni.showToast({ title: '需要先登录', icon: 'none' }) + uni.showToast({ title: '需要先登录', icon: 'none', silentVoice: true }) this.scheduleScanInputFocus(150) return } @@ -704,7 +708,7 @@ export default { // 未绑定操作员时禁止查询订单,避免绕过绑定流程直接查询 if (!this.workbenchMembers.length) { this.speak('未绑定操作员') - uni.showToast({ title: '请先绑定操作员', icon: 'none' }) + uni.showToast({ title: '请先绑定操作员', icon: 'none', silentVoice: true }) return } const token = this.getWorkbenchToken() @@ -824,6 +828,7 @@ export default { uni.showToast({ title: String(failMsg).length > 24 ? '未找到对应订单' : failMsg, icon: 'none', + silentVoice: true, }) return } @@ -933,14 +938,14 @@ export default { const precheck = this.packPrecheck() if (!precheck.ok) { this.speak(precheck.speakText) - uni.showToast({ title: precheck.reason, icon: 'none' }) + uni.showToast({ title: precheck.reason, icon: 'none', silentVoice: true }) return } this.precheckPassed = true // 重复查询正在打包的同一单:保持打包中,不重复上报、不重新复核 if (this.sameOrderQuery && this.packStarted) { this.speak('正在打包') - uni.showToast({ title: '正在打包', icon: 'none' }) + uni.showToast({ title: '正在打包', icon: 'none', silentVoice: true }) return } if (this.isGroupOrder) { @@ -963,7 +968,7 @@ export default { if (this.isItemScanned(target)) { this.keyword = '' this.speak('数据一致') - uni.showToast({ title: `${target.name || ''} 已核实`, icon: 'none' }) + uni.showToast({ title: '数据一致', icon: 'none', silentVoice: true }) return } // 按商品种类:扫 1 次即标记为已核实,无需扫满数量 @@ -971,12 +976,12 @@ export default { this.addScanRecord(barcode) this.keyword = '' this.speak('数据一致') - uni.showToast({ title: `${target.name || ''} 已核实`, icon: 'none' }) + uni.showToast({ title: '数据一致', icon: 'none', silentVoice: true }) // 全部核实后自动开始打包 this.maybeAutoSubmitGroupPack() } else { this.speak('无记录') - uni.showToast({ title: '条码与待核实商品不匹配', icon: 'none' }) + uni.showToast({ title: '条码与待核实商品不匹配', icon: 'none', silentVoice: true }) } }, isItemScanned(item) { @@ -1001,7 +1006,7 @@ export default { item.scannedQty = total this.addScanRecord(`免验:${item.name || item.barcode || ''}`) this.speak('免验通过') - uni.showToast({ title: `「${item.name || ''}」免验通过`, icon: 'none' }) + uni.showToast({ title: `「${item.name || ''}」免验通过`, icon: 'none', silentVoice: true }) // 全部核实后自动开始打包 this.maybeAutoSubmitGroupPack() }, @@ -1027,7 +1032,7 @@ export default { this.clearPackState() this.cancelVerifyPopupOpen = false this.speak('已取消核实') - uni.showToast({ title: '已取消核实', icon: 'none' }) + uni.showToast({ title: '已取消核实', icon: 'none', silentVoice: true }) }, /** * 打包预检(本地判断,基于 queryOrder 返回字段) @@ -1134,7 +1139,7 @@ export default { // 有新打包任务:重置 30 分钟无新任务自动登出计时 this.scheduleIdleAutoLogout() this.speak('开始打包') - uni.showToast({ title: '开始打包', icon: 'none' }) + uni.showToast({ title: '开始打包', icon: 'none', silentVoice: true }) }) .catch((err) => { uni.showToast({ title: err?.message || '打包上报失败', icon: 'none' }) @@ -1183,34 +1188,80 @@ export default { this.packStarted = false }, speak(text) { - console.log('[语音播报] speak 入口:', String(text)) - let str = String(text || '').trim() + const str = this.normalizeSpeakText(text) if (!str) { return } + // 正在播报:不打断当前音频,只保留最新一条待播(快速连扫时合并为最后一条) + if (this.voicePlaying) { + this.voicePendingText = str + console.log('[语音播报] 正在播报,暂存待播文本:', str) + return + } + this.voicePlaying = true + this.playSpeakText(str) + }, + normalizeSpeakText(text) { + let str = String(text || '').trim() + if (!str) { + return '' + } // 长文本缩减:语音播报过长很啰嗦,超过 12 字符截断并以“等”收尾 if (str.length > 12) { str = str.slice(0, 12) + '等' } + return str + }, + /** + * 播报单条文本(串行队列执行单元) + * APP-PLUS:优先 HTTP 语音接口,失败兜底本地 TTS / Web Speech + * 非 APP:直接走 TTS / Web Speech,按语速估时后取下一条 + */ + playSpeakText(str) { + console.log('[语音播报] 开始播报:', str) // #ifdef APP-PLUS - // 优先 HTTP 语音接口(平板缺中文语音包时仍可发声),失败再走本地 TTS / Web Speech this.speakViaHttp(str).then((ok) => { console.log('[语音播报] HTTP 语音接口结果:', ok) if (!ok) { this.speakViaTtsOrWebSpeech(str) + // 原生 TTS / Web Speech 无结束回调,按语速估时后再取下一条 + this.voiceNextTimer = setTimeout(() => this.scheduleNextSpeak(), this.estimateSpeakMs(str)) + return } + this.scheduleNextSpeak() }) + return // #endif // #ifndef APP-PLUS this.speakViaTtsOrWebSpeech(str) + this.voiceNextTimer = setTimeout(() => this.scheduleNextSpeak(), this.estimateSpeakMs(str)) // #endif }, + scheduleNextSpeak() { + const next = this.voicePendingText + this.voicePendingText = '' + if (next) { + console.log('[语音播报] 播放待播文本:', next) + this.playSpeakText(next) + } else { + this.voicePlaying = false + } + }, + estimateSpeakMs(str) { + // 按中文语速粗略估算播放时长:每字约 300ms,下限 500ms,上限 4000ms + return Math.min(4000, Math.max(500, String(str || '').length * 300)) + }, speakViaHttp(msg) { return new Promise((resolve) => { let settled = false + let timeoutTimer = null const finish = (ok) => { if (!settled) { settled = true + if (timeoutTimer) { + clearTimeout(timeoutTimer) + timeoutTimer = null + } resolve(ok) } } @@ -1231,7 +1282,7 @@ export default { console.log('[语音播报] HTTP 音频地址:', src) this.playVoiceAudio(src, finish) // 超时兜底:5 秒后仍未播放完成也视为完成,避免一直等待 - setTimeout(() => finish(true), 5000) + timeoutTimer = setTimeout(() => finish(true), 5000) } catch (e) { console.error('[语音播报] HTTP 接口解析异常:', e) finish(false) @@ -1272,6 +1323,12 @@ export default { } }, destroyVoiceAudio() { + if (this.voiceNextTimer) { + clearTimeout(this.voiceNextTimer) + this.voiceNextTimer = null + } + this.voicePlaying = false + this.voicePendingText = '' if (this.voiceAudioContext) { try { this.voiceAudioContext.stop() @@ -2480,7 +2537,7 @@ export default { if (flag === 'failure' || Number(bizCode) === 404) { this.keyword = '' this.speak('未绑定操作员') - uni.showToast({ title: '未找到该用户', icon: 'none' }) + uni.showToast({ title: '未找到该用户', icon: 'none', silentVoice: true }) return } const realName = this.pickInfoField(raw, body, [ @@ -2505,10 +2562,7 @@ export default { // 同一用户已在线 → 下线该成员 if (member) { this.keyword = '' - this.doRemoveOperator(member.id, { - speakText: '操作员已下线', - toastText: '操作员已下线', - }) + this.doRemoveOperator(member.id) return } // 未在线 → 登录(绑定为在线成员,userId 取 user_id) @@ -2522,6 +2576,8 @@ export default { }) .finally(() => { this.badgeHandling = false + // 工牌码支持重复扫码切换上线/下线:处理完清空上次扫码缓存,允许下次扫同一码再次触发 + this.lastScannedCode = '' }) }, doBindOperator(realName, wmsAccountId) { @@ -2550,7 +2606,7 @@ export default { } if (flag === 'failure') { this.speak('绑定失败,请点击绑定重试') - uni.showToast({ title: body?.message || body?.msg || '绑定失败', icon: 'none' }) + uni.showToast({ title: body?.message || body?.msg || '绑定失败', icon: 'none', silentVoice: true }) return } const member = { @@ -2571,8 +2627,8 @@ export default { uni.setStorageSync(MEMBER_STORAGE_KEY, list) // 清空主搜索框(扫码内容为临时码/工牌,绑定后应清空) this.keyword = '' - this.speak('绑定成功') - uni.showToast({ title: '绑定成功', icon: 'none' }) + this.speak(`${member.user_name || realName || ''}绑定成功`) + uni.showToast({ title: '绑定成功', icon: 'none', silentVoice: true }) // 主搜索框扫码绑定:关闭弹窗 this.closeOperatorDialog() // 上线后重新拉取工作台信息,以服务端成员列表为准 @@ -2615,7 +2671,7 @@ export default { * - 全员下线后清空订单/核实数据,防止残留给下一批操作员 */ async doRemoveOperator(memberId, options = {}) { - const { silent = false, speakText = '', toastText = '' } = options + const { silent = false, toastText = '' } = options const token = this.getWorkbenchToken() if (!token) { if (!silent) { @@ -2650,13 +2706,15 @@ export default { if (flag === 'failure') { if (!silent) { this.speak('下线失败') - uni.showToast({ title: body?.message || body?.msg || '下线失败', icon: 'none' }) + uni.showToast({ title: body?.message || body?.msg || '下线失败', icon: 'none', silentVoice: true }) } return 'failed' } const removed = Number(raw?.removed ?? body?.removed ?? 0) if (removed > 0) { const list = Array.isArray(this.workbenchMembers) ? this.workbenchMembers.slice() : [] + const removedMember = list.find((m) => Number(m.id) === Number(memberId)) + const removedName = removedMember?.user_name || removedMember?.name || '' const next = list.filter((m) => Number(m.id) !== Number(memberId)) this.workbenchMembers = next if (next.length > 0) { @@ -2673,8 +2731,8 @@ export default { this.removeConfirmVisible = false this.removeTargetMember = null if (!silent) { - this.speak(speakText || '下线成功') - uni.showToast({ title: toastText || '操作员已下线', icon: 'none' }) + this.speak(`${removedName}下线成功`) + uni.showToast({ title: toastText || '操作员已下线', icon: 'none', silentVoice: true }) } // 下线后重新拉取工作台信息,以服务端成员列表为准 this.loadWorkbenchInfo({ silent: true }) @@ -2682,13 +2740,13 @@ export default { } if (!silent) { this.speak('下线失败') - uni.showToast({ title: '未找到该成员', icon: 'none' }) + uni.showToast({ title: '未找到该成员', icon: 'none', silentVoice: true }) } return 'failed' } catch (e) { if (!silent) { this.speak('下线失败') - uni.showToast({ title: '网络异常,请稍后重试', icon: 'none' }) + uni.showToast({ title: '网络异常,请稍后重试', icon: 'none', silentVoice: true }) } return 'failed' } finally { @@ -2944,7 +3002,7 @@ export default { // 4. 重拉工作台信息,成员列表以服务端为准 this.loadWorkbenchInfo({ silent: true }) this.speak('已结束打包并下线全部成员') - uni.showToast({ title: '长时间无新打包任务,已自动下线', icon: 'none' }) + uni.showToast({ title: '长时间无新打包任务,已自动下线', icon: 'none', silentVoice: true }) } finally { this.idleLoggingOut = false }