Meeting SDK for Windows API Reference
Loading...
Searching...
No Matches
Public Member Functions
ITestAudioDeviceHelper Class Referenceabstract

Audio device test interface. More...

#include <setting_service_interface.h>

Public Member Functions

virtual SDKError SetEvent (ITestAudioDeviceHelperEvent *pEvent)=0
 Audio device test callback handler.
 
virtual SDKError TestMicStartRecording (const zchar_t *deviceID=nullptr)=0
 Start to test the mic.
 
virtual SDKError TestMicStopTesting ()=0
 Stop the mic test. The SDK will return an error if there is no mic test.
 
virtual SDKError TestMicPlayRecording ()=0
 Play the mic recorded sound. If there is no mic testing, SDK return an error.
 
virtual SDKError TestSpeakerStartPlaying (const zchar_t *deviceID=nullptr)=0
 Start to test the speaker.
 
virtual SDKError TestSpeakerStopPlaying ()=0
 Stop the speaker test. The SDK will return an error if there is no speaker test.
 
virtual SDKError SetTimerInterval (unsigned int timerInterval)=0
 Set the time interval for audio test.
 

Detailed Description

Audio device test interface.

Definition at line 429 of file setting_service_interface.h.

Member Function Documentation

◆ SetEvent()

virtual SDKError ITestAudioDeviceHelper::SetEvent ( ITestAudioDeviceHelperEvent * pEvent)
pure virtual

Audio device test callback handler.

Parameters
pEventA pointer to the ITestAudioDeviceHelperEvent that receives audio device test event.
Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
Call the function before using any other interface of the same class.

◆ SetTimerInterval()

virtual SDKError ITestAudioDeviceHelper::SetTimerInterval ( unsigned int timerInterval)
pure virtual

Set the time interval for audio test.

Parameters
timerIntervalUsually the SDK sends the mic and speaker volumes every 200 ms by default via ITestAudioDeviceHelperEvent::OnMicSpkVolumeChanged().
Note
With this function, the user can modify the time interval instead of 200. The time interval varies only from 50 to 1000 in millisecond.
Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
This interface will stop the mic/speaker test(if there is). It is suggested to call it before audio test.

◆ TestMicPlayRecording()

virtual SDKError ITestAudioDeviceHelper::TestMicPlayRecording ( )
pure virtual

Play the mic recorded sound. If there is no mic testing, SDK return an error.

Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
The function is disabled if no event handler is set.

◆ TestMicStartRecording()

virtual SDKError ITestAudioDeviceHelper::TestMicStartRecording ( const zchar_t * deviceID = nullptr)
pure virtual

Start to test the mic.

Parameters
deviceIDSpecify to test a mic device. If the param is a wrong mic ID, the SDK will return an error. Otherwise the SDK tests the specified device and sets it as selected. The SDK will test the default device if no parameter is input.
Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
The function is disabled if no event handler is set.

◆ TestMicStopTesting()

virtual SDKError ITestAudioDeviceHelper::TestMicStopTesting ( )
pure virtual

Stop the mic test. The SDK will return an error if there is no mic test.

Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
The function is disabled if no event handler is set.

◆ TestSpeakerStartPlaying()

virtual SDKError ITestAudioDeviceHelper::TestSpeakerStartPlaying ( const zchar_t * deviceID = nullptr)
pure virtual

Start to test the speaker.

Parameters
deviceIDSpecify to test a speaker device. If the param is a wrong speaker ID, the SDK will return an error. Otherwise the SDK tests the specified device and sets it as selected. The SDK will test the default device if no parameter is input.
Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
The function is disabled if no event handler is set.

◆ TestSpeakerStopPlaying()

virtual SDKError ITestAudioDeviceHelper::TestSpeakerStopPlaying ( )
pure virtual

Stop the speaker test. The SDK will return an error if there is no speaker test.

Returns
If the function succeeds, the return value is SDKERR_SUCCESS. Otherwise failed. For detailed error codes, see the SDKError enum.
Note
The function is disabled if no event handler is set.