feat(taobao): add native mini program with shared backend

Preserve H5 flows while adding Taobao identity, native capture, reports and isolated local development. Fix canceled province selection and expired-session logout. Record passing local regressions, two pre-existing H5 assertion failures and pending platform validation.
2026-10-19 20:14:31 +08:00
parent d07f8cc1bb
commit 9eec4369da
61 changed files with 4827 additions and 17 deletions
@@ -0,0 +1,117 @@
+/* ═════ 语音播报:my.createInnerAudioContext 播放远程 MP3 ═════
+ * 文案/文件名契约:docs/语音播报内容设计文档_V1.0.md(A 步骤引导 / B 姿态提示 / C 流程音)
+ * 播放策略与 H5 一致:单通道;流程音排队顺序播不互截;姿态提示同条 4s 去重、不打断流程音;
+ * 资源远程化:{ASSET_BASE}voice/<id>.mp3,清单 manifest.json 缺失时默认全量尝试(404 静默) */
+
+var api = require('./api.js');
+
+// A/B/C 三类清单(与 H5 app.js VOICE 常量一致)
+var VOICE = {
+  step: ['step1-front', 'step2-rightface', 'step3-leftface'],           // A. 步骤引导
+  hint: {                                                               // B. 姿态提示(手动快门模式下基本不用,保留契约)
+    '未检测到人脸': 'hint-noface', '请靠近一点': 'hint-near', '请远一点': 'hint-far',
+    '请正对屏幕': 'hint-front', '请向左转头': 'hint-turn-left', '请向右转头': 'hint-turn-right',
+    '保持不动': 'hint-hold'
+  },
+  countdown: 'countdown-321', shot: 'shot-done',                        // C. 拍摄与流程
+  analyzing: 'analyzing', fail: 'analyze-fail'
+};
+
+var DEDUPE_MS = 4000; // 同条提示 4s 内不重复播
+
+var audio = null;        // InnerAudioContext 单实例
+var files = null;        // null=清单未加载;{}=清单不可用(默认全量尝试)
+var lastAt = {};         // id → 上次开播时间(去重)
+var cur = null;          // { id, kind:'flow'|'hint', token }
+var queue = [];          // 排队中的流程音
+var pendingHint = null;  // 流程音期间挂起的姿态提示(只留最新)
+var waiters = [];        // afterCurrent 回调:全部播报收尾后执行
+
+// 拉取远程清单;失败则放行全量(语音缺失时 InnerAudioContext onError 静默跳过)
+function init() {
+  if (audio) return;
+  if (typeof my.createInnerAudioContext !== 'function') return;
+  try { audio = my.createInnerAudioContext(); } catch (_) { return; }
+  audio.onEnded(function () { drain(); });
+  audio.onError(function () { drain(); }); // 单条加载失败:跳过,继续队列
+  files = {}; // Known voice IDs; unavailable files are skipped by onError.
+}
+
+function ensure() { if (!audio) init(); }
+
+function playable(id) { return !!id && (files === null || !Object.keys(files).length || files[id]); }
+
+function start(id, kind) {
+  ensure();
+  if (!audio) { drain(); return; }
+  lastAt[id] = Date.now();
+  cur = { id: id, kind: kind, token: {} };
+  var token = cur.token;
+  audio.stop();
+  audio.src = api.assetUrl('voice/' + id + '.mp3');
+  audio.play();
+  // 播放失败/结束时 cur 清理放在 drain 前,避免排队卡死
+  cur.token = token;
+}
+
+function stopCur() {
+  if (!cur) return;
+  cur = null;
+  if (audio) { try { audio.stop(); } catch (e) {} }
+}
+
+function drain() {
+  cur = null;
+  if (queue.length) { start(queue.shift(), 'flow'); return; }
+  if (pendingHint) { var h = pendingHint; pendingHint = null; start(h, 'hint'); return; }
+  var w = waiters;
+  waiters = [];
+  w.forEach(function (fn) { fn(); });
+}
+
+function busyWithFlow() { return (cur && cur.kind === 'flow') || queue.length > 0; }
+
+/**
+ * 播报一条语音
+ * @param {string} id 文件名(去 .mp3)
+ * @param {object} [opts] hint:姿态提示(4s 去重);cut:打断在播与排队(失败提示用)
+ */
+function play(id, opts) {
+  opts = opts || {};
+  if (!playable(id)) return;
+  ensure();
+  if (opts.hint) {
+    if (lastAt[id] && Date.now() - lastAt[id] < DEDUPE_MS) return;
+    if (busyWithFlow()) { pendingHint = id; return; }
+    start(id, 'hint');
+    return;
+  }
+  if (opts.cut) { queue = []; pendingHint = null; stopCur(); start(id, 'flow'); return; }
+  if (busyWithFlow()) { if (queue.indexOf(id) < 0) queue.push(id); return; }
+  start(id, 'flow');
+}
+
+function dropHint() { pendingHint = null; } // 换步/提示清空:挂起的旧提示作废
+
+// 流程切走:作废排队/挂起/等待;hard 连在播一并掐断(退出拍照页),否则让在播自然收尾(出报告)
+function stop(hard) {
+  queue = [];
+  pendingHint = null;
+  waiters = [];
+  if (hard) stopCur();
+}
+
+// 全部播报(含排队与挂起)自然收尾后执行 cb;空闲则立即执行
+function afterCurrent(cb) {
+  if (!cur && !queue.length && !pendingHint) { cb(); return; }
+  waiters.push(cb);
+}
+
+module.exports = {
+  VOICE: VOICE,
+  init: init,
+  play: play,
+  dropHint: dropHint,
+  stop: stop,
+  afterCurrent: afterCurrent
+};