游玩谱子的函数

与游戏界面（不是主菜单）、歌曲和过场动画相关的一些功能。

---

startCountdown

用法: startCountdown()

这个函数会在过场动画播放完后调用，如果没有过程动画，就是当歌曲开始时调用。

---

endSong

用法: endSong()

在歌曲结束时调用, 你可以用 Lua/HScript 回调 "onEndSong" 来重新播放过程动画再开始歌曲。

---

getSongPosition

用法: getSongPosition()

获取当前歌曲过的时间，以毫秒为单位。1000毫秒=1秒

---

restartSong

restartSong(?skipTransition:Bool = false):Void

在重新开始歌曲的时候调用

• skipTransition (可选) - 跳过淡出/淡入的过度, 默认不开启。

---

exitSong

exitSong(?skipTransition:Bool = false):Void

当从歌曲退出到Freeplay和StoryMode时调用.

• skipTransition (可选) - 跳过淡出/淡入的过度, 默认不开启。

---

loadSong

loadSong(?name:String = null, ?difficultyNum:Int = -1):Void

加载别的歌曲。

• name (可选) - 歌曲名字 (比如说 "Bopeebo", "Lit Up").
• difficultyNum (可选) - 歌曲的难度 (0 = Easy, 1 = Normal, 2 = Hard), 可以使用-1来表示使用当前歌曲的难度

---

triggerEvent

triggerEvent(name:String, ?value1:String = '', ?value2:String = ''):Bool

调用事件，跟谱子编辑器是差不多的。
应该总是返回 "true".

• name - 事件名称。
• value1 (可选) - 跟谱子编辑器一样。
• value2 (可选) - 跟谱子编辑器一样。

举个例子:

• triggerEvent('Hey!', 'BF', 0.6) - 调用名字叫"Hey!"的事件。

---

setHealthBarColors

setHealthBarColors(left:String, right:String):Void

改变血条的颜色

• left - 颜色的16进制或者 颜色名称/a> ，这是左侧的血条的颜色。
• right - 颜色的16进制或者 颜色名称 ，这是右侧的血条的颜色。

举个例子:

• setHealthBarColors('FF0000', '00FF00') - 让左边的血条变成红色，右边的变成灰色，这里可以使用颜色的16进制。
• setHealthBarColors('red', 'lime') - 和上面一样，但是我们这里用的是颜色名称。

---

setTimeBarColors

setTimeBarColors(left:String, right:String):Void

改变时间条的颜色

• left - 颜色的16进制或者颜色名称，这是左侧的条的颜色。
• right - 颜色的16进制或者颜色名称 这是右侧的条的颜色。

举个例子:

• setTimeBarColors('FF0000', '00FF00') - 让左边的条变成红色，右边的变成灰色，这里可以使用颜色的16进制。
• setTimeBarColors('red', 'lime') - 和上面一样，但是我们这里用的是颜色名称。

---

startDialogue

startDialogue(dialogueFile:String, ?music:String):Void

开启对话 在Chart文件夹中加载一个Dialog.JSON，自动翻译并加载。

• dialogueFile - 对话的json名字
• music (Optional) - 你可以播放"music/" 的音乐.

举个例子:

• startDialogue('dialogue') - 在Chart文件夹中加载“Dialog.json”，如果你使用葡萄牙语（巴西），将首选“Dialog_pt-BR.json”。
• startDialogue('dialogue', 'breakfast') - 跟上面一样，但是会播放"Breakfast" 作为背景音乐。

---

startVideo

startVideo(videoFile:String, ?canSkip:Bool = true):Void

在HUD上播放视频

• videoFile - 会在"videos/" 里加载一个视频。
• canSkip (可选) - 这个视频能不能被跳过，默认能跳过。

举个例子:

• startVideo('test_video') - 播放 mods/My-Mod/videos/test_video.mp4的视频。