bgm

播放背景音乐、切换背景音乐、停止背景音乐、设置背景音乐参数的四合一命令。

语句内容

填写背景音乐的路径。当文件路径为空或为 none 时，表示停止播放。
详情请见音频。

; 如果没有背景音乐，则此句表示播放背景音乐。
bgm:01.wav;
; 如果已有背景音乐存在，则此句表示切换背景音乐。
bgm:02.wav;
; 如果填写 none 或不填时，则此句表示停止播放背景音乐。
bgm:;

若背景音乐的路径不变，则不会打断背景音乐, 而是将新参数应用到背景音乐上。

bgm:morning.wav;
; 调整音量，但不会打断背景音乐
bgm:morning.wav -volume=50;

参数

volume

• 数字
• 范围：0 到 100
• 默认值：100

音乐音量百分比。

bgm:01.wav -volume=100;
bgm:01.wav -volume=50; 调整音量

enter

• 数字
• 单位：毫秒
• 范围：0 到正无穷
• 默认值：0

背景音乐的淡入时间。

bgm:01.wav -enter=1500;
bgm:02.wav -enter=1500;

unlockname

• 字符串

填写一个名称，BGM 鉴赏将收录该音乐，并以该名称进行展示。如果不填写该参数，或名称为空，则不会收录此音乐。

同一首音乐（严格来说是同路径的音乐）只能拥有一个展示名称。如果同一首音乐以不同的名称被收录多次，仅保留最后一次收录时填写的名称。

bgm:01.wav -unlockname=MyBgm01;

series

• 字符串

填写一个名称，BGM 鉴赏将收录该音乐到指定名称的系列中，如果不填写该参数，或系列名称为空，则会将该音乐收录到默认系列中。

默认系列
  | - BGM 名称 1
  | - BGM 名称 2
系列名称 1
  | - BGM 名称 3
  | - BGM 名称 4
  | - BGM 名称 5
系列名称 2
  | - BGM 名称 6

同一首音乐（严格来说是同路径的音乐）只能拥有存在于一个系列。如果同一首音乐被收录在多个系列中，该音乐只会存在于最后一次收录时填写的系列中。

单独填写 series 不会进行收录，请确保同时填写了 unlockname。

bgm:01.wav -unlockname=MyBgm01 -series=MySeries01;