コンテンツにスキップ

サウンド

BGM・効果音・ボイス・FM 音源に関するコマンドです。

対応ランタイムの記号

○ 対応 / △ 一部対応 / × 非対応 (読み飛ばし) / — 準備中


bgm — BGM を再生・停止

Resources/Audio/BGM のサンプリング音源 (mp3 / ogg / wav) を BGM として再生・停止します。

書式

bgm play <曲名>
bgm stop
bgm fadeout <秒数>

Resources/Audio/BGM/ の音声ファイル (mp3 / ogg / wav) を BGM としてループ再生します。MML の再生には fm play を使います。 bgm stop で停止、bgm fadeout <秒数> でフェードアウトして停止します。

例

bgm play morning_theme
bgm fadeout 2.0

対応ランタイム

ランタイム 対応 補足
Windows (Unity) ○
XZ80 ○
MSX (V9990) × サンプリング BGM は再生できないため、bgm 系コマンドはすべて読み飛ばします (警告が出ます)。bgm stop で FM 音源が止まることもありません。MSX では fm play を使ってください。
PSP ○
X68000 △ ADPCM 1 チャンネルで再生します。効果音・ボイスの再生中は BGM が一時中断し、終了後に再開します。

se — 効果音を再生

Resources/Audio/SE の効果音を再生します。

書式

se play <音名>

例

se play door_open

対応ランタイム

ランタイム 対応 補足
Windows (Unity) ○
XZ80 ○
MSX (V9990) △ PSG の単音で近似して再生します。
PSP ○
X68000 △ 再生中は BGM が一時中断します。

voice — ボイスを再生

キャラクター別のボイスを再生します。

書式

voice play <キャラ名> <音名> [音量0〜100]

Resources/Audio/VOICE/<キャラ名>/<音名>.wav (または .mp3) を再生します。 末尾の音量は、ユーザー設定の音量に対する割合 (0〜100) です。

引数 説明
キャラ名 ボイスのフォルダ名。
音名 ファイル名 (拡張子なし)。
音量 (省略可) 0〜100。

例

voice play kyouka v01
voice play kyouka v02 50

対応ランタイム

ランタイム 対応 補足
Windows (Unity) ○ 音量の指定に対応しています。
XZ80 ○ 音量の指定は無視します。
MSX (V9990) △ FM 音源 (OPLL) による近似音声で再生します。音量の指定は無視します。
PSP ○ 音量の指定に対応しています。
X68000 △ 再生中は BGM が一時中断します。音量の指定は無視します。

fm — FM 音源で MML を再生

Resources/Audio/BGM の MML を FM 音源でループ再生・停止します。

書式

fm play <MMLファイル名> [opna|opll]
fm stop
fm fadeout <秒数>

Resources/Audio/BGM/ の MML ファイルを FM 音源で BGM としてループ再生します。拡張子 (.mml / .txt) は省略できます。 音源を省略すると、MML から自動で判別します。

  • ; chip=opll ヘッダ、または Fray native 方言 (行頭 CHn:) → OPLL (YM2413)
  • それ以外 (; chip=opna / ; chip=dual ヘッダ、DPS/MXDRV 方言) → OPNA (YM2608)

bgm のサンプリング BGM とは同時に鳴らせません。再生すると、サンプリング BGM は停止します。 MML の書き方は MML 書式 を参照してください。

例

fm play kyouka_bgm1
fm fadeout 2.0
fm play dps00 opna

対応ランタイム

ランタイム 対応 補足
Windows (Unity) ○ OPNA / OPLL のエミュレーションで再生します。
XZ80 ○ OPNA 系として変換して再生します。fm fadeout はすぐに停止します。
MSX (V9990) △ OPLL (MSX-MUSIC) + PSG 用に変換して再生します。OPNA 用の MML は再生できないため読み飛ばします (警告が出ます)。fm fadeout は、指定時間の経過後に停止します (音量は変化しません)。
PSP × 非対応 (読み飛ばし)
X68000 × X68000 の FM 音源 (YM2151) では再生できないため、fm play は読み飛ばします。fm stop は音声の停止として働きます。