播放状态
提示
- 请务必先阅读如何正确使用酒馆助手
- 点击查看对应类型定义文件(可发给 AI 或 IDE 使用, 酒馆助手界面中提供了打包下载)
你可以通过函数控制音频播放器的当前播放状态.
playAudio
播放给定的音频; 如果该音频没在播放列表中, 则会加入到播放列表.
ts
function playAudio(type: 'bgm' | 'ambient', audio: AudioWithOptionalTitle): void;
ts
type AudioWithOptionalTitle = {
/** 标题 */
title?: string;
/** 音频的网络链接 */
url: string;
};
参数
type
- 类型:
'bgm' | 'ambient'
- 描述: 背景音乐 ('bgm') 或音效 ('ambient')
audio
- 类型:
AudioWithOptionalTitle
- 描述: 要播放的音频; 如果音频没有设置标题 (
title
), 则会从链接 (url
) 提取文件名作为标题
示例
ts
playAudio('bgm', { url: 'http://commondatastorage.googleapis.com/codeskulptor-demos/DDR_assets/Kangaroo_MusiQue_-_The_Neverwritten_Role_Playing_Game.mp3' });
ts
playAudio('bgm', { title: 'Kangaroo Music', url: 'http://commondatastorage.googleapis.com/codeskulptor-demos/DDR_assets/Kangaroo_MusiQue_-_The_Neverwritten_Role_Playing_Game.mp3' });
pauseAudio
暂停音乐
ts
function pauseAudio(type: 'bgm' | 'ambient'): void;
参数
type
- 类型:
'bgm' | 'ambient'
- 描述: 背景音乐 ('bgm') 或音效 ('ambient')