aliyun-rts-sdk

RTS拉流使用文档

当您需要使用RTS拉流。您可以通过本章节，了解接入的方法，帮助您更好的体验阿里云音视频通信服务。

接入方法

1、实例化

var aliRts = AliRTS.createClient();

2、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}`);
})

3、RTS开始拉流

/**
 * rts开始拉流接口
 * @param {string} pullStreamUrl 拉流地址,在地址后添加@subaudio=no或者@subvideo=no来表示不订阅音频流或视频流
 * @param {Object} [config] （可选）自定义配置
 * @param {string} [config.signalUrl] （可选）信令地址
 * @return {Promise}
 */
aliRts.subscribe(pullStreamUrl).then((remoteStream) => {
  // mediaElement是媒体标签audio或video
  remoteStream.play(mediaElement);
}).catch((err) => {
  // 订阅失败
})

4、RTS停止播放

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

5、静音接口

remoteStream.muted = true;

6、获取本地流

/**
 * 获取本地流localStream
 * @param {Object} config 配置
 * @param {boolean} config.audio 是否使用音频设备
 * @param {boolean} config.video 是否使用视频设备
 * @param {boolean} config.screen 是否使用屏幕捕获
 * @returns {Promise}
 */
aliRts.createStream({
  audio: true,
  video: true,
  screen: false,
}).then((localStream) => {
  // 预览推流内容，mediaElement是媒体标签audio或video
  localStream.play(mediaElement);
}).catch((err) => {
  // 创建本地流失败
})

7、推流

/**
 * 开始推流
 * @param {string} pushUrl 推流地址
 * @param {Object} localStream 由 createStream 创建的本地流
 * @param {Object} [config] （可选）自定义配置
 * @param {string} [config.signalUrl] （可选）信令地址
 * @return {Promise}
 */
aliRts.publish(pushUrl, localStream)).then(() => {
  // 推流成功
}).catch((err) => {
  // 推流失败
})

8、停止推流

/**
 * 停止推流
 */
aliRts.unpublish();

注：1、由于浏览器策略问题，https协议无法正常加载http资源，所以https协议链接的拉流地址必须也是https(如果使用http也同理，拉流地址也需要是http)。

浏览器支持情况

平台	浏览器	最低支持版本
Windwos	Chrome	63
	Firefox	62
	Opera	15
Mac	Chrome	63
	Safari	11
	Firefox	62
	Opera	15
Android	Chrome	63
	微信浏览器	微信版本号>=7.0.9
ios	Safari	11
	微信浏览器	微信版本号>=7.0.9
	钉钉浏览器	ios系统版本号>=11.2.5

错误码

错误码 （errorCode）	错误信息（message）	描述
10000	device unknown error	设备未知错误
10001	audio device not found	没有找到音频设备
10002	video device not found	没有找到视频设备
10003	audio device not allowed	不允许使用音频设备
10004	video device not allowed	不允许使用视频设备
10005	audio device not readable	没有使用音频设备权限
10006	video device not readable	没有使用视频设备权限
10007	device constrained error	获取设备参数错误
10010	screenshare unknown error	屏幕共享未知错误
10011	screenshare not allowed	不允许屏幕共享
10012	screenshare ended	屏幕共享结束
10013	screenshare no permission	应用没有屏幕共享的权限
10018	screenshare not support	不支持屏幕共享
10101	http request error	信令请求失败
10102	play fail	播放失败，默认5秒没有成功返回播放失败
10110	not support webrtc	不支持webrtc
10111	browser not support	不支持此浏览器
10112	browser version too low	浏览器版本过低
10113	not support h264	不支持H264
10114	create offer error	create offer 失败
10125	html element not match	订阅内容和传入的媒体类型不匹配
10201	auto play failed	自动播放失败
10202	play url error	播放url协议错误
10203	subscribe nothing	没有订阅任何内容
10204	html element error	订阅传入的HTMLElement不是Audio/Video
10205	http request error	http请求失败
10206	http answer error	answer失败
10300	publish url error	推流url错误
10301	publish no audio	推流缺少音频
11000	track type audio	tracktype不存在
11001	track kingd error	mediastreamtrack类型错误，比如添加audio，但是传入的是videotrack
11002	no audio track error	没有音频流，至少需要一个audiotrack
12000	peerconnection error	peerconnection