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
}