3.5 zwplayer 播放器方法说明

方法名 说明
play(url, isLive, useOldFlv) 启动播放。调用此方法,将开始一个新的播放会话,如果播放器当前正在播放状态,则调用用此方法将重新打开媒体从头开始播放;如果播放器正在播放直播流,则调用此方法将关闭当前播放重新建立新连接。参数说明: url: 此参数与构造函数参数url的意义相同,请参见下面专门针对URL参数的说明章节-播放器URL参数详细说明,可以缺省;isLive: 指定要播放的url参数指定的媒体流是否直播,可以缺省;useOldFlv: 是否用旧的Flv播放接口,参见构造函数参数。所有的参数都可以缺省,如果不带任何参数调用该方法,zwplayer会用播放器内部已经存在的原始参数来启动播放,如果在调用构造函数时没有传递url参数并且从未用调用过带url参数的play方法,则play调用将失败。
stop() 停止正在进行的播放,停止播放与暂停播放不同,停止播放将清除播放器内部所有数据,将播放器置为初始状态。此播放器对象后续仍旧可以调用play来启动一个播放会话。
pause() 暂停当前的播放,暂停操作不会清除播放器内部任何数据。
resume() 恢复播放。如果播放器处于暂停状态,则播放器会从当前位置继续播放;如果播放器处于停止状态,则播放器,则播放器会开启一个新的播放会话。
getDuration() 获取播放器当前媒体的时间长度,单位为秒,类型为浮点数。 如果播放器当前没有打开媒体,返回 undefined;如果播放的媒体不能获取时间长度,则返回Infinity。
getCurrentTime() 获取播放器当前媒体的播放位置,单位为秒
seekTime(time) 定位播放时间,仅对点播节目有效。参数说明:time:要定位的时间,单位是秒,类型是浮点数。
destroy() 销毁播放器。调用此方法后,播放器将停止播放当前流,并彻底从内存中清除所有内容,后续不能再用该播放器对象调用方法,否则将出现不可预料的结果。
setplaystate(bPlaying) 设置播放状态。参数说明:bPlaying: boolean类型,为true,设置为正在播放,为false设置为暂停播放。
setEnableDanmu(bEnable) 打开或关闭弹幕功能。用户可以通过此方法在自己的界面里操控弹幕的开启与关闭。参数说明:bEnable:boolean类型,为true,开启弹幕,为false关闭弹幕。
appendDanmu(danmuObj, setting) 添加弹幕。zwplayer内部实现了弹幕渲染器,如果想在播放器里显示一条弹幕,需要调用此方法。弹幕通常是由网络弹幕服务器转发过来的,zwplayer没有绑定任何弹幕转发服务器,亦没有指定用何种弹幕传输协议,用户用自己的办法获取到弹幕后,调用此函数在播放器上显示。
setChapters(chapters) 设置章节信息。可以通过此方法在播放器启动播放后加载章节信息。参数说明:chapters: 要加载的章节信息。此参数可以是章节文件的url,章节内容文本串(js string)或者已经分析好的章节列表对象(js数组)。如果 chapters 参数为null,将移除当前章节信息。要详细了解章节信息加载,请参见设置章节信息一节。
addSubtitle(subtitleUrl, pos, title) 添加字幕。zwplayer支持同时显示两个字幕,即所谓的双字幕。参数说明:subtitleUrl:字幕文件的url,字幕文件必须是srt、vtt、json或者bcc格式之一,目前不支持其它格式。pos:字幕位置,string类型,目前字幕位置只支持‘1‘,’2‘两个值,分别表示第一字幕与第二字幕,输入其它值,则字幕不能加载。title:string类型,为字幕定义的一个用户可读的名称,方便用户选择。
removeSubtitle() 移除所有字幕。可以调用此函数将已经加载的所有字幕从播放器里移除。
buildDanmuControlbar(parentId, className) 创建弹幕输入控制工具条。弹幕输入控制工具条用于用户输入弹幕与对弹幕进行相关设置,由于通常在非全屏幕情况下,将播放器嵌套在一个DIV里,该div的空间比较小,不足以容纳弹幕控制工具条;再者自行制作一个弹幕控制工具条需要不少时间,因此,zwplayer将弹幕控制工具条的UI部分独立出来,作为一个组件,可以与zwplayer脱离安装在页面的其它div里,方便开发者设重用而不必重复发明轮子。注意:必须调用该函数,zwplayer才能在全屏幕状态下输入弹幕。参数说明:parentId: 一个用于容纳控制条的元素ID,应该用DIV元素作为控制条的父元素。如果缺省或者输入一个并不存在的ID,弹幕控制条将被创建在播放器主控制工具条内部,如果播放器主控制条的空间太小,弹幕输入控制条将不显示。className: 添加于弹幕控制条顶层DIV元素上的css类,弹幕控制条已经有一个 zwp_danmu-controlbar类,如果想对弹幕控制条的风格做进一步控制,可以设置此参数,可以缺省。
notifyResize(width, height) 播放器宽度或高度发生变化时,通知播放器。建议将播放器的playerElm参数关联的DIV元素的style设置为"width:100%;height:100%",这样播放可以随父元素的尺寸变化而变化,父元素尺寸变化时,可以无需调用此方法,推荐用此方法。 参数说明:width:新设置的宽度,string类型,单位可以为像素或百分比 height:新设置的高度,string类型,单位可以为像素或百分比
上次更新: 2024/9/14 09:30:11