宜信同城网交流论坛技术专版技术专区Video模块管理多媒体视频相关能力，可用创建视频播放控件，直播推流控件等 ...方法： createVideoPlayer: 创建VideoPlayer对象createLivePusher: 创建LivePusher对象getVideoPlayerBy ...

admin 发表于 2023-2-16 18:54:47

Video模块管理多媒体视频相关能力，可用创建视频播放控件，直播推流控件等 ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.createVideoPlayer">createVideoPlayer</a>: 创建VideoPlayer对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.createLivePusher">createLivePusher</a>: 创建LivePusher对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.getVideoPlayerById">getVideoPlayerById</a>: 查找已经创建的VideoPlayer对象</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.getLivePusherById">getLivePusherById</a>: 查找已经创建的LivePusher对象</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayer">VideoPlayer</a>: 视频播放控件对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerStyles">VideoPlayerStyles</a>: 视频播放控件参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerEvents">VideoPlayerEvents</a>: 视频播放控件事件类型</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusher">LivePusher</a>: 直播推流控件对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherStyles">LivePusherStyles</a>: 直播推流控件配置选项</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherEvents">LivePusherEvents</a>: 直播推流控件事件类型</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerEventCallback">VideoPlayerEventCallback</a>: 视频播放控件事件监听回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherEventCallback">LivePusherEventCallback</a>: 视频播放控件事件监听回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"VideoPlayer": {
"description": "视频播放"
},
"LivePusher": {
"description": "直播推流"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">createVideoPlayer</h1>
创建VideoPlayer对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
VideoPlayer plus.video.createVideoPlayer(id, styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法创建后并不会显示，需要调用Webview窗口的append方法将其添加到Webview窗口后才能显示。注意：此时需要通过styles参数的top/left/width/height属性设置控件的位置及大小。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 VideoPlayer对象的全局标识 可用于通过plus.video.getVideoPlayerById()方法查找已经创建的VideoPlayer对象。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerStyles">VideoPlayerStyles</a> ) 可选 视频播放控件参数 设置视频播放控件的位置及大小等。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayer">VideoPlayer</a> : 视频播放控件对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 4.0+ (支持) : Android4.0及以上版本支持。 </li><li>iOS - 7.0+ (支持) : iOS7.0及以上版本支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var player = null;
// 创建视频播放控件
function createVideoPlayer() {
if(!player){
player = plus.video.createVideoPlayer('videoplayer', {
src:'rtmp://live.hkstv.hk.lxdns.com/live/hks',
top:'100px',
left:'0px',
width: '100%',
height: '200px',
position: 'static'
});
plus.webview.currentWebview().append(player);
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">createLivePusher</h1>
创建LivePusher对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
LivePusher plus.video.createLivePusher(id, styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用此方法创建后并不会显示，需要调用Webview窗口的append方法将其添加到Webview窗口后才能显示。注意：此时需要通过styles参数的top/left/width/height属性设置控件的位置及大小。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 LivePusher对象的全局标识 可用于通过plus.video.getLivePusherById()方法查找已经创建的LivePusher对象。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherStyles">LivePusherStyles</a> ) 可选 直播推流控件参数 设置直播推流控件的位置及大小等。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusher">LivePusher</a> : 直播推流控件对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 4.1+ (支持) : Android4.1及以上版本支持。 </li><li>iOS - 8.0+ (支持) : iOS8.0及以上版本支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var pusher = null;
// 创建直播推流控件
function createLivePusher() {
if(!pusher){
pusher = plus.video.createLivePusher('livepusher', {
url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb',
top:'100px',
left:'0px',
width: '100%',
height: '300px',
position: 'static'
});
plus.webview.currentWebview().append(pusher);
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getVideoPlayerById</h1>
查找已经创建的VideoPlayer对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
VideoPlayer plus.video.getVideoPlayerById(id);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
查找指定id的VideoPlayer对象，如果不存在则返回null。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 VideoPlayer对象的全局标识 如果存在多个相同标识的VideoPlayer对象，则返回第一个查找到的VideoPlayer对象。如果不存在指定标识的VideoPlayer对象，则返回null。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer">VideoPlayer</a> : 视频播放控件对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 查找视频播放控件
function findVideoPlayer() {
var b = plus.video.getVideoPlayerById('videoplayer');
if(b){
console.log('find success!');
alert('success');
} else {
console.log('find failed!');
alert('failed');
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getLivePusherById</h1>
查找已经创建的LivePusher对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
LivePusher plus.video.getLivePusherById(id);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
查找指定id的LivePusher对象，如果不存在则返回null。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 LivePusher对象的全局标识 如果存在多个相同标识的LivePusher对象，则返回第一个查找到的LivePusher对象。如果不存在指定标识的LivePusher对象，则返回null。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher">LivePusher</a> : 直播推流控件对象
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 查找直播推流控件
function findLivePusher() {
var b = plus.video.getLivePusherById('livepusher');
if(b){
console.log('find success!');
alert('success');
} else {
console.log('find failed!');
alert('failed');
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">VideoPlayer</h1>
视频播放控件对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.video.VideoPlayer {
// Methods
function void addEventListener(event, listener, capture);
function void setStyles(styles);
function void play();
function void pause();
function void seek(position);
function void requestFullScreen();
function void exitFullScreen();
function void stop();
function void hide();
function void show();
function void close();
function void sendDanmu(danmu);
function void playbackRate(rate);
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
VideoPlayer对象表示视频播放控件对象，在窗口中播放视频，可支持本地视频(mp4/flv)，网络视频地址（mp4/flv/m3u8）及流媒体（rtmp/hls/rtsp）。 编码格式：
<ul><li>Android平台：h264、mpeg4、flv、hevc、vp6f、vp8/9</li><li>iOS平台：h264、mpeg4、flv、hevc、vp6f</li></ul>

<h2 style="margin-left:.8em;">构造：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.VideoPlayer.constructor%28id,%20styles%29">VideoPlayer.constructor(id, styles)</a>: 创建VideoPlayer对象</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.addEventListener">addEventListener</a>: 监听视频播放控件事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.setStyles">setStyles</a>: 设置视频播放控件参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.setOptions">setOptions</a>: 设置视频播放控件参数（将废弃，使用setStyles）</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.play">play</a>: 播放视频</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.pause">pause</a>: 暂停视频</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.seek">seek</a>: 跳转到指定位置</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.requestFullScreen">requestFullScreen</a>: 切换到全屏</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.exitFullScreen">exitFullScreen</a>: 退出全屏</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.stop">stop</a>: 停止播放视频</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.hide">hide</a>: 隐藏视频播放控件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.show">show</a>: 显示视频播放控件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.close">close</a>: 关闭视频播放控件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.sendDanmu">sendDanmu</a>: 发送弹幕</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayer.playbackRate">playbackRate</a>: 设置倍速播放</li></ul>
<h1 style="margin-left:0;">VideoPlayer.constructor(id, styles)</h1>
创建VideoPlayer对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var video = new plus.video.VideoPlayer(id, styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建VideoPlayer对象，并指定VideoPlayer对象的在界面中关联div或object标签的id号。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 视频播放控件在Webview窗口的DOM节点的id值 为了定义视频控件在Webview窗口中的位置，需要指定控件定位标签（div或objecct）的id号，系统将根据此id号来确定视频播放控件的大小及位置。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerStyles">VideoPlayerStyles</a> ) 可选 视频播放控件参数 设置视频播放控件的资源地址、初始播放位置等参数。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayer">VideoPlayer</a> : 视频播放控件对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 4.0+ (支持) : Android4.0及以上版本支持。 </li><li>iOS - 7.0+ (支持) : iOS7.0及以上版本支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建视频播放控件
var video = new plus.video.VideoPlayer('video',{
src:'rtmp://live.hkstv.hk.lxdns.com/live/hks'
});
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">addEventListener</h1>
监听视频播放控件事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.addEventListener(event, listener, capture);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
向视频播放控件添加事件监听器，当指定的事件发生时，将触发listener函数的执行。可多次调用此方法向视频播放控件添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayerEvents">VideoPlayerEvents</a> ) 必选 视频播放控件事件类型 </li><li>listener: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayerEventCallback">VideoPlayerEventCallback</a> ) 必选 监听事件发生时执行的回调函数 </li><li>capture: ( Boolean ) 可选 捕获事件流顺序，暂无效果 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建视频播放控件
var video = new plus.video.VideoPlayer('video',{
src:'rtmp://live.hkstv.hk.lxdns.com/live/hks'
});
// 监听开始播放事件
video.addEventListener('play', function(e){
plus.nativeUI.alert('Video play');
}, false)
// 监听播放进度更新事件
video.addEventListener('timeupdate', function(e){
console.log(JSON.stringify(e));
}, false);
// 监听播放结束事件
video.addEventListener('ended', function(e){
plus.nativeUI.alert('Video ended');
}, false);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setStyles</h1>
设置视频播放控件参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.setStyles(styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于动态更新视频播放控件的配置参数。注意：有些选项无法动态更新，只能创建时进行设置，详情参考VideoPlayerStyles。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayerStyles">VideoPlayerStyles</a> ) 必选 要更新的配置参数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 切换视频地址
function switchVideo(){
src = (src==src1)?src2:src1;
video.setStyles({src:src});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setOptions</h1>
设置视频播放控件参数（将废弃，使用setStyles）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.setOptions(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于动态更新视频播放控件的配置选项。注意：有些选项无法动态更新，只能创建时进行设置，详情参考VideoPlayerStyles。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.VideoPlayerStyles">VideoPlayerStyles</a> ) 必选 要更新的配置选项 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 切换视频地址
function switchVideo(){
src = (src==src1)?src2:src1;
video.setOptions({src:src});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">play</h1>
播放视频
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.play();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果视频已经处于播放状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 播放视频
function plsyVideo(){
video.play();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">pause</h1>
暂停视频
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.pause();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果视频未处于播放状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 暂停视频
function pauseVideo(){
video.pause();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">seek</h1>
跳转到指定位置
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.seek(position);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果视频未处于播放状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>position: ( Number ) 必选 跳转到的位置 单位为秒（s）。注意：由于视频流只能从关键帧开始播放，可能存在不精确的情况。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 调到指定位置播放
function seekVideo(){
video.seek(100)
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">requestFullScreen</h1>
切换到全屏
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.requestFullScreen(direction);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>direction: ( Number ) 必选 视频的方向 可取值： 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 全屏播放
function fullscreenVideo(){
video.requestFullScreen();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">exitFullScreen</h1>
退出全屏
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.exitFullScreen();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 全屏播放，播放完成后自动退出全屏
function fullscreenVideo(){
video.requestFullScreen();
video.addEventListener('ended', function(){
video.exitFullScreen();
}, false);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">stop</h1>
停止播放视频
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.stop();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果视频未处于播放或暂停状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 停止播放
function stopVideo(){
video.stop();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">hide</h1>
隐藏视频播放控件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.hide();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
隐藏只是控件不可见，控件依然存在并且不改变播放状态。如果控件已经隐藏，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 隐藏视频
function hideVideo(){
video.hide();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">show</h1>
显示视频播放控件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.show();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
将隐藏的控件显示出来（回复到隐藏前的状态）。如果控件已经显示，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 显示视频
function showVideo(){
video.show();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">close</h1>
关闭视频播放控件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.close();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭操作将释放控件所有资源，不再可用。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 关闭视频
function closeVideo(){
video.close();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">sendDanmu</h1>
发送弹幕
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.sendDanmu(danmu);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果视频未处于播放状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>danmu: ( Object ) 必选 发送的弹幕 支持以下属性：text（弹幕的文本内容），color（弹幕的颜色）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 发送弹幕
function danmuVideo(){
video.sendDanmu({text:'要显示的弹幕文本',color:'#FF0000'});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">playbackRate</h1>
设置倍速播放
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void video.playbackRate(rate);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>rate: ( Number ) 必选 播放的倍率 可取值： 0.5/0.8/1.0/1.25/1.5。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (支持)</li><li>iOS - ALL (不支持) : 暂不支持倍率播放。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设置播放倍率
function rateVideo(){
video.playbackRate(1.5);
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">VideoPlayerStyles</h1>
视频播放控件参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>src: (String 类型 )视频资源地址 支持本地地址，也支持网络地址及直播流（RTMP）。 </li><li>header: (JSON 类型 )自定义请求头 播放http/https协议的视频资源时设置请求的header。 注意：HBuilderX3.1.19及以上版本支持。 </li><li>initial-time: (Number 类型 )视频初始播放位置 单位为秒（s）。注意：仅在视频开始播放前设置有效。 </li><li>duration: (Number 类型 )视频长度 单位为秒（s）。注意：仅在视频开始播放前设置有效。 </li><li>controls: (Boolean 类型 )是否显示默认播放控件 默认值为true。包括播放/暂停按钮、播放进度、时间等。 </li><li>danmu-list: (Array(JSON) 类型 )弹幕列表 弹幕JSON对象包括属性：text（String类型，弹幕文本类容），color（String类型，弹幕颜色，格式为#RRGGBB），time（Number类型，弹幕出现的时间，单位为秒）。 </li><li>danmu-btn: (Boolean 类型 )是否显示弹幕按钮 默认值为false。注意：仅在控件构造时设置有效，不能动态更新。 </li><li>enable-danmu: (Boolean 类型 )是否展示弹幕 默认值为false。注意：仅在控件构造时设置有效，不能动态更新。 </li><li>autoplay: (Boolean 类型 )是否自动播放 默认值为false。 </li><li>loop: (Boolean 类型 )是否循环播放 默认值为false。 </li><li>muted: (Boolean 类型 )是否静音播放 默认值为false。 </li><li>direction: (Number 类型 )设置全屏时视频的方向 不指定则根据宽高比自动判断。有效值为： 0（正常竖向）, 90（屏幕逆时针90度）, -90（屏幕顺时针90度）。默认值为-90。 </li><li>show-center-play-btn: (Boolean 类型 )是否显示视频中间的播放按钮 默认值为true。 </li><li>show-fullscreen-btn: (Boolean 类型 )是否显示全屏按钮 默认值为true。 </li><li>show-loading: (Boolean 类型 )加载视频时是否显示loading 默认值为true。 HBuilderX2.8.12+版本支持。 </li><li>show-mute-btn: (Boolean 类型 )是否显示静音按钮 默认值为false。 注意： HBuilderX2.9.10+版本支持。 </li><li>show-progress: (Boolean 类型 )是否显示播放进度 默认值为true。 </li><li>show-play-btn: (Boolean 类型 )是否显示视频底部控制栏的播放按钮 默认值为true。 </li><li>enable-progress-gesture: (Boolean 类型 )是否开启控制进度的手势 默认值为true。 </li><li>objectFit: (String 类型 )当视频大小与 video 容器大小不一致时，视频的表现形式 有效值为：contain（包含），fill（填充），cover（覆盖）。默认值为contain。 </li><li>poster: (String 类型 )视频封面的图片网络资源地址 如果 controls 属性值为 false 则设置 poster 无效。 </li><li>top: (String 类型 )VideoPlayer控件左上角的垂直偏移量 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的高度； 自动计算，如"auto",根据height值自动计算，相对于父Webview窗口垂直居中。 </li><li>left: (String 类型 )VideoPlayer控件左上角的水平偏移量 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的宽度； 自动计算，如"auto"，根据width值自动计算，相对于父Webview窗口水平居中。默认值为"0px"。 </li><li>width: (String 类型 )VideoPlayer控件的宽度 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的宽度。默认值为"100%"。 </li><li>height: (String 类型 )VideoPlayer控件的高度 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的高度。默认值为"100%"。 </li><li>position: (String 类型 )VideoPlayer控件在Webview窗口的布局模式 可取值： "static" - 静态布局模式，如果页面存在滚动条则随窗口内容滚动； "absolute" - 绝对布局模式，如果页面存在滚动条不随窗口内容滚动； 默认值为"static"。 </li><li>codec: (String 类型 )解码方式 可取值：
<ul style="margin-left:2em;"><li>"hardware" - 硬解码，优点是可以利用设备硬件进行加速，提高视频清晰度，缺点是在部分设备可能存在兼容性问题</li><li>"software" - 软解码，优点是兼容性较好，缺点是性能不足</li></ul> 默认值为"software"，如果播放视频出现清晰度不好的情况可以调整为"hardware"。 HBuilderX3.1.0+版本新增支持。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 4.4+ (支持)</li><li>iOS - ALL (不支持)</li></ul></li><li>httpCache: (Boolean 类型 )是否对http/https 视频源开启本地缓存 true表示开启缓存，重复播放视频会优先使用本地缓存，false表示不缓存。默认值为false。 缓存策略：开启了此开关的视频源,在视频播放时会在本地保存缓存文件，如果本地缓存池已超过100M，在进行缓存前会清空之前的缓存。 注意：不适用于m3u8等流媒体协议。 HBuilderX3.1.0+版本新增支持。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 4.4+ (支持)</li><li>iOS - ALL (不支持)</li></ul></li><li>playStrategy: (Number 类型 )视频播放策略 可取值：
<ul style="margin-left:2em;"><li>0 - 普通模式，适合播放本地视频文件</li><li>1 - 高清视频优化模式，增加缓冲区大小，采用open sl解码音频，避免音视频脱轨的问题，可能会降低首屏展现速度、视频帧率，出现开屏音频延迟等。适用于高码率视频的极端场景</li><li>3 - M3U8优化模式，增加缓冲区大小，提升视频加载速度和流畅度，可能会降低首屏展现速度。适用于M3U8在线播放的场景</li></ul> 默认值为0。 HBuilderX3.1.0+版本新增支持。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 4.4+ (支持)</li><li>iOS - ALL (不支持)</li></ul></li></ul>
<h1 style="margin-left:0;">VideoPlayerEvents</h1>
视频播放控件事件类型
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"play": (String 类型 )视频播放事件 当视频开始/继续播放时触发。无事件回调函数参数。 </li><li>"pause": (String 类型 )视频暂停事件 当视频暂停播放时触发。无事件回调函数参数。 </li><li>"ended": (String 类型 )视频结束事件 当视频播放到末尾时触发。无事件回调函数参数。 </li><li>"timeupdate": (String 类型 )视频播放进度更新事件 当视频播放进度变化时触发，触发频率250ms一次。事件回调函数参数event.detail = {currentTime:"Number类型，当前播放时间（单位为秒）",duration:"Number类型，视频总长度（单位为秒）"}。 </li><li>"fullscreenchange": (String 类型 )视频播放全屏播放状态变化事件 当视频播放进入或退出全屏时触发。事件回调函数参数event.detail = {fullScreen:"Boolean类型，当前状态是否为全屏", direction:"String类型，vertical或horizontal"}。 </li><li>"fullscreenclick": (String 类型 )视频播放全屏播放时点击事件 当视频播放进入全屏后，点击屏幕时触发。事件回调函数参数event.detail = { screenX:"Number类型，点击点相对于屏幕左侧边缘的 X 轴坐标", screenY:"Number类型，点击点相对于屏幕顶部边缘的 Y 轴坐标", screenWidth:"Number类型，屏幕总宽度", screenHeight:"Number类型，屏幕总高度"}。注意：HBuilderX2.6.3+版本支持。 </li><li>"waiting": (String 类型 )视频缓冲事件 当视频播放出现缓冲时触发。无事件回调函数参数。 </li><li>"error": (String 类型 )视频错误事件 当视频播放出错时触发。无事件回调函数参数。 </li></ul>
<h1 style="margin-left:0;">LivePusher</h1>
直播推流控件对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.video.LivePusher {
// Methods
function void addEventListener(event, listener, capture);
function void setStyles(styles);
function void preview();
function void start();
function void stop(options);
function void pause();
function void resume();
function void switchCamera();
function void snapshot();
function void close();
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
LivePusher对象表示直播推流控件对象，在窗口中显示捕获视频，实时推送到流媒体（RTMP）服务器。
<h2 style="margin-left:.8em;">构造：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.LivePusher.constructor%28id,%20options%29">LivePusher.constructor(id, options)</a>: 创建LivePusher对象</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.addEventListener">addEventListener</a>: 监听直播推流控件事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.setStyles">setStyles</a>: 设置直播推流控件参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.setOptions">setOptions</a>: 设置直播推流控件参数（将废弃，使用setStyles）</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.preview">preview</a>: 预览摄像头采集数据</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.start">start</a>: 开始推流</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.stop">stop</a>: 停止推流</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.pause">pause</a>: 暂停推流</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.resume">resume</a>: 恢复推流</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.switchCamera">switchCamera</a>: 切换前后摄像头</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.snapshot">snapshot</a>: 快照</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusher.close">close</a>: 关闭直播推流控件</li></ul>
<h1 style="margin-left:0;">LivePusher.constructor(id, options)</h1>
创建LivePusher对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
var pusher = new plus.video.LivePusher(id, styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
创建LivePusher对象，并指定LivePusher对象的在界面中关联div或object标签的id号。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>id: ( String ) 必选 直播推流控件在Webview窗口的DOM节点的id值 为了定义直播推流控件在Webview窗口中的位置，需要指定控件定位标签（div或objecct）的id号，系统将根据此id号来确定直播推流控件的大小及位置。 </li><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherStyles">LivePusherStyles</a> ) 可选 直播推流控件配置选项 设置直播推流服务器地址地址等参数。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
<ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusher">LivePusher</a> : 直播推流控件对象
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 4.1+ (支持) : Android4.1及以上版本支持。 </li><li>iOS - 8.0+ (支持) : iOS8.0及以上版本支持。 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建直播推流控件
var pusher = new plus.video.LivePusher('pusher',{
url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb'
});
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">addEventListener</h1>
监听直播推流控件事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.addEventListener(event, listener, capture);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
向直播推流控件添加事件监听器，当指定的事件发生时，将触发listener函数的执行。可多次调用此方法向直播推流控件添加多个监听器，当监听的事件发生时，将按照添加的先后顺序执行。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusherEvents">LivePusherEvents</a> ) 必选 直播推流控件事件类型 </li><li>listener: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusherEventCallback">LivePusherEventCallback</a> ) 必选 监听事件发生时执行的回调函数 </li><li>capture: ( Boolean ) 可选 捕获事件流顺序，暂无效果 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建直播推流控件
pusher = new plus.video.LivePusher('pusher',{
url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb'
});
// 监听状态变化事件
pusher.addEventListener('statechange', function(e){
console.log('statechange: '+JSON.stringify(e));
}, false);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setStyles</h1>
设置直播推流控件参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.setStyles(styles);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于动态更新直播推流控件的配置参数。注意：有些选项无法动态更新，只能创建时进行设置，详情参考LivePusherStyles。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>styles: ( <ahref="https://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusherStyles">LivePusherStyles</a> ) 必选 要更新的配置选项 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设置推流服务器
function updatePusher() {
pusher.setStyles({
url:'rtmp://push.live.dcloud.io/test/test123';
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setOptions</h1>
设置直播推流控件参数（将废弃，使用setStyles）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.setOptions(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于动态更新直播推流控件的配置选项。注意：有些选项无法动态更新，只能创建时进行设置，详情参考LivePusherStyles。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122839131#plus.video.LivePusherStyles">LivePusherStyles</a> ) 必选 要更新的配置选项 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 设置推流服务器
function updatePusher() {
pusher.setOptions({
url:'rtmp://push.live.dcloud.io/test/test123';
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">preview</h1>
预览摄像头采集数据
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.preview();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用摄像头采集图像数据，并在推流控件中预览（此时不会向服务器推流，需调用start方法才开始推流）。注意：为了确保预览窗口大小正确，应该在创建控件后延时一定的时间（如500ms）进行预览。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 预览
function preview(){
pusher.preview();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">start</h1>
开始推流
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.start(successCB, errorCB);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果已经处于推流状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( Function ) 必选 开始推流成功回调 开始推流操作成功时触发，回调函数无参数。 </li><li>errorCB: ( Function ) 可选 快照失败回调 开始推流操作失败时触发，返回错误信息，回调参数event={code:"错误代码",message:"错误描述信息"}。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 开始推流
function startPusher() {
pusher.start(function(){
console.log('Start pusher success!');
}, function(e){
console.log('Start pusher failed: '+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">stop</h1>
停止推流
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.stop(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果未处于推流状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>options: ( Object ) 必选 停止推流的参数 支持属性值preview，用于定义停止推流后是否继续预览，可取值： true - 继续预览，仅停止向服务器推流； false - 关闭预览，同时停止向服务器推流。默认值为false。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 停止推流
function stopPusher() {
pusher.stop();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">pause</h1>
暂停推流
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.pause();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果未处于推流状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 暂停推流
function pausePusher() {
pusher.pause();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">resume</h1>
恢复推流
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.resume();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果未处于暂停状态，则操作无效。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 恢复推流
function resumePusher() {
pusher.resume();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">switchCamera</h1>
切换前后摄像头
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.switchCamera();
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 切换摄像头
function switchCamera() {
pusher.switchCamera();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">snapshot</h1>
快照
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.snapshot(successCB, errorCB);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( Function ) 必选 快照成功回调 快照操作成功时触发，并返回快照信息，回调参数event={width:"快照图片宽度",height:"快照图片高度",tempImagePath:"快照图片路径"}。 </li><li>errorCB: ( Function ) 可选 快照失败回调 快照操作失败时触发，返回错误信息，回调参数event={code:"错误代码",message:"错误描述信息"}。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 快照
function snapshotPusher() {
pusher.snapshot(function(e){
plus.nativeUI.alert("snapshot success: "+JSON.stringify(e));
}, function(e) {
plus.nativeUI.alert("snapshot error: "+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">close</h1>
关闭直播推流控件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void pusher.close();
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
关闭操作将释放控件所有资源，不再可用。
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 关闭推流
function closePusher() {
pusher.close();
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">LivePusherStyles</h1>
直播推流控件配置选项
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>url: (String 类型 )推流地址 支持RTMP协议。 </li><li>mode: (String 类型 )推流视频模式 可取值：SD（标清）, HD（高清）, FHD（超清）。 </li><li>muted: (Boolean 类型 )是否静音 默认值为false。 </li><li>enable-camera: (Boolean 类型 )开启摄像头 默认值为true。 </li><li>auto-focus: (Boolean 类型 )自动聚集 默认值为true。 </li><li>beauty: (Number 类型 )是否美颜 可取值0、1，其中0表示不使用美颜，1表示不使用美颜。默认值为0(不使用美颜)。 </li><li>whiteness: (Number 类型 )是否美白 可取值0、1、2、3、4、5，其中0表示不使用美白，其余值分别表示美白的程度，值越大美白程度越大。默认值为0（不使用美白）。 </li><li>aspect: (String 类型 )宽高比 可取值：3:4, 9:16。 </li><li>min-bitrate: (Number 类型 )最小码率 默认值为200。 </li><li>max-bitrate: (Number 类型 )最大码率 默认值为1000。 </li><li>top: (String 类型 )LivePusher控件左上角的垂直偏移量 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的高度； 自动计算，如"auto",根据height值自动计算，相对于父Webview窗口垂直居中。 </li><li>left: (String 类型 )LivePusher控件左上角的水平偏移量 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的宽度； 自动计算，如"auto"，根据width值自动计算，相对于父Webview窗口水平居中。默认值为"0px"。 </li><li>width: (String 类型 )LivePusher控件的宽度 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的宽度。默认值为"100%"。 </li><li>height: (String 类型 )LivePusher控件的高度 可取值： 像素值，如"100px"； 百分比，如"10%"，相对于父Webview窗口的高度。默认值为"100%"。 </li><li>position: (String 类型 )LivePusher控件在Webview窗口的布局模式 可取值： "static" - 静态布局模式，如果页面存在滚动条则随窗口内容滚动； "absolute" - 绝对布局模式，如果页面存在滚动条不随窗口内容滚动； 默认值为"static"。 </li></ul>
<h1 style="margin-left:0;">LivePusherEvents</h1>
直播推流控件事件类型
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>"statechange": (String 类型 )状态变化事件 当推流连接服务器状态变化时触发。事件回调函数参数event={type:"事件类型，此时为statechange",target:"触发此事件的直播推流控件对象",detail:{code:"状态码，参考后面状态码说明",message:"描述信息"}}。其中code状态码： 1001 - 已经连接推流服务器； 1002 - 已经与服务器握手完毕,开始推流； 1003 - 打开摄像头成功； 1004 - 录屏启动成功； 1005 - 推流动态调整分辨率； 1006 - 推流动态调整码率； 1007 - 首帧画面采集完成； 1008 - 编码器启动； -1301 - 打开摄像头失败； -1302 - 打开麦克风失败； -1303 - 视频编码失败； -1304 - 音频编码失败； -1305 - 不支持的视频分辨率； -1306 - 不支持的音频采样率； -1307 - 网络断连，且经多次重连抢救无效，更多重试请自行重启推流； -1308 - 开始录屏失败，可能是被用户拒绝； -1309 - 录屏失败，不支持的Android系统版本，需要5.0以上的系统； -1310 - 录屏被其他应用打断了； -1311 - Android Mic打开成功，但是录不到音频数据； -1312 - 录屏动态切横竖屏失败； 1101 - 网络状况不佳：上行带宽太小，上传数据受阻； 1102 - 网络断连, 已启动自动重连； 1103 - 硬编码启动失败,采用软编码； 1104 - 视频编码失败； 1105 - 新美颜软编码启动失败，采用老的软编码； 1106 - 新美颜软编码启动失败，采用老的软编码； 3001 - RTMP -DNS解析失败； 3002 - RTMP服务器连接失败； 3003 - RTMP服务器握手失败； 3004 - RTMP服务器主动断开，请检查推流地址的合法性或防盗链有效期； 3005 - RTMP 读/写失败。 </li><li>"netstatus": (String 类型 )网络状态通知事件 当推流的网络状态发生变化时触发。事件回调函数参数event={type:"事件类型，此时为netstatus",target:"触发此事件的直播推流控件对象",detail:{videoBitrate:"视频码率",audioBitrate:"音频码率",videoFPS:"视频帧率",netSpeed:"推流网速",videoWidth:"视频宽度",videoHeight:"视频高度"}}。 </li><li>"error": (String 类型 )渲染错误事件 当推流发生错误是触发。事件回调函数参数event={type:"事件类型，此时为error",target:"触发此事件的直播推流控件对象",detail:{code:"错误编码，参考后面错误码说明",message:"描述信息"}}。其中code错误码： 1001 - 用户禁止使用摄像头； 1002 - 用户禁止使用录音。 </li></ul>
<h1 style="margin-left:0;">VideoPlayerEventCallback</h1>
视频播放控件事件监听回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onEvent(event) {
// Authenticate success code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 事件触发时返回的参数 不同事件返回的参数不一样，详情参考VideoPlayerEvents事件说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建视频播放控件
var video = new plus.video.VideoPlayer('video',{
src:'rtmp://live.hkstv.hk.lxdns.com/live/hks'
});
// 监听播放进度更新事件
video.addEventListener('timeupdate', function(e){
console.log(JSON.stringify(e));
}, false);
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">LivePusherEventCallback</h1>
视频播放控件事件监听回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onEvent(event) {
// event code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 事件触发时返回的参数 不同事件返回的参数不一样，详情参考LivePusherEvents事件说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 创建直播推流控件
pusher = new plus.video.LivePusher('pusher',{
url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb'
});
// 监听状态变化事件
pusher.addEventListener('statechange', function(e){
console.log('statechange: '+JSON.stringify(e));
}, false);
// 监听网络状态变化事件
pusher.addEventListener('netstatus', function(e){
console.log('netstatus: '+JSON.stringify(e));
}, false);
// 监听错误事件
pusher.addEventListener('error', function(e){
console.log('error: '+JSON.stringify(e));
}, false);
</code></code></pre>
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

Video模块管理多媒体视频相关能力，可用创建视频播放控件，直播推流控件等 ...