112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org/* 212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * libjingle 312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * Copyright 2004 Google Inc. 412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * 512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * Redistribution and use in source and binary forms, with or without 612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * modification, are permitted provided that the following conditions are met: 77d299ad4dc0ca26e0017b190b48362ad71328ce4machenbach@chromium.org * 87d299ad4dc0ca26e0017b190b48362ad71328ce4machenbach@chromium.org * 1. Redistributions of source code must retain the above copyright notice, 912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * this list of conditions and the following disclaimer. 107d299ad4dc0ca26e0017b190b48362ad71328ce4machenbach@chromium.org * 2. Redistributions in binary form must reproduce the above copyright notice, 1112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * this list of conditions and the following disclaimer in the documentation 1212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * and/or other materials provided with the distribution. 1312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * 3. The name of the author may not be used to endorse or promote products 1412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * derived from this software without specific prior written permission. 1512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * 1612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 1712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 1812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 1912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 2012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 2212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 2312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 2412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 2512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 2612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org */ 2712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 2812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#ifndef TALK_MEDIA_BASE_MEDIAENGINE_H_ 29e3c177a423baa3c30225c4e422b6f6c76d38b951machenbach@chromium.org#define TALK_MEDIA_BASE_MEDIAENGINE_H_ 3012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 3112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#ifdef OSX 3212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include <CoreAudio/CoreAudio.h> 3312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#endif 34e3c177a423baa3c30225c4e422b6f6c76d38b951machenbach@chromium.org 3512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include <limits.h> 3612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 3712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include <string> 3812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include <vector> 39e3c177a423baa3c30225c4e422b6f6c76d38b951machenbach@chromium.org 4012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/codec.h" 4112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/mediachannel.h" 4212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/mediacommon.h" 4312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/videocapturer.h" 4412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/videocommon.h" 4512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/videoprocessor.h" 4612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/base/voiceprocessor.h" 4712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "talk/media/devices/devicemanager.h" 4812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "webrtc/base/fileutils.h" 4912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#include "webrtc/base/sigslotrepeater.h" 5012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 5112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#if defined(GOOGLE_CHROME_BUILD) || defined(CHROMIUM_BUILD) 5212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#define DISABLE_MEDIA_ENGINE_FACTORY 5312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#endif 5412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 5512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgnamespace cricket { 5612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 5712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass VideoCapturer; 5812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 5912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// MediaEngineInterface is an abstraction of a media engine which can be 6012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// subclassed to support different media componentry backends. 6112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// It supports voice and video operations in the same class to facilitate 6212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// proper synchronization between both media types. 6312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass MediaEngineInterface { 6412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 6512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Default value to be used for SetAudioDelayOffset(). 6612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org static const int kDefaultAudioDelayOffset; 6712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 6812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual ~MediaEngineInterface() {} 6912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 7012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Initialization 7112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Starts the engine. 7212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool Init(rtc::Thread* worker_thread) = 0; 7312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Shuts down the engine. 7412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void Terminate() = 0; 7512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Returns what the engine is capable of, as a set of Capabilities, above. 7612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual int GetCapabilities() = 0; 7712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 7812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // MediaChannel creation 7912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Creates a voice media channel. Returns NULL on failure. 8012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VoiceMediaChannel *CreateChannel() = 0; 8112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Creates a video media channel, paired with the specified voice channel. 8212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Returns NULL on failure. 8312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoMediaChannel *CreateVideoChannel( 8412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceMediaChannel* voice_media_channel) = 0; 8512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 8612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Creates a soundclip object for playing sounds on. Returns NULL on failure. 8712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual SoundclipMedia *CreateSoundclip() = 0; 8812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 8912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Configuration 9012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Gets global audio options. 9112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual AudioOptions GetAudioOptions() const = 0; 9212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Sets global audio options. "options" are from AudioOptions, above. 9312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetAudioOptions(const AudioOptions& options) = 0; 9412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Sets the value used by the echo canceller to offset delay values obtained 9512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // from the OS. 9612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetAudioDelayOffset(int offset) = 0; 9712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Sets the default (maximum) codec/resolution and encoder option to capture 9812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // and encode video. 9912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetDefaultVideoEncoderConfig(const VideoEncoderConfig& config) 10012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org = 0; 10112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Gets the default (maximum) codec/resolution and encoder option used to 10212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // capture and encode video, as set by SetDefaultVideoEncoderConfig or the 10312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // default from the video engine if not previously set. 10412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoEncoderConfig GetDefaultVideoEncoderConfig() const = 0; 10512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 10612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Device selection 10712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // TODO(tschmelcher): Add method for selecting the soundclip device. 10812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetSoundDevices(const Device* in_device, 10912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const Device* out_device) = 0; 11012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 11112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Device configuration 11212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Gets the current speaker volume, as a value between 0 and 255. 11312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool GetOutputVolume(int* level) = 0; 11412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Sets the current speaker volume, as a value between 0 and 255. 11512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetOutputVolume(int level) = 0; 11612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 11712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Local monitoring 11812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Gets the current microphone level, as a value between 0 and 10. 11912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual int GetInputLevel() = 0; 12012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Starts or stops the local microphone. Useful if local mic info is needed 12112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // prior to a call being connected; the mic will be started automatically 12212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // when a VoiceMediaChannel starts sending. 12312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetLocalMonitor(bool enable) = 0; 12412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Installs a callback for raw frames from the local camera. 12512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 12612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<AudioCodec>& audio_codecs() = 0; 12712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<RtpHeaderExtension>& 12812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org audio_rtp_header_extensions() = 0; 12912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<VideoCodec>& video_codecs() = 0; 13012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<RtpHeaderExtension>& 13112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org video_rtp_header_extensions() = 0; 13212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 13312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Logging control 13412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void SetVoiceLogging(int min_sev, const char* filter) = 0; 13512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void SetVideoLogging(int min_sev, const char* filter) = 0; 13612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 13712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Starts AEC dump using existing file. 13812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool StartAecDump(rtc::PlatformFile file) = 0; 13912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 14012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Voice processors for effects. 14112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool RegisterVoiceProcessor(uint32 ssrc, 14212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* video_processor, 14312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) = 0; 14412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool UnregisterVoiceProcessor(uint32 ssrc, 14512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* video_processor, 14612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) = 0; 14712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 14812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoFormat GetStartCaptureFormat() const = 0; 14912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 15012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual sigslot::repeater2<VideoCapturer*, CaptureState>& 15112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org SignalVideoCaptureStateChange() = 0; 15212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 15312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 15412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 15512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#if !defined(DISABLE_MEDIA_ENGINE_FACTORY) 15612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass MediaEngineFactory { 15712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 15812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org typedef cricket::MediaEngineInterface* (*MediaEngineCreateFunction)(); 15912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Creates a media engine, using either the compiled system default or the 16012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // creation function specified in SetCreateFunction, if specified. 16112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org static MediaEngineInterface* Create(); 16212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // Sets the function used when calling Create. If unset, the compiled system 16312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // default will be used. Returns the old create function, or NULL if one 16412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // wasn't set. Likewise, NULL can be used as the |function| parameter to 16512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // reset to the default behavior. 16612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org static MediaEngineCreateFunction SetCreateFunction( 16712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaEngineCreateFunction function); 16812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org private: 16912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org static MediaEngineCreateFunction create_function_; 17012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 17112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#endif 17212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 17312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// CompositeMediaEngine constructs a MediaEngine from separate 17412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// voice and video engine classes. 17512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgtemplate<class VOICE, class VIDEO> 17612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass CompositeMediaEngine : public MediaEngineInterface { 17712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 17812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org CompositeMediaEngine() {} 17912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual ~CompositeMediaEngine() {} 18012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool Init(rtc::Thread* worker_thread) { 18112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org if (!voice_.Init(worker_thread)) 18212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return false; 18312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org if (!video_.Init(worker_thread)) { 18412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org voice_.Terminate(); 18512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return false; 18612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 18712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org SignalVideoCaptureStateChange().repeat(video_.SignalCaptureStateChange); 18812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return true; 18912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 19012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void Terminate() { 19112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org video_.Terminate(); 19212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org voice_.Terminate(); 19312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 19412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 19512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual int GetCapabilities() { 19612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return (voice_.GetCapabilities() | video_.GetCapabilities()); 19712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 19812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VoiceMediaChannel *CreateChannel() { 19912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.CreateChannel(); 20012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 20112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoMediaChannel *CreateVideoChannel(VoiceMediaChannel* channel) { 20212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.CreateChannel(channel); 20312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 20412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual SoundclipMedia *CreateSoundclip() { 20512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.CreateSoundclip(); 20612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 20712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 20812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual AudioOptions GetAudioOptions() const { 20912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.GetOptions(); 21012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 21112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetAudioOptions(const AudioOptions& options) { 21212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.SetOptions(options); 21312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 21412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetAudioDelayOffset(int offset) { 21512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.SetDelayOffset(offset); 21612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 21712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetDefaultVideoEncoderConfig(const VideoEncoderConfig& config) { 21812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.SetDefaultEncoderConfig(config); 21912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 22012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoEncoderConfig GetDefaultVideoEncoderConfig() const { 22112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.GetDefaultEncoderConfig(); 22212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 22312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 22412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetSoundDevices(const Device* in_device, 22512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const Device* out_device) { 22612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.SetDevices(in_device, out_device); 22712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 22812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 22912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool GetOutputVolume(int* level) { 23012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.GetOutputVolume(level); 23112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 23212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetOutputVolume(int level) { 23312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.SetOutputVolume(level); 23412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 23512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 23612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual int GetInputLevel() { 23712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.GetInputLevel(); 23812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 23912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool SetLocalMonitor(bool enable) { 24012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.SetLocalMonitor(enable); 24112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 24212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<AudioCodec>& audio_codecs() { 24312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.codecs(); 24412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 24512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<RtpHeaderExtension>& audio_rtp_header_extensions() { 24612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.rtp_header_extensions(); 24712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 24812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<VideoCodec>& video_codecs() { 24912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.codecs(); 25012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 25112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<RtpHeaderExtension>& video_rtp_header_extensions() { 25212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.rtp_header_extensions(); 25312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 25412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 25512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void SetVoiceLogging(int min_sev, const char* filter) { 25612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org voice_.SetLogging(min_sev, filter); 25712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 25812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual void SetVideoLogging(int min_sev, const char* filter) { 25912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org video_.SetLogging(min_sev, filter); 26012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 26112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 26212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool StartAecDump(rtc::PlatformFile file) { 26312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.StartAecDump(file); 26412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 26512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 26612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool RegisterVoiceProcessor(uint32 ssrc, 26712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* processor, 26812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) { 26912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.RegisterProcessor(ssrc, processor, direction); 27012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 27112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual bool UnregisterVoiceProcessor(uint32 ssrc, 27212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* processor, 27312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) { 27412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return voice_.UnregisterProcessor(ssrc, processor, direction); 27512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 27612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual VideoFormat GetStartCaptureFormat() const { 27712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return video_.GetStartCaptureFormat(); 27812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 27912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual sigslot::repeater2<VideoCapturer*, CaptureState>& 28012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org SignalVideoCaptureStateChange() { 28112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return signal_state_change_; 28212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 28312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 28412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org protected: 28512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VOICE voice_; 28612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VIDEO video_; 28712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org sigslot::repeater2<VideoCapturer*, CaptureState> signal_state_change_; 28812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 28912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 29012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// NullVoiceEngine can be used with CompositeMediaEngine in the case where only 29112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// a video engine is desired. 29212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass NullVoiceEngine { 29312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 29412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool Init(rtc::Thread* worker_thread) { return true; } 29512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org void Terminate() {} 29612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org int GetCapabilities() { return 0; } 29712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // If you need this to return an actual channel, use FakeMediaEngine instead. 29812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceMediaChannel* CreateChannel() { 29912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return NULL; 30012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 30112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org SoundclipMedia* CreateSoundclip() { 30212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return NULL; 30312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 30412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetDelayOffset(int offset) { return true; } 30512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org AudioOptions GetOptions() const { return AudioOptions(); } 30612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetOptions(const AudioOptions& options) { return true; } 30712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetDevices(const Device* in_device, const Device* out_device) { 30812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return true; 30912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 31012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool GetOutputVolume(int* level) { 31112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org *level = 0; 31212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return true; 31312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 31412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetOutputVolume(int level) { return true; } 31512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org int GetInputLevel() { return 0; } 31612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetLocalMonitor(bool enable) { return true; } 31712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const std::vector<AudioCodec>& codecs() { return codecs_; } 31812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const std::vector<RtpHeaderExtension>& rtp_header_extensions() { 31912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return rtp_header_extensions_; 32012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 32112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org void SetLogging(int min_sev, const char* filter) {} 32212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool StartAecDump(rtc::PlatformFile file) { return false; } 32312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool RegisterProcessor(uint32 ssrc, 32412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* voice_processor, 32512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) { return true; } 32612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool UnregisterProcessor(uint32 ssrc, 32712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceProcessor* voice_processor, 32812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org MediaProcessorDirection direction) { return true; } 32912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 33012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org private: 33112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org std::vector<AudioCodec> codecs_; 33212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org std::vector<RtpHeaderExtension> rtp_header_extensions_; 33312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 33412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 33512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// NullVideoEngine can be used with CompositeMediaEngine in the case where only 33612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org// a voice engine is desired. 33712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass NullVideoEngine { 33812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 33912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool Init(rtc::Thread* worker_thread) { return true; } 34012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org void Terminate() {} 34112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org int GetCapabilities() { return 0; } 34212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org // If you need this to return an actual channel, use FakeMediaEngine instead. 34312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VideoMediaChannel* CreateChannel( 34412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VoiceMediaChannel* voice_media_channel) { 34512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return NULL; 34612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 34712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetOptions(const VideoOptions& options) { return true; } 34812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VideoEncoderConfig GetDefaultEncoderConfig() const { 34912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return VideoEncoderConfig(); 35012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 35112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org bool SetDefaultEncoderConfig(const VideoEncoderConfig& config) { 35212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return true; 35312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 35412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const std::vector<VideoCodec>& codecs() { return codecs_; } 35512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org const std::vector<RtpHeaderExtension>& rtp_header_extensions() { 35612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org return rtp_header_extensions_; 35712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org } 35812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org void SetLogging(int min_sev, const char* filter) {} 35912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org VideoFormat GetStartCaptureFormat() const { return VideoFormat(); } 36012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 36112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org sigslot::signal2<VideoCapturer*, CaptureState> SignalCaptureStateChange; 36212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org private: 36312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org std::vector<VideoCodec> codecs_; 36412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org std::vector<RtpHeaderExtension> rtp_header_extensions_; 365e3c177a423baa3c30225c4e422b6f6c76d38b951machenbach@chromium.org}; 36612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 36712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgtypedef CompositeMediaEngine<NullVoiceEngine, NullVideoEngine> NullMediaEngine; 36812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 36912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgenum DataChannelType { 37012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org DCT_NONE = 0, 37112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org DCT_RTP = 1, 37212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org DCT_SCTP = 2 37312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 37412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 37512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.orgclass DataEngineInterface { 37612e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org public: 37712e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual ~DataEngineInterface() {} 37812e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual DataMediaChannel* CreateChannel(DataChannelType type) = 0; 37912e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org virtual const std::vector<DataCodec>& data_codecs() = 0; 38012e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org}; 38112e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 38212e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org} // namespace cricket 38312e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org 38412e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org#endif // TALK_MEDIA_BASE_MEDIAENGINE_H_ 38512e05e8fde625d746b998a15049e8487c43a3b17machenbach@chromium.org