wave --- 讀寫(xiě)WAV格式文件?
源代碼: Lib/wave.py
wave 模塊提供了一個(gè)處理 WAV 聲音格式的便利接口。它不支持壓縮/解壓，但是支持單聲道/立體聲。
wave 模塊定義了以下函數和異常:
- wave.open(file, mode=None)?
如果 file 是一個(gè)字符串，打開(kāi)對應文件名的文件。否則就把它作為文件類(lèi)對象來(lái)處理。mode 可以為以下值：
'rb'只讀模式。
'wb'只寫(xiě)模式。
注意不支持同時(shí)讀寫(xiě)WAV文件。
mode 設為
'rb'時(shí)返回一個(gè)Wave_read對象，而 mode 設為'wb'時(shí)返回一個(gè)Wave_write對象。如果省略 mode 并指定 file 來(lái)傳入一個(gè)文件類(lèi)對象，則file.mode會(huì )被用作 mode 的默認值。如果操作的是文件對象，當使用 wave 對象的
close()方法時(shí)，并不會(huì )真正關(guān)閉文件對象，這需要調用者負責來(lái)關(guān)閉文件對象。open()函數可以在with語(yǔ)句中使用。 當with阻塞結束時(shí)，Wave_read.close()或Wave_write.close()方法會(huì )被調用。在 3.4 版更改: 添加了對不可搜索文件的支持。
- exception wave.Error?
當不符合WAV格式或無(wú)法操作時(shí)引發(fā)的錯誤。
Wave_read對象?
由 open() 返回的 Wave_read 對象，有以下幾種方法:
- Wave_read.getnchannels()?
返回聲道數量（
1為單聲道，2為立體聲）
- Wave_read.getsampwidth()?
返回采樣字節長(cháng)度。
- Wave_read.getframerate()?
返回采樣頻率。
- Wave_read.getnframes()?
返回音頻總幀數。
- Wave_read.getcomptype()?
返回壓縮類(lèi)型（只支持
'NONE'類(lèi)型）
- Wave_read.getcompname()?
getcomptype()的通俗版本。使用'not compressed'代替'NONE'。
- Wave_read.getparams()?
返回一個(gè)
namedtuple()(nchannels, sampwidth, framerate, nframes, comptype, compname)，與get*()方法的輸出相同。
- Wave_read.rewind()?
重置文件指針至音頻開(kāi)頭.
后面兩個(gè)方法是為了和 aifc 保持兼容，實(shí)際不做任何事情。
- Wave_read.getmarkers()?
返回
None。
- Wave_read.getmark(id)?
引發(fā)錯誤異常。
以下兩個(gè)方法都使用指針，具體實(shí)現由其底層決定。
- Wave_read.setpos(pos)?
設置文件指針到指定位置。
- Wave_read.tell()?
返回當前文件指針位置。
Wave_write 對象?
對于可查找的輸出流，wave 頭將自動(dòng)更新以反映實(shí)際寫(xiě)入的幀數。 對于不可查找的流，當寫(xiě)入第一幀時(shí) nframes 值必須準確。 獲取準確的 nframes 值可以通過(guò)調用 setnframes() 或 setparams() 并附帶 close() 被調用之前將要寫(xiě)入的幀數，然后使用 writeframesraw() 來(lái)寫(xiě)入幀數據，或者通過(guò)調用 writeframes() 并附帶所有要寫(xiě)入的幀。 在后一種情況下 writeframes() 將計算數據中的幀數并在寫(xiě)入幀數據之前相應地設置 nframes。
由 open() 返回的 Wave_write 對象，有以下幾種方法:
在 3.4 版更改: 添加了對不可搜索文件的支持。
- Wave_write.close()?
確保 nframes 是正確的，并在文件被
wave打開(kāi)時(shí)關(guān)閉它。 此方法會(huì )在對象收集時(shí)被調用。 如果輸出流不可查找且 nframes 與實(shí)際寫(xiě)入的幀數不匹配時(shí)引發(fā)異常。
- Wave_write.setnchannels(n)?
設置聲道數。
- Wave_write.setsampwidth(n)?
設置采樣字節長(cháng)度為 n。
- Wave_write.setframerate(n)?
設置采樣頻率為 n。
在 3.2 版更改: 對此方法的非整數輸入會(huì )被舍入到最接近的整數。
- Wave_write.setnframes(n)?
設置總幀數為 n。 如果與之后實(shí)際寫(xiě)入的幀數不一致此值將會(huì )被更改（ 如果輸出流不可查找則此更改嘗試將引發(fā)錯誤）。
- Wave_write.setcomptype(type, name)?
設置壓縮格式。目前只支持
NONE即無(wú)壓縮格式。
- Wave_write.setparams(tuple)?
tuple 應該是
(nchannels, sampwidth, framerate, nframes, comptype, compname)，每項的值應可用于set*()方法。設置所有形參。
- Wave_write.tell()?
返回當前文件指針，其指針含義和
Wave_read.tell()以及Wave_read.setpos()是一致的。
- Wave_write.writeframesraw(data)?
寫(xiě)入音頻數據但不更新 nframes。
在 3.4 版更改: 現在可接受任意 bytes-like object。
- Wave_write.writeframes(data)?
寫(xiě)入音頻幀并確保 nframes 是正確的。 如果輸出流不可查找且在 data 被寫(xiě)入之后寫(xiě)入的總幀數與之前設定的 nframes 值不匹配將會(huì )引發(fā)錯誤。
在 3.4 版更改: 現在可接受任意 bytes-like object。
注意在調用 writeframes() 或 writeframesraw() 之后再設置任何格式參數是無(wú)效的，而且任何這樣的嘗試將引發(fā) wave.Error。