# API

player是播放器的实例对象。

let player=new Player({
  id:'mse',
  url:'/mp4/'
})

# 属性

# 方法

# play

• 说明： 播放

• 举例：

player.play()

# pause

• 说明： 暂停

• 举例：

player.pause()

# reload

• 说明： 重新加载视频

• 举例：

player.reload()

# destroy

• 说明： 播放器销毁

• 举例：

player.destroy(isDelDom) // 参数 isDelDom: true 删除内部DOM元素 | false 保留内部DOM元素，默认为true

# canPlayType

• 说明： 检测您的浏览器是否能播放不同类型的视频

• 举例：

player.canPlayType('video/mp4; codecs="avc1.64001E, mp4a.40.5"')

# getBufferedRange

• 说明： 返回当前的缓冲片段时间范围，start表示缓冲起始时间，end表示缓存截止时间

• 返回值 [start,end]

• 举例：

player.getBufferedRange()

# getFullscreen

• 说明：播放器进入全屏

• 举例：

player.getFullscreen(player.root)

# exitFullscreen

• 说明：播放器退出全屏

• 举例：

player.exitFullscreen(player.root)

# getCssFullscreen

• 说明：播放器进入样式全屏

• 举例：

player.getCssFullscreen()

# exitCssFullscreen

• 说明：播放器退出样式全屏

• 举例：

player.exitCssFullscreen()

# getMiniplayer

• 说明：播放器进入迷你播放器模式

• 举例：

player.getMiniplayer()

# exitMiniplayer

• 说明：播放器退出迷你播放器模式

• 举例：

player.exitMiniplayer()

# rotate

• 说明：播放器旋转

• 参数： clockwise 是否顺时针旋转，默认false； innerRotate 是否内部旋转，默认true； times 旋转次数（一次旋转90度），默认1

• 举例：

player.rotate(true, true, 1)

# start

• 说明： 启动播放器，start一般都是播放器内部隐式调用，主要功能是将video添加到DOM

• 参数： url 视频地址

• 举例：

player.start(url)

# replay

• 说明： 播放器重播，重播的组件就调用了这个方法。

• 举例：

player.replay()

# install 【静态方法】

• 说明： 插件的安装方法

• 举例：

Player.install('play',function(){})

# 切换视频源

player.src = 'new url'

# 切换封面图

player.poster = 'new poster url'

# 事件

# 事件注册/注销

# 永久注册

player.on('事件名',function(){
  //事件名称可以在上述查询
})

# 一次注册

player.once('事件名',function(){

})

# 事件注销

player.off('事件名',function(){

})

# 事件触发

player.emit('事件名')

# 生命周期

# 实例化完成

播放器调用Player进行实例化，实例化结束后会触发 ready 事件，通过对 ready 的监听可以确定实例化是否完成。实例化主要包括自定义UI生成、事件绑定、插件化实例化工作。代码如下：

let player=new Player({/*配置*/});
player.once('ready',()=>{console.log('ready')})

# 视频生成结束

考虑到节约视频流量和HTTP连接数的限制，PC端播放器在实例化的时候只是UI生效并未生成video视频，只有点击播放后才会创建video标签拉取视频进行播放。如果想捕获创建video的时机，监听 complete 事件。代码如下：

let player=new Player({/*配置*/});
player.once('complete',()=>{console.log('complete')})

不过值得注意的是，没有使用白名单的手机端会创建的原生的video。由于部分机型对插入的video有bug，所以播放器实例化的时候会直接生成video，这个动作的执行是在mobile插件，所以意味着 complete 事件会先于 ready 事件。

# 实例已销毁

播放器在销毁实例的时候会触发 destroy 事件，代码如下：

let player=new Player({/*配置*/});
player.once('destroy',()=>{console.log('destroy')})

• 错误的使用方式

  let player=new Player({/*配置*/});
  setTimeout(function () {
    player.once('ready',()=>{console.log('ready')})
  }, 1000);
  

• 正确的使用方式

let player=new Player({/*配置*/});
player.once('ready',()=>{
  setTimeout(function () {
    console.log('ready')
  }, 1000);
})

# 辅助库

# util

• createDom
• hasClass
• addClass
• removeClass
• toggleClass
• findDom
• format
• event

# sniffer

• browser
• platform
• version
• device