Whaty-media-player NPM

media-player

属性

名称	类型	默认值	是否必填	说明
vid	String	/	是	播放器平台的音视频唯一id
width	String	100%	否	播放器的宽度，支持像素值和百分比两种方式，比如200px或100%，默认根据父容器宽度
height	String	100%	否	播放器的高度，支持像素值和百分比两种方式，比如200px或100%，默认根据父容器高度
autoplay	Boolean	/	否	是否自动播放注：目前大多数浏览器都会限制自动播放，该参数可能无效。
loop	Boolean	false	否	是否开启循环播放
playSafeUrl	String	/	是	获取播放加密视频凭证的接口URL。只有pc端才有该参数。
playSafeData	Boolean	/	否	请求加密视频凭证接口所需数据。只有pc端才有该参数
viewerInfo	Object	/	是	自定义观众信息。播放器上报的观看行为日志中会附带观众信息{id: XXX, name: XXX}
poster	String	/	否	播放器封面默认为视频第一秒的截图。默认样式铺满
primaryColor	String	#669900FF	否	播放器主题色
lang	String	ZH	否	播放器语种中文ZH 英语EN
initVolume	Number	50	否	播放器初始音量，取值范围0, 100。
speed	Boolean/Array	/	否	当speed参数值为boolean类型时，代表是否显示倍速切换的按钮。当参数值为数组时，则代表倍速切换的可选速率。最多可设置6个速率，取值范围：(0,3]。PC端默认值为：2, 1.5, 1.2, 0.5，移动端默认值为：1, 1.5, 2。
ban_seek	String	off	否	是否禁止拖拽进度条，取值：{on,off}注：Android系统下各厂商浏览器表现不一致，该参数可能不生效。
ban_seek_by_limit_time	String	off	否	是否禁止拖拽进度至视频未播放到的位置，取值：{on,off}。为on时只可在已播放过的进度范围内拖拽（向前拖拽）。
watchStartTime	Number	/	否	播放开始时间，表示视频从第几秒开始播放，参数值需小于视频时长。
showHd	Boolean	true	否	是否显示清晰度选择按钮。
df	String	SD	否	视频清晰度，可选值LD: 普清, SD: 标清, HD: 高清。若该视频下清晰度对应转码列表未转码成功则显示自动。
ITSupport	Object	/	否	播放器右键显示card内容，不传只显示播放器版本号。{text: 内容文本, link: 跳转地址}
code	String	/	否	自定义跑马灯内容

方法

名称	参数及类型	返回值及类型	说明
playVideo	/	/	播放视频
pauseVideo	/	/	暂停播放
seekVideo	Number	/	跳转到某个时刻播放，单位：秒
getDuration	/	Number	获取视频总时长，单位：秒。
getCurrentTime	/	Number	获取视频当前的播放时刻，单位：秒。
setVolume	Number	/	设置视频播放音量，取值范围0, 100区间
changeVid	String/Object	/	切换到下一个视频传参为String类型时为vid传参为Object类型时为Object.assign({vid: XXX}, options)
updateVideoDefinition	String	/	切换清晰度，参数取值LD/SD/HD，分别对应普清，标清，高清
fullScreenChange	/	/	全屏/退出全屏切换因移动端不同手机限制，该方法可能不生效

事件

名称	说明
wpv-init-over	播放器初始化完毕时触发。播放器提供的方法需要在此事件发生后才可以调用
wpv-first-play	视频初次播放时触发
wpv-play	视频初次播放或由暂停恢复播放时触发
wpv-pause	视频暂停时触发
wpv-ended	视频播放结束时触发
wpv-volume-change	播放音频发生变化时触发，变化后的音量
wpv-seeked	视频拖拽进度时触发，参数返回拖拽开始、拖拽结束的时间点以及vid
wpv-full-screen-change	播放器改变全屏状态时触发，参数返回Boolean，true代表全屏，false代表非全屏
wpv-error	播放器加载错误时触发