Cast Streaming API end-to-end browser_test.

media/cast/cast_environment.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef MEDIA_CAST_CAST_ENVIRONMENT_H_
 #define MEDIA_CAST_CAST_ENVIRONMENT_H_
 
 #include "base/basictypes.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/single_thread_task_runner.h"
+#include "base/synchronization/lock.h"
 #include "base/time/tick_clock.h"
 #include "base/time/time.h"
 #include "media/cast/logging/logging_defines.h"
 #include "media/cast/logging/logging_impl.h"
 
+namespace base {
+class Thread;
+}
+
 namespace media {
 namespace cast {
 
 class CastEnvironment : public base::RefCountedThreadSafe<CastEnvironment> {
  public:
   // An enumeration of the cast threads.
   enum ThreadId {
     // The main thread is where the cast system is configured and where timers
     // and network IO is performed.
     MAIN,
     // The audio encoder thread is where all send side audio processing is done,
     // primarily encoding but also re-sampling.
     AUDIO_ENCODER,
     // The audio decoder thread is where all receive side audio processing is
     // done, primarily decoding but also error concealment and re-sampling.
     AUDIO_DECODER,
     // The video encoder thread is where the video encode processing is done.
     VIDEO_ENCODER,
     // The video decoder thread is where the video decode processing is done.
     VIDEO_DECODER,
     // The transport thread is where the transport processing is done.
     TRANSPORT,
   };
 
+  // Use these constructors to create a standalone CastEnvironment. They use
+  // base::DefaultTickClock, and all task runners are created on-demand.
+  CastEnvironment();  // No logging.

[hubbe, 2014/03/04 22:42:26]

This is only used for testing.
Seems better to keep it out of the production code.

[miu, 2014/03/06 06:09:15]

Done.

+  explicit CastEnvironment(const CastLoggingConfig& logging_config);
+
+  // Use this constructor to create a CastEnvironment that integrates with an
+  // existing environment, such as content::BrowserThread, or a test/simulation
+  // framework. It is valid for any of the proxy args to be NULL for any task
+  // runners that will not be used.
   CastEnvironment(
       scoped_ptr<base::TickClock> clock,
       scoped_refptr<base::SingleThreadTaskRunner> main_thread_proxy,
       scoped_refptr<base::SingleThreadTaskRunner> audio_encode_thread_proxy,
       scoped_refptr<base::SingleThreadTaskRunner> audio_decode_thread_proxy,
       scoped_refptr<base::SingleThreadTaskRunner> video_encode_thread_proxy,
       scoped_refptr<base::SingleThreadTaskRunner> video_decode_thread_proxy,
       scoped_refptr<base::SingleThreadTaskRunner> transport_thread_proxy,
-      const CastLoggingConfig& config);
+      const CastLoggingConfig& logging_config);
 
   // These are the same methods in message_loop.h, but are guaranteed to either
   // get posted to the MessageLoop if it's still alive, or be deleted otherwise.
   // They return true iff the thread existed and the task was posted.  Note that
   // even if the task is posted, there's no guarantee that it will run, since
   // the target thread may already have a Quit message in its queue.
   bool PostTask(ThreadId identifier,
                 const tracked_objects::Location& from_here,
                 const base::Closure& task);
 
   bool PostDelayedTask(ThreadId identifier,
                        const tracked_objects::Location& from_here,
                        const base::Closure& task,
                        base::TimeDelta delay);
 
   bool CurrentlyOn(ThreadId identifier);
 
-  base::TickClock* Clock() const;
+  // All of the media::cast implementation must use this TickClock.
+  base::TickClock* Clock() const { return clock_.get(); }
 
-  // Logging is not thread safe. Should always be called from the main thread.
-  LoggingImpl* Logging();
+  // Logging is not thread safe. Its methods should always be called from the
+  // main thread.
+  LoggingImpl* Logging() const { return logging_.get(); }
 
   scoped_refptr<base::SingleThreadTaskRunner>
       GetMessageSingleThreadTaskRunnerForThread(ThreadId identifier);
 
   bool HasAudioEncoderThread() {
     return audio_encode_thread_proxy_ ? true : false;
   }
 
   bool HasVideoEncoderThread() {
     return video_encode_thread_proxy_ ? true : false;
   }
 
  protected:
   virtual ~CastEnvironment();
 
  private:
   friend class base::RefCountedThreadSafe<CastEnvironment>;
 
   scoped_ptr<base::TickClock> clock_;
   scoped_refptr<base::SingleThreadTaskRunner> main_thread_proxy_;
   scoped_refptr<base::SingleThreadTaskRunner> audio_encode_thread_proxy_;
   scoped_refptr<base::SingleThreadTaskRunner> audio_decode_thread_proxy_;
   scoped_refptr<base::SingleThreadTaskRunner> video_encode_thread_proxy_;
   scoped_refptr<base::SingleThreadTaskRunner> video_decode_thread_proxy_;
   scoped_refptr<base::SingleThreadTaskRunner> transport_thread_proxy_;
 
   scoped_ptr<LoggingImpl> logging_;
 
+  // Auto-created threads for missing task runners, with the one-time creation
+  // action protected by a lock.
+  base::Lock create_lock_;
+  scoped_ptr<base::Thread> main_thread_;
+  scoped_ptr<base::Thread> audio_encode_thread_;
+  scoped_ptr<base::Thread> audio_decode_thread_;
+  scoped_ptr<base::Thread> video_encode_thread_;
+  scoped_ptr<base::Thread> video_decode_thread_;
+  scoped_ptr<base::Thread> transport_thread_;
+
   DISALLOW_COPY_AND_ASSIGN(CastEnvironment);
 };
 
 }  // namespace cast
 }  // namespace media
 
 #endif  // MEDIA_CAST_CAST_ENVIRONMENT_H_