MIDI，WAVEファイルなどのメディアファイルの操作を行います．
メディア関数は「メディアタイプ」を介してメディアを操作します．
使用できるメディアタイプは .WAV, .MID, .AVI, .WMA, .MP3の5種類です．
全てのメディアファイルは， 使用の前にMediaOpenでオープンする必要があります． 次にメディアタイプを指定して再生，停止などの操作を行います． 操作が終了したら MediaCloseでメディアファイルをクローズします．
MediaCDExists
MediaCDGetDrives
MediaCDGetNumTracks
MediaCDGetTrackLength
MediaClose
MediaGetLength
MediaGetPosition
MediaGetProperty
MediaGetStatus
MediaOpen
MediaPause
MediaPlay
MediaStop
|
boolean MediaCDExists( string drive )[2.00以降] |
| 機能 | 指定したドライブにCDが入っているかどうかを判定します． | ||||
|---|---|---|---|---|---|
| 引数 |
|
||||
| 戻り値 |
|
||||
| 説明 | 指定したドライブにCDが入っているかどうかを判定します． |
|
void MediaCDGetDrives( string drives[] )[2.00以降] |
| 機能 | 使用可能な全てのCD-ROMドライブのドライブ名を返します． | ||
|---|---|---|---|
| 引数 |
|
||
| 戻り値 |
なし |
||
| 説明 | 使用可能な全てのCD-ROMドライブのドライブ名を返します． drives引数に使用可能なドライブが順に書き込まれます． ドライブ名は"ドライブ名:\"で表されます． Dドライブの場合は"d:\"となります． 使用可能なドライブの数はdrives配列に lengthof演算子を適用して取得できます． 使用可能なドライブが一つも存在しないとき， drives配列の要素数は0になります． |
|
int MediaCDGetNumTracks( )[2.00以降] |
| 機能 | 現在オープンしているCDドライブに挿入されているCDの全トラック数 を返します． | ||||
|---|---|---|---|---|---|
| 引数 |
なし |
||||
| 戻り値 |
|
||||
| 説明 | 現在オープンしているCDドライブに挿入されているCDの全トラック数 を返します．現在オープンしているCDドライブとは，最後に MediaOpenを使ってオープンしたCDが挿入されているドラ イブを指します． |
|
int MediaCDGetTrackLength( int track )[2.00以降] |
| 機能 | 指定されたトラックの長さを返します． | ||||
|---|---|---|---|---|---|
| 引数 |
|
||||
| 戻り値 |
|
||||
| 説明 | track引数で指定したトラックの長さを返します．単位は[ms](ミリ秒) です．長さを調べるドライブは，最後にMediaOpenで指定したCD-ROM ドライブになります． |
|
int MediaClose( string MediaType ) |
| 機能 | メディアをクローズし，そのメディアを解放します． | ||||
|---|---|---|---|---|---|
| 引数 |
|
||||
| 戻り値 |
|
||||
| 説明 |
メディアをクローズし，そのメディアを解放します．MediaTypeに はMediaPlayと同様の形式でメディアタイプを指定ます． |
|
int MediaGetLength( string MediaType ) |
| 機能 | メディアの長さを返します． | ||||
|---|---|---|---|---|---|
| 引数 |
|
||||
| 戻り値 |
|
||||
| 説明 |
MediaTypeで指定したメディアの長さを[ms](ミリ秒，1/1000秒)単位で返します． |
|
int MediaGetPosition( string MediaType ) |
| 機能 | 現在のメディアの再生位置を返します． | ||
|---|---|---|---|
| 引数 |
|
||
| 戻り値 |
|
||
| 説明 |
MediaTypeで指定したメディアの現在再生位置を，[ms]単位で返します． |
||
|
string MediaGetProperty( |
| 機能 | マルチメディアファイルの情報を取得します． | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 引数 |
|
|||||||||
| 戻り値 |
|
|||||||||
| 説明 |
マルチメディアファイルの情報を取得します．filename引数に情報 を取得するファイルの名前を指定します．typeidには取得する情報 の種類を指定します．typeidに指定できる値と取得する情報は次の とおりです．
情報を取得できるファイルは，MP3ファイル，Oggファイル，MIDIファ イルです．
|
|||||||||
|
int MediaGetStatus( string MediaType ) |
| 機能 | MediaTypeで指定したメディアの状態を取得します． | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 引数 |
|
||||||||||||
| 戻り値 |
|
||||||||||||
| 説明 |
MediaTypeで指定したメディアの状態を取得します． |
|
int MediaOpen( string fname ) |
| 機能 | メディア操作の前処理として，メディアのオープンを行います． | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 引数 |
|
||||||||||||
| 戻り値 |
|
||||||||||||
| 説明 |
メディア操作の前処理として，メディアのオープンを行います． MediaPlayなどのすべてのMedia系関数は， MediaOpenで最後にオープンされたメディアに対して働きます． MediaOpenせずにこれらの関数を使用すると， [メディアがオープンされていない]のエラーとなります． オープンするファイルのメディアタイプが既にオープンされている場合は， これまでオープンしていたファイルをクローズした後， 新しくファイルを開きます． |
| 例1 |
int result = MediaOpen( "canyon.mid" );
if( result == 0 )
{
Talk( "正常にオープンできました．再生を開始します．" );
MediaPlay( ".mid" );
}
else if( result == -1 )
Talk( "ファイルが見つからないようですが…再生をとりやめます．" );
|
|---|
|
int MediaPause( string MediaType ) |
| 機能 | メディアの再生を一時停止します． | ||||
|---|---|---|---|---|---|
| 引数 |
|
||||
| 戻り値 |
|
||||
| 説明 |
メディアの再生を一時停止します． 停止したいメディアをMediaType引数で指定します． MediaType引数はMediaPlayを参照してください． 一時停止状態を解除するには，MediaPlayを実行します． |
|
int MediaPlay( string MediaType ) |
| 機能 | メディアの再生を行います． | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 引数 |
|
|||||||||||
| 戻り値 |
|
|||||||||||
| 説明 |
メディアの再生を行います． MediaTypeにはメディアタイプを指定します． MediaType引数には次の値が指定できます(大文字，小文字どちらでも指定できます)．
|