開發文件/SAORI/人格套件列表/mciaudior

作者資訊 †

• 作者：umeici
• 配布： http://umeici.hp.infoseek.co.jp/ (連接已失效)
• 版本：20050524 - construction 24

功能解說 †

能夠播放 MID/WAV/MP3/WMA/AU/OGG 格式的音訊檔。

事件指令 †

讀取曲目 †

• 所需引數：
  • Argument0 load
  • Argument1 檔案名

• 使用註解
  • 檔名請根據 mciaudior.dll 的所在作為相對路徑來指定，或直接指定該載入檔案的絕對路徑。

演奏開始 †

• 所需引數：
  • Argument0 play

• 使用註解
  • 播放音樂。
  • 若在音樂播放中的時候送出 play 指令，會使音樂暫停。再送出一次則會繼續播放。

循環演奏開始 †

• 所需引數：
  • Argument0 loop

• 使用註解
  • 循環播放音樂。
  • 若在音樂播放中的時候送出 loop 指令，會使音樂暫停。再送出一次則會繼續播放。

演奏停止 †

• 所需引數：
  • Argument0 stop

• 使用註解
  • 停止音樂。
  • 使用 stop 指令後再播放的話，音樂會重新開始。

事件通知 †

OnMAAPlayFinish †

• 事件參照
  • Reference0 檔案名
  • Reference1 此音訊檔的音樂長度，單位為秒。

• 事件原因
  • 音樂播放終了。

OnMAAPlayLoop †

• 事件參照
  • Reference0 檔案名
  • Reference1 一次循環播放所需的時間長度，單位為秒。

• 事件原因
  • 循環音樂播放已完成一次循環。

使用範例 †

• 播放音樂(美坂)

  {$saori("mciaudior.dll","load","C:\music\op.mp3")}
  {$saori("mciaudior.dll","play")}

• 播放音樂(文)

  FUNCTIONEX("mciaudior.dll","load","C:\music\op.mp3");
  FUNCTIONEX("mciaudior.dll","play");

• 播放音樂(華和梨)

  $(callsaori mciaudio.dll load C:\music\op.mp3)
  $(callsaori mciaudio.dll play)