API Reference for windows - IRTCChannel
更新时间: 2023-10-23 16:45:52
Public 成员函数 | |
virtual | ~IRTCChannel () |
virtual const char * | channelId ()=0 |
virtual void | release ()=0 |
virtual int | joinChannel ()=0 |
virtual int | leaveChannel ()=0 |
virtual bool | setClientRole (CLIENT_ROLE_TYPE roleType)=0 |
virtual bool | muteRemoteVideoStream (UserId userId, bool mute)=0 |
virtual bool | muteRemoteAudioStream (UserId userId, bool mute)=0 |
virtual void | registerChannelEventHandler (IRTCChannelEventHandler *eventHandler)=0 |
virtual bool | muteAllRemoteVideoStreams (bool mute)=0 |
virtual bool | muteAllRemoteAudioStreams (bool mute)=0 |
virtual int | muteLocalVideoStream (bool mute)=0 |
virtual int | muteLocalAudioStream (bool mute)=0 |
virtual bool | getCurSeiTimestamp (uint64_t &seiTime)=0 |
virtual int | setRemoteVideoStreamType (UserId uid, rtc::REMOTE_VIDEO_STREAM_TYPE streamType)=0 |
virtual int | applyRemoteStreamSubscribeAdvice (UserId userId, rtc::SUBSCRIPTION_STREAM_TYPE streamType)=0 |
virtual int | startChannelMediaRelay (char *srcToken, char **dstToken, int nDstCount)=0 |
virtual int | updateChannelMediaRelay (char *srcToken, char **dstToken, int nDstCount)=0 |
virtual int | stopChannelMediaRelay ()=0 |
virtual int | addPublishStreamUrl (const char *url, bool transcodingEnabled)=0 |
virtual int | removePublishStreamUrl (const char *url)=0 |
virtual int | setLiveTranscoding (const Stru_RtmpLiveTranscoding &transcoding)=0 |
virtual bool | sendSeiTimestamp (uint64_t seiTime)=0 |
virtual int | sendStreamMessage (const char *data, size_t length, uint64_t timestamp)=0 |
virtual void | setSubscribeOption (bool autoSubscribeAudio, bool autoSubscribeVideo)=0 |
构造及析构函数说明
◆ ~IRTCChannel()
| virtual |
成员函数说明
◆ channelId()
| pure virtual |
获取当前房间的channelId
- 返回
- const char* 返回当前房间的channelId
◆ release()
| pure virtual |
释放该channel对象的内存 如果关注 onLeaveChannel 的回调,需要调用 leaveChannel 的回调,后等待onLeaveChannel 的回调,收到后再release channel资源
◆ joinChannel()
| pure virtual |
通过token 获取 IRTCChannel 对象后,可以加入房间
- 返回
- int 0: 方法调用成功;<0: 方法调用失败。
◆ leaveChannel()
| pure virtual |
离开房间,离开房间后自动不再接收音视频数据
- 返回
- int 0: 方法调用成功;<0: 方法调用失败。
◆ setClientRole()
| pure virtual |
设置channel 中本用户的角色,默认使用观众模式进入房间;该接口可以在加入房间前或者加入房间后设置;在加入房间后重新设置角色会收到 onClientRoleChanged 回调
- 参数
roleType 角色类型 详见: CLIENT_ROLE_TYPE
- 返回
- true
- false
◆ muteRemoteVideoStream()
| pure virtual |
设置是否接收该房间内某个用户的视频数据
- 参数
userId 需要设置的用户id mute true: 不再接收该uid的视频数据, false:接收该Uid的视频数据
- 返回
- true:成功
- false:失败
◆ muteRemoteAudioStream()
| pure virtual |
设置是否接收该房间内某个用户的音频数据
- 参数
userId 需要设置的用户id mute true: 不再接收该uid的音频数据, false:接收该Uid的音频数据
- 返回
- true:成功
- false:失败
◆ registerChannelEventHandler()
| pure virtual |
注册channel对象的回调函数,用于接收该房间内的一些状态
- 参数
eventHandler 要注册的对象
◆ muteAllRemoteVideoStreams()
| pure virtual |
关闭channel房间内所有的视频流
- 参数
mute true:不接收 false:接收
- 返回
- true:成功
- false:失败
◆ muteAllRemoteAudioStreams()
| pure virtual |
静音channel房间内所有的音频流
- 参数
mute true:不接收; false:接收
- 返回
- true:成功
- false:失败
◆ muteLocalVideoStream()
| pure virtual |
取消或恢复发布本地视频流。
- 参数
mute true:取消发布;false:发布
- 返回
- int 0: 方法调用成功;<0: 方法调用失败。
◆ muteLocalAudioStream()
| pure virtual |
取消或恢复发布本地音频流。
- 参数
mute true:取消发布;false:发布
- 返回
- int 0: 方法调用成功;<0: 方法调用失败。
◆ getCurSeiTimestamp()
| pure virtual |
◆ setRemoteVideoStreamType()
| pure virtual |
◆ applyRemoteStreamSubscribeAdvice()
| pure virtual |
◆ startChannelMediaRelay()
| pure virtual |
开始跨房间推流,需要在加入房间后才可以调用
- 参数
srcToken 推流token dstToken 目的房间token nDstCount 的房间token数量,最大是4
- 返回
- int 0: 成功. < 0: 失败.
◆ updateChannelMediaRelay()
| pure virtual |
更新跨房间推流,在 startChannelMediaRelay 后才可以调用
- 参数
srcToken 推流token dstToken 目的房间token nDstCount 目的房间token数量,最大是4
- 返回
- int 0: 成功. < 0: 失败.
◆ stopChannelMediaRelay()
| pure virtual |
停止跨房间推流
- 返回
- int 0: 成功. < 0: 失败.
◆ addPublishStreamUrl()
| pure virtual |
增加rtmp旁路推流功能,当transcodingEnabled=true时,要先调用setLiveTranscoding接口来设置转码参数,
- 参数
url 转推rtmp的地址; transcodingEnabled true:开启转码推流;false:关闭转码推流。
- 返回
- true 成功
- false 失败
◆ removePublishStreamUrl()
| pure virtual |
◆ setLiveTranscoding()
| pure virtual |
设置编码参数
- 参数
config
- 返回
- true 成功
- false 失败
◆ sendSeiTimestamp()
| pure virtual |
发送sei时间戳,单位毫秒,对端通过 onSeiTimestampArrived 回调收到sei时间戳,该接口需要在加入房间后调用,
注意如果不需要发送sei,千万不要调用该接口,否则会变成主播身份
- 参数
seiTime seiTime
- 返回
- true 成功
- false 失败
◆ sendStreamMessage()
| pure virtual |
发送irc信息
- 参数
data irc数据 length data长度, 最大1000 timestamp 时间戳
- 返回
- int 0: 成功. < 0: 失败.
◆ setSubscribeOption()
| pure virtual |
设置是否自动订阅频道内所有远端音频、视频流
- 参数
autoSubscribeAudio true:订阅;fasle:不订阅 autoSubscribeVideo true:订阅;fasle:不订阅
该类的文档由以下文件生成: