git-svn-id: http://webrtc.googlecode.com/svn/trunk@156 4adac7df-926f-26a2-2b94-8c16560cd09d
diff --git a/src/modules/audio_device/main/source/audio_device_impl.h b/src/modules/audio_device/main/source/audio_device_impl.h
new file mode 100644
index 0000000..9c84952
--- /dev/null
+++ b/src/modules/audio_device/main/source/audio_device_impl.h
@@ -0,0 +1,235 @@
+/*
+ * 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_