插件属性
以下属性可以直接在插件实例上获取
ready
- 类型:
Promise<*>
- 含义:标志该插件是否安装完毕。安装完毕后会置为
resolved
的状态
readySync
- 类型:
boolean
- 含义:标志该插件是否安装完毕。安装完毕后会置为
true
$dom
- 类型:
HTMLElement
- 含义:插件所拥有的 dom 节点
$wrapper
- 类型:
HTMLElement
- 不建议使用,wrapper 对应的 DOM 节点
$container
- 类型:
HTMLElement
- 不建议使用,container 对应的 DOM 节点
$video
- 类型:
HTMLVideoElement
- 不建议使用,video 对应的 DOM 节点
$level
- 类型:
number
- 含义:插件的层级优先值
- 注意事项
- 可动态设置
$operable
- 类型:
boolean
- 含义:插件是否可操作
- 注意事项
- 可动态设置
$config
- 类型:
Object
- 含义:用户对该插件的参数设置
$videoConfig
- 类型:
Object
- 含义:播放器的参数设置
属性 含义 类型 默认值 备注 src 播放地址 string '' 假如 autoload
为true
,则当我们设置src
后,该地址会加载到video
元素上,并作出相应加载。若果autoload
为false
, 则意味着我们仅仅在videoConfig
上设置了地址,此时可以手动调用load
方法进行autoplay 是否自动播放 boolean false autoplay 指在分配 src 后自动播放,即调用 chimee.load()
后。controls 是否展示控制条 boolean false 在没有安装任何皮肤插件时,该属性控制是否展示原生控制条。若果安装了皮肤插件,则意味着是否展示皮肤自带的控制条。 width video 的宽度 number \ string '100%' 支持数字、百分比或像素值。在大部分浏览器下,数字和 px
值一致,其余单位没有效果,建议尽量使用数字。且该属性优先级较低,会被 CSS 值覆盖。建议谨慎使用。height video 的高度 number \ string '100%' 支持数字、百分比或像素值。在大部分浏览器下,数字和 px
值一致,其余单位没有效果,建议尽量使用数字。且该属性优先级较低,会被 CSS 值覆盖。建议谨慎使用。crossOrigin 是否跨域 boolean undefined loop 是否循环 boolean false muted 是否静音 boolean false preload 是否预加载 string auto poster 封面 string '' playsInline 是否内联 boolean false 我们会为此添加 playsinle webkit-playsinline x5-playsinline
xWebkitAirplay 是否添加 x-webkit-airplay
boolean false x5VideoPlayerFullscreen 是否添加 x5-video-play-fullscreen
boolean false x5VideoOrientation x5-video-orientation
string \ void undefined 可选 landscape 和 portrait x5VideoPlayerType x5-video-player-type
'h5' \ void undefined playbackRate 回放速率 number 1 大于1加速,小于1减速 defaultPlaybackRate 默认回放速率 number 1 大于1加速,小于1减速 autoload 设置 src
时是否进行自动加载boolean true defaultMuted 是否是默认静音 boolean false 对应于 video 上的 muted 标签 disableRemotePlayback 是否不展示远程回放标志 boolean false 对应于 video 上的 disableRemotePlayback 标签 volume 音量 number 1
注意1)autoplay 属性在并不是在所有情况下都会生效。但是通过一些配置,我们可以使其在大部分模式下生效。- 在 iOS 下需要 inline 的模式下才能自动播放,因此在传入的时候需要设置inline: true
。我们会为你设置playsinline="true" webkit-playsinline="true"
- 然而并不是所有 iOS 的 webview 都支持该模式,如果你的 iOS 版本比较旧,请检查 webView 上有否设置webview.allowsInlineMediaPlayback = YES;
- 在腾讯的 X5 浏览器也需要同理,设为inline: true
,我们会为你设置x5-playsinline
- 部分浏览器必须要一开始就添加 video 元素,此时,请将 wrapper 的 html 写成如下格式。
<div id="wrapper">
<container>
<video></video>
</container>
</div>
2)以上所有属性均可以在 chimee 实例上直接自上使用,如this.src
。
$inner
- 类型:
boolean
- 含义:是否内层插件
- 只读属性
$autoFocus
- 类型:
boolean
- 含义:是否可自动聚焦到 video
- 只读属性
$penetrate
- 类型:
boolean
- 含义:是否穿透型插件
- 只读属性
$plugins
- 类型:
Object
- 含义:所有插件实例的集合
- 注意事项
- 只读属性,不可作任何删除、改写或增加操作,否则会导致播放器运行不正常。
- 可以通过此属性查找其他插件,但应减少此类操作,尽量使用事件沟通。
$pluginsOrder
- 类型:
Array<string>
- 含义:插件执行的顺序
- 注意事项:
- 只读属性,不可作任何删除、改写或增加操作,否则会导致播放器运行不正常。
- 可以通过此属性查看自己的优先级,了解事件会被谁拦截等。
VERSION
- 类型:
string
- 含义:播放器版本
- 只读属性
以下设置均是与 video 元素属性相关的属性。可以在任意阶段直接设置。但是在 beforeCreate, create, init 阶段进行设置并不会立即设定到 video 元素上,因为此阶段还没生成 video 元素。但是会在生成 video 元素后立即设定。
buffered
- 类型:
TimeRanges
- 含义:video 上的 buffered,代表已缓冲内容。
- 只读属性
duration
- 类型:
number
- 含义:video 上的 duration, 代表视频时长
- 只读属性
volume
- 类型:
number
- 含义:video 上的 volume,代表音量
currentTime
- 类型:
number
- 含义:video 上的 currentTime,代表播放位置,可用于快进后退