Windows如何测试音视频设备_音视频通信(RTC)-阿里云帮助中心

RTC SDK为您提供音视频设备测试的方法，您可以在音视频通话前检查当前设备上的摄像头，麦克风以及扬声器等音视频设备是否正常工作，以保证音视频通话质量。通过阅读本文，您可以了解音视频设备测试的方法。

摄像头测试

创建SDK实例后，应用层可以调用接口getCameraList，获取当前设备上所有可用摄像头，返回设备列表中将同时返回设备ID及设备名称，应用层可选择通过设备名称或设备ID进行判断，并通过接口SetCurrentCameraName或SetCurrentCameraID选中需要测试的设备。

AliRtcEngine *pEngine = AliRtcEngine::Create("");
IAliEngineAudioDeviceManager* videoDeviceManager = nullptr;
pEngine->pInterface(AliEngineInterfaceVideoDeviceManger, &videoDeviceManager);

AliEngineDeviceInfoList cameraList = videoDeviceManager->getCameraList();

#if defined(USE_DEVIC_NAME)
// 可以通过遍历所有摄像头设备名，查找并设置需要测试的设备
std::string matchDeviceName = /*测试设备名*/;
for (size_t i = 0; i != cameraList.deviceNames.size(); ++i)
{
    AliRtc::String deviceName = cameraList.deviceNames.at(i);
    if(std::string(deviceName.c_str()) == matchDeviceName)
    {
        // 设置测试设备
        videoDeviceManager->SetCurrentCameraName(deviceName);
    }
}
#else
// 可以通过遍历所有摄像头设备ID并查找需要测试的设备
std::string matchDeviceId = /*测试设备ID*/;
for (size_t i = 0; i != cameraList.deviceIds.size(); ++i)
{
    AliRtc::String deviceId = cameraList.deviceIds.at(i);
    if(std::string(deviceId.c_str()) == matchDeviceId)
    {
        // 设置测试设备
        videoDeviceManager->SetCurrentCameraID(deviceId);
    }
}
#endif

设置测试摄像头设备之后，通过setLocalViewConfig接口可以设置预览显示窗口，然后启动预览，即可通过预览画面是否正常显示，判断当前摄像头设备是否正常工作。

// 设置预览窗口
AliVideoCanvas canvas;
canvas.displayView = /*预览显示窗口句柄*/;
pEngine->setLocalViewConfig(canvas, AliEngineVideoTrackCamera);

// 开启预览检查，确认显示是否正常
pEngine->startPreview();

麦克风测试

创建SDK实例后，应用层需要继承AliEngineEventListener接口，实现OnAudioDeviceRecordLevel回调，用于接收麦克风测试时返回的音量值。再通过SDK接口SetEngineEventListener创建设备测试实例，并在创建时传入回调监听实例。

// 继承实现设备测试事件回调
class EventListener : public AliEngineEventListener {
  void OnAudioDeviceRecordLevel(int level) {
    // 处理麦克风测试音量回调
  } override;
}

// 创建SDK实例及设备测试实例
AliRtcEngine *pEngine = AliRtcEngine::Create("");
EventListener *listener = new EventListener();
pEngine->SetEngineEventListener(listener);

开始测试前，通过接口GetAudioCaptureList获取当前设备上所有可用麦克风设备，返回设备列表中将同时返回设备ID及设备名称，应用层可选择通过设备名或设备ID判断并选择需要测试的设备。

IAliEngineAudioDeviceManager* audioDeviceManager = nullptr;
pEngine->pInterface(AliEngineInterfaceAudioDeviceManger, &audioDeviceManager);
AliEngineDeviceInfoList audioCaptureList = audioDeviceManager->GetAudioCaptureList();

#if defined(USE_DEVIC_NAME)
// 可以通过遍历所有麦克风设备名，查找需要测试的设备
std::string matchDeviceName = /*测试设备名*/;
for (size_t i = 0; i != audioCaptureList.deviceNames.size(); ++i)
{
    AliRtc::String deviceName = audioCaptureList.deviceNames.at(i);
    if(std::string(deviceName.c_str()) == matchDeviceName)
    {
        // 设置测试设备
        audioDeviceManager->SetCurrentAudioCaptureName(deviceName);
    }
}
#else
// 可以通过遍历所有麦克风设备ID，查找需要测试的设备
std::string matchDeviceId = /*测试设备ID*/;
for (size_t i = 0; i != audioCaptureList.deviceIds.size(); ++i)
{
    AliRtc::String deviceId = audioCaptureList.deviceIds.at(i);
    if(std::string(deviceId.c_str()) == matchDeviceId)
    {
        // 设置测试设备
        audioDeviceManager->SetCurrentAudioCaptureID(deviceId);
    }
}
#endif

选中测试设备后，调用麦克风测试接口启动测试，接口中需要指明测试设备名称或者设备ID，以及音量回调频率（传入0为默认频率，每20ms回调一次音量）。测试开始后，提示您对麦克风设备说话，并将OnAudioDeviceRecordLevel回调中返回的采集音量值进行展示，判断当前麦克风设备是否正常工作。
```
// 启动麦克风设备测试
#if defined(USE_DEVIC_NAME)
audioDeviceManager->StartTestAudioRecordByName(matchDeviceName.c_str(), 0);
#else
audioDeviceManager->StartTestAudioRecordById(matchDeviceId.c_str(), 0);
#endif
```
测试完成后，调用接口StopTestAudioRecord停止麦克风测试，并释放设备测试功能实例。
```
audioDeviceManager->StopTestAudioRecord();
audioDeviceManager->Release();
audioDeviceManager = nullptr;
```

扬声器测试

创建SDK引擎实例后，应用层需要继承AliEngineEventListener接口，实现OnAudioDevicePlayoutLevel回调，用于接收扬声器测试时返回的音量值，同时实现OnAudioDevicePlayoutEnd回调，用于接收播放文件结束事件。然后通过SDK接口SetEngineEventListener创建设备测试实例，并在创建时传入回调监听实例。

// 继承实现设备测试事件回调
class EventListener : public AliEngineEventListener {
  void OnAudioDevicePlayoutLevel(int level) {
    // 处理扬声器测试音量回调
  } override;

  void OnAudioDevicePlayoutEnd() {
    // 处理扬声器测试播放结束事件
  } override;
}

// 创建SDK实例及设备测试实例
AliRtcEngine *pEngine = AliRtcEngine::Create("");
EventListener *listener = new EventListener();
pEngine->SetEngineEventListener(listener);

开始测试前，通过接口GetAudioPlayerList获取当前设备上所有可用扬声器，返回设备列表中将同时返回设备 ID 及设备名称，应用层可选择通过设备名或设备 ID 判断并选中需要测试的设备。

IAliEngineAudioDeviceManager* audioDeviceManager = nullptr;
pEngine->pInterface(AliEngineInterfaceAudioDeviceManger, &audioDeviceManager);
AliEngineDeviceInfoList audioRenderList = audioDeviceManager->GetAudioPlayerList();


#if defined(USE_DEVIC_NAME)
// 可以通过遍历所有麦克风设备名，查找需要测试的设备
std::string matchDeviceName = /*测试设备名*/;
for (size_t i = 0; i != audioRenderList.deviceNames.size(); ++i)
{
    AliRtc::String deviceName = audioRenderList.deviceNames.at(i);
    if(std::string(deviceName.c_str()) == matchDeviceName)
    {
        // 设置测试设备
        audioDeviceManager->SetCurrentAudioPlayerName(deviceName);
    }
}
#else
// 也可以通过遍历所有麦克风设备ID，查找需要测试的设备
std::string matchDeviceId = /*测试设备ID*/;
for (size_t i = 0; i != audioRenderList.deviceIds.size(); ++i)
{
    AliRtc::String deviceId = audioRenderList.deviceIds.at(i);
    if(std::string(deviceId.c_str()) == matchDeviceId)
    {
        // 设置测试设备
        audioDeviceManager->SetCurrentAudioPlayerID(deviceId);
    }
}
#endif

选中测试设备后，调用扬声器测试接口启动测试，接口中需要指明测试设备名称或设备 ID，音量回调频率（传入0为默认频率，每20ms回调一次音量），以及测试使用的音频文件路径。开始测试后，可以将OnAudioDevicePlayoutLevel回调中返回的采集音量值进行展示，同时关注扬声器中播放的测试音频，判断当前扬声器设备是否正常工作。
```
// 启动麦克风设备测试
#if defined(USE_DEVIC_NAME)
audioDeviceManager->StartTestAudioPlayoutByName(matchDeviceName.c_str(), wavPath.c_str(), 200, 0 );
#else
audioDeviceManager->StartTestAudioPlayoutById(matchDeviceId.c_str(), wavPath.c_str(), 200, 0);
#endif
```
说明目前扬声器测试播放文件只支持Wave格式，传入路径需要为绝对路径，并保证可以被读取访问。
测试完成或接收到文件播放结束事件回调后，调用StopTestAudioRecord接口停止麦克风测试，并释放设备测试功能实例。
```
audioDeviceManager->StopTestAudioPlayout();
audioDeviceManager->Release();
audioDeviceManager = nullptr;
```