index.js 51 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944
  1. import TrtcCloudImpl from './TrtcCloudImpl';
  2. import { TRTCVideoStreamType } from './TrtcDefines';
  3. const version = '1.3.1';
  4. export * from './TrtcDefines';
  5. /**
  6. * TrtcCloud
  7. *
  8. * @class TrtcCloud
  9. */
  10. export default class TrtcCloud {
  11. /**
  12. * 创建 TrtcCloud 单例
  13. *
  14. * @static
  15. * @memberof TrtcCloud
  16. * @example
  17. * TrtcCloud.createInstance();
  18. */
  19. static createInstance() {
  20. console.log('----------------------------------------------------------------');
  21. console.log(` SDK ${version} `);
  22. console.log('----------------------------------------------------------------');
  23. return TrtcCloudImpl._createInstance();
  24. }
  25. /**
  26. * 销毁 TrtcCloud 单例
  27. *
  28. * @static
  29. * @memberof TrtcCloud
  30. * @example
  31. * TrtcCloud.destroyInstance();
  32. */
  33. static destroyInstance() {
  34. return TrtcCloudImpl._destroyInstance();
  35. }
  36. /**
  37. * 设置 TrtcCloud 事件监听
  38. *
  39. * @param {String} event 事件名称
  40. * @param {Function} callback 事件回调
  41. * @memberof TrtcCloud
  42. *
  43. * @example
  44. * this.trtcCloud = TrtcCloud.createInstance(); // 创建 trtcCloud 实例
  45. * this.trtcCloud.on('onEnterRoom', (res) => {});
  46. */
  47. on(event, callback) {
  48. return TrtcCloudImpl._getInstance().on(event, callback);
  49. }
  50. /**
  51. * 取消事件绑定<br>
  52. *
  53. * @param {String} event 事件名称,传入通配符 '*' 会解除所有事件绑定。
  54. * @memberof TrtcCloud
  55. * @example
  56. * this.trtcCloud.off('onEnterRoom');
  57. *
  58. * this.trtcCloud.off('*'); // 取消所有绑定的事件
  59. */
  60. off(event) {
  61. return TrtcCloudImpl._getInstance().off(event);
  62. }
  63. /**
  64. * 进房<br>
  65. * 调用接口后,您会收到来自 TRTCCallback 中的 [onEnterRoom(result)]{@link TRTCCallback#onEnterRoom} 回调
  66. * 如果加入成功,result 会是一个正数(result > 0),表示加入房间所消耗的时间,单位是毫秒(ms)。<br>
  67. * 如果加入失败,result 会是一个负数(result < 0),表示进房失败的错误码。
  68. *
  69. * * 参数 scene 的枚举值如下:
  70. * - {@link TRTCAppSceneVideoCall}:<br>
  71. * 视频通话场景,支持720P、1080P高清画质,单个房间最多支持300人同时在线,最高支持50人同时发言。<br>
  72. * 适合:[1对1视频通话]、[300人视频会议]、[在线问诊]、[视频聊天]、[远程面试]等。<br>
  73. * - {@link TRTCAppSceneAudioCall}:<br>
  74. * 语音通话场景,支持 48kHz,支持双声道。单个房间最多支持300人同时在线,最高支持50人同时发言。<br>
  75. * 适合:[1对1语音通话]、[300人语音会议]、[语音聊天]、[语音会议]、[在线狼人杀]等。<br>
  76. * - {@link TRTCAppSceneLIVE}:<br>
  77. * 视频互动直播,支持平滑上下麦,切换过程无需等待,主播延时小于300ms;支持十万级别观众同时播放,播放延时低至1000ms。<br>
  78. * 适合:[视频低延时直播]、[十万人互动课堂]、[视频直播 PK]、[视频相亲房]、[互动课堂]、[远程培训]、[超大型会议]等。<br>
  79. * - {@link TRTCAppSceneVoiceChatRoom}:<br>
  80. * 语音互动直播,支持平滑上下麦,切换过程无需等待,主播延时小于300ms;支持十万级别观众同时播放,播放延时低至1000ms。<br>
  81. * 适合:[语音低延时直播]、[语音直播连麦]、[语聊房]、[K 歌房]、[FM 电台]等。<br>
  82. *
  83. * **Note:**
  84. * 1. 当 scene 选择为 TRTCAppSceneLIVE 或 TRTCAppSceneVoiceChatRoom 时,您必须通过 TRTCParams 中的 role 字段指定当前用户的角色。
  85. * 2. 不管进房是否成功,enterRoom 都必须与 exitRoom 配对使用,在调用 `exitRoom` 前再次调用 `enterRoom` 函数会导致不可预期的错误问题。
  86. *
  87. * @param {TRTCParams} params - 进房参数
  88. * @param {Number} params.sdkAppId - 应用标识(必填)
  89. * @param {String} params.userId - 用户标识(必填)
  90. * @param {String} params.userSig - 用户签名(必填)
  91. * @param {Number} params.roomId - 房间号码, roomId 和 strRoomId 必须填一个, 若您选用 strRoomId,则 roomId 需要填写为0。
  92. * @param {String} params.strRoomId - 字符串房间号码 [选填],在同一个房间内的用户可以看到彼此并进行视频通话, roomId 和 strRoomId 必须填一个。若两者都填,则优先选择 roomId
  93. * @param {TRTCRoleType} params.role - 直播场景下的角色,默认值:主播
  94. * - TRTCRoleAnchor: 主播,可以上行视频和音频,一个房间里最多支持50个主播同时上行音视频。
  95. * - TRTCRoleAudience: 观众,只能观看,不能上行视频和音频,一个房间里的观众人数没有上限。
  96. * @param {String=} params.privateMapKey - 房间签名(非必填)
  97. * @param {String=} params.businessInfo - 业务数据(非必填)
  98. * @param {String=} params.streamId - 自定义 CDN 播放地址(非必填)
  99. * @param {String=} params.userDefineRecordId - 设置云端录制完成后的回调消息中的 "userdefinerecordid" 字段内容,便于您更方便的识别录制回调(非必填)
  100. * @param {TRTCAppScene} scene 应用场景,目前支持视频通话(TRTCAppSceneVideoCall)、语音通话(TRTCAppSceneAudioCall)、在线直播(TRTCAppSceneLIVE)、语音聊天室(VTRTCAppSceneVoiceChatRoom)四种场景,
  101. * 详见 [TrtcDefines] 中 TRTCAppScene 参数定义
  102. *
  103. * @memberof TrtcCloud
  104. * @example
  105. * import { TRTCAppScene } from '@/TrtcCloud/lib/TrtcDefines';
  106. * this.trtcCloud = TrtcCloud.createInstance(); // 创建实例,只需创建一次
  107. * const params = {
  108. * sdkAppId: 0,
  109. * userId: 'xxx',
  110. * roomId: 12345,
  111. * userSig: 'xxx'
  112. * };
  113. * this.trtcCloud.enterRoom(params, TRTCAppScene.TRTCAppSceneVideoCall);
  114. */
  115. enterRoom(params, scene) {
  116. return TrtcCloudImpl._getInstance().enterRoom(params, scene);
  117. }
  118. /**
  119. * 退房<br>
  120. * 执行退出房间的相关逻辑释放资源后,SDK 会通过 `onExitRoom()` 回调通知到您
  121. *
  122. * **Note:**
  123. * 1. 如果您要再次调用 `enterRoom()` 或者切换到其它的音视频 SDK,请等待 `onExitRoom()` 回调到来后再执行相关操作,否则可能会遇到如摄像头、麦克风设备被强占等各种异常问题。
  124. *
  125. * @memberof TrtcCloud
  126. * @example
  127. * this.trtcCloud.exitRoom();
  128. */
  129. exitRoom() {
  130. return TrtcCloudImpl._getInstance().exitRoom();
  131. }
  132. /**
  133. * 切换角色,仅适用于直播场景(TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom)
  134. *
  135. * 在直播场景下,一个用户可能需要在“观众”和“主播”之间来回切换。
  136. * 您可以在进房前通过 TRTCParams 中的 role 字段确定角色,也可以通过 switchRole 在进房后切换角色。
  137. *
  138. * @param {TRTCRoleType} role - 目标角色,默认为主播
  139. * - TRTCRoleAnchor: 主播,可以上行视频和音频,一个房间里最多支持50个主播同时上行音视频。
  140. * - TRTCRoleAudience: 观众,只能观看,不能上行视频和音频,一个房间里的观众人数没有上限。
  141. *
  142. * @memberof TrtcCloud
  143. * @example
  144. * import { TRTCRoleType } from '@/TrtcCloud/lib/TrtcDefines';
  145. * this.trtcCloud.switchRole(TRTCRoleType.TRTCRoleAudience);
  146. */
  147. switchRole(role) {
  148. return TrtcCloudImpl._getInstance().switchRole(role);
  149. }
  150. /**
  151. * 请求跨房通话
  152. *
  153. * 默认情况下,只有同一个房间中的用户之间可以进行音视频通话,不同的房间之间的音视频流是相互隔离的。
  154. * 使用该接口让身处两个不同房间中的主播进行跨房间的音视频流分享,从而让每个房间中的观众都能观看到这两个主播的音视频。
  155. * 跨房通话的请求结果会通过监听 [onConnectOtherRoom](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TRTCCallback.html#event:onConnectOtherRoom) 事件通知给您。
  156. *
  157. * @param {Object} params - 跨房通话参数
  158. * - 如果对端的房间号为数字,那么传入的参数为 roomId。
  159. * - 如果对端的房间号为字符串,那么传入的参数为 strRoomId。
  160. * - 针对对端的房间号类型传递对应参数,不需要两个同时传递。具体请看 example 的使用。
  161. * @param {Number} params.roomId 跨房通话时对端的数字房间号 roomId(与 strRoomId 选填其中一个,不可同时传递)
  162. * @param {String} params.strRoomId 跨房通话时对端的字符串房间号 strRoomId(与 roomId 选填其中一个,不可同时传递)
  163. * @param {String} params.userId 跨房通话时对端的 userId(必填)
  164. *
  165. *
  166. * @memberof TrtcCloud
  167. * @example
  168. * this.trtcCloud.connectOtherRoom({"roomId": 1233, "userId": "user_11"});
  169. * this.trtcCloud.connectOtherRoom({"strRoomId": "1233", "userId": "user_22"});
  170. */
  171. connectOtherRoom(params) {
  172. return TrtcCloudImpl._getInstance().connectOtherRoom(params);
  173. }
  174. /**
  175. * 退出跨房通话
  176. *
  177. * 退出跨房通话的请求结果会通过监听 [onDisconnectOtherRoom](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TRTCCallback.html#event:onDisconnectOtherRoom) 事件通知给您。
  178. *
  179. * @memberof TrtcCloud
  180. * @example
  181. * this.trtcCloud.disconnectOtherRoom();
  182. */
  183. disconnectOtherRoom() {
  184. return TrtcCloudImpl._getInstance().disconnectOtherRoom();
  185. }
  186. /**
  187. * 开启本地视频的预览画面<br>
  188. * 当开始渲染首帧摄像头画面时,您会收到 `onFirstVideoFrame(null)` 回调
  189. *
  190. * @param {Boolean} isFrontCamera 前置、后置摄像头,true:前置摄像头;false:后置摄像头,**默认为 true**
  191. * @param {String=} viewId 用于承载视频画面的渲染控件,使用原生插件中的 TRTCCloudUniPlugin-TXLocalViewComponent component,需要提供 viewId 属性值,例如 viewId=userId
  192. * @memberof TrtcCloud
  193. * @example
  194. * // 预览本地画面
  195. * const viewId = this.userId;
  196. * this.trtcCloud.startLocalPreview(true, viewId);
  197. */
  198. startLocalPreview(isFrontCamera = true, viewId) {
  199. return TrtcCloudImpl._getInstance().startLocalPreview(isFrontCamera, viewId);
  200. }
  201. /**
  202. * 设置视频编码器的编码参数
  203. * - 该设置能够决定远端用户看到的画面质量,同时也能决定云端录制出的视频文件的画面质量。
  204. * @param {TRTCVideoEncParam} param 用于设置视频编码器的相关参数
  205. * @memberof TrtcCloud
  206. * @example
  207. *
  208. * import { TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoEncParam } from '@/TrtcCloud/lib/TrtcDefines';
  209. * const videoResolution = TRTCVideoResolution.TRTCVideoResolution_480_360;
  210. * const videoResolutionMode = TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape; // 横屏采集
  211. * const videoFps = 15;
  212. * const videoBitrate = 900;
  213. * const minVideoBitrate = 200;
  214. * const enableAdjustRes = false;
  215. * // const param = new TRTCVideoEncParam(videoResolution, videoResolutionMode, videoFps, videoBitrate, minVideoBitrate, enableAdjustRes); // v1.1.0 方式
  216. *
  217. * const param = { // v1.2.0 以上版本支持的方式
  218. * videoResolution,
  219. * videoResolutionMode,
  220. * videoFps,
  221. * videoBitrate,
  222. * minVideoBitrate,
  223. * enableAdjustRes,
  224. * };
  225. *
  226. * this.trtcCloud.setVideoEncoderParam(param);
  227. */
  228. setVideoEncoderParam(param) {
  229. return TrtcCloudImpl._getInstance().setVideoEncoderParam(param);
  230. }
  231. /**
  232. * 切换前置或后置摄像头
  233. *
  234. * @param {Boolean} isFrontCamera 前置、后置摄像头,true:前置摄像头;false:后置摄像头
  235. * @memberof TrtcCloud
  236. * @example
  237. * // 切换前置或后置摄像头
  238. * const isFrontCamera = true;
  239. * this.trtcCloud.switchCamera(isFrontCamera);
  240. */
  241. switchCamera(isFrontCamera) {
  242. return TrtcCloudImpl._getInstance().switchCamera(isFrontCamera);
  243. }
  244. /**
  245. * 停止本地视频采集及预览
  246. *
  247. * @memberof TrtcCloud
  248. * @example
  249. * this.trtcCloud.stopLocalPreview();
  250. */
  251. stopLocalPreview() {
  252. return TrtcCloudImpl._getInstance().stopLocalPreview();
  253. }
  254. /**
  255. * 设置本地画面的渲染参数,可设置的参数包括有:画面的旋转角度、填充模式以及左右镜像等。
  256. * @param {TRTCRenderParams} params - 本地图像的参数
  257. * @param {TRTCVideoRotation} params.rotation - 图像的顺时针旋转角度,支持90、180以及270旋转角度,默认值:TRTCVideoRotation.TRTCVideoRotation_0
  258. * @param {TRTCVideoFillMode} params.fillMode - 视频画面填充模式,填充(画面可能会被拉伸裁剪)或适应(画面可能会有黑边),默认值:TRTCVideoFillMode.TRTCVideoFillMode_Fill
  259. * @param {TRTCVideoMirrorType} params.mirrorType - 画面镜像模式,默认值:TRTCVideoMirrorType.TRTCVideoMirrorType_Auto
  260. *
  261. * @memberof TrtcCloud
  262. * @example
  263. * import { TRTCVideoRotation, TRTCVideoFillMode, TRTCVideoMirrorType } from '@/TrtcCloud/lib/TrtcDefines';
  264. * const renderParams = {
  265. * rotation: TRTCVideoRotation.TRTCVideoRotation_0,
  266. * fillMode: TRTCVideoFillMode.TRTCVideoFillMode_Fill,
  267. * mirrorType: TRTCVideoMirrorType.TRTCVideoMirrorType_Auto
  268. * };
  269. * this.trtcCloud.setLocalRenderParams(renderParams);
  270. */
  271. setLocalRenderParams(params) {
  272. return TrtcCloudImpl._getInstance().setLocalRenderParams(params);
  273. }
  274. /**
  275. * 暂停/恢复发布本地的视频流
  276. *
  277. * 该接口可以暂停(或恢复)发布本地的视频画面,暂停之后,同一房间中的其他用户将无法继续看到自己画面。 该接口在指定 TRTCVideoStreamTypeBig 时等效于 start/stopLocalPreview 这两个接口,但具有更好的响应速度。 因为 start/stopLocalPreview 需要打开和关闭摄像头,而打开和关闭摄像头都是硬件设备相关的操作,非常耗时。 相比之下,muteLocalVideo 只需要在软件层面对数据流进行暂停或者放行即可,因此效率更高,也更适合需要频繁打开关闭的场景。 当暂停/恢复发布指定 TRTCVideoStreamTypeBig 后,同一房间中的其他用户将会收到 onUserVideoAvailable 回调通知。 当暂停/恢复发布指定 TRTCVideoStreamTypeSub 后,同一房间中的其他用户将会收到 onUserSubStreamAvailable 回调通知。
  278. * @param {TRTCVideoStreamType} streamType 要暂停/恢复的视频流类型(仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub)
  279. * @param {Boolean} mute - true:屏蔽;false:开启,默认值:false
  280. *
  281. * @memberof TrtcCloud
  282. * @example
  283. * this.trtcCloud.muteLocalVideo(TRTCVideoStreamType.TRTCVideoStreamTypeBig, true);
  284. */
  285. muteLocalVideo(streamType, mute) {
  286. return TrtcCloudImpl._getInstance().muteLocalVideo(streamType, mute);
  287. }
  288. /**
  289. * 显示远端视频或辅流<br>
  290. *
  291. * @param {String} userId 指定远端用户的 userId
  292. * @param {TRTCVideoStreamType} streamType 指定要观看 userId 的视频流类型
  293. * - 高清大画面:TRTCVideoStreamType.TRTCVideoStreamTypeBig
  294. * - 低清小画面:TRTCVideoStreamType.TRTCVideoStreamTypeSmall
  295. * - 辅流(屏幕分享):TRTCVideoStreamType.TRTCVideoStreamTypeSub
  296. * @param {String} viewId 用于承载视频画面的渲染控件,使用原生插件中的 TRTCCloudUniPlugin-TXRemoteViewComponent component,需要提供 viewId 属性值,例如 viewId=userId
  297. * @memberof TrtcCloud
  298. * @example
  299. * import { TRTCVideoStreamType } from '@/TrtcCloud/lib/TrtcDefines';
  300. * const viewId = this.remoteUserId;
  301. * this.trtcCloud.startRemoteView(userId, TRTCVideoStreamType.TRTCVideoStreamTypeBig, viewId);
  302. */
  303. startRemoteView(userId, streamType, viewId) {
  304. return TrtcCloudImpl._getInstance().startRemoteView(userId, streamType, viewId);
  305. }
  306. /**
  307. * 停止显示远端视频画面,同时不再拉取该远端用户的视频数据流<br>
  308. * 指定要停止观看的 userId 的视频流类型
  309. *
  310. * @param {String} userId 指定的远端用户 ID
  311. * @param {TRTCVideoStreamType} streamType
  312. * - 高清大画面:TRTCVideoStreamType.TRTCVideoStreamTypeBig
  313. * - 低清小画面:TRTCVideoStreamType.TRTCVideoStreamTypeSmall
  314. * - 辅流(屏幕分享):TRTCVideoStreamType.TRTCVideoStreamTypeSub
  315. * @memberof TrtcCloud
  316. * @example
  317. * import { TRTCVideoStreamType } from '@/TrtcCloud/lib/TrtcDefines';
  318. * this.trtcCloud.stopRemoteView(remoteUserId, TRTCVideoStreamType.TRTCVideoStreamTypeBig);
  319. */
  320. stopRemoteView(userId, streamType) {
  321. return TrtcCloudImpl._getInstance().stopRemoteView(userId, streamType);
  322. }
  323. /**
  324. * 设置远端画面的渲染参数,可设置的参数包括有:画面的旋转角度、填充模式以及左右镜像等。
  325. * @param {String} userId 远端用户 ID
  326. * @param {TRTCVideoStreamType} streamType 可以设置为主路画面(TRTCVideoStreamTypeBig)或辅路画面(TRTCVideoStreamTypeSub)
  327. * @param {TRTCRenderParams} params - 图像的参数
  328. * @param {TRTCVideoRotation} params.rotation - 图像的顺时针旋转角度,支持90、180以及270旋转角度,默认值:TRTCVideoRotation.TRTCVideoRotation_0
  329. * @param {TRTCVideoFillMode} params.fillMode - 视频画面填充模式,填充(画面可能会被拉伸裁剪)或适应(画面可能会有黑边),默认值:TRTCVideoFillMode.TRTCVideoFillMode_Fill
  330. * @param {TRTCVideoMirrorType} params.mirrorType - 画面镜像模式,默认值:TRTCVideoMirrorType.TRTCVideoMirrorType_Auto
  331. * @memberof TrtcCloud
  332. * @example
  333. * import { TRTCVideoRotation, TRTCVideoFillMode, TRTCVideoMirrorType } from '@/TrtcCloud/lib/TrtcDefines';
  334. * const renderParams = {
  335. * rotation: TRTCVideoRotation.TRTCVideoRotation_0,
  336. * fillMode: TRTCVideoFillMode.TRTCVideoFillMode_Fill,
  337. * mirrorType: TRTCVideoMirrorType.TRTCVideoMirrorType_Auto
  338. * };
  339. * this.trtcCloud.setRemoteRenderParams(userId, TRTCVideoStreamType.TRTCVideoStreamTypeBig, renderParams);
  340. */
  341. setRemoteRenderParams(userId, streamType, params) { }
  342. /**
  343. * 视频画面截图
  344. *
  345. * 您可以通过本接口截取本地的视频画面,远端用户的主路画面以及远端用户的辅路(屏幕分享)画面。
  346. *
  347. * @param {String | null} userId 用户 ID,如指定 null 表示截取本地的视频画面
  348. * @param {TRTCVideoStreamType} streamType 视频流类型,可选择截取主路画面(TRTCVideoStreamTypeBig,常用于摄像头)或辅路画面(TRTCVideoStreamTypeSub,常用于屏幕分享)
  349. * @param {TRTCSnapshotSourceType} sourceType 画面来源,可选择截取视频流画面(TRTCSnapshotSourceTypeStream)或视频渲染画面(TRTCSnapshotSourceTypeView),前者一般更清晰
  350. *
  351. * @memberof TrtcCloud
  352. * @example
  353. * import { TRTCVideoStreamType } from '@/TrtcCloud/lib/TrtcDefines';
  354. * this.trtcCloud.snapshotVideo(null, TRTCVideoStreamType.TRTCVideoStreamTypeBig, TRTCSnapshotSourceType.TRTCSnapshotSourceTypeStream); // 截取本地视频流画面
  355. * this.trtcCloud.snapshotVideo(this.remoteUserId, TRTCVideoStreamType.TRTCVideoStreamTypeBig, TRTCSnapshotSourceType.TRTCSnapshotSourceTypeView); // 截取远端指定用户视频渲染画面
  356. */
  357. snapshotVideo(userId, streamType, sourceType) {
  358. return TrtcCloudImpl._getInstance().snapshotVideo(userId, streamType, sourceType);
  359. }
  360. /**
  361. * 开启本地音频的采集和上行, 并设置音频质量<br>
  362. * 该函数会启动麦克风采集,并将音频数据传输给房间里的其他用户。 SDK 不会默认开启本地音频采集和上行,您需要调用该函数开启,否则房间里的其他用户将无法听到您的声音<br>
  363. * 主播端的音质越高,观众端的听感越好,但传输所依赖的带宽也就越高,在带宽有限的场景下也更容易出现卡顿
  364. *
  365. * @param {TRTCAudioQuality} quality 声音音质
  366. * - TRTCAudioQualitySpeech,流畅:采样率:16k;单声道;音频裸码率:16kbps;适合语音通话为主的场景,比如在线会议,语音通话。
  367. * - TRTCAudioQualityDefault,默认:采样率:48k;单声道;音频裸码率:50kbps;SDK 默认的音频质量,如无特殊需求推荐选择之。
  368. * - TRTCAudioQualityMusic,高音质:采样率:48k;双声道 + 全频带;音频裸码率:128kbps;适合需要高保真传输音乐的场景,比如在线K歌、音乐直播等
  369. * @memberof TrtcCloud
  370. * @example
  371. * import { TRTCAudioQuality } from '@/TrtcCloud/lib/TrtcDefines';
  372. * this.trtcCloud.startLocalAudio(TRTCAudioQuality.TRTCAudioQualityDefault);
  373. */
  374. startLocalAudio(quality) {
  375. return TrtcCloudImpl._getInstance().startLocalAudio(quality);
  376. }
  377. /**
  378. * 关闭本地音频的采集和上行<br>
  379. * 当关闭本地音频的采集和上行,房间里的其它成员会收到 `onUserAudioAvailable(false)` 回调通知
  380. *
  381. * @memberof TrtcCloud
  382. * @example
  383. * this.trtcCloud.stopLocalAudio();
  384. */
  385. stopLocalAudio() {
  386. return TrtcCloudImpl._getInstance().stopLocalAudio();
  387. }
  388. /**
  389. * 静音本地的音频
  390. *
  391. * 当静音本地音频后,房间里的其它成员会收到 onUserAudioAvailable(false) 回调通知。
  392. * 与 stopLocalAudio 不同之处在于,muteLocalAudio 并不会停止发送音视频数据,而是会继续发送码率极低的静音包。
  393. * 在对录制质量要求很高的场景中,选择 muteLocalAudio 是更好的选择,能录制出兼容性更好的 MP4 文件。
  394. * 这是由于 MP4 等视频文件格式,对于音频的连续性是要求很高的,简单粗暴地 stopLocalAudio 会导致录制出的 MP4 不易播放。
  395. *
  396. * @param {Boolean} mute - true:屏蔽;false:开启,默认值:false
  397. *
  398. * @memberof TrtcCloud
  399. * @example
  400. * this.trtcCloud.muteLocalAudio(true);
  401. */
  402. muteLocalAudio(mute) {
  403. return TrtcCloudImpl._getInstance().muteLocalAudio(mute);
  404. }
  405. /**
  406. * 静音掉某一个用户的声音,同时不再拉取该远端用户的音频数据流
  407. *
  408. * @param {String} userId - 用户 ID
  409. * @param {Boolean} mute - true:静音;false:非静音
  410. *
  411. * @memberof TrtcCloud
  412. * @example
  413. * this.trtcCloud.muteRemoteAudio('denny', true);
  414. */
  415. muteRemoteAudio(userId, mute) {
  416. return TrtcCloudImpl._getInstance().muteRemoteAudio(userId, mute);
  417. }
  418. /**
  419. * 静音掉所有用户的声音,同时不再拉取该远端用户的音频数据流
  420. *
  421. * @param {Boolean} mute - true:静音;false:非静音
  422. *
  423. * @memberof TrtcCloud
  424. * @example
  425. * this.trtcCloud.muteAllRemoteAudio(true);
  426. */
  427. muteAllRemoteAudio(mute) {
  428. return TrtcCloudImpl._getInstance().muteAllRemoteAudio(mute);
  429. }
  430. /**
  431. * 设置音频路由
  432. *
  433. * 设置“音频路由”,即设置声音是从手机的扬声器还是从听筒中播放出来,因此该接口仅适用于手机等移动端设备。 手机有两个扬声器:一个是位于手机顶部的听筒,一个是位于手机底部的立体声扬声器。
  434. * 设置音频路由为听筒时,声音比较小,只有将耳朵凑近才能听清楚,隐私性较好,适合用于接听电话。 设置音频路由为扬声器时,声音比较大,不用将手机贴脸也能听清,因此可以实现“免提”的功能。
  435. *
  436. * @param {TRTCAudioRoute} route 音频路由,即声音由哪里输出(扬声器、听筒), 默认值:TRTCAudioRoute.TRTCAudioRouteSpeaker(扬声器),
  437. * @memberof TrtcCloud
  438. * @example
  439. * import { TRTCAudioRoute } from '@/TrtcCloud/lib/TrtcDefines';
  440. * this.trtcCloud.setAudioRoute(TRTCAudioRoute.TRTCAudioRouteSpeaker); // TRTCAudioRoute.TRTCAudioRouteEarpiece (听筒)
  441. */
  442. setAudioRoute(route) {
  443. return TrtcCloudImpl._getInstance().setAudioRoute(route);
  444. }
  445. /**
  446. * 启用或关闭音量大小提示
  447. *
  448. * 开启此功能后,SDK 会在 onUserVoiceVolume() 中反馈对每一路声音音量大小值的评估。
  449. *
  450. * **Note:**
  451. * - 如需打开此功能,请在 startLocalAudio 之前调用才可以生效。
  452. *
  453. * @param {Number} interval - 设置 onUserVoiceVolume 回调的触发间隔,单位为ms,最小间隔为100ms,如果小于等于0则会关闭回调,建议设置为300ms
  454. * @memberof TrtcCloud
  455. * @example
  456. * this.trtcCloud.enableAudioVolumeEvaluation(300);
  457. */
  458. enableAudioVolumeEvaluation(interval) {
  459. return TrtcCloudImpl._getInstance().enableAudioVolumeEvaluation(interval);
  460. }
  461. /////////////////////////////////////////////////////////////////////////////////
  462. //
  463. // 屏幕分享
  464. //
  465. /////////////////////////////////////////////////////////////////////////////////
  466. /**
  467. * 设置屏幕分享(即辅路)的视频编码参数
  468. *
  469. * 该接口可以设定远端用户所看到的屏幕分享(即辅路)的画面质量,同时也能决定云端录制出的视频文件中屏幕分享的画面质量。 请注意如下两个接口的差异:
  470. * - setVideoEncoderParam 用于设置主路画面(TRTCVideoStreamTypeBig,一般用于摄像头)的视频编码参数。
  471. * - setSubStreamEncoderParam 用于设置辅路画面(TRTCVideoStreamTypeSub,一般用于屏幕分享)的视频编码参数。
  472. *
  473. * **Note:**
  474. * - 即使您使用主路传输屏幕分享(在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig),依然要使用 setSubStreamEncoderParam 设定屏幕分享的编码参数,而不要使用 setVideoEncoderParam
  475. * @param {TRTCVideoEncParam} param 辅流编码参数,详情请参考 TRTCVideoEncParam。
  476. * @memberof TrtcCloud
  477. * @example
  478. * const params = {
  479. * videoResolution: TRTCVideoResolution.TRTCVideoResolution_640_360,
  480. * videoResolutionMode: TRTCVideoResolutionMode.TRTCVideoResolutionModePortrait,
  481. * videoFps: 15,
  482. * videoBitrate: 900,
  483. * minVideoBitrate: 200,
  484. * enableAdjustRes: false,
  485. * };
  486. * this.trtcCloud.setSubStreamEncoderParam(params);
  487. */
  488. setSubStreamEncoderParam(param) {
  489. return TrtcCloudImpl._getInstance().setSubStreamEncoderParam(param);
  490. }
  491. /**
  492. * 启动屏幕分享
  493. *
  494. * **Note:**
  495. * - 一个用户同时最多只能上传一条主路(TRTCVideoStreamTypeBig)画面和一条辅路(TRTCVideoStreamTypeSub)画面,
  496. * 默认情况下,屏幕分享使用辅路画面,如果使用主路画面,建议您提前停止摄像头采集(stopLocalPreview)避免相互冲突。
  497. * - **仅支持 iOS 13.0 及以上系统,进行应用内的屏幕分享**
  498. *
  499. * @param {TRTCVideoStreamType} streamType 屏幕分享使用的线路,可以设置为主路(TRTCVideoStreamTypeBig)或者辅路(TRTCVideoStreamTypeSub),推荐使用
  500. * @param {TRTCVideoEncParam} encParams 屏幕分享的画面编码参数,可以设置为 null,表示让 SDK 选择最佳的编码参数(分辨率、码率等)。即使在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig,依然可以使用此接口更新屏幕分享的编码参数。
  501. * @memberof TrtcCloud
  502. * @example
  503. * import { TRTCVideoResolution, TRTCVideoResolutionMode, TRTCVideoStreamType} from '@/TrtcCloud/lib/TrtcDefines';
  504. * const encParams = {
  505. * videoResolution: TRTCVideoResolution.TRTCVideoResolution_640_360,
  506. * videoResolutionMode: TRTCVideoResolutionMode.TRTCVideoResolutionModePortrait,
  507. * videoFps: 15,
  508. * videoBitrate: 900,
  509. * minVideoBitrate: 200,
  510. * enableAdjustRes: false,
  511. * };
  512. * this.trtcCloud.startScreenCapture(TRTCVideoStreamType.TRTCVideoStreamTypeSub, encParams);
  513. */
  514. startScreenCapture(streamType = TRTCVideoStreamType.TRTCVideoStreamTypeSub, encParams = null) {
  515. return TrtcCloudImpl._getInstance().startScreenCapture(streamType, encParams);
  516. }
  517. /**
  518. * 停止屏幕分享
  519. * @memberof TrtcCloud
  520. * @example
  521. * this.trtcCloud.stopScreenCapture();
  522. */
  523. stopScreenCapture() {
  524. return TrtcCloudImpl._getInstance().stopScreenCapture();
  525. }
  526. /**
  527. * 暂停屏幕分享
  528. * @memberof TrtcCloud
  529. * @example
  530. * this.trtcCloud.pauseScreenCapture();
  531. */
  532. pauseScreenCapture() {
  533. return TrtcCloudImpl._getInstance().pauseScreenCapture();
  534. }
  535. /**
  536. * 恢复屏幕分享
  537. * @memberof TrtcCloud
  538. * @example
  539. * this.trtcCloud.resumeScreenCapture();
  540. */
  541. resumeScreenCapture() {
  542. return TrtcCloudImpl._getInstance().resumeScreenCapture();
  543. }
  544. /////////////////////////////////////////////////////////////////////////////////
  545. //
  546. // 美颜 + 水印
  547. //
  548. /////////////////////////////////////////////////////////////////////////////////
  549. /**
  550. * 设置美颜(磨皮)算法
  551. * TRTC 内置多种不同的磨皮算法,您可以选择最适合您产品定位的方案
  552. *
  553. * **Note:**
  554. * - 设置美颜前,先调用 `setBeautyLevel` 设置美颜级别。否则美颜级别为 0 表示关闭美颜
  555. *
  556. * @param {TRTCBeautyStyle} beautyStyle 美颜风格,TRTCBeautyStyleSmooth:光滑;TRTCBeautyStyleNature:自然;TRTCBeautyStylePitu:优图
  557. * @memberof TrtcCloud
  558. * @example
  559. * import { TRTCBeautyStyle } from '@/TrtcCloud/lib/TrtcDefines';
  560. * const beautyLevel = 5; // 美颜级别,取值范围0 - 9; 0表示关闭,9表示效果最明显。
  561. * this.trtcCloud.setBeautyLevel(beautyLevel);
  562. * this.trtcCloud.setBeautyStyle(TRTCBeautyStyle.TRTCBeautyStyleSmooth);
  563. */
  564. setBeautyStyle(beautyStyle) {
  565. return TrtcCloudImpl._getInstance().setBeautyStyle(beautyStyle);
  566. }
  567. /**
  568. * 设置美颜级别
  569. * @param {Number} beautyLevel 美颜级别,取值范围0 - 9; 0表示关闭,9表示效果最明显。
  570. *
  571. * @memberof TrtcCloud
  572. * @example
  573. * const beautyLevel = 5; // 美颜级别,取值范围0 - 9; 0表示关闭,9表示效果最明显。
  574. * this.trtcCloud.setBeautyLevel(beautyLevel);
  575. */
  576. setBeautyLevel(beautyLevel) {
  577. return TrtcCloudImpl._getInstance().setBeautyLevel(beautyLevel);
  578. }
  579. /////////////////////////////////////////////////////////////////////////////////
  580. //
  581. // 背景音效
  582. //
  583. /////////////////////////////////////////////////////////////////////////////////
  584. /**
  585. * 开始播放背景音乐
  586. * 每个音乐都需要您指定具体的 ID,您可以通过该 ID 对音乐的开始、停止、音量等进行设置。<br>
  587. * **Note:**
  588. * - 如果要多次播放同一首背景音乐,请不要每次播放都分配一个新的 ID,我们推荐使用相同的 ID。
  589. * - 若您希望同时播放多首不同的音乐,请为不同的音乐分配不同的 ID 进行播放。
  590. * - 如果使用同一个 ID 播放不同音乐,SDK 会先停止播放旧的音乐,再播放新的音乐。
  591. *
  592. * **Note:**<br>
  593. * 在 uni-app 中 path 如何获取。
  594. * - 使用 cdn 地址,例如:`path = https://web.sdk.qcloud.com/component/TUIKit/assets/uni-app/calling-bell-1.mp3;`
  595. * - 使用本地绝对路径。
  596. * 1. 通过 [uni.saveFile](https://zh.uniapp.dcloud.io/api/file/file.html#savefile) 获取保存后的相对路径(建议这种路径)。
  597. * 2. 将上一步的相对路径转成绝对路径,[plus.io.convertLocalFileSystemURL](https://www.html5plus.org/doc/zh_cn/io.html#plus.io.convertLocalFileSystemURL)。
  598. *
  599. * @param {AudioMusicParam} musicParam 音乐参数
  600. * @param {Number} musicParam.id 音乐 ID
  601. * @param {String} musicParam.path 音效文件的完整路径或 URL 地址。支持的音频格式包括 MP3、AAC、M4A、WAV
  602. * @param {Number} musicParam.loopCount 音乐循环播放的次数。取值范围为0 - 任意正整数,默认值:0。0表示播放音乐一次;1表示播放音乐两次;以此类推
  603. * @param {Boolean} musicParam.publish 是否将音乐传到远端。true:音乐在本地播放的同时,远端用户也能听到该音乐;false:主播只能在本地听到该音乐,远端观众听不到。默认值:false。
  604. * @param {Boolean} musicParam.isShortFile 播放的是否为短音乐文件。true:需要重复播放的短音乐文件;false:正常的音乐文件。默认值:false
  605. * @param {Number} musicParam.startTimeMS 音乐开始播放时间点,单位: 毫秒。
  606. * @param {Number} musicParam.endTimeMS 音乐结束播放时间点,单位: 毫秒,0 表示播放至文件结尾。
  607. * @memberof TrtcCloud
  608. * @example
  609. * import { AudioMusicParam } from '@/TrtcCloud/lib/TrtcDefines';
  610. * const musicParam = {
  611. * id: 1,
  612. * path: '',
  613. * loopCount: 1,
  614. * publish: true,
  615. * isShortFile: false,
  616. * startTimeMS: 0,
  617. * endTimeMS: 0,
  618. * };
  619. * this.trtcCloud.startPlayMusic(musicParam);
  620. */
  621. startPlayMusic(musicParam) {
  622. return TrtcCloudImpl._getInstance().startPlayMusic(musicParam);
  623. }
  624. /**
  625. * 停止播放背景音乐
  626. * @param {Number} id 音乐 ID
  627. *
  628. * @memberof TrtcCloud
  629. * @example
  630. * const musicId = 5;
  631. * this.trtcCloud.stopPlayMusic(musicId);
  632. */
  633. stopPlayMusic(id) {
  634. return TrtcCloudImpl._getInstance().stopPlayMusic(id);
  635. }
  636. /**
  637. * 暂停播放背景音乐
  638. * @param {Number} id 音乐 ID
  639. * @memberof TrtcCloud
  640. * @example
  641. * const musicId = 5;
  642. * this.trtcCloud.pausePlayMusic(musicId);
  643. */
  644. pausePlayMusic(id) {
  645. return TrtcCloudImpl._getInstance().pausePlayMusic(id);
  646. }
  647. /**
  648. * 恢复播放背景音乐
  649. * @param {Number} id 音乐 ID
  650. * @memberof TrtcCloud
  651. * @example
  652. * const musicId = 5;
  653. * this.trtcCloud.resumePlayMusic(musicId);
  654. */
  655. resumePlayMusic(id) {
  656. return TrtcCloudImpl._getInstance().resumePlayMusic(id);
  657. }
  658. /////////////////////////////////////////////////////////////////////////////////
  659. //
  660. // 设置 TRTCCallback 回调
  661. //
  662. /////////////////////////////////////////////////////////////////////////////////
  663. /**
  664. * 设置 TrtcCloud 回调
  665. *
  666. * @example
  667. * // 创建/使用/销毁 TrtcCloud 对象的示例代码:
  668. * import TrtcCloud from '@/TrtcCloud/lib/index';
  669. * this.trtcCloud = new TrtcCloud();
  670. *
  671. * // 添加事件监听的方法,事件关键字详见下方”通用事件回调“
  672. * this.trtcCloud.on('onEnterRoom', (result) => {
  673. * if (result > 0) {
  674. * console.log(`enter room success, spend ${result}ms`);
  675. * } else {
  676. * console.log(`enter room failed, error code = ${result}`);
  677. * }
  678. * });
  679. *
  680. * @namespace TRTCCallback
  681. */
  682. /////////////////////////////////////////////////////////////////////////////////
  683. //
  684. // (一)事件回调
  685. //
  686. /////////////////////////////////////////////////////////////////////////////////
  687. /**
  688. * 错误回调,表示 SDK 不可恢复的错误,一定要监听并分情况给用户适当的界面提示<br>
  689. * @event TRTCCallback#onError
  690. * @param {Number} code 错误码,[详见](https://cloud.tencent.com/document/product/647/38308#.E9.94.99.E8.AF.AF.E7.A0.81.E8.A1.A8)
  691. * @param {String} message 错误信息
  692. * @param {Object} extraInfo 扩展信息字段,个别错误码可能会带额外的信息帮助定位问题
  693. */
  694. onError(code, message, extraInfo) { }
  695. /**
  696. * 警告回调,用于告知您一些非严重性问题,例如出现卡顿或者可恢复的解码失败<br>
  697. * @event TRTCCallback#onWarning
  698. * @param {Number} code 警告码,[详见](https://cloud.tencent.com/document/product/647/38308#.E8.AD.A6.E5.91.8A.E7.A0.81.E8.A1.A8)
  699. * @param {String} message 警告信息
  700. * @param {Object} extraInfo 扩展信息字段,个别警告码可能会带额外的信息帮助定位问题
  701. */
  702. onWarning(code, message, extraInfo) { }
  703. /**
  704. * 进房后的回调<br>
  705. * 调用 `enterRoom()` 接口执行进房操作后,会收到 `onEnterRoom(result)` 回调<br>
  706. * 如果加入成功,result 会是一个正数(result > 0),代表加入房间的时间消耗,单位是毫秒(ms)。<br>
  707. * 如果加入失败,result 会是一个负数(result < 0),代表进房失败的错误码。
  708. *
  709. * @event TRTCCallback#onEnterRoom
  710. * @param {Number} result 进房耗时
  711. */
  712. onEnterRoom(result) { }
  713. /**
  714. * 离开房间的事件回调<br>
  715. * 调用 `exitRoom()` 接口会执行退出房间的相关逻辑,例如释放音视频设备资源和编解码器资源等。待资源释放完毕,会通过 `onExitRoom()` 回调通知到您<br>
  716. *
  717. * **Note:**
  718. * - 如果您要再次调用 `enterRoom()` 或者切换到其他的音视频 SDK,请等待 `onExitRoom()` 回调到来之后再执行相关操作。 否则可能会遇到音频设备被占用等各种异常问题
  719. *
  720. * @event TRTCCallback#onExitRoom
  721. * @param {Number} reason 离开房间原因,0:主动调用 exitRoom 退房;1:被服务器踢出当前房间;2:当前房间整个被解散
  722. */
  723. onExitRoom(reason) { }
  724. /**
  725. * 跨房通话事件回调<br>
  726. * 调用 TRTCCloud 中的 [connectOtherRoom()](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TrtcCloud.html#connectOtherRoom) 接口会将两个不同房间中的主播拉通视频通话,也就是所谓的“主播PK”功能。
  727. * 调用者会收到 onConnectOtherRoom() 事件回调来获知跨房通话是否成功, 如果成功,两个房间中的所有用户都会收到来自另一个房间中的 PK 主播的 [onUserVideoAvailable()](http://127.0.0.1:5500/UniApp-TRTC-SDK/packages/TrtcCloud/docs/zh-cn/api/TRTCCallback.html#event:onUserVideoAvailable) 回调。
  728. *
  729. * @event TRTCCallback#onConnectOtherRoom
  730. * @param {Object} params 调用 [connectOtherRoom()](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TrtcCloud.html#connectOtherRoom) 接口返回值数据。
  731. * - userId:跨房通话时对端 userId
  732. * - errCode: [错误状态码](https://cloud.tencent.com/document/product/647/38308#.E8.AD.A6.E5.91.8A.E7.A0.81.E8.A1.A8),返回0表示跨房通话成功。
  733. * - errMsg: 状态信息,跨房通话成功返回 OK。
  734. */
  735. onConnectOtherRoom(params) { }
  736. /**
  737. * 结束跨房通话的结果回调<br>
  738. * 调用 TRTCCloud 中的 [disconnectOtherRoom()](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TrtcCloud.html#disconnectOtherRoom) 接口会将两个不同房间中的主播拉通视频通话,也就是所谓的“主播PK”功能。
  739. * 调用者会收到 onDisconnectOtherRoom() 事件回调来获知结束跨房通话是否成功。
  740. *
  741. * @event TRTCCallback#onDisconnectOtherRoom
  742. * @param {Object} params 调用 [disconnectOtherRoom()](https://web.sdk.qcloud.com/trtc/uniapp/doc/zh-cn/TrtcCloud.html#disconnectOtherRoom) 失败时返回的错误数据。
  743. * - errCode: [错误状态码](https://cloud.tencent.com/document/product/647/38308#.E8.AD.A6.E5.91.8A.E7.A0.81.E8.A1.A8)。
  744. * - errMsg: 错误信息。
  745. */
  746. onDisconnectOtherRoom(params) { }
  747. /**
  748. * 切换角色的事件回调<br>
  749. * 调用 TRTCCloud 中的 switchRole() 接口会切换主播和观众的角色,该操作会伴随一个线路切换的过程, 待 SDK 切换完成后,会抛出 onSwitchRole() 事件回调
  750. *
  751. * @event TRTCCallback#onSwitchRole
  752. * @param {Number} code 错误码,[详见](https://cloud.tencent.com/document/product/647/38308#.E8.AD.A6.E5.91.8A.E7.A0.81.E8.A1.A8)
  753. * @param {String} message 错误信息
  754. */
  755. onSwitchRole(code, message) { }
  756. /**
  757. * 开始渲染本地或远程用户的首帧画面<br>
  758. * 如果 userId 为 null,代表开始渲染本地采集的摄像头画面,需要您先调用 `startLocalPreview` 触发。 如果 userId 不为 null,代表开始渲染远程用户的首帧画面,需要您先调用 `startRemoteView` 触发<br>
  759. * 只有当您调用 `startLocalPreview()、startRemoteView() 或 startRemoteSubStreamView()` 之后,才会触发该回调
  760. *
  761. * @event TRTCCallback#onFirstVideoFrame
  762. * @param {String} userId 本地或远程用户 ID,如果 userId === null 代表本地,userId !== null 代表远程
  763. * @param {TRTCVideoStreamType} streamType 视频流类型:摄像头或屏幕分享
  764. * @param {Number} width 画面宽度
  765. * @param {Number} height 画面高度
  766. */
  767. onFirstVideoFrame(userId, streamType, width, height) { }
  768. /**
  769. * 开始播放远程用户的首帧音频(本地声音暂不通知)<br>
  770. * 如果 userId 为 null,代表开始渲染本地采集的摄像头画面,需要您先调用 `startLocalPreview` 触发。 如果 userId 不为 null,代表开始渲染远程用户的首帧画面,需要您先调用 `startRemoteView` 触发<br>
  771. * 只有当您调用 `startLocalPreview()、startRemoteView() 或 startRemoteSubStreamView()` 之后,才会触发该回调
  772. *
  773. * @event TRTCCallback#onFirstAudioFrame
  774. * @param {String} userId 远程用户 ID
  775. */
  776. onFirstAudioFrame(userId) { }
  777. /**
  778. * 截图完成时回调<br>
  779. * @event TRTCCallback#onSnapshotComplete
  780. * @param {String} base64Data 截图对应的 base64 数据
  781. * @param {String} message 错误信息
  782. */
  783. onSnapshotComplete(base64Data, message) { }
  784. /**
  785. * 麦克风准备就绪
  786. */
  787. onMicDidReady() { }
  788. /**
  789. * 摄像头准备就绪
  790. */
  791. onCameraDidReady() { }
  792. /**
  793. * 网络质量:该回调每2秒触发一次,统计当前网络的上行和下行质量<br>
  794. * userId 为本地用户 ID 代表自己当前的视频质量
  795. *
  796. * @param {String} localQuality 上行网络质量
  797. * @param {String} remoteQuality 下行网络质量
  798. */
  799. onNetworkQuality(localQuality, remoteList) { }
  800. /**
  801. * 有用户加入当前房间<br>
  802. * 出于性能方面的考虑,在两种不同的应用场景下,该通知的行为会有差别:<br>
  803. * 通话场景(TRTCAppScene.TRTCAppSceneVideoCall 和 TRTCAppScene.TRTCAppSceneAudioCall):该场景下用户没有角色的区别,任何用户进入房间都会触发该通知。<br>
  804. * 直播场景(TRTCAppScene.TRTCAppSceneLIVE 和 TRTCAppScene.TRTCAppSceneVoiceChatRoom ):该场景不限制观众的数量,如果任何用户进出都抛出回调会引起很大的性能损耗,所以该场景下只有主播进入房间时才会触发该通知,观众进入房间不会触发该通知
  805. *
  806. * @event TRTCCallback#onRemoteUserEnterRoom
  807. * @param {String} userId 用户标识 ID
  808. */
  809. onRemoteUserEnterRoom(userId) { }
  810. /**
  811. * 有用户离开当前房间<br>
  812. * 与 onRemoteUserEnterRoom 相对应,在两种不同的应用场景下,该通知的行为会有差别:<br>
  813. * 通话场景(TRTCAppScene.TRTCAppSceneVideoCall 和 TRTCAppScene.TRTCAppSceneAudioCall):该场景下用户没有角色的区别,任何用户进入房间都会触发该通知。<br>
  814. * 直播场景(TRTCAppScene.TRTCAppSceneLIVE 和 TRTCAppScene.TRTCAppSceneVoiceChatRoom ):该场景不限制观众的数量,如果任何用户进出都抛出回调会引起很大的性能损耗,所以该场景下只有主播进入房间时才会触发该通知,观众进入房间不会触发该通知
  815. *
  816. * @event TRTCCallback#onRemoteUserLeaveRoom
  817. * @param {String} userId 用户标识 ID
  818. * @param {Number} reason 离开原因,0 表示用户主动退出房间,1 表示用户超时退出,2 表示被踢出房间
  819. */
  820. onRemoteUserLeaveRoom(userId, reason) { }
  821. /**
  822. * 首帧本地音频数据已经被送出<br>
  823. * 在 `enterRoom()` 并 `startLocalAudio()` 成功后开始麦克风采集,并将采集到的声音进行编码。 当 SDK 成功向云端送出第一帧音频数据后,会抛出这个回调事件
  824. *
  825. * @event TRTCCallback#onSendFirstLocalAudioFrame
  826. */
  827. onSendFirstLocalAudioFrame() { }
  828. /**
  829. * 首帧本地视频数据已经被送出<br>
  830. * SDK 会在 `enterRoom()` 并 `startLocalPreview()` 成功后开始摄像头采集,并将采集到的画面进行编码。 当 SDK 成功向云端送出第一帧视频数据后,会抛出这个回调事件
  831. *
  832. * @event TRTCCallback#onSendFirstLocalVideoFrame
  833. * @param {TRTCVideoStreamType} streamType 视频流类型,大画面、小画面或辅流画面(屏幕分享)
  834. */
  835. onSendFirstLocalVideoFrame(streamType) { }
  836. /**
  837. * 技术指标统计回调<br>
  838. * 如果您是熟悉音视频领域相关术语,可以通过这个回调获取 SDK 的所有技术指标。 如果您是首次开发音视频相关项目,可以只关注 `onNetworkQuality` 回调
  839. *
  840. * **Note:**
  841. * - 每 2 秒回调一次
  842. *
  843. * @param {Object} statics 状态数据
  844. */
  845. onStatistics(statics) { }
  846. /**
  847. * 远端用户是否存在可播放的音频数据<br>
  848. * @event TRTCCallback#onUserAudioAvailable
  849. * @param {String} userId 用户标识 ID
  850. * @param {Boolean} available 声音是否开启
  851. */
  852. onUserAudioAvailable(userId, available) { }
  853. /**
  854. * 远端用户是否存在可播放的主路画面(一般用于摄像头)<br>
  855. * 当您收到 `onUserVideoAvailable(userId, true)` 通知时,表示该路画面已经有可用的视频数据帧到达。 此时,您需要调用 `startRemoteView(userId)` 接口加载该用户的远程画面。 然后,您会收到名为 onFirstVideoFrame(userid) 的首帧画面渲染回调。<br>
  856. * 当您收到 `onUserVideoAvailable(userId, false)` 通知时,表示该路远程画面已经被关闭,可能由于该用户调用了 `muteLocalVideo()` 或 `stopLocalPreview()`。
  857. *
  858. * @event TRTCCallback#onUserVideoAvailable
  859. * @param {String} userId 用户标识 ID
  860. * @param {Boolean} available 画面是否开启
  861. */
  862. onUserVideoAvailable(userId, available) { }
  863. /**
  864. * 用于提示音量大小的回调,包括每个 userId 的音量和远端总音量<br>
  865. * SDK 可以评估每一路音频的音量大小,并每隔一段时间抛出该事件回调,您可以根据音量大小在 UI 上做出相应的提示,比如“波形图”或“音量槽”。 要完成这个功能, 您需要先调用 enableAudioVolumeEvaluation 开启这个能力并设定事件抛出的时间间隔。 需要补充说明的是,无论当前房间中是否有人说话,SDK 都会按照您设定的时间间隔定时抛出此事件回调,只不过当没有人说话时,userVolumes 为空,totalVolume 为 0。
  866. *
  867. * **Note:**
  868. * - userVolumes 为一个数组,对于数组中的每一个元素,当 userId 为空时表示本地麦克风采集的音量大小,当 userId 不为空时代表远端用户的音量大小
  869. *
  870. * @event TRTCCallback#onUserVoiceVolume
  871. * @param {Array} userVolumes 是一个数组,用于承载所有正在说话的用户的音量大小,取值范围 0 - 100
  872. * @param {Number} totalVolume 所有远端用户的总音量大小, 取值范围 0 - 100
  873. */
  874. onUserVoiceVolume(userVolumes, totalVolume) { }
  875. /**
  876. * 屏幕分享开启的事件回调<br>
  877. * 当您通过 startScreenCapture 等相关接口启动屏幕分享时,SDK 便会抛出此事件回调
  878. * @event TRTCCallback#onScreenCaptureStarted
  879. */
  880. onScreenCaptureStarted() { }
  881. /**
  882. * 屏幕分享停止的事件回调<br>
  883. * 当您通过 stopScreenCapture 停止屏幕分享时,SDK 便会抛出此事件回调
  884. * @event TRTCCallback#onScreenCaptureStopped
  885. * @param {Number} reason 停止原因,0:用户主动停止;1:屏幕窗口关闭导致停止;2:表示屏幕分享的显示屏状态变更(如接口被拔出、投影模式变更等)
  886. */
  887. onScreenCaptureStopped(reason) { }
  888. /**
  889. * 屏幕分享停止的事件回调<br>
  890. * 当您通过 pauseScreenCapture 停止屏幕分享时,SDK 便会抛出此事件回调
  891. * @event TRTCCallback#onScreenCapturePaused
  892. * @param {Number} reason 停止原因,0:用户主动停止;1:屏幕窗口关闭导致停止;2:表示屏幕分享的显示屏状态变更(如接口被拔出、投影模式变更等)
  893. */
  894. onScreenCapturePaused(reason) { }
  895. /**
  896. * 屏幕分享恢复的事件回调<br>
  897. * 当您通过 resumeScreenCapture 恢复屏幕分享时,SDK 便会抛出此事件回调
  898. * @event TRTCCallback#onScreenCaptureResumed
  899. */
  900. onScreenCaptureResumed() { }
  901. /**
  902. * 某远端用户发布/取消了辅路视频画面<br>
  903. * “辅路画面”一般被用于承载屏幕分享的画面。当您收到 onUserSubStreamAvailable(userId, true) 通知时,表示该路画面已经有可播放的视频帧到达。 此时,您需要调用 startRemoteView 接口订阅该用户的远程画面,订阅成功后,您会继续收到该用户的首帧画面渲染回调 onFirstVideoFrame(userId)
  904. *
  905. * **Note:**
  906. * - 拉取 Web 端(用 [WebRTC](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/index.html) 实现屏幕分享)的屏幕分享,收不到 onUserSubStreamAvailable 事件。因为 [WebRTC](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/index.html) 推的屏幕分享也是主流
  907. * @param {String} userId 用户 ID
  908. * @param {Boolean} available 是否可用,true 表示辅流可用
  909. * @event TRTCCallback#onUserSubStreamAvailable
  910. */
  911. onUserSubStreamAvailable(userId, available) { }
  912. /**
  913. * 用户视频大小发生改变回调。<br>
  914. * 当您收到 onUserVideoSizeChanged(userId, streamtype, newWidth, newHeight) 通知时,表示该路画面大小发生了调整,调整的原因可能是该用户调用了 setVideoEncoderParam 或者 setSubStreamEncoderParam 重新设置了画面尺寸。
  915. * @param {String} userId 用户 ID
  916. * @param {TRTCVideoStreamType} streamType 视频流类型,仅支持 TRTCVideoStreamTypeBig 和 TRTCVideoStreamTypeSub
  917. * @param {Number} newWidth 视频流的宽度(像素)
  918. * @param {Number} newHeight 视频流的高度(像素)
  919. * @event TRTCCallback#onUserVideoSizeChanged
  920. */
  921. onUserVideoSizeChanged(userId, streamType, newWidth, newHeight) { }
  922. /**
  923. * 背景音乐开始播放
  924. * @param {Number} id 播放的 id
  925. * @param {Number} errCode 播放的状态码
  926. * @event TRTCCallback#onStart
  927. */
  928. onStart(id, errCode) { }
  929. /**
  930. * 背景音乐的播放进度
  931. * @param {Number} id 播放的 id
  932. * @param {Number} curPtsMS 当前播放的位置
  933. * @param {Number} durationMS 当前音频总时长
  934. * @event TRTCCallback#onPlayProgress
  935. */
  936. onPlayProgress(id, curPtsMS, durationMS) { }
  937. /**
  938. * 背景音乐已经播放完毕
  939. * @param {Number} id 播放的 id
  940. * @param {Number} errCode 播放结束的状态码
  941. * @event TRTCCallback#onComplete
  942. */
  943. onComplete(id, errCode) { }
  944. }