xsl
9eec4369da
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.
118 lines
4.3 KiB
JavaScript
118 lines
4.3 KiB
JavaScript
/* ═════ 语音播报: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
|
|
};
|