RTS Web播放器说明

概述

RTS Web SDK是通过HTML网页加载的JavaScript 库，不包含普通直播Web播放器功能，且不依赖用户安装App实现直播播放。该SDK只用于RTS低延时直播协议拉流，可以解决在手机、微信和PC浏览器上播放音视频流的问题。本文适合有一定JavaScript语言基础的开发人员阅读。SDK视频播放能力本身不是网页代码实现的，而是靠浏览器支持，因此不是所有的浏览器都能有符合预期的表现，其兼容性参考下文。

兼容性说明

使用说明

接入方法

• 初始化实例

  var aliRts = new AliRTS()

• isSupport检测浏览器是否可用

  //调用此接口时必须传递参数，否则调用时会出现报错
  /** 
   * isSupport检测是否可用 
   * @param {Object} supportInfo 检测信息 
   * @param {Boolean} supportInfo.isReceiveVideo 是否拉视频流 
   * @return {Promise}  
   */ 
  aliRts.isSupport(supportInfo).then(re=> { 
      //可用 
  }).catch(err=> { 
    //不可用 
    console.log(`not support errorCode: ${err.errorCode}`); 
    console.log(`not support message: ${err.message}`); 
  })

• RTS开始拉流

  /** 
   * rts开始拉流接口 
   * @param {String} pullStreamUrl 拉流地址 
   * @param {HTMLMediaElement} mediaElement 播放视频的video标签 
   * @return {Promise}  
   */ 
  aliRts.startLiveStream(pullStreamUrl, mediaElement);

• RTS停止播放

  /** 
   * 停止rts播放接口 
   */ 
  aliRts.stopLiveStream();

• 静音接口

  /** 
   * 拉流静音接口 
   * @param {Boolean} muted 是否开启静音 
   */ 
  aliRts.muteLiveStream(muted);

• 回调监听

  /*
   * 在onError中获取到错误码10201时，此时网页的音频是静音的，
   * 需要用户在网页上手动触发事件（必须有用户交互，不能直接通过代码控制）
   * 调用aliRts.muteLiveStream(false) 来取消静音
   */
  aliRts.on("onError", (err)=> {
    console.log(`errorCode: ${err.errorCode}`);
    console.log(`message: ${err.message}`);
  })
  
  const PLAY_EVENT = {
    CANPLAY: "canplay",
    WAITING: "waiting",
    PLAYING: "playing"
  }
  
  aliRts.on('onPlayEvent', (play)=>{
    if(play.event === PLAY_EVENT.CANPLAY){
      //拉流可以播放
    }else if(play.event === PLAY_EVENT.WAITING){
      //拉流卡顿等待缓冲中 （仅Chrome）
    }else if(play.event === PLAY_EVENT.PLAYING){
      //拉流卡顿结束恢复播放 （仅Chrome）
    }
  })

错误码