winsound — Windows用のサウンド再生インターフェイス—Pythonドキュメント
winsound —Windows用のサウンド再生インターフェイス
winsound モジュールは、Windowsプラットフォームが提供する基本的なサウンド再生機構へのアクセスを提供します。 関数といくつかの定数が含まれています。
- winsound.Beep(frequency, duration)
- PCのスピーカーからビープ音を鳴らします。 Frequency パラメーターは、サウンドの周波数をヘルツ単位で指定し、37〜32,767の範囲内である必要があります。 duration パラメーターは、サウンドが持続するミリ秒数を指定します。 システムがスピーカーからビープ音を鳴らすことができない場合、 RuntimeError が発生します。
- winsound.PlaySound(sound, flags)
- PlatformAPIから基盤となる
PlaySound()
関数を呼び出します。 sound パラメータは、ファイル名、システムサウンドエイリアス、バイトのようなオブジェクトとしてのオーディオデータ、またはNone
です。 その解釈は、 flags の値に依存します。これは、以下で説明する定数のビットごとのOR演算の組み合わせにすることができます。 sound パラメーターがNone
の場合、現在再生中の波形音は停止します。 システムがエラーを示した場合、 RuntimeError が発生します。
- winsound.MessageBeep(type=MB_OK)
- PlatformAPIから基盤となる
MessageBeep()
関数を呼び出します。 レジストリで指定された音が鳴ります。 type 引数は、再生するサウンドを指定します。 可能な値は、-1
、MB_ICONASTERISK
、MB_ICONEXCLAMATION
、MB_ICONHAND
、MB_ICONQUESTION
、およびMB_OK
です。 値-1
は、「単純なビープ音」を生成します。 これは、他の方法でサウンドを再生できない場合の最後のフォールバックです。 システムがエラーを示した場合、 RuntimeError が発生します。
- winsound.SND_FILENAME
- sound パラメータはWAVファイルの名前です。 SND_ALIAS と一緒に使用しないでください。
- winsound.SND_ALIAS
sound パラメータは、レジストリからのサウンドアソシエーション名です。 レジストリにそのような名前が含まれていない場合は、 SND_NODEFAULT も指定されていない限り、システムのデフォルトサウンドを再生します。 デフォルトのサウンドが登録されていない場合は、 RuntimeError を発生させます。 SND_FILENAME と一緒に使用しないでください。
すべてのWin32システムは、少なくとも以下をサポートしています。 ほとんどのシステムはさらに多くをサポートしています。
PlaySound()
名前対応するコントロールパネルのサウンド名
'SystemAsterisk'
アスタリスク
'SystemExclamation'
感嘆
'SystemExit'
Windowsを終了します
'SystemHand'
クリティカルストップ
'SystemQuestion'
質問
例えば:
import winsound # Play Windows exit sound. winsound.PlaySound("SystemExit", winsound.SND_ALIAS) # Probably play Windows default sound, if any is registered (because # "*" probably isn't the registered name of any sound). winsound.PlaySound("*", winsound.SND_ALIAS)
- winsound.SND_LOOP
- 音を繰り返し再生します。 SND_ASYNC フラグも、ブロッキングを回避するために使用する必要があります。 SND_MEMORY では使用できません。
- winsound.SND_MEMORY
PlaySound()の sound パラメータは、バイトのようなオブジェクトとしてのWAVファイルのメモリイメージです。
ノート
このモジュールは、メモリイメージからの非同期再生をサポートしていないため、このフラグと SND_ASYNC を組み合わせると、 RuntimeError が発生します。
- winsound.SND_PURGE
指定されたサウンドのすべてのインスタンスの再生を停止します。
ノート
このフラグは、最新のWindowsプラットフォームではサポートされていません。
- winsound.SND_ASYNC
- すぐに戻り、サウンドを非同期で再生できるようにします。
- winsound.SND_NODEFAULT
- 指定したサウンドが見つからない場合は、システムのデフォルトサウンドを再生しないでください。
- winsound.SND_NOSTOP
- 現在再生中のサウンドを中断しないでください。
- winsound.SND_NOWAIT
サウンドドライバがビジーの場合は、すぐに戻ってください。
ノート
このフラグは、最新のWindowsプラットフォームではサポートされていません。
- winsound.MB_ICONASTERISK
SystemDefault
の音を鳴らします。
- winsound.MB_ICONEXCLAMATION
SystemExclamation
の音を鳴らします。
- winsound.MB_ICONHAND
SystemHand
の音を鳴らします。
- winsound.MB_ICONQUESTION
SystemQuestion
の音を鳴らします。
- winsound.MB_OK
SystemDefault
の音を鳴らします。