Skip to content

Video

Video的属性说明

属性类型默认值权限说明
autoplaybooleanfalse读写视频是否自动播放
currentTimenumber0读写视频的当前播放位置, 单位为秒(s), 合理值范围为 [0, duration]; 若无视频源则取值为 0; 若是直播则无法通过设置该属性进行视频跳转
defaultPlaybackRate(*)number1.0读写视频的默认播放速度, 在 src 之前赋值才生效, 合理值范围为 [0.1, 16]
durationnumberNaN视频总时长, 单位为秒(s); 若是没有指定视频源, 则取值为NaN; 若是直播, 取值为 Infinity
endedbooleanfalse当前是否已经播放结束
errorobjectnull为最近一次的错误返回一个错误信息对象
livebooleanfalse是否为直播
loopbooleanfalse读写视频循环播放
mutedbolleanfalse读写视频静音状态
obeyMuteSwitchbooleanfalse读写视频是否遵循系统静音开关设置(仅iOS)
pausedbooleanfalse当前是否处于暂停状态
playbackRate(*)number1.0读写视频的播放速度, 在 src 之后赋值才生效, 合理值范围为 [0.1, 16]
playedTimeRangesnull当前视频已播放的时间范围
instanceIDnumber0视频播放器实例唯一ID
preloadstringmetadata读写视频预加载策略, 合法值为 (1)”none“: 不预加载任何内容(2)“metadata”:当加载的内容足够解析出 metadata 时, 即停止加载(3)"auto": 尽可能多的加载内容 (4)空值 "": auto 值的同义词 注意: (1) preload == none 时, 不校验 src(2) preload == none 时, 不加载非自定义封面
seekingbooleanfalse当前是否正在 seek
srcstring空字符串读写视频源
videoHeightnumber0视频的固有高度
videoWidthnumber0视频的固有宽度
volumenumber1读写音量, 合理值范围为 [0.0, 1.0]

属性说明

  1. error: error 表示最近一次错误的信息, 如果没有错误则为 null

    Object error 属性说明

    属性类型说明
    codenumber错误代码
    messageString错误描述

    其中, error.code 合法取值如下表

    名称取值说明
    MEDIA_ERR_NONE0正常
    MEDIA_ERR_ABORTED1当获取视频内容过程被终止
    MEDIA_ERR_NETWORK2当下载时发生错误
    MEDIA_ERR_DECODE3当解码时发生错误
    MEDIA_ERR_SRC_NOT_SUPPORTED4video 的 src 指向不支持的资源类型
  2. videoHeight & videoWidth: 视频的固有尺寸, 以像素为单位

    (1)显示封面时, videoHeiht 、videoWidth 为封面的长宽

    (2)显示视频内容时, videoHeiht 、videoWidth 为视频内容的长宽

    loadedmetadata 事件之后,videoHeight、videoWidth 中任意一个属性变化则会触发一个 resize 事件