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の音を鳴らします。

winsound — Windows用のサウンド再生インターフェイス—Pythonドキュメント

winsound —Windows用のサウンド再生インターフェイス