开发者社区> 视频云技术小编> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

产品百科 | RTC Windows SDK 音视频设备测试说明

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

摄像头测试

  1. 创建 SDK 实例后,应用层可以调用接口 getCameraList,获取当前设备上所有可用摄像头,返回设备列表中将同时返回设备 ID 及设备名称,应用层可选择通过设备名称或设备 ID 进行判断,并通过接口 setCurrentCamerasetCurrentCameraById 选中需要测试的设备。
AliRtcEngine *pEngine = AliRtcEngine::sharedInstance(listener, "");
AliRtcDeviceList cameraList;
pEngine->getCameraList(cameraList);
#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)
    {
        // 设置测试设备
        pEngine->setCurrentCamera(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)
    {
        // 设置测试设备
        pEngine->setCurrentCameraById(deviceId);
    }    
}
#endif
  1. 设置测试摄像头设备之后,通过 setLocalViewConfig 接口可以设置预览显示窗口,然后启动预览,即可通过预览画面是否正常显示,判断当前摄像头设备是否正常工作。
// 设置预览窗口
AliVideoCanvas canvas;
canvas.hWnd = /*预览显示窗口句柄*/;
pEngine->setLocalViewConfig(canvas, AliRtcVideoTrackCamera);
// 开启预览检查,确认显示是否正常
pEngine->startPreview();

麦克风测试

  1. 创建 SDK 实例后,应用层需要继承 AliMediaDeviceTestEventListener 接口,实现 OnAudioDeviceRecordLevel 回调,用于接收麦克风测试时返回的音量值。再通过 SDK 接口 createMediaDeviceTestInterface 创建设备测试实例,并在创建时传入回调监听实例。
// 继承实现设备测试事件回调
class DeviceTestEventListener : public AliMediaDeviceTestEventListener
{
public:
    virtual void OnAudioDeviceRecordLevel(int level)
    {
        // 处理麦克风测试音量回调
    }   
};
// 创建SDK实例及设备测试实例
AliRtcEngine *pEngine = AliRtcEngine::sharedInstance(listener, "");
DeviceTestEventListener* deviceTestListener = new DeviceTestEventListener();
AliMediaDeviceTestInterface *pTestInterface = pEngine->createMediaDeviceTestInterface(deviceTestListener);
  1. 开始测试前,通过接口 getAudioCaptures 获取当前设备上所有可用麦克风设备,返回设备列表中将同时返回设备 ID 及设备名称,应用层可选择通过设备名或设备 ID 判断并选择需要测试的设备。
AliRtcDeviceList audioCaptureList;
pEngine->getAudioCaptures(audioCaptureList);
#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);
    matchDeviceName = ...  
}
#else
// 可以通过遍历所有麦克风设备ID,查找需要测试的设备
std::string matchDeviceId = /*测试设备ID*/;
for (size_t i = 0; i != audioCaptureList.deviceIds.size(); ++i)
{
    AliRtc::String deviceId = audioCaptureList.deviceIds.at(i);
    matchDeviceId = ...  
}
#endif
  1. 选中测试设备后,调用麦克风测试接口启动测试,接口中需要指明测试设备名称或者设备 ID,以及音量回调频率(传入 0 为默认频率,每 20ms 回调一次音量)。测试开始后,提示您对麦克风设备说话,并将 OnAudioDeviceRecordLevel 回调中返回的采集音量值进行展示,判断当前麦克风设备是否正常工作。
// 启动麦克风设备测试
#if defined(USE_DEVIC_NAME)
pTestInterface->StartTestAudioRecord(matchDeviceName.c_str(), 0);
#else
pTestInterface->StartTestAudioRecordById(matchDeviceName.c_str(), 0); 
#endif
  1. 测试完成后,调用接口 StopTestAudioRecord 停止麦克风测试,并释放设备测试功能实例。
pTestInterface->StopTestAudioRecord();
pTestInterface->Release();
pTestInterface = nullptr;

扬声器测试

  1. 创建 SDK 引擎实例后,应用层需要继承 AliMediaDeviceTestEventListener 接口,实现 OnAudioDevicePlayoutLevel 回调,用于接收扬声器测试时返回的音量值,同时实现 OnAudioDevicePlayoutEnd 回调,用于接收播放文件结束事件。然后通过 SDK 接口 createMediaDeviceTestInterface 创建设备测试实例,并在创建时传入回调监听实例。
// 继承实现设备测试事件回调
class DeviceTestEventListener : public AliMediaDeviceTestEventListener
{
public:
    virtual void OnAudioDevicePlayoutLevel(int level)
    {
        // 处理扬声器测试音量回调
    }
    virtual void OnAudioDevicePlayoutEnd()
    {
        // 处理扬声器测试播放结束事件
    }
};
// 创建SDK实例及设备测试实例
AliRtcEngine *pEngine = AliRtcEngine::sharedInstance(listener, "");
DeviceTestEventListener* deviceTestListener = new DeviceTestEventListener();
AliMediaDeviceTestInterface *pTestInterface = pEngine->createMediaDeviceTestInterface(deviceTestListener);
  1. 开始测试前,通过接口 getAudioCaptures 获取当前设备上所有可用扬声器,返回设备列表中将同时返回设备 ID 及设备名称,应用层可选择通过设备名或设备 ID 判断并选中需要测试的设备。
AliRtcDeviceList audioRenderList;
pEngine->getAudioRenderers(audioRenderList);
#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);
    matchDeviceName = ...  
}
#else
// 也可以通过遍历所有麦克风设备ID,查找需要测试的设备
std::string matchDeviceId = /*测试设备ID*/;
for (size_t i = 0; i != audioRenderList.deviceIds.size(); ++i)
{
    AliRtc::String deviceId = audioRenderList.deviceIds.at(i);
    matchDeviceId = ...  
}
#endif
  1. 选中测试设备后,调用扬声器测试接口启动测试,接口中需要指明测试设备名称或设备 ID,音量回调频率(传入 0 为默认频率,每 20ms 回调一次音量),以及测试使用的音频文件路径。开始测试后,可以将 OnAudioDevicePlayoutLevel 回调中返回的采集音量值进行展示,同时关注扬声器中播放的测试音频,判断当前扬声器设备是否正常工作。
// 启动麦克风设备测试
#if defined(USE_DEVIC_NAME)
pTestInterface->StartTestAudioPlayout(matchDeviceName.c_str(), 0, wavPath.c_str());
#else
pTestInterface->StartTestAudioPlayoutById(matchDeviceId.c_str(), 0, wavPath.c_str());
#endif

  1. 说明 目前扬声器测试播放文件只支持 Wave 格式,传入路径需要为绝对路径,并保证可以被读取访问。
  2. 测试完成或接收到文件播放结束事件回调后,调用 StopTestAudioRecord 接口停止麦克风测试,并释放设备测试功能实例。
pTestInterface->StopTestAudioPlayout();
pTestInterface->Release();
pTestInterface = nullptr;


「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

image.png

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
FFMPEG音视频开发: 完成摄像头、桌面本地录制与rtmp推流(windows)
FFMPEG音视频开发: 完成摄像头、桌面本地录制与rtmp推流(windows)
166 0
Qt Creator的IDE选项配置参数的保存路径在哪里?即QtProject文件夹在哪里?(Windows/Linux/MacOS)
Qt Creator的IDE选项配置参数的保存路径在哪里?即QtProject文件夹在哪里?(Windows/Linux/MacOS)
134 0
产品百科 |RTC Windows SDK 如何进行设备检测?
本文为您介绍了阿里云 RTC 的设备检测和管理功能,您可以在加入频道之前检查硬件设备是否能正常工作。
74 0
产品百科 |RTC Windows SDK 手动推流和手动订阅的实现步骤
通过阅读本文,您可以了解手动推流和手动订阅的实现步骤。
165 0
无法保存对hosts权限所作的更改 拒绝访问(权限,防止Windows主机文件、进程、注册表项进行操作和更改)
为Windows安装或修改配置、 无法保存对hosts权限所作的更改 拒绝访问 (权限,防止Windows主机文件、进程、注册表项进行操作和更改) 例如,下图: 1.使用Windows的“管理员权限”进行操作 或给当前的Windows用户分配此文件的写权限: 2.如果为文件的修改,可以先创建和复制文件副本其他地方,修改后覆盖 3.计算机安装的杀毒软件和管理软件,控制了
8642 0
211
文章
25
问答
来源圈子
更多
+ 订阅
相关文档: 云会议 智能视觉 音视频通信
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载