API
API调用流程
初始化相关接口
initializeBaiduRtcSdk
void initializeBaiduRtcSdk(char* appId, char* token, char* cerPath)介绍
初始化SDK。
初始化 Windows RTC SDK, 需在使用之前调用进行初始化。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| appId | char* | RTC 基础业务单元的唯一标识 |
| token | char* | RTC Server 端鉴权使用的字符串 |
| cerPath | char* | SSL 证书存放路径，证书由百度提供，在SDK文件中 |
返回
无
deInitializeBaiduRtcSdk
void deInitializeBaiduRtcSdk()介绍
释放SDK。
SDK 使用完，可调用该 API 进行释放，销毁操作。
参数
无
返回
无
createBaiduRtcRoomClient
std::unique_ptr<BaiduRtcRoomClient> createBaiduRtcRoomClient()介绍
创建 BaiduRtcRoomClient。
用户使用该 SDK 开发的入口，首先需要创建 BaiduRtcRoomClient, 通过该 API 初始化 SDK，发布流，订阅流等其他可提供的 API 操作。
参数
无
返回
BaiduRtcRoomClient 指针
createBaiduRtcRoomClient
std::unique_ptr<BaiduRtcRoomClient> createBaiduRtcRoomClient(RtcConfig config)介绍
创建 BaiduRtcRoomClient。
用户使用该 SDK 开发的入口，首先需要创建 BaiduRtcRoomClient, 通过该 API 初始化 SDK，发布流，订阅流等其他可提供的 API 操作。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| config | RtcConfig | 配置参数，用于初始化SDK相关配置 |
返回
BaiduRtcRoomClient 指针
createBaiduRtcRoomClientRef
BaiduRtcRoomClient* createBaiduRtcRoomClientRef()介绍
创建 BaiduRtcRoomClient。
用户使用该 SDK 开发的入口，首先需要创建 BaiduRtcRoomClient, 通过该 API 初始化 SDK，发布流，订阅流等其他可提供的 API 操作。
参数
无
返回
BaiduRtcRoomClient* ，销毁SDK时需调用freeBaiduRtcRoomClient
createBaiduRtcRoomClientRef
BaiduRtcRoomClient* createBaiduRtcRoomClientRef(RtcConfig config)介绍
创建 BaiduRtcRoomClient。
用户使用该 SDK 开发的入口，首先需要创建 BaiduRtcRoomClient, 通过该 API 初始化 SDK，发布流，订阅流等其他可提供的 API 操作。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| config | RtcConfig | 配置参数，用于初始化SDK相关配置 |
返回
BaiduRtcRoomClient* ，销毁SDK时需调用freeBaiduRtcRoomClient
freeBaiduRtcRoomClient
BaiduRtcRoomClient* createBaiduRtcRoomClientRef(RtcConfig config)介绍
释放 BaiduRtcRoomClient。与createBaiduRtcRoomClientRef接口对应，在销毁SDK时进行释放。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| config | RtcConfig | 配置参数，用于初始化SDK相关配置 |
返回
空
RtcConfig说明
介绍
设置SDK初始化配置
内容
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| isOnlyPullStream | bool | false | 仅拉视频流模式，专用于视频监控、无人车等场景 |
| h264GopSize | int | 3 | 设置 H264 Gop 大小，用于控制关键帧间隔 |
| isFrameDynamicBind | bool | false | 设置是视图绑定模式，为true时允许视图动态添加 |
| isEnableMultistream | bool | true | 设置是否使能多流模式，单流模式用于与旧版服务器兼容 |
房间相关接口
BaiduRtcRoomClient::loginRoom
bool BaiduRtcRoomClient::loginRoom(char* roomId, char* userId)介绍
房间登录。
登录房间成功后，用户可以发布流，或订阅流，并能通过IRtcMessageListener接口获取房间状态信息。
默认登录房间后不自动推流，需要调用publishStreaming进行推流。
当设置 setAutoPublish(true) 时会自动推流，可以通过setAutoSubscribe控制是否自动订阅流。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| roomId | char* | 房间名，长度不超过255字节 |
| userId | char* | 用户id, 每个房间的用户id必须唯一 |
返回
true 成功， false 失败
BaiduRtcRoomClient::logoutRoom
bool BaiduRtcRoomClient::loginRoom(char* roomId, char* userId)介绍
房间登出。
关闭媒体通道，关闭信令通道，释放内存资源，及销毁其他申请的资源。
参数
无
返回
true 成功， false 失败
BaiduRtcRoomClient::setForceLogin
void BaiduRtcRoomClient::setForceLogin(bool force)介绍
设置是否强制登录，为true时userId相同情况情况下踢出对端用户，为false时userId相同情况登录失败，通过 IRtcErrorListener 回调 RTC_ROOM_USERID_ALREADY_EXIST_ERROR 事件，需业务侧进行提示处理
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| force | bool | 是否使能强制登录 |
返回
空
发布/订阅流相关接口
BaiduRtcRoomClient::publishStreaming
void BaiduRtcRoomClient::publishStreaming(bool isSubsrcibe)介绍
发布流。
流发布在roomId指定的房间，在同一房间加入的用户可以相互订阅流。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isSubscribe | bool | 标识在发布流的同时，是否订阅流，默认是订阅流的 |
返回
无
BaiduRtcRoomClient::publishStreaming
void BaiduRtcRoomClient::publishStreaming(char* streamingIds[],int streamingNum)介绍
发布流。
流发布在 roomId 指定的房间，在同一房间加入 的用户可以相互订阅流，该 API 可以指定要订阅的流。
用于提前获取房间内其他用户userId情况下，指定订阅流用户；
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| streamingIds | char* | 用户要订阅的流 id 列表 |
| streamingNum | int | 欲订阅的流数目，即streamingIds的大小 |
返回
无
BaiduRtcRoomClient::subscribeStreaming
void BaiduRtcRoomClient::subscribeStreaming(char* streamingIds[], int streamingNum)介绍
订阅流。
用于订阅同一房间的其他用户的流。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| streamingIds | char* | 用户要订阅的其他用户的流id列表(即其他用户id列表) |
| streamingNum | int | 欲订阅的流数目，即streamingIds的大小 |
返回
无
BaiduRtcRoomClient::stopPublishStreaming
void BaiduRtcRoomClient::stopPublishStreaming()介绍
停止发布流。
publishing 的流都可通过该接口停止发布或订阅。
参数
无
返回
无
BaiduRtcRoomClient::stopSubscribeStreaming
void BaiduRtcRoomClient::stopSubscribeStreaming(char* streamingIds[], int streamingNum)介绍
停止订阅流。
订阅的流都可通过该接口停止发布或订阅。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| streamingIds | char* | 用户要停止订阅的流id列表(即其他用户id列表) |
| streamingNum | int | 欲停止订阅的流数目，即streamingIds的大小 |
返回
无
BaiduRtcRoomClient::setOnlyPublishVideo
void BaiduRtcRoomClient::setOnlyPublishVideo()介绍
设置仅推视频流，需要在 loginRoom 前调用
参数
无
返回
无
BaiduRtcRoomClient::setOnlyPublishAudio
void BaiduRtcRoomClient::setOnlyPublishAudio()介绍
设置仅推音频流，需要在 loginRoom 前调用
参数
无
返回
无
BaiduRtcRoomClient::setRoomMode
void BaiduRtcRoomClient::setRoomMode(RtcRoomMode mode)介绍
设置房间模式
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| mode | RtcRoomMode | 房间模式 |
参数类型RtcRoomMode说明：
- RTC_NORMAL_ROOM：普通房间模式，默认为该模式
- RTC_LARGE_ROOM_MODE：大房间模式，SDK不进行房间管理
返回
无
BaiduRtcRoomClient::setRoomMode
void BaiduRtcRoomClient::setRoomMode(RtcRoomMode mode)介绍
设置房间模式
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| mode | RtcRoomMode | 房间模式 |
参数类型RtcRoomMode说明：
- RTC_NORMAL_ROOM：普通房间模式，默认为该模式
- RTC_LARGE_ROOM_MODE：大房间模式，SDK不进行房间管理
返回
无
BaiduRtcRoomClient::setAutoPublish
void BaiduRtcRoomClient::setAutoPublish(bool enable)介绍
设置是否自动推流
该接口主要用于设置设置是否自动推流，默认为false，为true时login后不需要调用 publishStreaming
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| enable | bool | 是否自动推流 |
返回
无
BaiduRtcRoomClient::setAutoSubscribe
void BaiduRtcRoomClient::setAutoSubscribe(bool enable)介绍
设置是否自动订阅流
该接口主要用于设置设置是否自动订阅流，默认为true，为false时需手动调用subscribeStreaming 订阅用户流
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| enable | bool | 是否自动订阅流 |
返回
无
音视频参数设置
BaiduRtcRoomClient::setBitRate
void BaiduRtcRoomClient::setBitRate(int bitRate)介绍
设置视频编码码率。
该接口用于设置视频编码码率，SDK 会根据网络状况做自适应码率调整，但不会超过通过该接口设置的码率即以该值为最大码率。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| bitRate | int | 需要设置视频码率值，如设置300kbps, 则bitRate = 300*1024 |
返回
无
BaiduRtcRoomClient::setResolution
void BaiduRtcRoomClient::setResolution(int width, int height)介绍
设置视频编码码率。
用于设置视频采集分辨率，若使用外部视频采集，就无需设置。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| width | int | 视频采集宽 |
| height | int | 视频采集高 |
返回
无
BaiduRtcRoomClient::setFps
void BaiduRtcRoomClient::setFps(int fps)介绍
设置视频采集帧率。
用于设置视频采集分辨率，若使用外部视频采集，就无需设置。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| fps | int | 视频采集的帧率，如15fps, 24fps, 29fps等 |
返回
无
BaiduRtcRoomClient::setVideoFromat
void BaiduRtcRoomClient::setVideoFromat(VideoColorFormat vcf)介绍
设置视频颜色空间格式。
用于设置视频颜色空间格式。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| vcf | VideoColorFormat | 支持的视频颜色空间格式ARGB/I420 |
返回
无
摄像头相关接口
BaiduRtcRoomClient::openCamera
void BaiduRtcRoomClient::openCamera(char* deviceName)介绍
打开摄像头。
打开摄像头后，可开始画面预览。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceName | char* | 设备名称，若为空，开启默认的设备，否则开启指定的设备 |
返回
无
BaiduRtcRoomClient::closeCamera
void BaiduRtcRoomClient::closeCamera()介绍
关闭摄像头。
关闭并释放摄像头资源。
参数
无
返回
无
BaiduRtcRoomClient::muteCamera
void BaiduRtcRoomClient::muteCamera(bool isMuted)介绍
开关摄像头。
静默摄像头，停止画面预览及传输。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isMuted | bool | 是否静默摄像头 |
返回
无
音频相关接口
BaiduRtcRoomClient::muteMicphone
void BaiduRtcRoomClient::muteMicphone(bool isMuted)介绍
开关麦克风。
静默麦克风，停止声音传输。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isMuted | bool | 是否静默麦克风 |
返回
无
BaiduRtcRoomClient::muteSpeaker
void BaiduRtcRoomClient::muteSpeaker(bool isMuted)介绍
开关扬声器。
静默扬声器，停止声音播放。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isMuted | bool | 是否静默扬声器 |
返回
无
BaiduRtcRoomClient::setVolume
void BaiduRtcRoomClient::setVolume(uint32_t volume)介绍
音量控制。
用于控制扬声器音量的大小。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| volume | uint32_t | 音量值，范围 0~100 |
返回
无
BaiduRtcRoomClient::setUserPlaybackVolume
void BaiduRtcRoomClient::setUserPlaybackVolume(long long userId, int volume)介绍
设置远端用户音量，在订阅远端用户流完成后
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| userId | long long | 远端用户userId |
| volume | int | 远端用户音量，范围 0~100 |
返回
无
视频相关接口
BaiduRtcRoomClient::startPreview
void BaiduRtcRoomClient::startPreview()介绍
开始预览。
打开摄像头后，可开始画面预览。
参数
无
返回
无
BaiduRtcRoomClient::stopPreview
void BaiduRtcRoomClient::stopPreview()介绍
停止预览。
在开始预览后，可通过该接口停止预览。
参数
无
返回
无
BaiduRtcRoomClient::setVideoMirror
void BaiduRtcRoomClient::setVideoFromat(bool isOpenMirror)介绍
设置镜像。
用于设置是否打开镜像功能。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isOpenMirror | bool | 设置是否打开镜像功能 |
返回
无
BaiduRtcRoomClient::registerVideoFrameObserver
void BaiduRtcRoomClient::registerVideoFrameObserver(IVideoFrameObserver* iVfo[], int iVfoNum)介绍
注册视频数据帧到达Observer。
当使用外部渲染时，需要注册视频数据监测接口，有视频数据到来时，可通知用户去做渲染或其他处理。接口详细信息可查看头文件：BaiduExternalVideoRendererInterface.h
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| iVfo | IVideoFrameObserver* | 数据帧到达Observer接口数组，多个接口可多路流，一个接口listening一路流 |
| iVfoNum | int | Observer 接口数 |
返回
无
屏幕共享相关接口
BaiduRtcRoomClient::startShareScreen
void BaiduRtcRoomClient::startShareScreen()介绍
屏幕共享。
可通过该接口开启屏幕分享功能, 让其他用户看到你的屏幕操作。
参数
无
返回
无
BaiduRtcRoomClient::stopShareScreen
void BaiduRtcRoomClient::stopShareScreen()介绍
停止屏幕共享。
关闭屏幕分享功能。
参数
无
返回
无
BaiduRtcRoomClient::startShareScreenWithSource
void BaiduRtcRoomClient::startShareScreenWithSource(long long sourceId)介绍
可通过该接口开启屏幕分享功能, 让其他用户看到你的屏幕操作，通过sourceId指定分享的屏幕。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| sourceId | long long | 屏幕ID，可通过getWindowSourceList获取，或者外部传入 |
返回
无
BaiduRtcRoomClient::getWindowSourceList
void BaiduRtcRoomClient::getWindowSourceList(CaptureType type, int& count)介绍
可通过该接口获取可共享屏幕/窗口列表
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| type | CaptureType | 类型，桌面或者窗口 |
| count | int& | 列表长度 |
返回
无
BaiduRtcRoomClient::freeWindowSourceList
void BaiduRtcRoomClient::freeWindowSourceList(WindowSource* sourceList, int length)介绍
释放共享屏幕/窗口列表
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| sourceList | WindowSource* | 列表指针 |
| length | int | 列表长度 |
返回
无
BaiduRtcRoomClient::startShareWindow
void BaiduRtcRoomClient::startShareWindow(long long sourceId)介绍
可通过该接口开启窗口分享功能, 让其他用户看到你的窗口操作，通过sourceId指定分享的窗口。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| sourceId | long long | 窗口Wid,通过getWindowSourceList获取,或者外部获取传入 |
返回
无
BaiduRtcRoomClient::setShareScreenMode
void BaiduRtcRoomClient::setShareScreenMode(ShareScreenMode type)介绍
设置屏幕共享模式
可通过该接口设置屏幕共享模式, 可以同时回调屏幕数据与摄像头采集数据
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| type | ShareScreenMode | 屏幕共享模式 |
参数类型ShareScreenMode说明：
- kOnlyScreen：仅回调屏幕数据
- kWithPreviewVideo：回调屏幕数据与摄像头数据
返回
无
BaiduRtcRoomClient::stopShareWindow
void BaiduRtcRoomClient::stopShareWindow()介绍
关闭窗口分享功能
参数
无
返回
无
消息接口
BaiduRtcRoomClient::sendMessage
void BaiduRtcRoomClient::sendMessage(const char* message)介绍
发送消息。
可通过该接口发送文本消息到聊天室，房间的其他人能接收到所发消息。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| message | const char* | 准备发的消息 |
返回
无
BaiduRtcRoomClient::sendMessageToUser
void BaiduRtcRoomClient::sendMessageToUser(const char* message, long userId)介绍
发送消息。
通过该接口发送消息给其他人，userId=0 时房间内广播消息，其他指定用户发送消息
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| message | const char* | 准备发的消息 |
| userId | long | 用户UserId，为0时广播消息 |
返回
无
BaiduRtcRoomClient::registerRtcMessageListener
void BaiduRtcRoomClient::registerRtcMessageListener(IRtcMessageListener* msgListener)介绍
注册消息监听接口。
用户可以实现参数定义的接口，并通过该接口注册，当SDK启动后，可以收到来自SDK的消息，并做相应的处理。接口详细信息可查看头文件：BaiduRtcCommonDefine.h
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| msgListener | IRtcMessageListener* | rtc sdk 消息上报接口 |
返回
无
状态获取接口
BaiduRtcRoomClient::getRoomStates
void BaiduRtcRoomClient::getRoomStates(RtcRoomUserInfo** userInfoList, int& userNumber)介绍
查询房间信息。
可通过该接口查询房间用户信息。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| userInfoList | RtcRoomUserInfo** | 准备发的消息 |
| userNumber | int& | 用户id |
返回
无
BaiduRtcRoomClient::getConnectionStats
ConnectionStats BaiduRtcRoomClient::getConnectionStats(ConnectionType connectionType)介绍
获取当前网络状态。
根据连接类型，返回用户当前的网络连接状态值。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| connectionType | ConnectionType | 网络连接类型，信令通道连接/媒体通道连接 |
返回
ConnectionStats 网络连接状态值
转推相关接口
可将当前用户RTP 流转推为 RTMP 流，用于互娱、教育等场景
BaiduRtcRoomClient::configLiveStreamWithUrl
void BaiduRtcRoomClient::getRoomStates(char* url, bool isMix,
bool isRecording, char* mixTemplate, RtcLiveTransferMode transferMode)介绍
配置Server端推流参数
接口用于配置Server推流的参数，在登录前调用。
聊天室模式：在同一个RTC房间的所有参与者在混流后，直接转推到一个指定的直播房间。
主播转推模式：主播推向不同的直播房间，进入房间前调用。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| url | char* | 转推RTMP地址 |
| isMix | bool | 是否混流 |
| isRecording | bool | 是否录制 |
| mixTemplate | char* | 转推RTMP模板 |
| transferMode | RtcLiveTransferMode | 转推模式 |
返回
无
BaiduRtcRoomClient::startLiveServerStreaming
void BaiduRtcRoomClient::startLiveServerStreaming(char* url, bool isMix,
bool isRecording, char* mixTemplate, RtcLiveTransferMode transferMode)介绍
开启server端推流
接口开启server推流的参数，在推流成功后调用。
聊天室模式：在同一个RTC房间的所有参与者在混流后，直接转推到一个指定的直播房间。
主播转推模式：主播推向不同的直播房间，进入房间前调用。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| url | char* | 转推RTMP地址 |
| isMix | bool | 是否混流 |
| isRecording | bool | 是否录制 |
| mixTemplate | char* | 转推RTMP模板 |
| transferMode | RtcLiveTransferMode | 转推模式 |
返回
无
BaiduRtcRoomClient::stopLiveServerStreaming
void BaiduRtcRoomClient::stopLiveServerStreaming(RtcLiveTransferMode transferMode)介绍
停止Server端推流
聊天室模式：在同一个RTC房间的所有参与者在混流后，直接转推到一个指定的直播房间。
主播转推模式：主播推向不同的直播房间，进入房间前调用。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| transferMode | RtcLiveTransferMode | 转推模式 |
返回
无
转推相关接口
声卡采集相关接口，可用于麦克风与系统音频混音输出
BaiduRtcRoomClient::enableLoopbackRecording
void BaiduRtcRoomClient::enableLoopbackRecording(bool enabled)介绍
控制声卡采集开启，在推流成功后调用
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| enabled | bool | 为true时开启，为false时关闭 |
返回
无
BaiduRtcRoomClient::setLoopbackRecordingVolume
void BaiduRtcRoomClient::setLoopbackRecordingVolume(int volume)介绍
设置声卡采集音量
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| volume | int | 声卡采集音量，范围 0~100 |
返回
无
BaiduRtcRoomClient::setLoopbackRecordingMute
void BaiduRtcRoomClient::setLoopbackRecordingMute(bool mute)介绍
设置声卡采集静音
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| mute | bool | 是否静音 |
返回
无
其他接口
BaiduRtcRoomClient::enableRtcStatsInfoDot
void BaiduRtcRoomClient::enableRtcStatsInfoDot(bool isEnable)介绍
RTC状态信息打点。
是否开启 RTC 状态信息打点功能，默认开启。当开启打点时，日志信息会上传到百度日志统计Server,并通过图表的形式展示，可实时查询。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isEnable | bool | 是否开启打点 |
返回
ConnectionStats 网络连接状态值
getBaiduRtcSdkVersion
void getBaiduRtcSdkVersion(char* version, int len)介绍
获取SDK版本号。
获取百度 RTC SDK 版本号。 参数
| 参数 | 类型 | 描述 |
|---|---|---|
| version | char* | 版本号字符串 |
| int | len | 字符串长度 |
返回
无
enableBaiduRtcLog
void enableBaiduRtcLog(bool isEnable)介绍
日志功能。
日志功能开关, 谨记在销毁 SDK 时需关闭。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| isEnable | bool | 若为 true, 开启日志功能， 开启日志功能后，会把日志保存到本地文件中；若为false 关闭日志功能。 |
返回
无
configStreamingAddr
void configStreamingAddr(const char* url)介绍
切换媒接入Server。
当链路不稳定，或视频画面卡顿时，可使用该接口，切换媒体接入Server. 切换后，需要重新进入房间，并发布流或拉流。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| url | const char* | 媒体服务器地址 |
返回
无
setVideoDevice
void setVideoDevice(const char* deviceId)介绍
设置视频设备。
用户通过getVideoDeviceList 获取的设备信息列表，设置准备开启的视频设备。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceId | const char* | 视频设备 ID 或 NAME |
返回
无
getVideoDeviceList
RtcVideoDeviceInfo* getVideoDeviceList(int & deviceCount)介绍
获取视频设备列表。
获取当前可用的视频设备列表，用户可根据获取的列表，选择要开启的视频设备。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceCount | int& | 可用设备数目 |
返回
RtcVideoDeviceInfo* 指向当前可用信息列表
freeVideoDeviceList
void freeVideoDeviceList(RtcVideoDeviceInfo* deviceInfoList)介绍
释放视频设备列表。
当用户调用 getVideoDeviceList 获取视频设备列表后，须使用改接口是否释放设备列表资源。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceInfoList | RtcVideoDeviceInfo* | 当前可用信息列表 |
返回
无