Createplaylist_创建播放列表
通过 <<track>> 子宏把轨道(必须先经 <<cacheaudio>> 设置)收集到一个播放列表里。(<<createplaylist>> 是「歌单」——把曲目排好队,之后 <<playlist>> 一键播放。)
语法
SugarCube
<<createplaylist listId>>
[<<track trackId actionList>> …]
<</createplaylist>>参数
<<createplaylist>>
listId:播放列表 ID,用于引用。
<<track>>
trackId:轨道 ID。actionList:要执行的动作列表。可用动作:volumelevel:(可选)设置轨道在列表中的基础音量,省略则用轨道当前音量。有效值0(静音)到1(最响)。own:(可选)关键字,表示列表应创建轨道的独立副本,而非引用现有版本。自有副本完全由列表控制——<<audio>>动作(即使使用组 ID)也无法影响它们。
示例
SugarCube
/* 给定设置 */
<<cacheaudio "swamped" "media/audio/Swamped.mp3">>
<<cacheaudio "heavens_a_lie" "media/audio/Heaven's_A_Lie.mp3">>
<<cacheaudio "closer" "media/audio/Closer.mp3">>
<<cacheaudio "to_the_edge" "media/audio/To_The_Edge.mp3">>
/* 建列表 "bgm_lacuna" */
<<createplaylist "bgm_lacuna">>
<<track "swamped" volume 1>> /* 100% 音量 */
<<track "heavens_a_lie" volume 0.5>> /* 50% 音量 */
<<track "closer" own>> /* 独立副本,当前音量 */
<<track "to_the_edge" volume 1 own>> /* 独立副本,100% 音量 */
<</createplaylist>>注意:
StoryInit特殊段落通常是设置播放列表的最佳位置。