Home | History | Annotate | Download | only in cast 
      1 // Copyright 2013 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef MEDIA_CAST_CAST_ENVIRONMENT_H_
      6 #define MEDIA_CAST_CAST_ENVIRONMENT_H_
      7 
      8 #include "base/basictypes.h"
      9 #include "base/memory/ref_counted.h"
     10 #include "base/memory/scoped_ptr.h"
     11 #include "base/task_runner.h"
     12 #include "base/time/tick_clock.h"
     13 #include "base/time/time.h"
     14 #include "media/cast/logging/logging_defines.h"
     15 #include "media/cast/logging/logging_impl.h"
     16 
     17 namespace media {
     18 namespace cast {
     19 
     20 class CastEnvironment : public base::RefCountedThreadSafe<CastEnvironment> {
     21  public:
     22   // An enumeration of the cast threads.
     23   enum ThreadId {
     24     // The main thread is where the cast system is configured and where timers
     25     // and network IO is performed.
     26     MAIN,
     27     // The audio encoder thread is where all send side audio processing is done,
     28     // primarily encoding but also re-sampling.
     29     AUDIO_ENCODER,
     30     // The audio decoder thread is where all receive side audio processing is
     31     // done, primarily decoding but also error concealment and re-sampling.
     32     AUDIO_DECODER,
     33     // The video encoder thread is where the video encode processing is done.
     34     VIDEO_ENCODER,
     35     // The video decoder thread is where the video decode processing is done.
     36     VIDEO_DECODER,
     37   };
     38 
     39   CastEnvironment(base::TickClock* clock,
     40                   scoped_refptr<base::TaskRunner> main_thread_proxy,
     41                   scoped_refptr<base::TaskRunner> audio_encode_thread_proxy,
     42                   scoped_refptr<base::TaskRunner> audio_decode_thread_proxy,
     43                   scoped_refptr<base::TaskRunner> video_encode_thread_proxy,
     44                   scoped_refptr<base::TaskRunner> video_decode_thread_proxy,
     45                   const CastLoggingConfig& config);
     46 
     47   // These are the same methods in message_loop.h, but are guaranteed to either
     48   // get posted to the MessageLoop if it's still alive, or be deleted otherwise.
     49   // They return true iff the thread existed and the task was posted.  Note that
     50   // even if the task is posted, there's no guarantee that it will run, since
     51   // the target thread may already have a Quit message in its queue.
     52   bool PostTask(ThreadId identifier,
     53                 const tracked_objects::Location& from_here,
     54                 const base::Closure& task);
     55 
     56   bool PostDelayedTask(ThreadId identifier,
     57                        const tracked_objects::Location& from_here,
     58                        const base::Closure& task,
     59                        base::TimeDelta delay);
     60 
     61   bool CurrentlyOn(ThreadId identifier);
     62 
     63   base::TickClock* Clock() const;
     64 
     65   // Logging is not thread safe. Should always be called from the main thread.
     66   LoggingImpl* Logging();
     67 
     68  protected:
     69   virtual ~CastEnvironment();
     70 
     71  private:
     72   friend class base::RefCountedThreadSafe<CastEnvironment>;
     73 
     74   scoped_refptr<base::TaskRunner> GetMessageTaskRunnerForThread(
     75       ThreadId identifier);
     76 
     77   base::TickClock* const clock_;  // Not owned by this class.
     78   scoped_refptr<base::TaskRunner> main_thread_proxy_;
     79   scoped_refptr<base::TaskRunner> audio_encode_thread_proxy_;
     80   scoped_refptr<base::TaskRunner> audio_decode_thread_proxy_;
     81   scoped_refptr<base::TaskRunner> video_encode_thread_proxy_;
     82   scoped_refptr<base::TaskRunner> video_decode_thread_proxy_;
     83 
     84   scoped_ptr<LoggingImpl> logging_;
     85 
     86   DISALLOW_COPY_AND_ASSIGN(CastEnvironment);
     87 };
     88 
     89 }  // namespace cast
     90 }  // namespace media
     91 
     92 #endif  // MEDIA_CAST_CAST_ENVIRONMENT_H_
     93