控制接口
更新时间：2023-08-31
| 接口 | 参数列表 | 返回类型 | 接口功能 | 代码示例 |
|---|---|---|---|---|
| cyberplayer | String - 播放器DIV容器的id，用于盛放播放器 | Object | 在指定的DIV容器内创建一个播放器实例。 | var myPlayer =cyberplayer("playerContainer").setup({width:600,height:450,file:"http://ip:port/playlist.m3u8",image: "<Image_File>"}); |
| cyberplayer::setup | Object | 无 | 创建一个播放器。 | var myPlayer = cyberplayer("playerContainer").setup({flashplayer:"player/cyberplayer.flash.swf ", width:600,height:450,file:" http://ip:port/playlist.m3u8",image: "<Image_File> controlbar: {barLogo: false}});参数详解见下表 |
| cyberplayer::remove | 无 | 无 | 移除当前播放器。 | myPlayer.remove(); |
| cyberplayer::getPlaylist | 无 | Array | 获取当前的播放列表。 | var playlist = myPlayer. getPlaylist(); |
| cyberplayer::getPlaylistIndex | 无 | Number | 获取当前正在播放视频在播放列表中的位置，0代表第一个，依次类推。 | var playlistIndex = myPlayer. getPlaylistIndex(); |
| cyberplayer::getPlaylistItem | 无 | object | 获取当前正在播放的视频对象。 | var playlistItem = myPlayer. getPlaylistItem(); |
| cyberplayer::playlistItem | Number | object | 播放指定的播放条目，并返回该项对象，条目从0开始计数。 | var item = myPlayer.playlistItem(2); |
| cyberplayer::playlistNext | 无 | Object | 播放当前播放条目的后一项，并返回该项对象。 | var item = myPlayer.playlistNext(); |
| cyberplayer::playlistPrev | 无 | Object | 播放当前播放条目的前一项，并返回该项对象。 | var item = myPlayer.playlistPrev(); |
| cyberplayer::getBuffer | 无 | Object | 获取当前正在播放视频的缓冲时长，单位为秒。 | var buffer = myPlayer. getBuffer(); |
| cyberplayer::getState | 无 | String | 获取当前播放器状态。 | var state = myPlayer.getState();取值范围：{“playing”、“paused”、“idle”、“buffering”} |
| cyberplayer::play | 无 | 无 | 开始播放当前媒体内容。 | myPlayer.play(); |
| cyberplayer::pause | 无 | Number | 暂停播放当前媒体内容。 | myPlayer.pause(); |
| cyberplayer::stop | 无 | 无 | 停止播放当前媒体内容。 | myPlayer.stop(); |
| cyberplayer::getDuration | 无 | Number - 当前播放的媒体文件的总时长 | 获取当前播放的媒体文件的总时长。 | var duration = myPlayer.getDuration(); |
| cyberplayer::getPosition | 无 | Number | 获取当前播放的媒体文件的播放位置。 | var position = myPlayer.getPosition(); |
| cyberplayer::seek | Number - 目标播放时间 | 无 | 定位当前媒体内容开始播放的位置。 | myPlayer.seek(102); |
| cyberplayer::getMute | 无 | Boolean - true : 声音关闭； false : 声音打开 | 获取当前播放器声音是否打开。 | var mute = myPlayer.getMute(); |
| cyberplayer::getVolume | 无 | Number | 获取当前播放器的音量。 | var volume = myPlayer.getVolume(); |
| cyberplayer::setMute | Boolean - true : 关闭声音；false : 打开声音 | 无 | 设置当前播放器的声音开关。 | myPlayer.setMute(true); |
| cyberplayer::setVolume | Number - 音量大小（0-100） | 无 | 设置播放器音量。 | myPlayer.setVolume(90); |
| cyberplayer::getWidth | 无 | Number | 获取当前播放器窗口宽度。 | myPlayer.setVolume(90); |
| cyberplayer::getHeight | 无 | Number - 播放器高度 | 获取当前播放器显示窗口高度。 | var height = myPlayer.getHeight(); |
| cyberplayer::getFullscreen | 无 | Boolean - true : 全屏 ；false : 非全屏 | 获取当前播放器是否处于全屏状态。 | var fullscreen = myPlayer.getFullscreen(); |
| cyberplayer::resize | Number - 播放器宽, Number - 播放器高 | 无 | 调整播放器大小。 | myPlayer.resize(600, 400); |
| cyberplayer::setFullscreen | Boolean - true : 全屏；false : 非全屏 | 无 | 设置当前播放器是否全屏。 | myPlayer.setFullscreen(true); |
| cyberplayer::getQualityLevels | 无 | Array | 获取当前视频的所有码率。 | var qualityLevels = myPlayer.getQualityLevels(); |
| cyberplayer::getCurrentQuality | 无 | Number | 获取当前正在播放视频的码率索引，从0开始。 | var currentQuality = myPlayer.getCurrentQuality(); |
| cyberplayer::getControls | 无 | Boolean | 获得是否能展现播放器的controlbar。 | var controls = myPlayer.getControls(); |
| cyberplayer::getSafeRegion | 无 | Object | 获得播放器的位置对象。 | var region = myPlayer.getSafeRegion(); |
| cyberplayer::setControls | Boolean - true : 显示；false : 不显示 | Object | 设置播放器是否显示controlbar。 | myPlayer.setControls(); |
| cyberplayer::getMeta | 无 | Object - 元数据对象 | 获取当前播放的媒体文件的元数据对象。 | var meta = myPlayer.getMeta(); |
| cyberplayer::getRenderingMode | 无 | String - 渲染模式 | 获取当前播放器的渲染模式。 | var mode = myPlayer.getRenderingMode();取值范围：{“flash”、“html5”} |
| cyberplayer::getCaptionsList | 无 | Array | 获取当前视频的所有字符对象。 | var captionList = myPlayer.getCaptionList(); |
| cyberplayer::getCurrentCaptions | 无 | Number | 获取当前正在使用的字符文件索引，用0开始。 | var currentCaptions = myPlayer.getCurrentCaptions(); |
| cyberplayer::setCurrentCaptions | Number | Object | 设置使用某种特定字幕。 | myPlayer.setCurrentCaptions(1); |
| cyberplayer::setScreenshot | 无 | 无 | 播放器视频截图。 | myPlayer.setScreenshot(); |
| cyberplayer::setCaptureFrameStart | 无 | 无 | 播放器开启视频录制。 | myPlayer.setCaptureFrameStart(); |
| cyberplayer::setCaptureFrameEnd | 无 | 无 | 播放器结束视频录制。 | myPlayer.setCaptureFrameEnd(); |
| cyberplayer::sendDanmu | Object | 无 | 发送弹幕消息。 | myPlayer.sendDanmu({text:'欢迎使用cyberplayer',time:10}); |
| cyberplayer::on | - | - | 播放器事件监听方法，当执行了某个动作后激活。 | myPlayer.on('play', function () {alert('视频已经播放了');});类似事件有 ready, setupError, playlist, playlistItem, playlistComplete, bufferChange, play, pause, buffer, idle, complete, error, seek, seeked, time, mute, volume, fullscreen, resize, levels, levelsChanged, captionsList, captionsChange, controls, displayClick, meta，performanceInfo 等。 |
cyberplayer::setup接口参数详解：setup只有一个Object类型的参数，该参数是一个参数集合，该参数集合所包含的参数元素及使用方法如下描述
| 参数名称 | 参数解释 | 备注 |
|---|---|---|
| width | 指定要创建的播放窗口的宽度。 | 必选 |
| height | 指定要创建的播放窗口的高度。 | 必选 |
| playlist | 请参见实现列表播放 | 可选 |
| imageAdvs | 在视频片头、片尾和播放暂停时显示图片广告，支持gif、png、jpeg格式图片。 start是片头广告参数，pause是暂停广告参数，end是片尾广告参数。Image参数表示显示图片地址，url表示链接地址，time表示片头广告显示时长，单位为秒。 暂停广告图片显示时会被缩放到400x300，推荐使用宽高比为4:3的图片作为暂停广告。 imageAdvs : { start : { image : "http://xxxx/abc.gif", url : "http://xxxx", time : 10 }, pause : { image : " http://xxxx/abc.gif ", url : " http://xxxx" }, end : { image : " http://xxxx/abc.gif ", url : " http://xxxx" } } |
可选 |
| autostart | 设置是否在播放器载入后自动播放：true : 自动播放；false : 不自动播放。 | 可选 |
| repeat | 设置视频的重复播放模式，重复模式分为： 1.false:无重复； 2.true:重复播放 |
可选 |
| file | 设置媒体流名称或文件名或M3U8播放列表地址 | 必选 |
| image | 设置媒体流的预览图 | 可选 |
| screenshot | 设置是否支持剪辑，布尔类型，默认false | 可选 |
| volume | 设置播放器音量大小，范围（0 - 100） | 可选 |
| controls | 设置播放器控制条的显示模式，显示模式分为： 1.none:不显示； 2.over:悬浮（鼠标无操作时自动隐藏） |
可选 |
| barLogo | 设置是否显示Logo，controls的子参数，可选值为true (显示)，false（不显示） |
可选 |
| skin | 设置播放器皮肤包 | 可选 |
| useSoftDecoding | 是否使用软解播放 | 可选 |
| liveInfoPanel | 是否显示面板信息，Object类型，参数包括showH265Info，默认为false | 可选 |
| stretching | 设置播放器缩放方式，缩放方式分为： 1.none:不缩放； 2.uniform:添加黑边缩放； 3. exactfit:改变宽高比缩到最大； 4.fill:剪切并缩放到最大（默认方式为uniform） |
可选 |