(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

オペレーション : Stop ( filePath )

音声ファイルの再生を停止します。
音声ファイルをまだ再生していない場合は、この操作をしても何も起きません。

filePath 文字列 音声ファイルのパス。
ローカルファイル(例:c:\music\track1.mp3)またはネットワーク上のファイル(例:http://contoso.com/track01.wma)を指定できます。
戻り値 (なし)
対応バージョン v0.8~

コメントを投稿