参数

如何使用 Kico Player

参数类型

播放器初始化参数

参数 可选值 说明
container DOM 元素 元素选择器，可以是 document.getElementById("player")
playlist 数组 播放列表，数据类型为一个 歌曲对象
autoplay true false 是否自动播放音乐，默认为 false
show_list true false 是否展开播放列表，默认为 false
title_change true false 是否在播放音乐时修改页面标题，默认为 false

歌曲对象参数

参数 可选值 说明
title 音乐标题
artist 音乐作者
album 音乐专辑名称
cover 音乐专辑封面
link 音乐链接地址

开放接口

方法 参数 说明
play 播放当前选择的音乐
pause 暂停当前选择的音乐
toggle 切换播放/暂停
jump id 播放列表的指定音乐
prev 切换播放上一首音乐
next 切换播放下一首音乐
mode 切换当前播放模式
add 包含歌曲构造 JSON 的一个数组 向列表添加音乐
remove 删除倒数第一首音乐
toggle_list 打开或关闭播放列表
toggle_volume 切换音量

示例

引用一个播放器，添加两首音乐，默认展开列表，并开启标题切换

const player = new KPlayer({
    container: document.getElementById("player-1"),
    playlist: [
        {
            title: "Born Free",
            artist: "The Rassle",
            album: "Introducing",
            cover: "sample/cover/1.jpg",
            link: "sample/music/1.mp3"
        },
        {
            title: "Summer Vibe",
            artist: "Walk off the Earth",
            album: "Summer Vibe",
            cover: "sample/cover/2.jpg",
            link: "sample/music/2.mp3"
        }
    ],
    show_list: true,
    title_change: true
});

使播放器播放和暂停

player.play();
player.pause();

使播放器添加一首新音乐

player.add([{
    title: "Summer Vibe",
    artist: "Walk off the Earth",
    album: "Summer Vibe",
    cover: "sample/cover/2.jpg",
    link: "sample/music/2.mp3"
}]);

使播放器删除最后一首歌曲

player.remove();