236 lines
8.9 KiB
C
236 lines
8.9 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.
|
||
|
|
*
|
||
|
|
* Use of this source code is governed by a BSD-style license
|
||
|
|
* that can be found in the LICENSE file in the root of the source
|
||
|
|
* tree. An additional intellectual property rights grant can be found
|
||
|
|
* in the file PATENTS. All contributing project authors may
|
||
|
|
* be found in the AUTHORS file in the root of the source tree.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef WEBRTC_AUDIO_DEVICE_AUDIO_DEVICE_IMPL_H
|
||
|
|
#define WEBRTC_AUDIO_DEVICE_AUDIO_DEVICE_IMPL_H
|
||
|
|
|
||
|
|
#include "audio_device.h"
|
||
|
|
#include "audio_device_buffer.h"
|
||
|
|
|
||
|
|
namespace webrtc
|
||
|
|
{
|
||
|
|
|
||
|
|
class AudioDeviceGeneric;
|
||
|
|
class AudioDeviceUtility;
|
||
|
|
class CriticalSectionWrapper;
|
||
|
|
|
||
|
|
class AudioDeviceModuleImpl : public AudioDeviceModule
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
enum PlatformType
|
||
|
|
{
|
||
|
|
kPlatformNotSupported = 0,
|
||
|
|
kPlatformWin32 = 1,
|
||
|
|
kPlatformWinCe = 2,
|
||
|
|
kPlatformLinux = 3,
|
||
|
|
kPlatformMac = 4
|
||
|
|
};
|
||
|
|
|
||
|
|
WebRtc_Word32 CheckPlatform();
|
||
|
|
WebRtc_Word32 CreatePlatformSpecificObjects();
|
||
|
|
WebRtc_Word32 AttachAudioBuffer();
|
||
|
|
|
||
|
|
AudioDeviceModuleImpl(const WebRtc_Word32 id, const AudioLayer audioLayer);
|
||
|
|
virtual ~AudioDeviceModuleImpl();
|
||
|
|
|
||
|
|
public: // Module
|
||
|
|
virtual WebRtc_Word32 ChangeUniqueId(const WebRtc_Word32 id);
|
||
|
|
virtual WebRtc_Word32 Version(
|
||
|
|
WebRtc_Word8 *version, WebRtc_UWord32& remainingBufferInBytes,
|
||
|
|
WebRtc_UWord32& position) const;
|
||
|
|
virtual WebRtc_Word32 TimeUntilNextProcess();
|
||
|
|
virtual WebRtc_Word32 Process();
|
||
|
|
|
||
|
|
public:
|
||
|
|
// Factory methods (resource allocation/deallocation)
|
||
|
|
static AudioDeviceModule* Create(
|
||
|
|
const WebRtc_Word32 id,
|
||
|
|
const AudioLayer audioLayer = kPlatformDefaultAudio);
|
||
|
|
static void Destroy(AudioDeviceModule* module);
|
||
|
|
|
||
|
|
// Retrieve the currently utilized audio layer
|
||
|
|
virtual WebRtc_Word32 ActiveAudioLayer(AudioLayer* audioLayer) const;
|
||
|
|
|
||
|
|
// Error handling
|
||
|
|
virtual ErrorCode LastError() const;
|
||
|
|
virtual WebRtc_Word32 RegisterEventObserver(
|
||
|
|
AudioDeviceObserver* eventCallback);
|
||
|
|
|
||
|
|
// Full-duplex transportation of PCM audio
|
||
|
|
virtual WebRtc_Word32 RegisterAudioCallback(
|
||
|
|
AudioTransport* audioCallback);
|
||
|
|
|
||
|
|
// Main initializaton and termination
|
||
|
|
virtual WebRtc_Word32 Init();
|
||
|
|
virtual WebRtc_Word32 Terminate();
|
||
|
|
virtual bool Initialized() const;
|
||
|
|
|
||
|
|
// Device enumeration
|
||
|
|
virtual WebRtc_Word16 PlayoutDevices();
|
||
|
|
virtual WebRtc_Word16 RecordingDevices();
|
||
|
|
virtual WebRtc_Word32 PlayoutDeviceName(
|
||
|
|
WebRtc_UWord16 index,
|
||
|
|
WebRtc_Word8 name[kAdmMaxDeviceNameSize],
|
||
|
|
WebRtc_Word8 guid[kAdmMaxGuidSize]);
|
||
|
|
virtual WebRtc_Word32 RecordingDeviceName(
|
||
|
|
WebRtc_UWord16 index,
|
||
|
|
WebRtc_Word8 name[kAdmMaxDeviceNameSize],
|
||
|
|
WebRtc_Word8 guid[kAdmMaxGuidSize]);
|
||
|
|
|
||
|
|
// Device selection
|
||
|
|
virtual WebRtc_Word32 SetPlayoutDevice(WebRtc_UWord16 index);
|
||
|
|
virtual WebRtc_Word32 SetPlayoutDevice(WindowsDeviceType device);
|
||
|
|
virtual WebRtc_Word32 SetRecordingDevice(WebRtc_UWord16 index);
|
||
|
|
virtual WebRtc_Word32 SetRecordingDevice(WindowsDeviceType device);
|
||
|
|
|
||
|
|
// Audio transport initialization
|
||
|
|
virtual WebRtc_Word32 PlayoutIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 InitPlayout();
|
||
|
|
virtual bool PlayoutIsInitialized() const;
|
||
|
|
virtual WebRtc_Word32 RecordingIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 InitRecording();
|
||
|
|
virtual bool RecordingIsInitialized() const;
|
||
|
|
|
||
|
|
// Audio transport control
|
||
|
|
virtual WebRtc_Word32 StartPlayout();
|
||
|
|
virtual WebRtc_Word32 StopPlayout();
|
||
|
|
virtual bool Playing() const;
|
||
|
|
virtual WebRtc_Word32 StartRecording();
|
||
|
|
virtual WebRtc_Word32 StopRecording();
|
||
|
|
virtual bool Recording() const;
|
||
|
|
|
||
|
|
// Microphone Automatic Gain Control (AGC)
|
||
|
|
virtual WebRtc_Word32 SetAGC(bool enable);
|
||
|
|
virtual bool AGC() const;
|
||
|
|
|
||
|
|
// Volume control based on the Windows Wave API (Windows only)
|
||
|
|
virtual WebRtc_Word32 SetWaveOutVolume(WebRtc_UWord16 volumeLeft,
|
||
|
|
WebRtc_UWord16 volumeRight);
|
||
|
|
virtual WebRtc_Word32 WaveOutVolume(WebRtc_UWord16* volumeLeft,
|
||
|
|
WebRtc_UWord16* volumeRight) const;
|
||
|
|
|
||
|
|
// Audio mixer initialization
|
||
|
|
virtual WebRtc_Word32 SpeakerIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 InitSpeaker();
|
||
|
|
virtual bool SpeakerIsInitialized() const;
|
||
|
|
virtual WebRtc_Word32 MicrophoneIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 InitMicrophone();
|
||
|
|
virtual bool MicrophoneIsInitialized() const;
|
||
|
|
|
||
|
|
// Speaker volume controls
|
||
|
|
virtual WebRtc_Word32 SpeakerVolumeIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 SetSpeakerVolume(WebRtc_UWord32 volume);
|
||
|
|
virtual WebRtc_Word32 SpeakerVolume(WebRtc_UWord32* volume) const;
|
||
|
|
virtual WebRtc_Word32 MaxSpeakerVolume(WebRtc_UWord32* maxVolume) const;
|
||
|
|
virtual WebRtc_Word32 MinSpeakerVolume(WebRtc_UWord32* minVolume) const;
|
||
|
|
virtual WebRtc_Word32 SpeakerVolumeStepSize(
|
||
|
|
WebRtc_UWord16* stepSize) const;
|
||
|
|
|
||
|
|
// Microphone volume controls
|
||
|
|
virtual WebRtc_Word32 MicrophoneVolumeIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 SetMicrophoneVolume(WebRtc_UWord32 volume);
|
||
|
|
virtual WebRtc_Word32 MicrophoneVolume(WebRtc_UWord32* volume) const;
|
||
|
|
virtual WebRtc_Word32 MaxMicrophoneVolume(
|
||
|
|
WebRtc_UWord32* maxVolume) const;
|
||
|
|
virtual WebRtc_Word32 MinMicrophoneVolume(
|
||
|
|
WebRtc_UWord32* minVolume) const;
|
||
|
|
virtual WebRtc_Word32 MicrophoneVolumeStepSize(
|
||
|
|
WebRtc_UWord16* stepSize) const;
|
||
|
|
|
||
|
|
// Speaker mute control
|
||
|
|
virtual WebRtc_Word32 SpeakerMuteIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 SetSpeakerMute(bool enable);
|
||
|
|
virtual WebRtc_Word32 SpeakerMute(bool* enabled) const;
|
||
|
|
|
||
|
|
// Microphone mute control
|
||
|
|
virtual WebRtc_Word32 MicrophoneMuteIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 SetMicrophoneMute(bool enable);
|
||
|
|
virtual WebRtc_Word32 MicrophoneMute(bool* enabled) const;
|
||
|
|
|
||
|
|
// Microphone boost control
|
||
|
|
virtual WebRtc_Word32 MicrophoneBoostIsAvailable(bool* available);
|
||
|
|
virtual WebRtc_Word32 SetMicrophoneBoost(bool enable);
|
||
|
|
virtual WebRtc_Word32 MicrophoneBoost(bool* enabled) const;
|
||
|
|
|
||
|
|
// Stereo support
|
||
|
|
virtual WebRtc_Word32 StereoPlayoutIsAvailable(bool* available) const;
|
||
|
|
virtual WebRtc_Word32 SetStereoPlayout(bool enable);
|
||
|
|
virtual WebRtc_Word32 StereoPlayout(bool* enabled) const;
|
||
|
|
virtual WebRtc_Word32 StereoRecordingIsAvailable(bool* available) const;
|
||
|
|
virtual WebRtc_Word32 SetStereoRecording(bool enable);
|
||
|
|
virtual WebRtc_Word32 StereoRecording(bool* enabled) const;
|
||
|
|
virtual WebRtc_Word32 SetRecordingChannel(const ChannelType channel);
|
||
|
|
virtual WebRtc_Word32 RecordingChannel(ChannelType* channel) const;
|
||
|
|
|
||
|
|
// Delay information and control
|
||
|
|
virtual WebRtc_Word32 SetPlayoutBuffer(const BufferType type,
|
||
|
|
WebRtc_UWord16 sizeMS = 0);
|
||
|
|
virtual WebRtc_Word32 PlayoutBuffer(BufferType* type,
|
||
|
|
WebRtc_UWord16* sizeMS) const;
|
||
|
|
virtual WebRtc_Word32 PlayoutDelay(WebRtc_UWord16* delayMS) const;
|
||
|
|
virtual WebRtc_Word32 RecordingDelay(WebRtc_UWord16* delayMS) const;
|
||
|
|
|
||
|
|
// CPU load
|
||
|
|
virtual WebRtc_Word32 CPULoad(WebRtc_UWord16* load) const;
|
||
|
|
|
||
|
|
// Recording of raw PCM data
|
||
|
|
virtual WebRtc_Word32 StartRawOutputFileRecording(
|
||
|
|
const WebRtc_Word8 pcmFileNameUTF8[kAdmMaxFileNameSize]);
|
||
|
|
virtual WebRtc_Word32 StopRawOutputFileRecording();
|
||
|
|
virtual WebRtc_Word32 StartRawInputFileRecording(
|
||
|
|
const WebRtc_Word8 pcmFileNameUTF8[kAdmMaxFileNameSize]);
|
||
|
|
virtual WebRtc_Word32 StopRawInputFileRecording();
|
||
|
|
|
||
|
|
// Native sample rate controls (samples/sec)
|
||
|
|
virtual WebRtc_Word32 SetRecordingSampleRate(
|
||
|
|
const WebRtc_UWord32 samplesPerSec);
|
||
|
|
virtual WebRtc_Word32 RecordingSampleRate(
|
||
|
|
WebRtc_UWord32* samplesPerSec) const;
|
||
|
|
virtual WebRtc_Word32 SetPlayoutSampleRate(
|
||
|
|
const WebRtc_UWord32 samplesPerSec);
|
||
|
|
virtual WebRtc_Word32 PlayoutSampleRate(
|
||
|
|
WebRtc_UWord32* samplesPerSec) const;
|
||
|
|
|
||
|
|
// Mobile device specific functions
|
||
|
|
virtual WebRtc_Word32 ResetAudioDevice();
|
||
|
|
virtual WebRtc_Word32 SetLoudspeakerStatus(bool enable);
|
||
|
|
virtual WebRtc_Word32 GetLoudspeakerStatus(bool* enabled) const;
|
||
|
|
|
||
|
|
public:
|
||
|
|
WebRtc_Word32 Id() {return _id;}
|
||
|
|
|
||
|
|
private:
|
||
|
|
PlatformType Platform() const;
|
||
|
|
AudioLayer PlatformAudioLayer() const;
|
||
|
|
|
||
|
|
private:
|
||
|
|
CriticalSectionWrapper& _critSect;
|
||
|
|
CriticalSectionWrapper& _critSectEventCb;
|
||
|
|
CriticalSectionWrapper& _critSectAudioCb;
|
||
|
|
|
||
|
|
AudioDeviceObserver* _ptrCbAudioDeviceObserver;
|
||
|
|
|
||
|
|
AudioDeviceUtility* _ptrAudioDeviceUtility;
|
||
|
|
AudioDeviceGeneric* _ptrAudioDevice;
|
||
|
|
|
||
|
|
AudioDeviceBuffer _audioDeviceBuffer;
|
||
|
|
|
||
|
|
WebRtc_Word32 _id;
|
||
|
|
AudioLayer _platformAudioLayer;
|
||
|
|
WebRtc_UWord32 _lastProcessTime;
|
||
|
|
PlatformType _platformType;
|
||
|
|
bool _initialized;
|
||
|
|
mutable ErrorCode _lastError;
|
||
|
|
};
|
||
|
|
|
||
|
|
} // namespace webrtc
|
||
|
|
|
||
|
|
#endif // WEBRTC_MODULES_INTERFACE_AUDIO_DEVICE_IMPL_H_
|