插件属性

以下属性可以直接在插件实例上获取

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''假如 autoloadtrue,则当我们设置 src 后,该地址会加载到 video 元素上,并作出相应加载。若果 autoloadfalse, 则意味着我们仅仅在 videoConfig 上设置了地址,此时可以手动调用 load 方法进行
    autoplay是否自动播放booleanfalseautoplay 指在分配 src 后自动播放,即调用chimee.load()后。
    controls是否展示控制条booleanfalse在没有安装任何皮肤插件时,该属性控制是否展示原生控制条。若果安装了皮肤插件,则意味着是否展示皮肤自带的控制条。
    widthvideo 的宽度number \string'100%'支持数字、百分比或像素值。在大部分浏览器下,数字和px值一致,其余单位没有效果,建议尽量使用数字。且该属性优先级较低,会被 CSS 值覆盖。建议谨慎使用。
    heightvideo 的高度number \string'100%'支持数字、百分比或像素值。在大部分浏览器下,数字和px值一致,其余单位没有效果,建议尽量使用数字。且该属性优先级较低,会被 CSS 值覆盖。建议谨慎使用。
    crossOrigin是否跨域booleanundefined
    loop是否循环booleanfalse
    muted是否静音booleanfalse
    preload是否预加载stringauto
    poster封面string''
    playsInline是否内联booleanfalse我们会为此添加 playsinle webkit-playsinline x5-playsinline
    xWebkitAirplay是否添加 x-webkit-airplaybooleanfalse
    x5VideoPlayerFullscreen是否添加x5-video-play-fullscreenbooleanfalse
    x5VideoOrientationx5-video-orientationstring \voidundefined可选 landscape 和 portrait
    x5VideoPlayerTypex5-video-player-type'h5' \voidundefined
    playbackRate回放速率number1大于1加速,小于1减速
    defaultPlaybackRate默认回放速率number1大于1加速,小于1减速
    autoload设置src时是否进行自动加载booleantrue
    defaultMuted是否是默认静音booleanfalse对应于 video 上的 muted 标签
    disableRemotePlayback是否不展示远程回放标志booleanfalse对应于 video 上的 disableRemotePlayback 标签
    volume音量number1
注意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 写成如下格式。

  1. <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,代表播放位置,可用于快进后退