1 /* 2 * libjingle 3 * Copyright 2014 Google Inc. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #ifndef TALK_APP_WEBRTC_REMOTEAUDIOSOURCE_H_ 29 #define TALK_APP_WEBRTC_REMOTEAUDIOSOURCE_H_ 30 31 #include <list> 32 #include <string> 33 34 #include "talk/app/webrtc/mediastreaminterface.h" 35 #include "talk/app/webrtc/notifier.h" 36 #include "talk/media/base/audiorenderer.h" 37 #include "webrtc/audio/audio_sink.h" 38 #include "webrtc/base/criticalsection.h" 39 40 namespace rtc { 41 struct Message; 42 class Thread; 43 } // namespace rtc 44 45 namespace webrtc { 46 47 class AudioProviderInterface; 48 49 // This class implements the audio source used by the remote audio track. 50 class RemoteAudioSource : public Notifier<AudioSourceInterface> { 51 public: 52 // Creates an instance of RemoteAudioSource. 53 static rtc::scoped_refptr<RemoteAudioSource> Create( 54 uint32_t ssrc, 55 AudioProviderInterface* provider); 56 57 // MediaSourceInterface implementation. 58 MediaSourceInterface::SourceState state() const override; 59 bool remote() const override; 60 61 void AddSink(AudioTrackSinkInterface* sink) override; 62 void RemoveSink(AudioTrackSinkInterface* sink) override; 63 64 protected: 65 RemoteAudioSource(); 66 ~RemoteAudioSource() override; 67 68 // Post construction initialize where we can do things like save a reference 69 // to ourselves (need to be fully constructed). 70 void Initialize(uint32_t ssrc, AudioProviderInterface* provider); 71 72 private: 73 typedef std::list<AudioObserver*> AudioObserverList; 74 75 // AudioSourceInterface implementation. 76 void SetVolume(double volume) override; 77 void RegisterAudioObserver(AudioObserver* observer) override; 78 void UnregisterAudioObserver(AudioObserver* observer) override; 79 80 class Sink; 81 void OnData(const AudioSinkInterface::Data& audio); 82 void OnAudioProviderGone(); 83 84 class MessageHandler; 85 void OnMessage(rtc::Message* msg); 86 87 AudioObserverList audio_observers_; 88 rtc::CriticalSection sink_lock_; 89 std::list<AudioTrackSinkInterface*> sinks_; 90 rtc::Thread* const main_thread_; 91 SourceState state_; 92 }; 93 94 } // namespace webrtc 95 96 #endif // TALK_APP_WEBRTC_REMOTEAUDIOSOURCE_H_ 97