Home | History | Annotate | Download | only in media 
      1 // Copyright 2014 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 CONTENT_RENDERER_MEDIA_MEDIA_STREAM_VIDEO_CAPTURER_SOURCE_H_
      6 #define CONTENT_RENDERER_MEDIA_MEDIA_STREAM_VIDEO_CAPTURER_SOURCE_H_
      7 
      8 #include "base/callback.h"
      9 #include "base/gtest_prod_util.h"
     10 #include "base/message_loop/message_loop_proxy.h"
     11 #include "base/threading/thread_checker.h"
     12 #include "content/common/media/video_capture.h"
     13 #include "content/renderer/media/media_stream_video_source.h"
     14 
     15 namespace content {
     16 
     17 // VideoCapturerDelegate is a delegate used by MediaStreamVideoCapturerSource
     18 // for local video capturer. It uses VideoCaptureImplManager to start / stop
     19 // and receive I420 frames from Chrome's video capture implementation.
     20 //
     21 // This is a render thread only object.
     22 class CONTENT_EXPORT VideoCapturerDelegate
     23     : public base::RefCountedThreadSafe<VideoCapturerDelegate> {
     24  public:
     25   typedef base::Callback<void(MediaStreamRequestResult result)> RunningCallback;
     26 
     27   explicit VideoCapturerDelegate(const StreamDeviceInfo& device_info);
     28 
     29   // Collects the formats that can currently be used.
     30   // |max_requested_height|, |max_requested_width|, and
     31   // |max_requested_frame_rate| is used by Tab and Screen capture to decide what
     32   // resolution/framerate to generate. |callback| is triggered when the formats
     33   // have been collected.
     34   virtual void GetCurrentSupportedFormats(
     35       int max_requested_width,
     36       int max_requested_height,
     37       double max_requested_frame_rate,
     38       const VideoCaptureDeviceFormatsCB& callback);
     39 
     40   // Starts capturing frames using the resolution in |params|.
     41   // |new_frame_callback| is triggered when a new video frame is available.
     42   // If capturing is started successfully then |running_callback| will be
     43   // called with a parameter of true.
     44   // If capturing fails to start or stopped due to an external event then
     45   // |running_callback| will be called with a parameter of false.
     46   virtual void StartCapture(
     47       const media::VideoCaptureParams& params,
     48       const VideoCaptureDeliverFrameCB& new_frame_callback,
     49       const RunningCallback& running_callback);
     50 
     51   // Stops capturing frames and clears all callbacks including the
     52   // SupportedFormatsCallback callback.
     53   virtual void StopCapture();
     54 
     55  private:
     56   FRIEND_TEST_ALL_PREFIXES(MediaStreamVideoCapturerSourceTest, Ended);
     57   friend class base::RefCountedThreadSafe<VideoCapturerDelegate>;
     58   friend class MockVideoCapturerDelegate;
     59 
     60   virtual ~VideoCapturerDelegate();
     61 
     62   void OnStateUpdateOnRenderThread(VideoCaptureState state);
     63   void OnDeviceFormatsInUseReceived(const media::VideoCaptureFormats& formats);
     64   void OnDeviceSupportedFormatsEnumerated(
     65       const media::VideoCaptureFormats& formats);
     66 
     67   // The id identifies which video capture device is used for this video
     68   // capture session.
     69   media::VideoCaptureSessionId session_id_;
     70   base::Closure release_device_cb_;
     71   base::Closure stop_capture_cb_;
     72 
     73   bool is_screen_cast_;
     74 
     75   // |running_callback| is provided to this class in StartCapture and must be
     76   // valid until StopCapture is called.
     77   RunningCallback running_callback_;
     78 
     79   VideoCaptureDeviceFormatsCB source_formats_callback_;
     80 
     81   // Bound to the render thread.
     82   base::ThreadChecker thread_checker_;
     83 
     84   DISALLOW_COPY_AND_ASSIGN(VideoCapturerDelegate);
     85 };
     86 
     87 // Owned by WebMediaStreamSource in Blink as a representation of a video
     88 // stream coming from a camera.
     89 // This is a render thread only object. All methods must be called on the
     90 // render thread.
     91 class CONTENT_EXPORT MediaStreamVideoCapturerSource
     92     : public MediaStreamVideoSource {
     93  public:
     94   MediaStreamVideoCapturerSource(
     95       const StreamDeviceInfo& device_info,
     96       const SourceStoppedCallback& stop_callback,
     97       const scoped_refptr<VideoCapturerDelegate>& delegate);
     98 
     99   virtual ~MediaStreamVideoCapturerSource();
    100 
    101  protected:
    102   // Implements MediaStreamVideoSource.
    103   virtual void GetCurrentSupportedFormats(
    104       int max_requested_width,
    105       int max_requested_height,
    106       double max_requested_frame_rate,
    107       const VideoCaptureDeviceFormatsCB& callback) OVERRIDE;
    108 
    109   virtual void StartSourceImpl(
    110       const media::VideoCaptureFormat& format,
    111       const VideoCaptureDeliverFrameCB& frame_callback) OVERRIDE;
    112 
    113   virtual void StopSourceImpl() OVERRIDE;
    114 
    115  private:
    116   // The delegate that provides video frames.
    117   scoped_refptr<VideoCapturerDelegate> delegate_;
    118 
    119   DISALLOW_COPY_AND_ASSIGN(MediaStreamVideoCapturerSource);
    120 };
    121 
    122 }  // namespace content
    123 
    124 #endif  // CONTENT_RENDERER_MEDIA_MEDIA_STREAM_VIDEO_CAPTURER_SOURCE_H_
    125