sound — 音效和音樂播放

sound模塊包含在iOS上播放音效和音頻文件的功能。

它還可以使用Recorder類從麥克風錄制音頻文件。

注意: 為了使用Recorder類，你必須允許訪問麥克風。首次使用Recorder.record()方法時，系統會自動顯示一個對話框。如果你未授權訪問麥克風，則也可以在應用“設置”的“隱私”部分中啟用它。

函數

sound.play_effect(name[, volume, pitch=1.0, pan=0.0, looping=False])

使用給定名稱播放音效。你可以使用資源管理器（工具欄中的[+]按鈕）訪問內置音效名稱的列表，但是如果你想使用自己的音效，名稱也可以是文件路徑。

播放是異步的，即函數在聲音播放完畢之前返回。

返回值是一個sound.Effect對象，可用于稍后調整播放設置，或在完成播放之前停止音效。

如果已經播放了太多音效（通常限制為32個左右），則可能不會返回任何聲音。

sound.stop_all_effects()

停止當前正在播放的所有音效（通過play_effect()）。

sound.stop_effect(effect)

停止播放給定的音效。effect應該是play_effect()的返回值。

sound.set_volume(vol)

設置所有音效的默認音量（介于0.0和1.0之間，默認值為0.5）。這對已經播放的音效沒有影響。

sound.set_honors_silent_switch(flag)

確定在播放聲音時是否接受靜音開關（默認為True）。

音效類

class sound.Effect

Effect類代表當前正在播放的音效。你不能直接創建Effect對象，它們是從play_effect()函數中返回的。對于簡單的一次性效果，你可以忽略play_effect()的返回值，但對于在播放效果時調整播放屬性（例如音量或音調）或停止循環效果很有用。

音效類的方法

Effect.stop()

停止播放音效。

音效類的屬性

Effect.looping

設置為True時，音效將無限循環，直到使用該Effect.stop()方法停止播放為止。

Effect.pan

音效的立體聲位置（-1 =左，+ 1 =右，0 =中心）。

Effect.pitch

音效的音調（播放速度）。默認值為1.0。

Effect.position

音效的空間（3D）位置。該值是一個（x，y，z）三元組。請注意，這將覆蓋（立體聲）Sound.pan屬性。

Effect.volume

當前音效的音量。

播放器類

class sound.Player(file_path)

Player類提供了一個易于使用的界面，用于從磁盤播放音頻文件。建議對不需要很低延遲的音樂和其他音頻使用此類。對于游戲中的音效，play_effect()更合適。

播放器類的方法

Player.play()

開始播放音頻。

Player.stop()

停止播放音頻并重置播放位置。

Player.pause()

停止播放音頻，但保持當前播放位置。

播放器類的屬性

Player.current_time

當前播放位置，以秒為單位。

Player.duration

音軌的持續時間（只讀）。

Player.finished_handler

播放器結束播放時調用的不帶參數的函數/可調用對象。

Player.number_of_loops

音軌應重復的次數。設置為-1可永久重復。

Player.playing

一個布爾值，指示音頻播放器是否正在播放。

Player.pan

播放聲音的立體聲位置（-1 =左，+1 =右，0 =居中）。

錄音器類

class sound.Recorder(file_path)

file_path參數指定了在磁盤上創建的音頻文件。音頻文件格式由文件擴展名自動確定。它應該是.m4a（MPEG4 AAC）或.wav（Linear PCM）。MPEG4音頻文件比Wav文件小得多，但是如果要使用該wave模塊處理原始音頻數據，則可能要使用Wav 。

錄音器類的方法

Recorder.record([duration])

開始從麥克風錄制音頻。如果提供了可選的duration參數，則在經過指定的秒數后，錄制會自動停止。否則，必須使用Recorder.stop()方法顯式停止記錄。

Recorder.stop()

停止錄制音頻。

Recorder.pause()

暫停錄音。可以使用Recorder.record()方法恢復記錄。

錄音器類的屬性

Recorder.current_time

當前活動記錄的持續時間。

Recorder.recording

記錄器當前是否正在記錄（布爾值）。

Recorder.meters

當前的平均功率和峰值功率（只讀）。訪問此屬性會自動啟用對此Recorder實例的計數，這可能會消耗額外的處理資源。該值為帶有’average‘和’peak‘鍵的字典，每個鍵包含用于左右聲道的兩個數字的元組。范例：{'average': (-35.3, -30.1), 'peak': (-5.2, -8.2)}。

MIDI播放器類的方法

class sound.MIDIPlayer(file_path[, sound_bank_path])

MIDIPlayer使用內置的“Merlin Silver”聲音庫或你提供的聲音庫，為MIDI（.mid）文件提供簡單的播放功能。如果提供自定義聲音庫，則它必須為sf2格式。

MIDI播放器類

MIDIPlayer.play()

開始播放。

MIDIPlayer.stop()

停止播放。

MIDI播放器類的屬性

MIDIPlayer.current_time

當前播放位置。

MIDIPlayer.duration

加載的MIDI文件的持續時間。

MIDIPlayer.rate

播放速率（正常速度為1.0）。

總結

以上是生活随笔為你收集整理的pythonista3使用说明_Pythonista中文文档：sound的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。