直播业务指南

*注意要使用HBuilderX而不是HBuilder

引言

直播是很多开发者的需求。
HTML5的video,虽然可以播放流媒体,但不支持rtmp等常用直播格式。更无法实现推流,就是实时流式上传视频。
5+App、uni-app给开发者提供了完整的直播解决方案。
HTML5Plus规范提供了plus.video扩展规范,实现了原生的视频播放和推流录制上传。

HTML5Plus的规范是通行规范,可支持任何直播云服务厂商的直播服务器。
但又拍云公司作为HTML5中国产业联盟成员,为HTML5plus的开发者提供了更多完善服务。

  1. 注册优惠
    点此链接注册,可得众多优惠。
    a) 认证完毕后赠送 61 元免费代金券;
    b) 首次充值后,奖励充值金额 10% 代金券
    c) 一周后再赠送200元的代金劵
    以上优惠不是三选一,是全都有。有效期1个月时间。
  2. 便捷的服务器搭建
    无需关心rtmp服务器的搭建和网络cdn的优化,注册后提供自己的直播推流和播放的域名,做cname映射到又拍云的服务器,然后自己随便定义二级目录地址就可以用了。
    详见又拍云文档http://docs.upyun.com/live/guide/

代码示例-推流上传(live-pusher)

直播推流控件会调用手机摄像头采集视频流,编码后通过rtmp协议提交到直播服务器。

  • 创建直播推流控件
    1. uni-app下nvue页面
      uni-app下的nvue页面在uni-app编译模式下,实现了live-pusher组件及uni.createLivePusherContext API

并实现了一套代码兼容App和小程序,具体参考上述组件及API文档。

  1. uni-app下的vue页面
    app平台的vue页面中使用直播推流,不能使用uni的api,而需要使用plus的API

    const currentWebview = this.$mp.page.$getAppWebview()
    var pusher = plus.video.createLivePusher("", {
    url:'rtmp://testlivesdk.v0.upaiyun.com/live/upyunb',
    top:'100px',
    left:'0px',
    width: '100%',
    height: '300px',
    position: 'static'
    });
    currentWebview.append(pusher);  
  2. 5+App模式示例:
    在页面中直播推流控件需要绑定div确定位置及大小,创建直播推流控件需要传入div的id,示例如下:

    <html>
    <head>
    <meta charset="utf-8"/>
    <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
    <title>Hello H5+</title>
    <script type="text/javascript">
    var pusher = null;
    // H5 plus事件处理
    function plusReady(){
    // 创建直播推流控件
    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);
    }
    document.addEventListener('plusready', plusReady, false);
    </script>
    </head>
    <body>
    <br/>
    <div></div>
    </body>
    </html>

    其中new plus.video.LivePusher()第一个参数'pusher'为绑定div的id值,第二个参数中的url属性值为直播推流服务器地址,必须为rtmp协议。创建后返回直播推流控件(LivePusher)对象,后续可通过此对象进行操作控制。

使用HBuilderX新建5+App项目时自带的Hello H5+模板,真机运行,可以看到video示例,里面有推流和播放的示例代码。

  • 采集直播推流提交到服务器
    创建直播推流控件后可通过setOptions方法更新直播控件参数,如下更新直播推流服务器地址:

    pusher.setOptions({url:'rtmp://新的直播推流服务器地址'});

    配置完成后调用start方法开始采集直播流提交到服务器:

    pusher.start();

推流时支持美颜、摄像头切换。不支持其他特效滤镜。
目前不支持录屏直播,无法实现手机录制。除非使用原生sdk自行开发离线打包。
目前暂不支持直播连麦功能。

更多API参考文档http://www.html5plus.org/doc/zh_cn/video.html#plus.video.LivePusher。
推流到直播服务器后可通过原生视频播放控件进行播放。

代码示例-使用视频播放控件播放直播视频流

HTML5标准的video是无法播放直播视频流的,所以需要使用原生增加的播放控件。
HTML5plus扩展的原生视频播放控件(也是uni-app的App端自带的)支持视频格式包括mp4和flv,视频传输协议支持http/https和rtmp/hls/rtsp(直播流)

  • 创建视频播放控件

    1. uni-app模式
      uni-app模式直接使用组件进行播放,无需其他复杂设置。
    2. 5+App模式
      在页面中视频播放控件需要绑定div确定位置及大小,创建视频播放控件需要传入div的id,示例如下:

      <!DOCTYPE HTML>
      <html>
      <head>
      <meta charset="utf-8"/>
      <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
      <title>Hello H5+</title>
      <script type="text/javascript">
      var video = null;
      // H5 plus事件处理
      function plusReady(){
      // 创建视频播放控件
      video = new plus.video.VideoPlayer('video',{
      src:'rtmp://live.hkstv.hk.lxdns.com/live/hks'
      });
      }
      document.addEventListener('plusready', plusReady, false);
      </script>
      </head>
      <body>
      <br/>
      <div></div>
      </body>
      </html>

      其中new plus.video.VideoPlayer()第一个参数'video'为绑定div的id值,第二个参数中的src属性值为要播放的直播视频地址,直播视频必须为rtmp协议。创建后返回视频播放控件(VideoPlayer)对象,后续可通过此对象进行操作控制。

  • 播放视频流
    创建视频播放控件后可通过setOptions方法更新播放控件参数,如下更新视频服务器地址:

    video.setOptions({src:'新的视频服务器地址'});

    用户可以点击播放控件上的播放按钮进行播放,也可调用play方法进行播放:

    video.play();

如果想在视频上绘制一些内容,比如滚动的聊天记录,5+App可以在上面创建一个透明webview,具体代码在Hello H5+的video示例里有;uni-app可以在上面创建一个subnvue,在HBuilderX1.9.10+版本中自带的hello uni-app - API - 界面 - 原生子窗体中也有示例。

包括防盗播的跑马灯也可以这么做。

更多API参考文档http://www.html5plus.org/doc/zh_cn/video.html#plus.video.VideoPlayer。

三方示例模板

这个是插件市场里三方开发者做的直播业务模板,开源,可以参考:http://ext.dcloud.net.cn/plugin?id=226

还有一些开发者封装了三方原生sdk,比如腾讯直播sdk,可以在插件市场获取

问答

以上是直播业务指南的全部内容。
THE END
分享
二维码
< <上一篇
下一篇>>