本文為您介紹了阿裡雲 RTC 的裝置檢測和管理功能,您可以在加入頻道之前檢查硬體裝置是否能正常工作。
功能簡介
AliRTCSDK 提供了檢測和管理裝置的功能,友善您測試和檢測裝置。例如,您可以查詢裝置資訊、檢測攝像頭是否正常工作、檢測音頻裝置是否正常錄音及播放、設定攝像頭方向或者切換音頻裝置(麥克風和揚聲器)等。
實作方法
在實作該功能之前,需要您已經搭建 AppServer、實作基本功能等操作。詳情請參見
入門概述。
具體實作方法如下所示。
- getCameraList:擷取攝像頭清單。
void getCameraList(AliRtc::StringArray& array)
參數 | 類型 | 描述 |
array | AliRtc::StringArray& | 攝像頭清單。 |
- getCurrentCamera:擷取目前使用的攝像頭名稱。
AliRtc::String getCurrentCamera()
- setCurrentCamera:選擇攝像頭。必須先調用 getCameraList 接口擷取裝置清單後再調用此接口設定。
void setCurrentCamera(const AliRtc::String& camera)
camera | const AliRtc::String& | 攝像頭名稱。 |
- isCameraOn:檢查攝像頭是否打開。傳回 true 表示攝像頭已打開,false 表示攝像頭未打開。
bool isCameraOn()
- getAudioCaptures:擷取系統中的錄音裝置清單。
void getAudioCaptures(AliRtc::StringArray& array)
音頻采集裝置清單。 |
- getCurrentAudioCapture:擷取目前使用的音頻采集裝置名稱。
AliRtc::String getCurrentAudioCapture()
- setCurrentAudioCapture:選擇音頻采集裝置。必須先調用 getAudioCaptures 接口擷取裝置清單後再調用此接口設定。
void setCurrentAudioCapture(const AliRtc::String& capture)
capture | String | 音頻采集裝置名稱。 |
- getAudioRenderers:擷取系統中的揚聲器清單。
void getAudioRenderers(AliRtc::StringArray& array)
音頻播放裝置清單。 |
- getCurrentAudioRenderer:擷取目前使用的音頻播放裝置。
AliRtc::String getCurrentAudioRenderer()
- setCurrentAudioRenderer:選擇音頻播放裝置。必須先調用 getAudioRenderers 接口擷取裝置清單後再調用此接口設定。
void setCurrentAudioRenderer(const AliRtc::String &renderer)
renderer | 音頻播放裝置名稱。 |
更多接口實作方法,請參見
AliRtcEngine 接口「視訊雲技術」你最值得關注的音視訊技術公衆号,每周推送來自阿裡雲一線的實踐技術文章,在這裡與音視訊領域一流工程師交流切磋。
