music

HTML5悬浮音乐播放器插件

介绍

gui-MusicPlayer.js插件是一款由小枫开发的开源式的HTML5悬浮音乐播放器插件，由原生JS开发无任何依赖，引入两行代码就能给网页添加漂亮的音乐播放器！改播放器目前有6种不同颜色的主题样式可任意切换 + 3种获取音乐的方式！

注意：该插件代码有用到ES6语法和css3新特性，如果你使用浏览器内核还是IE10以下，那请回避吧~

演示站 https://y.cenguigui.cn/YYDS/musicPlayer/

开源地址：

https://gitee.com/cenguigui/html5-music-player

展示图

gui-MusicPlayer-pic

获取音乐方式

获取网易云【热歌榜, 新歌榜, 飙升榜, 原创榜】默认为热歌榜（每周二0:20每个歌榜更新100首音乐，vip歌曲自动跳过）。
通过网易云的歌单id获取该歌单所有音乐。（注意：不支持解析VIP音乐）
自定义音乐，通过修改 playlistData.json 文件自定义歌曲，相对来说比较繁琐，如果你要自定义音乐推荐上面的方式。

文本教程

如果你用过笒鬼鬼音乐播放器 y.cenguigui.cn 再用这个插件那你不用看可直接上手。代码放到</body>的上面即可

<!DOCTYPE html> // html5声明
<html lang="en"> // 网页声明 zh-CN指的是中文 cn就是英文
    <head> // 头部标签 ==> 指的是头部标签开始
        <meta charset="UTF-8"> // 声明字符编码
        <title>Document</title> // 网页标题
    </head> // 头部结尾标签 ==> 指的是头部标签结束
    
    <body> // 页面主体开始
    
            中间的是网页其他的内容代码
    
            <!-- 这里就是显示网页内容的地方，也就是放播放器代码的地方！ -->
            <div id="gui-MusicPlayer" data-cdnName="https://y.cenguigui.cn/js"></div>
            <script src="https://y.cenguigui.cn/js/gui-MusicPlayer/js/gui-MusicPlayer.min.js"></script>
    </body> // 页面主体结束
</html> // 结尾

俺用的是以下的：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>demo</title>
    <link rel="shortcut icon" href="https://y.cenguigui.cn/lihua/image/logo.jpg" type="image/x-icon">
</head>
<body>
    <!--注释，加载黑胶vip热歌榜，设置cdn引入的路径，选择播放器颜色，随机播放器歌曲，让播放器淡出-->
    <div id="gui-MusicPlayer" data-songChart="黑胶vip热歌榜" data-cdnName="https://y.cenguigui.cn/js" data-themeColor="gui-wineRed" data-random="true" data-fadeOutAutoplay></div>
    <script src="https://y.cenguigui.cn/js/gui-MusicPlayer/js/gui-MusicPlayer.js"></script>
</body>
</html>

方法一：直接引入插件CDN，复制下面的代码就能直接使用（注意data-cdnName的属性不能删除）

<!-- 配置播放器 -->
<div id="gui-MusicPlayer" data-cdnName="https://y.cenguigui.cn/js"></div>

<!-- 引入外部CDN插件 -->
<script src="https://y.cenguigui.cn/js/gui-MusicPlayer/js/gui-MusicPlayer.min.js"></script>

方法二：插件下载到本地运行（注意引入正确的插件路径）

<!-- 配置播放器 -->
<div id="gui-MusicPlayer"></div>

<!-- 引入插件 -->
<script src="/gui-MusicPlayer/js/gui-MusicPlayer.min.js"></script>

全局属性配置

id=”gui-MusicPlayer”属性：初始化音乐播放器【必填】

示例代码：

也可以把id换成class，但是只能存在一个

<div id="gui-MusicPlayer"></div>

data-cdnName属性：自定义CDN域名 data-cdnName=”http:// + cdn域名 + 路径”，后面不加/，和你添加js插件的路径一样否则网页样式全部失效！【选填】

示例代码：

比如你CDN的路径是：https://y.cenguigui.cn/js/gui-MusicPlayer/js/gui-MusicPlayer.min.js

那下面的data-filePath属性就要和上面的一样

<div id="gui-MusicPlayer" data-cdnName="https://y.cenguigui.cn/js"></div>

data-filePath属性：如果你本地修改了插件的文件路径就必须使用这个属性，和你添加js插件的路径一样否则网页样式全部失效！【选填】

示例代码：

比如你插件的路径是：/zdy/music/gui-MusicPlayer/js/gui-MusicPlayer.min.js

那下面的data-filePath属性就要和上面的一样

<div id="gui-MusicPlayer" data-filePath="/zdy/music/"></div>

data-fadeOutAutoplay属性：自动淡出音乐播放器，默认不淡出，后面不跟参数【选填】

示例代码：

<div id="gui-MusicPlayer"  data-fadeOutAutoplay></div>

data-themeColor属性：切换播放器主题颜色【gui-original（默认主题），gui-sky（天空），gui-orange（橙子），gui-darkGreen（墨绿），gui-wineRed（酒红），gui-girlPink（少女粉）】【选填】

示例代码：

如果你啥也不添加那就是默认主题颜色样式，下面是更换少女粉主题示例

<div id="gui-MusicPlayer"  data-themeColor="gui-girlPink"></div>

6. data-random属性：打开页面随机返回一个歌曲，也可以用来定义从哪首歌开始播放

随机播放示例：

<div id="gui-MusicPlayer"  data-random="true"></div>

自定义播放器歌曲数值（演示第3首）示例：

<div id="gui-MusicPlayer"  data-random="3"></div>

网易云接口版属性配置（不能解析VIP歌曲）

data-musicApi属性：自定义播放API接口，接口已嵌入默认接口【选填】

示例代码：

<div id="gui-MusicPlayer"  data-musicApi="musicapi.cenguigui.cn"></div>

data-songChart属性：获取网易云歌榜【热歌榜（默认歌榜），新歌榜，飙升榜，原创榜，黑胶vip热歌榜，说唱榜，古典榜，韩语榜，日语榜，国风榜，中文DJ榜，网络热歌榜，蛋仔派对听歌榜】，每周二0:20每个歌榜更新100首音乐，vip歌曲自动跳过【选填】

示例代码：

如果你啥也不添加那就是默认的热歌榜的音乐，下面是更换新歌榜音乐

<div id="gui-MusicPlayer"  data-songChart="新歌榜"></div>

data-songList属性：获取网易云歌单音乐，如果你发现歌曲播放不了那肯定是VIP歌曲，支持动态更新 data-songList=”歌单ID”【选填】

示例代码：

<div id="gui-MusicPlayer"  data-songList="2192163086"></div>

本地音乐属性配置

data-localMusic属性：本地音乐，填写 playlistData.json 文件路径【本地音乐必填】

示例代码：

注意引入的是playlistData.json文件的路径

<div id="gui-MusicPlayer"  data-localMusic="playlistData.json"></div>