DanmuPlayer
Html5弹幕视频播放器插件
Danmmu Player是一个轻量级具备弹幕功能的Html5视频播放器,仅63KB大小。
具备弹幕视频播放,接受用户发送彩色弹幕,实时调解弹幕显示效果等功能。
Danmmu Player意在使开发者能便捷的在网站中实现弹幕视频播放。
更新日志
Vision 4
1.放弃了以秒做单秒,继续改用分秒。
2.对弹幕位置布局做了进一步优化。
3.性能继续提升。
4.bug增量修复
Vision 3
1.增加了弹幕显示的数量的控制,屏幕上的显示的弹幕数量和每秒的最大弹幕数量。
2.大幅度的性能优化,大幅度减少了漏帧的问题。
3.增加了缓冲条和缓冲时等待的效果。
4.切割了所使用的web font,大幅的减少了体积。
5.对弹幕位置做了进一步优化,减少了重叠现象的发送。
Vision 2
1.和videojs解耦合,提高了运行效率和稳定性。
2.API规范化。 *API有较大变化。
3.弹幕较少时主要飘于视频的上半部分,与AB站相同。
4.一个页面可以添加多个播放器啦。
*.此版本API较上一版本有较大改变,若需使用上一版本,请去OldEdition目录下。
###开始使用
1.第一步引入本播放器的js和css文件,需要和jQuery一起引用。
2.新建一个div,这里把id值设为danmp
3.初始化DanmuPlayer,利用刚才新建的div.
$("#danmup").danmuplayer({
src:"shsn.mp4", //视频源
width:800,//视频宽度
height:445//视频高度
});
好了,已经可以在页面上看到播放器。试着发下弹幕,也OK。
等等,现在用户发的弹幕貌似没有写入数据库,也就是说是一次性的,刷新页面后就没了?是这样的,但是接下来就告诉你可以怎么做。
###进阶使用
4.在上一步中,我们用调用某jQuery对象的方法初始化了一个弹幕播放器,并传递了一些参数(src,width,height)。其实这个方法具有以下参数 (除了视频源外其余参数均可选,冒号后面的为默认值)
src: "shsn.mp4", //视频源
height: 450, //播放器的高度
width: 800,//播放器的宽度,最小宽度支持为720
speed:20000,//弹幕速度,这是数值指的是视频穿过672像素所需要的毫秒数
sumTime:65535,//弹幕视频的总时间,可不填。
danmuList:{},//弹幕列表
defaultColor:"#ffffff", //弹幕的默认字体颜色
fontSizeSmall:16,//小弹幕的字号
FontSizeBig:24,//大弹幕的字号
opacity:"1", //弹幕默认透明度
topBottonDanmuTime:6000, //底部及顶部弹幕存留的时间
urlToGetDanmu:"", //用来接收弹幕信息的url (稍后介绍)
urlToPostDanmu:"" , //用来存储弹幕信息的url (稍后介绍)
maxCountInScreen: 40, //屏幕上的最大的显示弹幕数目,弹幕数量过多时,优先加载最新的。
maxCountPerSec: 10 //每分秒秒钟最多的弹幕数目,弹幕数量过多时,优先加载最新的。
});
5.向米娜桑介绍DanmuPlayer中的js对象:danmu对象。
danmu对象意指具体某一条弹幕以及它的信息,它有如下属性:
text——弹幕文本内容。
color——弹幕颜色。
position——弹幕位置 0为滚动 1 为顶部 2为底部
size——弹幕文字大小。 0为小字 1为大字
time——弹幕所出现的时间。 单位为分秒(十分之一秒)
isnew——当出现该属性时(属性值可为任意),会认为这是用户新发的弹幕,从而弹幕在显示的时候会有边框。
举例:
var aDanmu={ text:"这是弹幕" ,color:"white",size:1,position:0,time:2};
要显示边框的新弹幕:
var aDanmu={ text:"这是弹幕" ,color:"white",size:1,position:1,time:2,isnew:1};
6.在这一节中,告诉米娜桑如何和后端连接将弹幕存储于数据库。DanmuPlayer提供了高度封装的和后端ajax交互的接口,你只需按照接口修改出一个或两个后端页面即可。当然,也可以使用自己的接口!
方法1:
在初始化DanmuPlayer时,两个参数urlToGetDanmu和urlToPostDanmu就是用来和后端连接的。urlToGetDanmu用来获取弹幕,urlToPostDanmu用来存储弹幕。urlToGetDanmu和urlToPostDanmu接受的参数都是url。
DanmuPlayer在页面载入时,会向urlToGetDanmu所对应的页面发送Get请求,urlToGetDanmu对应页面的http响应报文的内容中应该是一个由danmu对象组成的js数组(字符串形式)。"['{danmmu对象1}','{danmu对象2}',...,'{danmu对象n}']"这样的字符串(遵循JSON格式标准)(在报文中是没有最外面的引号的)(注意:每个danmu对象都要被引号所包裹,否则会产生致命错误)。
当用户发弹幕时,DanmuPlayer向urlToPostDanmu发送post请求,报文的内容是用户所发弹幕的danmu对象(字符串)(遵循JSON格式标准)。
如果你需要在get和post的同时向后端发送其他参数,请在URL里以get的形式发送。
gitHub的demo里有一个简单的php版的urlToGetDanmu和urlToPostDanmu所对应页面的编写示例:
方法2:
使用如下语句在视频播放前为播放器添加弹幕或弹幕数组(jQuery选择器为播放器的id、空格、 .danmu-div ):
$('#danmp .danmu-div').danmu(addDanmu,弹幕对象 或 弹幕对象数组);
举例:
$("#danmup .danmu-div").danmu("addDanmu",[
{text:"这是滚动弹幕" ,color:"white",size:1,position:0,time:2}
,{text:"这是顶部弹幕" ,color:"yellow" ,size:1,position:1,time:3}
,{text:"这是底部弹幕" , color:"red" ,size:1,position:2,time:3}
])
说明:DanmuPlayer中有一个class为danmu-div的标签(此标签是一个jQuery弹幕插件的容器,详情请参照 jQuery.danmu.js( http://github.com/chiruom/danmu )项目
7.由于DanmuPlayer中有一个html5 video便签,故几乎所有的html5 videoAPI和事件等都可用于DanmuPlayer。
可以使用代码任意改变video的播放时间,弹幕流的时间会与自动之同步。
8.注意:一个页面中可以防止多个DanmuPlayer,但是由于所有的danmuPlayer绑定有相同的键盘快捷键,可能会导致键盘事件的失灵。
9.如果你只需把弹幕应用视频除外的网页的其他位置,请看DanmuPlayer的姊妹项目jQuery.Danmu.js,它是一个独立于视频的弹幕插件。
许可
你可以随意使用本项目,只需要在您的项目中添加这么一行注释:
DanmuPlayer (//github.com/chiruom/danmuplayer/) - Licensed under the MIT license