(58) Small Basic v0.8~ API リファレンス : Sound
Soundオブジェクトは、音声を再生する機能を提供します。
このオブジェクトには、いくつかのサンプル音があらかじめ用意されています。
Pause
オペレーション : Pause ( filePath )
音声ファイルの再生を一時停止します。音声ファイルをまだ再生していない場合は、この操作をしても何も起きません。
| filePath | 文字列 | 音声ファイルのパス。 ローカルファイル(例:c:\music\track1.mp3)またはネットワーク上のファイル(例:http://contoso.com/track01.wma)を指定できます。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.8~ | |
Play
オペレーション : Play ( filePath )
音声ファイルを再生します。
MP3、WAV、またはWMAファイルを再生できます。
それ以外のファイル形式は、コンピューターにインストールされているオーディオコーデックによって、再生できない場合があります。
すでに音声ファイルが一時停止されている場合は、一時停止されたところから再生を再開します。
| filePath | 文字列 | 音声ファイルのパス。 ローカルファイル(例:c:\music\track1.mp3)またはネットワーク上のファイル(例:http://contoso.com/track01.wma)を指定できます。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.8~ | |
PlayAndWait
オペレーション : PlayAndWait ( filePath )
音声ファイルを再生し、終了するまで待ちます。
MP3、WAV、またはWMAファイルを再生できます。
それ以外のファイル形式は、コンピューターにインストールされているオーディオコーデックによって、再生できない場合があります。
すでに音声ファイルが一時停止されている場合は、一時停止されたところから再生を再開します。
| filePath | 文字列 | 音声ファイルのパス。 ローカルファイル(例:c:\music\track1.mp3)またはネットワーク上のファイル(例:http://contoso.com/track01.wma)を指定できます。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.8~ | |
PlayBellRing
オペレーション : PlayBellRing ( )
ベル音を再生します。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayBellRingAndWait
オペレーション : PlayBellRingAndWait ( )
ベル音を再生し、終了を待ちます。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayChime
オペレーション : PlayChime ( )
長いチャイム音を再生します。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayChimeAndWait
オペレーション : PlayChimeAndWait ( )
長いチャイム音を再生し、終了を待ちます。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayChimes
オペレーション : PlayChimes ( )
短いチャイム音を再生します。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayChimesAndWait
オペレーション : PlayChimesAndWait ( )
短いチャイム音を再生し、終了を待ちます。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayClick
オペレーション : PlayClick ( )
クリック音を再生します。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayClickAndWait
オペレーション : PlayClickAndWait ( )
クリック音を再生し、終了を待ちます。
| 戻り値 | (なし) |
| 対応バージョン | v0.8~ |
PlayMusic
オペレーション : PlayMusic ( notes )
演奏データを再生します。
- 原文では「Music Markup Language 」と記述されていますが、現在 Music Markup Language はXML ベースの音声記述言語であり、QBasic 等で採用されていた記述言語は、Music Macro Language と呼ぶのが正しいようです。
- MML ( Music Macro Language ) の具体的な記述要素については 2010/06/20 現在、公式な資料がありません。一般的なものについては、wikipedia 等に言及があります。
| notes | 文字列 | 演奏データ。 データの書式は、QBasic の MML のサブセットです。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9~ | |
オペレーション : Stop ( filePath )
音声ファイルの再生を停止します。
音声ファイルをまだ再生していない場合は、この操作をしても何も起きません。
| filePath | 文字列 | 音声ファイルのパス。 ローカルファイル(例:c:\music\track1.mp3)またはネットワーク上のファイル(例:http://contoso.com/track01.wma)を指定できます。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.8~ | |
