語音合成(TTS)服務需批次處理多筆文字,單次請求可能失敗,需實作「重試 N 次直到成功或達上限」的非同步流程控制。使用 jQuery Deferred 物件管理 Promise 狀態,搭配遞歸回調實現重試邏輯。
function runAsyncTTS(text, speecher, audiopath) {
var def = jQuery.Deferred();
var args = {
"SynthText": text,
"VoiceSpeecher": speecher,
"WordSpeed": "3",
"UseCSSML": "0",
"AudioPath": audiopath
};
tts.asyncTTS(JSON.stringify(args), function(err, result) {
def.resolve(result); // 成功回呼
});
return def.promise(); // 回傳 Promise,支援 .done()/.fail()
}
function textToSpeechBat(metaJson, speecher, audioPath) {
var def = $.Deferred();
var result = { originalWords: "", resultJsonArr: [] };
var jsons = "";
// 組裝批次參數字串
for (var index = 0; index < metaJson.words.length; index++) {
var audioName = metaJson.words[index]['audio'].replace('.mp3', '');
var audioFile = audioPath + "/" + audioName + '.wav';
var args = '{"SynthText": "' + metaJson.words[index]['word']
+ '", "VoiceSpeecher": "' + speecher
+ '", "WordSpeed": "3", "UseCSSML": "0", "AudioPath": "' + audioFile + '"}';
jsons += args + "|";
}
jsons = jsons.substr(0, jsons.length - 1); // 移除尾端分隔符
// 批次呼叫
tts.asyncTTSBat(jsons, function(err, ret) {
result['resultJsonArr'] = ret.split('|');
def.resolve(result);
});
return def.promise();
}
function textToSpeechWithTryTimes(metaJson, speecher, audioPath, times) {
var def = $.Deferred();
var ttsRet = null;
// 遞歸回調函式
var ttsCallBack = function(index) {
if (index < times) {
// 呼叫批次 TTS
textToSpeechBat(metaJson, speecher, audioPath).done(function(ret) {
console.log("嘗試 " + (index + 1) + ": " + JSON.stringify(ret));
ttsRet = ret;
var resultJsonArr = ret.resultJsonArr;
var audioFlag = true;
// 檢查每筆結果是否成功
for (var i = 0; i < resultJsonArr.length; i++) {
if (resultJsonArr[i] === "") {
audioFlag = false;
break;
}
var retObj = JSON.parse(resultJsonArr[i]);
if (retObj['audioFlag'] === 'false' || retObj['result'] === "") {
audioFlag = false;
break;
}
}
console.log("本次結果:", audioFlag ? "成功" : "失敗");
if (audioFlag === false) {
// 失敗:遞歸重試,索引 +1
console.log("重試中...");
ttsCallBack(++index);
} else {
// 成功:resolve 最終結果
console.log("成功完成");
def.resolve(ret);
}
});
}
// 達到最大重試次數仍失敗
if (index === times) {
console.log("重試次數耗盡,回傳最後結果");
def.resolve(ttsRet);
}
};
ttsCallBack(0); // 從第 0 次開始
return def.promise();
}
$.Deferred() 建立延遲物件,掌控解析/拒絕時機def.promise() 回傳受限 Promise,外部只能 .done()/.fail(),不可手動 resolvedef.resolve() 觸發後續鏈式處理
// 通用重試包裝器(現代 Promise 寫法)
function retry(fn, maxAttempts, delayMs = 1000) {
return fn().catch(function(err) {
if (maxAttempts <= 1) throw err;
console.log("重試剩餘:", maxAttempts - 1);
return new Promise(r => setTimeout(r, delayMs))
.then(() => retry(fn, maxAttempts - 1, delayMs * 2)); // 指數退避
});
}
// 使用範例
retry(() => textToSpeechBat(metaJson, speecher, audioPath), 3)
.then(result => console.log("最終成功:", result))
.catch(err => console.error("全部失敗:", err));
JavaScript 引擎對遞歸深度有限制(通常 ~10,000~15,000 層)。本範例重試次數通常 < 10,安全無虞。若需大量遞歸,請改用迴圈 + Promise 鏈或 async/await 避免堆疊溢位。
textToSpeechBat(...).fail(() => ttsCallBack(++index))Promise.race() 包裝請求與 setTimeoutDeferred 物件提供強大的非同步流程控制能力,配合遞歸回調可優雅實作重試機制。現代專案建議遷移至原生 Promise + async/await,程式碼更線性、易除錯、易維護。