標籤:doc html 結束時間 實現 節點 項目 channel axios ado
項目中需要利用百度語音介面在Web端實現語音辨識功能,採用了這樣的技術方案,但實現時遇到了很多問題,發現網上大部分文章都只是在詳解官方提供的example樣本,對實際開發沒有提供什麼有價值的建議,而recorder.js
是無法直接適配百度AI的語音介面的,故本篇將開發中各個細節點記錄與此,歡迎指點交流。
一. 技術棧選擇
需求:利用百度語音介面在Web端實現語音辨識功能
技術棧:React
+recorder-tool.js
+recorder.js
+ Express
+ Baidu語音辨識API
recorder.js
項目地址:https://github.com/mattdiamond/Recorderjs
示範效果:
二. 前端開發細節為recorder.js提供一個代理對象
前端的主架構採用React
,在基本結構和文法上並沒有太多問題,為了使用recorder.js
,我們封裝了一個recorder-tool.js
作為代理,其實現方法較為簡單,就是將官方樣本中example
樣本中的html
檔案的指令碼部分封裝成一個單例對象作為recorder.js
的代理,然後暴露一組API
供上層調用,大致的結構如下:
import Recorder from ‘./recorder-src‘;//Singletonvar recorder;//start recordfunction startRecord() { recorder && recorder.record();}//stop recordfunction stopRecord(button) { recorder && recorder.stop();}//....其他一些方法export default { init : init, start: startRecord, stop: stopRecord, exportData: exportData, sendRequest: sendRequest, clear: clearRecord, createDownloadLink : createDownloadLink}
解除exportWAV方法的回調地獄
官方樣本中輸出wav
編碼格式的資料這個動作是通過webworker
來完成的,也就是說位元據處理的開始和結束時間點是通過事件來觸發的,recorder.exportWAV( )
接收一個回呼函數作為入參,在得到wav
格式的資料後會執行傳入的回呼函數,如果要在react
中實現,就需要寫成:
//record-page.js...//處理錄音-事件監聽proce***ecord(){ RecorderTools.exportData(function(blob){ var wav = preProcessData(blob); //發送請求 axios.post({...}) .then(function(response){ handle(response); }) });}...
你或許已經發現了這個【回調地獄】的現象,深度的嵌套會讓邏輯變的複雜且代碼高度耦合,想把一些方法從react
中剝離出去非常困難,我們希望使用一些其他的方式來轉碼的控制權,而不是把一大堆後續的邏輯傳進exportData( )
方法。
我們在一個存在的DOM元素上添加一個自訂事件recorder.export
的監聽器,並在傳入recorder.exportWAV( )
方法的回呼函數中,手動初始化觸發一個自訂事件(暫不考慮相容性問題),並把recorder.js
匯出的資料掛在這個event對象上,然後在指定元素上派發這個事件:
//export datafunction exportData() { recorder && recorder.exportWAV(function (blob) { //init event var exportDone = document.createEvent(‘HTMLEvents‘); exportDone.initEvent(‘recorder.export‘, true, true); //add payload exportDone.data = blob; //dispatch document.getElementById(‘panel‘).dispatchEvent(exportDone); });}
這樣我們後續的處理邏輯就可以用常規的方式在React
組件中繼續編寫後續的商務邏輯,這樣就實現了基本的職責分離和代碼分離。
recorder.js
中使用DOM0級事件模型來與webworker
通訊,為了不覆蓋原功能,我們可以通過DOM2事件模型在recorder執行個體上綁定額外的監聽器:
recorder.worker.addEventListener(‘message‘,function(event){ //event.data中就包含了轉換後的WAV資料 processData(event.data); ...})
這樣我們就可以在自己的邏輯代碼或二次封裝的代碼中實現對轉碼動作的監聽。
使用Promise
來實現非同步調用,將音頻處理的代碼剝離出去,最終的調用方式為:
RecorderTools.exportData().then(data){ //繼續在React組件檔案中編寫其他邏輯或調用方法}
參考代碼如下:
//RecorderTools.js中的方法定義function exportData(){ return new Promise(function(resolve, reject){ recorder && recorder.exportWAV(function(blob){ resolve(blob); }) });}
回調,事件監聽,Promise都是javascript
中重要的非同步模式,根據個人喜好和實際情境選擇使用即可。
如何提交Blob對象
通過recorder.js
的官方樣本可以看到,如果不將錄音輸出為本地wav
格式的檔案,我們得到的是一個Blob
對象,Blob
對象需要使用form表單的方式進行提交,具體方法如下(使用axios
發送http
請求):
var formData = new FormData(); formData.set(‘recorder.wav‘,blob);//blob即為要發送的資料 axios({ url:‘http://localhost:8927/transmit‘, method : ‘POST‘, headers:{ ‘Content-Type‘: ‘multipart/form-data‘//此處也可以賦值為false }, data:formData });
三. Recorder.js的功能擴充
百度AI語音辨識介面接收的語音檔案需要滿足如下的要求:
pcm
格式或wav
格式檔案的位元據經過base64轉換後的編碼
- 16000Hz採樣率
- 16bit位深
- 單聲道
要利用recorder.js
實現上述需求,需要對源碼進行一些功能擴充。編碼轉換可以在服務端進行,而recorder.js
中的floatTo16BitPCM( )
方法看名字應該是為了滿足16bit位深這個條件的,那麼我們只需要考慮單聲道和16000採樣率這兩個條件了。
源碼中Recorder
建構函式是可以接受參數的,而這個參數會被合入執行個體的config
屬性,其中numChannles
就是聲道數,所以我們只需要在執行個體化是傳入自訂的聲道數目即可:
new Recorder({ numChannels:1//單聲道})
再來看16000採樣率這個條件,查看源碼可以知道,源碼中對於sampleRate
的使用,一律使用了音頻流資料來源內容相關的sampleRate
,也就是對應著電腦音效卡的採樣率(48000Hz
或44100Hz
),那如何得到16000Hz
採樣率的資料呢?比如一個48000Hz
採樣率的音效卡採集的訊號點,1秒採集了48000次,那麼這48000個資料要變成16000個資料,最簡單的辦法就是每4個點取1個然後組成新的資料,也就是說實際上聲音採集裝置傳過來的採樣率是固定的,我們需要多少的採樣率,只需要自己拿一個比例係數去換算一下,然後丟棄掉一部分資料點(當然也可以求平均值)就可以了,封裝後的調用方式為:
new Recorder({ numChannels:1, sampleRate:16000});
那麼在源碼中需要做一些功能的擴充,關鍵的部分在下面這段代碼:
//recorder.js部分源碼function exportWAV(type) { var buffers = []; for (var channel = 0; channel < numChannels; channel++) { buffers.push(mergeBuffers(recBuffers[channel], recLength)); } var interleaved = undefined; if (numChannels === 2) { interleaved = interleave(buffers[0], buffers[1]); } else { interleaved = buffers[0]; //此處是重點,可以看到對於單聲道的情況是沒有進行處理的,那麼仿照雙聲道的處理方式來添加採樣函數,此處改為interleaved = extractSingleChannel(buffers[0]); } var dataview = encodeWAV(interleaved); var audioBlob = new Blob([dataview], { type: type }); self.postMessage({ command: ‘exportWAV‘, data: audioBlob });}
extractSingleChannel( )
的具體實現參考interleave( )方法
/***sampleStep是系統的context.sampleRate/自訂sampleRate後取整的結果,這個方法實現了對單聲道的*採樣資料處理。*/function extractSingleChannel(input) { //如果此處不按比例縮短,實際輸出的檔案會包含sampleStep倍長度的空錄音 var length = Math.ceil(input.length / sampleStep); var result = new Float32Array(length); var index = 0, inputIndex = 0; while (index < length) { //此處是處理關鍵,演算法就是輸入的資料點每隔sampleStep距離取一個點放入result result[index++] = input[inputIndex]; inputIndex += sampleStep; } return result;}
這樣處理後exportWAV( )
方法輸出的Blob對象中存放的資料就滿足了百度語音的識別要求。
四. 服務端開發細節
在服務端我們使用Express
架構來部署一個訊息代理服務,這裡涉及的知識點相對較少,可以使用百度AI的nodejs-sdk
來實現,也可以自行封裝,許可權驗證的方法幾乎都是通用的,按照官方文檔來做就可以了。
通過multipart/form-data方式提交的表單無法直接通過req.body
或req.params
進行處理,這裡使用官方推薦的Multer
中介軟體來處理,此處較為簡單,直接附上筆者的參考代碼:
此處有一點需要注意的是:在執行個體化Multer
時,傳參和不傳參時得到的轉換對象是不一樣的,如果涉及到相關情境可以直接在控制台列印出來確保使用了正確的屬性。
【Recorder.js+百度語音辨識】全棧方案技術細節