Home | History | Annotate | Download | only in media 
      1 /*
      2  * libjingle
      3  * Copyright 2005 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 // Class to collect statistics from a media channel
     29 
     30 #ifndef TALK_SESSION_MEDIA_MEDIAMONITOR_H_
     31 #define TALK_SESSION_MEDIA_MEDIAMONITOR_H_
     32 
     33 #include "talk/base/criticalsection.h"
     34 #include "talk/base/sigslot.h"
     35 #include "talk/base/thread.h"
     36 #include "talk/media/base/mediachannel.h"
     37 
     38 namespace cricket {
     39 
     40 // The base MediaMonitor class, independent of voice and video.
     41 class MediaMonitor : public talk_base::MessageHandler,
     42     public sigslot::has_slots<> {
     43  public:
     44   MediaMonitor(talk_base::Thread* worker_thread,
     45                talk_base::Thread* monitor_thread);
     46   ~MediaMonitor();
     47 
     48   void Start(uint32 milliseconds);
     49   void Stop();
     50 
     51  protected:
     52   void OnMessage(talk_base::Message *message);
     53   void PollMediaChannel();
     54   virtual void GetStats() = 0;
     55   virtual void Update() = 0;
     56 
     57   talk_base::CriticalSection crit_;
     58   talk_base::Thread* worker_thread_;
     59   talk_base::Thread* monitor_thread_;
     60   bool monitoring_;
     61   uint32 rate_;
     62 };
     63 
     64 // Templatized MediaMonitor that can deal with different kinds of media.
     65 template<class MC, class MI>
     66 class MediaMonitorT : public MediaMonitor {
     67  public:
     68   MediaMonitorT(MC* media_channel, talk_base::Thread* worker_thread,
     69                 talk_base::Thread* monitor_thread)
     70       : MediaMonitor(worker_thread, monitor_thread),
     71         media_channel_(media_channel) {}
     72   sigslot::signal2<MC*, const MI&> SignalUpdate;
     73 
     74  protected:
     75   // These routines assume the crit_ lock is held by the calling thread.
     76   virtual void GetStats() {
     77     media_info_.Clear();
     78     media_channel_->GetStats(&media_info_);
     79   }
     80   virtual void Update() {
     81     MI stats(media_info_);
     82     crit_.Leave();
     83     SignalUpdate(media_channel_, stats);
     84     crit_.Enter();
     85   }
     86 
     87  private:
     88   MC* media_channel_;
     89   MI media_info_;
     90 };
     91 
     92 typedef MediaMonitorT<VoiceMediaChannel, VoiceMediaInfo> VoiceMediaMonitor;
     93 typedef MediaMonitorT<VideoMediaChannel, VideoMediaInfo> VideoMediaMonitor;
     94 typedef MediaMonitorT<DataMediaChannel, DataMediaInfo> DataMediaMonitor;
     95 
     96 }  // namespace cricket
     97 
     98 #endif  // TALK_SESSION_MEDIA_MEDIAMONITOR_H_
     99