首页你可以获取封装uni本地插件实例：

const RtcModule = uni.requireNativePlugin('插件名称');

渲染视频，使用 anyRTC 封装完成的组件：

<AR-CanvasView :ref="video" style="flex: 1;"></AR-CanvasView>

插件分为：

• Module
• Component

Module

setCallBack()

RtcModule.setCallBack((res) => {
    switch (res.engineEvent) {
        case "onWarning":  //警告回调
            //something
            break;
        case "onError": //错误回调
            //something
            break;
        
        ...

})

注册sdk事件回调 。先执行 sesetCallBack 后，才可以 create 创建对象

返回

• res.engineEvent：Rtc SDK事件回调，参考uni-app Rtc回调事件。

create()

RtcModule.create({
    "appId": "YOUR APPID"
}, (res) => {
    //something
})

声明 Rtc 对象。

返回

• res.code
  • 0 ：方法调用成功。
  • 其他：方法调用失败。

setParameters()

RtcModule.setParameters({
    
}, (res) => {
    //something
})

通过 JSON 配置 SDK 提供技术预览或特别定制功能。功能有些特殊，使用前可以咨询客服。

参数

咨询客服，使用特定功能。

返回

• res.code

  • 0 ：方法调用成功。

  • 其他：方法调用失败。

joinChannel()

RtcModule.joinChannel({
    "token": "",
    "channelId": "",
    "uid": ""
    }, (res) => {
        //something
})

加入频道。

该方法让用户加入通话频道，在同一个频道内的用户可以互相通话，多个用户加入同一个频道，可以群聊。使用不同 App ID 的 App 是不能互通的。如果已在通话中，用户必须调用 leaveChannel 退出当前通话，才能进入下一个频道。

成功调用该方加入频道后，本地会触发 onJoinChannelSuccess 回调；通信场景下的用户和直播场景下的主播加入频道后，远端会触发 onUserJoined 回调。

在网络状况不理想的情况下，客户端可能会与 RTC 的服务器失去连接；SDK 会自动尝试重连，重连成功后，本地会触发 onRejoinChannelSuccess 回调。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

enableAudio()

RtcModule.enableAudio((res) => {
    //something
})

启用音频模块（默认为开启状态）。

注解

• 该方法设置的是内部引擎为开启状态，在频道内和频道外均可调用，且在 leaveChannel 后仍然有效。
• 该方法重置整个引擎，响应速度较慢，因此我们建议使用如下方法来控制音频模块：
  • enableLocalAudio：是否启动麦克风采集并创建本地音频流
  • muteLocalAudioStream：是否发布本地音频流
  • muteRemoteAudioStream：是否接收并播放远端音频流
  • muteAllRemoteAudioStreams：是否接收并播放所有远端音频流

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

enableVideo()

RtcModule.enableVideo((res) => {
    //something
})

启用视频模块。

该方法用于打开视频模式。可以在加入频道前或者通话中调用，在加入频道前调用，则自动开启视频模式，在通话中调用则由音频模式切换为视频模式。调用 disableVideo 方法可关闭视频模式。

成功调用该方法后，远端会触发 onRemoteVideoStateChanged () 回调。

注解

• 该方法设置的是内部引擎为开启状态，在频道内和频道外均可调用，且在 leaveChannel 后仍然有效。
• 该方法重置整个引擎，响应速度较慢，因此我们建议使用如下方法来控制视频模块：
  • enableLocalVideo：是否启动摄像头采集并创建本地视频流
  • muteLocalVideoStream：是否发布本地视频流
  • muteRemoteVideoStream：是否接收并播放远端视频流
  • muteAllRemoteVideoStreams：是否接收并播放所有远端视频流

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

disableAudio()

RtcModule.disableAudio((res) => {
    //something
})

关闭音频模块。

注解

• 该方法设置的是内部引擎为禁用状态，在频道内和频道外均可调用，且在 leaveChannel 后仍然有效。
• 该方法重置整个引擎，响应速度较慢，因此我们建议使用如下方法来控制音频模块：
  • enableLocalAudio：是否启动麦克风采集并创建本地音频流
  • muteLocalAudioStream：是否发布本地音频流
  • muteRemoteAudioStream：是否接收并播放远端音频流
  • muteAllRemoteAudioStreams：是否接收并播放所有远端音频流

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

disableVideo()

RtcModule.disableVideo((res) => {
    //something
})

关闭视频模块。

该方法用于关闭视频。可以在加入频道前或者通话中调用，在加入频道前调用，则自动开启纯音频模式，在通话中调用则由视频模式切换为纯音频频模式。调用 enableVideo 方法可开启视频模式。

成功调用该方法后，远端会触发onRemoteVideoStateChanged ()回调。

注解

• 该方法设置的是内部引擎为禁用状态，在频道内和频道外均可调用，且在 leaveChannel 后仍然有效。
• 该方法重置整个引擎，响应速度较慢，因此 我们 建议使用如下方法来控制视频模块：
  • enableLocalVideo：是否启动摄像头采集并创建本地视频流
  • muteLocalVideoStream：是否发布本地视频流
  • muteRemoteVideoStream：是否接收并播放远端视频流
  • muteAllRemoteVideoStreams：是否接收并播放所有远端视频流

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setVideoEncoderConfiguration

RtcModule.setVideoEncoderConfiguration({
    "width":640 ,
    "height":480 ,
    "bitrate":0 ,
    "frameRate":15 ,
    "orientationMode":0 
    }, (res) => {
        //something
})

设置视频编码属性。

该方法设置视频编码属性。每个属性对应一套视频参数，如分辨率、帧率、码率、视频方向等。 所有设置的参数均为理想情况下的最大值。当视频引擎因网络环境等原因无法达到设置的分辨率、帧率或码率的最大值时，会取最接近最大值的那个值。

如果用户加入频道后不需要重新设置视频编码属性，则我们建议在 enableVideo 前调用该方法，可以加快首帧出图的时间。

• 返回

  • res.code
    • 0：方法调用成功
    • 其他：方法调用失败

setAudioProfile()

RtcModule.setAudioProfile({
    "profile":0 ,
    "scenario":0 ,
    }, (res) => {
        //something
})

设置音频编码配置。

注解

• 该方法需要在 joinChannel 之前设置好，加入频道后设置不生效。
• 通信和直播场景下，音质（码率）会有网络自适应的调整，通过该方法设置的是一个最高码率。
• 在有高音质需求的场景（例如音乐教学场景）中，建议将 Profile 设置为 4，Scenario 设置为 3。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

enableInEarMonitoring()

RtcModule.enableInEarMonitoring({
    "enabled":false 
    }, (res) => {
        //something
})

开启耳返功能。

该方法打开或关闭耳返功能。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setInEarMonitoringVolume()

RtcModule.setInEarMonitoringVolume({
    "volume":0 
    }, (res) => {
        //something
})

设置耳返音量。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setChannelProfile()

RtcModule.setChannelProfile({
    "profile":0 
    }, (res) => {
        //something
})

设置频道场景。

该方法用于设置频道的使用场景。AR会针对不同的使用场景采用不同的优化策略，如通信场景偏好流畅，直播场景偏好画质。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setClientRole()

RtcModule.setClientRole({
    "role":2 
    }, (res) => {
        //something
})

设置直播场景下的用户角色。

在加入频道前，用户需要通过本方法设置观众（默认）或主播模式。在加入频道后，用户可以通过本方法切换用户模式。

直播场景下，如果你在加入频道后调用该方法切换用户角色，调用成功后，本地会触发 onClientRoleChanged 回调；远端会触发 onUserJoined/onUserOffline(USER_OFFLINE_BECOME_AUDIENCE) 回调。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

playEffect()

RtcModule.playEffect({
    "soundId":0,
    "filePath":"",
    "loopCount":0,
    "pitch":1.0,
    "pan":0.0,
    "gain":100.0,
    "publish":false
    }, (res) => {
        //something
})

播放指定音效文件。 该方法播放指定的本地或在线音效文件。你可以在该方法中设置音效文件的播放次数、音调、音效的空间位置和增益，以及远端用户是否能听到该音效。

你可以多次调用该方法，通过传入不同的音效文件的 soundId 和 filePath，同时播放多个音效文件，实现音效叠加。为获得最佳用户体验，我们建议同时播放的音效文件不要超过 3 个。

调用该方法播放音效结束后，SDK 会触发 onAudioEffectFinished 回调。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

stopAllEffects()

RtcModule.stopAllEffects((res) => {
    //something
})

停止播放所有音效文件。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

stopEffect()

RtcModule.stopEffect({
    "soundId":0 
    }, (res) => {
        //something
})

停止播放指定音效文件。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

adjustAudioMixingVolume()

RtcModule.adjustAudioMixingVolume({
    "volume":100 
    }, (res) => {
        //something
})

调节音乐文件的播放音量。

该方法调节混音里伴奏在本端和远端播放的音量大小。请在频道内调用该方法。

注解

调用该方法不影响调用 playEffect 播放音效文件的音量。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

startAudioMixing()

RtcModule.startAudioMixing({
    "filePath":"",
    "loopback":false,
    "replace":false,
    "cycle":0
    }, (res) => {
        //something
})

开始播放音乐文件及混音。

该方法指定本地或在线音频文件来和麦克风采集的音频流进行混音或替换。替换是指用音频文件替换麦克风采集的音频流。该方法可以选择是否让对方听到本地播放的音频，并指定循环播放的次数。

注解

• 如需调用该方法，请确保使用 Android 4.2 或以上设备，且 API Level ≥ 16
• 请在频道内调用该方法，如果在频道外调用该方法可能会出现问题
• 如果播放的是在线音乐文件，请确保重复调用该 API 的间隔超过 100 ms，否则 SDK 会返回 702 警告码，表示音乐文件打开过于频繁
• 如果播放的是在线音乐文件，我们建议不要使用重定向地址。重定向地址在某些机型上可能会出现无法打开的情况
• 如果本地音乐文件不存在、文件格式不支持、无法访问在线音乐文件 URL 都会返回警告码 701
• 如果在模拟器上使用该 API，暂时只支持存放在 /sdcard/ 中的 mp3 文件

返回

• res.code
  • 0：方法调用成功
  • 701 : 如果指定播放的音频文件不存在，或打开在线文件流后 5 秒内未收到网络流的数据包，则 SDK 会认为媒体文件不可访问，并返回该警告 。
  • 其他：方法调用失败

stopAudioMixing()

RtcModule.stopAudioMixing((res) => {
    //something
})

停止播放音乐文件及混音。

该方法停止播放伴奏。请在频道内调用该方法。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

leaveChannel()

RtcModule.leaveChannel((res) => {
    //something
})

离开频道。

离开频道，即挂断或退出通话。 当调用 joinChannel API 方法后，必须调用 leaveChannel 结束通话，否则无法开始下一次通话。 不管当前是否在通话中，都可以调用 leaveChannel，没有副作用。该方法会把会话相关的所有资源释放掉。该方法是异步操作，调用返回时并没有真正退出频道。在真正退出频道后，SDK 会触发 onLeaveChannel 回调。

成功调用该方法离开频道后，本地会触发 onLeaveChannel 回调；通信场景下的用户和直播场景下的主播离开频道后，远端会触发 onUserOffline 回调。

注解

如果你调用了 leaveChannel 后立即调用 destroyRtc 方法，SDK 将无法触发 onLeaveChannel 回调。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

destroyRtc()

RtcModule.destroyRtc((res) => {
    //something
})

销毁 Rtc 实例。

该方法释放 RTC SDK 使用的所有资源。有些 App 只在用户需要时才进行语音通话，不需要时则将资源释放出来用于其他操作，该方法对这类程序可能比较有用。只要调用了 destroy 方法，用户将无法再使用和回调该 SDK 内的其它方法。如需再次使用通信功能，必须重新调用 create 一个 Rtc 实例。

注解

• 该方法为同步调用，需要等待 Rtc 实例资源释放后才能执行其他操作，所以我们建议在子线程中调用该方法，避免主线程阻塞。此外，我们不建议在 SDK 的回调中调用 destroyRtc，否则由于 SDK 要等待回调返回才能回收相关的对象资源，会造成死锁。
• 如果需要在销毁后再次创建 Rtc 实例，需要等待 destroyRtc 方法执行结束，收到返回值后才能再创建实例。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

switchCamera()

RtcModule.switchCamera((res) => {
    //something
})

切换前置/后置摄像头。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setDefaultAudioRouteToSpeakerphone()

RtcModule.setDefaultAudioRouteToSpeakerphone({
    "defaultToSpeaker":false
    },(res) => {
        //something
})

设置默认的音频播放路由。

该方法设置接收到的语音从听筒或扬声器出声。如果用户不调用本方法，则语音默认从听筒出声。 如果你想要在加入频道后修改语音路由，可以使用 setEnableSpeakerphone.

各场景下默认的语音路由：

通信场景：

• 语音通话，默认从听筒出声。
• 视频通话，默认从扬声器出声。如果有用户在频道中使用 disableVideo 或 muteLocalVideoStream 和 muteAllRemoteVideoStreams 关闭视频，则语音路由会自动切换回听筒。

直播场景

• 扬声器

注解

• 该方法仅适用于通信场景。
• 该方法需要在加入频道前设置，否则不生效。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setEnableSpeakerphone()

RtcModule.setEnableSpeakerphone({
    "enabled":false
    },(res) => {
        //something
})

启用/关闭扬声器播放。

该方法设置是否将语音路由设到扬声器（外放）。调用该方法后，SDK 将触发 onAudioRouteChanged 回调提示状态已更改。

注解

• 请确保在调用此方法前已调用过 joinChannel 方法。
• setAudioProfile 中 scenario 的设置会影响 setEnableSpeakerphone 的行为。setEnableSpeakerphone 不生效的情况如下：
• 当 scenario 为 3 时，所有用户都无法切换音频播放路由。
• 当 scenario 为 0 或 4 时，直播场景中的观众无法切换音频播放路由，且当频道中只有一个主播时，该主播也无法切换音频播放路由。
• 当 scenario 为 2 时，直播场景中的观众无法切换音频播放路由。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

isSpeakerphoneEnabled()

RtcModule.isSpeakerphoneEnabled((res) => {
    //something
})

检查扬声器状态启用状态。

该方法检查扬声器是否已开启。

返回

• res.code
  • false： 扬声器未开启，语音会输出到非扬声器（听筒，耳机等）
  • true： 扬声器已开启，语音会输出到扬声器

enableAudioVolumeIndication()

RtcModule.enableAudioVolumeIndication({
    "interval":0,
    "smooth":0,
    "report_vad":false,
    },(res) => {
        //something
})

启用说话者音量提示。

该方法允许 SDK 定期向 App 反馈当前谁在说话以及说话者的音量。启用该方法后，无论频道内是否有人说话，都会在说话声音音量提示回调 onAudioVolumeIndication 回调中按设置的间隔时间返回音量提示。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

adjustRecordingSignalVolume()

RtcModule.adjustRecordingSignalVolume({
    "volume":0
    },(res) => {
        //something
})

调节录音音量。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

adjustUserPlaybackSignalVolume()

RtcModule.adjustUserPlaybackSignalVolume({
    "uid":"",
    "volume":0
    },(res) => {
        //something
})

调节本地播放的指定远端用户音量。

你可以在通话中调用该方法调节指定远端用户在本地播放的音量。如需调节多个用户在本地播放的音量，则需多次调用该方法。

注解

• 该方法要在加入频道后调用。
• 该方法调节的是本地播放的指定远端用户混音后的音量。
• 该方法每次只能调整一位远端用户在本地播放的音量。若需调整多位远端用户在本地播放的音量，则需多次调用该方法。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

adjustPlaybackSignalVolume()

RtcModule.adjustPlaybackSignalVolume({
    "volume":0
    },(res) => {
        //something
})

调节本地播放的所有远端用户音量。

注解

• 该方法调节的是本地播放的所有远端用户混音后的音量。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

enableLocalAudio()

RtcModule.enableLocalAudio({
    "enabled":true
    },(res) => {
        //something
})

开/关本地音频采集。

当 App 加入频道时，它的语音功能默认是开启的。该方法可以关闭或重新开启本地语音功能，即停止或重新开始本地音频采集。

该方法不影响接收或播放远端音频流，enableLocalAudio(false) 适用于只听不发的用户场景。

注解

• 调用 enableLocalAudio() 关闭本地采集后，系统会走媒体音量；调用 enableLocalAudio() 重新打开本地采集后，系统会恢复为通话音量。
• 该方法与 muteLocalAudioStream 的区别在于：enableLocalAudio：开启或关闭本地语音采集及处理。使用 enableLocalAudio 关闭或开启本地采集后，本地听远端播放会有短暂中断。
• muteLocalAudioStream：停止或继续发送本地音频流。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

enableLocalVideo()

RtcModule.enableLocalVideo({
    "enabled":true
    },(res) => {
        //something
})

开/关本地视频采集。

该方法禁用或重新启用本地视频采集。不影响接收远端视频。

调用 enableVideo 后，本地视频即默认开启。 你可以调用 enableLocalVideo() 关闭本地视频采集。关闭后如果想重新开启，则可调用 enableLocalVideo()。

成功禁用或启用本地视频采集后，远端会触发 onRemoteVideoStateChanged 回调。

注解

该方法设置的是内部引擎为启用或禁用状态，在 leaveChannel 后仍然有效。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteLocalAudioStream()

RtcModule.muteLocalAudioStream({
    "muted":false
    },(res) => {
        //something
})

停止/恢复发送本地音频流。

静音/取消静音。该方法用于允许/禁止往网络发送本地音频流。

成功调用该方法后，远端会触发 onRemoteAudioStateChanged 回调。

注解

• 该方法不影响录音状态，并没有禁用麦克风。
• 如果你在该方法后调用 setChannelProfile 方法，SDK 会根据你设置的频道模式以及用户角色，重新设置是否停止发送本地音频。因此我们建议在 setChannelProfile 后调用该方法。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteLocalVideoStream()

RtcModule.muteLocalVideoStream({
    "muted":false
    },(res) => {
        //something
})

停止/恢复发送本地视频流。

成功调用该方法后，远端会触发 onRemoteVideoStateChanged 回调。

注解

• 调用该方法时，SDK 不再发送本地视频流，但摄像头仍然处于工作状态。相比于 enableLocalVideo () 用于控制本地视频流发送的方法，该方法响应速度更快。
• 该方法不影响本地视频流获取，没有禁用摄像头。如果你在该方法后调用 setChannelProfile 方法，SDK 会根据你设置的频道模式以及用户角色，重新设置是否停止发送本地视频。因此我们建议在 setChannelProfile 后调用该方法。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteRemoteAudioStream()

RtcModule.muteRemoteAudioStream({
    "uid":"",
    "muted":false
    },(res) => {
        //something
})

停止/恢复接收指定音频流。

注解

• 如果之前有调用过 muteAllRemoteAudioStreams () 停止接收所有远端音频流，在调用本 API 之前请确保你已调用 muteAllRemoteAudioStreams ()。muteAllRemoteAudioStreams 是全局控制，muteRemoteAudioStream 是精细控制。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteRemoteVideoStream()

RtcModule.muteRemoteVideoStream({
    "uid":"",
    "muted":false
    },(res) => {
        //something
})

停止/恢复接收指定视频流。

注解

如果之前有调用过 muteAllRemoteVideoStreams (true) 停止接收所有远端视频流，在调用本 API 之前请确保你已调用 muteAllRemoteVideoStreams (false)。 muteAllRemoteVideoStreams 是全局控制，muteRemoteVideoStream 是精细控制。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteAllRemoteAudioStreams()

RtcModule.muteAllRemoteAudioStreams({
    "muted":false
    },(res) => {
        //something
})

停止/恢复接收所有音频流。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

muteAllRemoteVideoStreams()

RtcModule.muteAllRemoteVideoStreams({
    "muted":false
    },(res) => {
        //something
})

停止/恢复接收所有视频流。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setDefaultMuteAllRemoteAudioStreams()

RtcModule.setDefaultMuteAllRemoteAudioStreams({
    "muted":false
    },(res) => {
        //something
})

设置是否默认接收音频流。

该方法在加入频道前后都可调用。如果在加入频道后调用 setDefaultMuteAllRemoteAudioStreams()， 会接收不到后面加入频道的用户的音频流。

注解

停止接收音频流后，如果想要恢复接收，请调用 muteRemoteAudioStream()，并指定你想要接收的远端用户的 ID。 如果想恢复接收多个用户的音频流，则需要多次调用 muteRemoteAudioStream。 setDefaultMuteAllRemoteAudioStreams() 只能恢复接收设置后加入频道的用户的音频流。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setDefaultMuteAllRemoteVideoStreams()

RtcModule.setDefaultMuteAllRemoteVideoStreams({
    "muted":false
    },(res) => {
        //something
})

设置是否默认接收视频流。

该方法在加入频道前后都可调用。如果在加入频道后调用 setDefaultMuteAllRemoteVideoStreams()， 会接收不到后面加入频道的用户的音频流。

注解

停止接收视频流后，如果想要恢复接收，请调用 muteRemoteVideoStream()，并指定你想要接收的远端用户的 ID。 如果想恢复接收多个用户的视频流，则需要多次调用 muteRemoteVideoStream。 setDefaultMuteAllRemoteVideoStreams() 只能恢复接收设置后加入频道的用户的视频流。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setCameraTorchOn()

RtcModule.setCameraTorchOn({
    "isOn":false
    },(res) => {
        //something
})

设置是否打开闪光灯。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

isCameraTorchSupported()

RtcModule.setCameraTorchOn((res) => {
    //something
})

检测设备是否支持闪光灯常开。

注解

一般情况下，App 默认开启前置摄像头，因此如果你的前置摄像头不支持闪光灯常开，直接使用该方法会返回 false。如果需要检查后置摄像头是否支持闪光灯常开，需要先使用 switchCamera 切换摄像头，再使用该方法。

返回

• res.code

  • true： 设备支持闪光灯常开
  • false： 设备不支持闪光灯常开

  addPublishStreamUrl()

  RtcModule.addPublishStreamUrl({
      "url":"",
      "transcodingEnabled":false
      },(res) => {
          //something
  })
  

增加旁路推流地址。

注解

该方法用于添加旁路推流地址，调用该方法后，SDK 会在本地触发 onRtmpStreamingStateChanged 回调，报告增加旁路推流地址的状态。

• 该方法仅适用于直播场景。

• 请确保在成功加入频道后再调用该接口。

• 请确保已开通旁路推流的功能

• 该方法每次只能增加一路旁路推流地址。若需推送多路流，则需多次调用该方法

  返回

• res.code

  • 0：方法调用成功

  • 其他：方法调用失败

    removePublishStreamUrl()

    RtcModule.removePublishStreamUrl({
        "url":"",
        },(res) => {
            //something
    })
    

    删除旁路推流地址。

    注解

该方法用于删除旁路推流过程中已经设置的 RTMP 推流地址。调用该方法后，SDK 会在本地触发 onRtmpStreamingStateChanged 回调，报告删除旁路推流地址的状态。

• 该方法仅适用于直播场景。

• 该方法每次只能删除一路旁路推流地址。若需删除多路流，则需多次调用该方法。

• URL 不支持中文等特殊字符。

  返回

• res.code

  • 0：方法调用成功

  • 其他：方法调用失败

    setLiveTranscoding()

    RtcModule.setLiveTranscoding({
        "transcoding": {
              "width": 640.0, //推流视频的总尺寸（宽），单位为像素
              "height": 480.0, //推流视频的总尺寸（高），单位为像素
              "videoBitrate": 400, //用于旁路直播的输出视频的码率。单位为 Kbps。400 Kbps 为默认值
              "videoFramerate": 15, //用于旁路直播的输出视频的帧率。取值范围是 (0,30]，单位为 fps。
              "videoGop": 30, //用于旁路直播的输出视频的 GOP。单位为帧。默认值为 30 帧
              "audioSampleRate": 0, //用于旁路直播的输出音频的采样率
              "audioBitrate": 48, //用于旁路直播的输出音频的码率。单位为 Kbps，默认值为 48，最大值为 128
              "audioChannels": 1, // 用于旁路直播的输出音频的声道数，默认值为 1
              "audioCodecProfile": 0, // 用于旁路直播输出音频的编码规格
              "videoCodecProfile": 100, //用于旁路直播的输出视频的编码规格
              "userConfigExtraInfo": "", //预留参数：用户自定义的发送到旁路推流客户端的信息，用于填充 H264/H265 视频中 SEI 帧内容
              "watermark": { //用于旁路直播的输出视频上的水印图片
                  "url": "", //直播视频上图片的 HTTP/HTTPS 地址，字符长度不得超过 1024 字节。
                  "x": 0.0,
                  "y": 0.0,
                  "width": 0.0,
                  "height": 0.0
              },
              "backgroundImage": { //用于旁路直播的输出视频上的背景图片
                  "url": "", //直播视频上图片的 HTTP/HTTPS 地址，字符长度不得超过 1024 字节。
                  "x": 0.0,
                  "y": 0.0,
                  "width": 0.0,
                  "height": 0.0
              },
              "backgroundColor": { //用于旁路直播的输出视频的背景色
                  "red": 0.0;
                  "green": 0.0,
                  "blue": 0.0
              },
              "transcodingUsers": {
                  [
                      {
                          "uid": "", //旁路推流的用户 ID
                          "x": 0.0,
                          "y": 0.0,
                          "width": 50.0,
                          "height": 50.0,
                          "zOrder": 0.0, //直播视频上用户视频帧的图层编号
                          "alpha": 1.0, //直播视频上用户视频的透明度
                          "audioChannel": 0.0 //直播音频所在声道, 取值范围为 [0,5]，默认值为 0
                      }
                  ]
              }
        }
        },(res) => {
            //something
    })
    

    设置直播转码。

    注解

    该方法用于旁路推流的视图布局及音频设置等。调用该方法更新转码设置后本地会触发 rtcEngineTranscodingUpdated 回调。

    • 该方法仅适用于直播场景。

    • 请确保已开通 CDN 旁路推流的功能

    • 首次调用该方法更新转码设置时，不会触发 onTranscodingUpdated 回调。

      返回

    • res.code

      • 0：方法调用成功
      • 其他：方法调用失败

Component

startPreview()

this.$refs.video.startPreview((res) => {
    //something
})

开启视频预览。

该方法用于在进入频道前启动本地视频预览。调用该 API 前，必须：

调用 enableVideo 开启视频功能

调用 setupLocalVideo 设置预览窗口及属性

注解

• 本地预览默认开启镜像功能
• 使用该方法启用了本地视频预览后，如果直接调用 leaveChannel 退出频道，并不会关闭预览。如需关闭预览，请调用 stopPreview

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

stopPreview()

this.$refs.video.stopPreview((res) => {
    //something
})

停止视频预览。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setupLocalVideo()

this.$refs.video.setupLocalVideo({
    "uid":"",
    "channelId":"",
    "renderMode":1,
    "mirrorMode":0
},(res) => {
    //something
})

初始化本地视图。

该方法初始化本地视图并设置本地用户视频显示信息，只影响本地用户看到的视频画面，不影响本地发布视频。 调用该方法绑定本地视频流的显示视窗（View），并设置本地用户视图的渲染模式和镜像模式。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败

setupRemoteVideo()

this.$refs.video.setupRemoteVideo({
    "uid":"",
    "channelId":"",
    "renderMode":0,
    "mirrorMode":0
},(res) => {
    //something
})

初始化远端用户视图。

该方法绑定远端用户和显示视图，并设置远端用户视图在本地显示时的渲染模式和镜像模式，只影响本地用户看到的视频画面。

如果 App 不能事先知道对方的用户 ID，可以在 APP 收到 onUserJoined 事件时设置。如果启用了视频录制功能，视频录制服务会做为一个哑客户端加入频道，因此其他客户端也会收到它的 onUserJoined 事件，App 不应给它绑定视图（因为它不会发送视频流），如果 App 不能识别哑客户端，可以在 onFirstRemoteVideoDecoded 事件时再绑定视图。解除某个用户的绑定视图可以把 view 设置为空。退出频道后，SDK 会把远程用户的绑定关系清除掉。

返回

• res.code
  • 0：方法调用成功
  • 其他：方法调用失败