| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 // VideoCaptureImplManager owns VideoCaptureImpl objects. Clients who | 5 // VideoCaptureImplManager manages video capture devices in renderer process. |
| 6 // want access to a video capture device call UseDevice() to get a handle | 6 // The video capture clients use AddDevice() to get a pointer to |
| 7 // to VideoCaptureImpl. | 7 // video capture device. VideoCaputreImplManager supports multiple clients |
| 8 // | 8 // accessing same device. |
| 9 // THREADING | |
| 10 // | |
| 11 // VideoCaptureImplManager lives only on the render thread. All methods | |
| 12 // must be called on this thread. | |
| 13 // | |
| 14 // The handle returned by UseDevice() is thread-safe. It ensures | |
| 15 // destruction is handled on the render thread. | |
| 16 | 9 |
| 17 #ifndef CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ | 10 #ifndef CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ |
| 18 #define CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ | 11 #define CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ |
| 19 | 12 |
| 13 #include <list> |
| 20 #include <map> | 14 #include <map> |
| 21 | 15 |
| 22 #include "base/callback.h" | |
| 23 #include "base/memory/linked_ptr.h" | |
| 24 #include "base/memory/scoped_ptr.h" | |
| 25 #include "base/memory/weak_ptr.h" | |
| 26 #include "base/message_loop/message_loop_proxy.h" | 16 #include "base/message_loop/message_loop_proxy.h" |
| 17 #include "base/threading/thread.h" |
| 27 #include "base/synchronization/lock.h" | 18 #include "base/synchronization/lock.h" |
| 28 #include "base/threading/thread_checker.h" | |
| 29 #include "content/common/content_export.h" | 19 #include "content/common/content_export.h" |
| 30 #include "media/video/capture/video_capture.h" | 20 #include "media/video/capture/video_capture.h" |
| 31 | 21 |
| 32 namespace content { | 22 namespace content { |
| 33 | 23 |
| 34 class VideoCaptureImpl; | 24 class VideoCaptureImpl; |
| 35 class VideoCaptureImplManager; | |
| 36 class VideoCaptureMessageFilter; | 25 class VideoCaptureMessageFilter; |
| 37 | 26 |
| 38 // Thread-safe wrapper for a media::VideoCapture object. During | 27 class CONTENT_EXPORT VideoCaptureImplManager |
| 39 // destruction |destruction_cb| is called. This mechanism is used | 28 : public base::RefCountedThreadSafe<VideoCaptureImplManager> { |
| 40 // by VideoCaptureImplManager to ensure de-initialization and | |
| 41 // destruction of the media::VideoCapture object happens on the render | |
| 42 // thread. | |
| 43 class CONTENT_EXPORT VideoCaptureHandle : media::VideoCapture { | |
| 44 public: | |
| 45 virtual ~VideoCaptureHandle(); | |
| 46 | |
| 47 // media::VideoCapture implementations. | |
| 48 virtual void StartCapture( | |
| 49 EventHandler* handler, | |
| 50 const media::VideoCaptureParams& params) OVERRIDE; | |
| 51 virtual void StopCapture(EventHandler* handler) OVERRIDE; | |
| 52 virtual bool CaptureStarted() OVERRIDE; | |
| 53 virtual int CaptureFrameRate() OVERRIDE; | |
| 54 | |
| 55 private: | |
| 56 friend class VideoCaptureImplManager; | |
| 57 | |
| 58 VideoCaptureHandle(media::VideoCapture* impl, | |
| 59 base::Closure destruction_cb); | |
| 60 | |
| 61 media::VideoCapture* impl_; | |
| 62 base::Closure destruction_cb_; | |
| 63 | |
| 64 DISALLOW_COPY_AND_ASSIGN(VideoCaptureHandle); | |
| 65 }; | |
| 66 | |
| 67 class CONTENT_EXPORT VideoCaptureImplManager { | |
| 68 public: | 29 public: |
| 69 VideoCaptureImplManager(); | 30 VideoCaptureImplManager(); |
| 70 virtual ~VideoCaptureImplManager(); | |
| 71 | 31 |
| 72 // Returns a video capture device referenced by |id|. | 32 // Called by video capture client |handler| to add device referenced |
| 73 scoped_ptr<VideoCaptureHandle> UseDevice(media::VideoCaptureSessionId id); | 33 // by |id| to VideoCaptureImplManager's list of opened device list. |
| 34 // A pointer to VideoCapture is returned to client so that client can |
| 35 // operate on that pointer, such as StartCaptrue, StopCapture. |
| 36 virtual media::VideoCapture* AddDevice( |
| 37 media::VideoCaptureSessionId id, |
| 38 media::VideoCapture::EventHandler* handler); |
| 39 |
| 40 // Called by video capture client |handler| to remove device referenced |
| 41 // by |id| from VideoCaptureImplManager's list of opened device list. |
| 42 virtual void RemoveDevice(media::VideoCaptureSessionId id, |
| 43 media::VideoCapture::EventHandler* handler); |
| 74 | 44 |
| 75 // Make all existing VideoCaptureImpl instances stop/resume delivering | 45 // Make all existing VideoCaptureImpl instances stop/resume delivering |
| 76 // video frames to their clients, depends on flag |suspend|. | 46 // video frames to their clients, depends on flag |suspend|. |
| 77 void SuspendDevices(bool suspend); | 47 virtual void SuspendDevices(bool suspend); |
| 78 | 48 |
| 79 VideoCaptureMessageFilter* video_capture_message_filter() const { | 49 VideoCaptureMessageFilter* video_capture_message_filter() const { |
| 80 return filter_.get(); | 50 return filter_.get(); |
| 81 } | 51 } |
| 82 | 52 |
| 83 protected: | 53 protected: |
| 84 // Used in tests to inject a mock VideoCaptureImpl. | 54 virtual ~VideoCaptureImplManager(); |
| 85 virtual VideoCaptureImpl* CreateVideoCaptureImpl( | |
| 86 media::VideoCaptureSessionId id, | |
| 87 VideoCaptureMessageFilter* filter) const; | |
| 88 | 55 |
| 89 private: | 56 private: |
| 90 void UnrefDevice(media::VideoCaptureSessionId id); | 57 friend class base::RefCountedThreadSafe<VideoCaptureImplManager>; |
| 91 | 58 |
| 92 // The int is used to count clients of the corresponding VideoCaptureImpl. | 59 struct Device { |
| 93 typedef std::map<media::VideoCaptureSessionId, | 60 Device(VideoCaptureImpl* device, |
| 94 std::pair<int, linked_ptr<VideoCaptureImpl> > > | 61 media::VideoCapture::EventHandler* handler); |
| 95 VideoCaptureDeviceMap; | 62 ~Device(); |
| 96 VideoCaptureDeviceMap devices_; | |
| 97 | 63 |
| 64 VideoCaptureImpl* vc; |
| 65 std::list<media::VideoCapture::EventHandler*> clients; |
| 66 }; |
| 67 |
| 68 void FreeDevice(VideoCaptureImpl* vc); |
| 69 |
| 70 typedef std::map<media::VideoCaptureSessionId, Device*> Devices; |
| 71 Devices devices_; |
| 72 base::Lock lock_; |
| 98 scoped_refptr<VideoCaptureMessageFilter> filter_; | 73 scoped_refptr<VideoCaptureMessageFilter> filter_; |
| 99 | 74 base::Thread thread_; |
| 100 // Following two members are bound to the render thread. | 75 scoped_refptr<base::MessageLoopProxy> message_loop_proxy_; |
| 101 base::WeakPtrFactory<VideoCaptureImplManager> weak_factory_; | |
| 102 base::ThreadChecker thread_checker_; | |
| 103 | 76 |
| 104 DISALLOW_COPY_AND_ASSIGN(VideoCaptureImplManager); | 77 DISALLOW_COPY_AND_ASSIGN(VideoCaptureImplManager); |
| 105 }; | 78 }; |
| 106 | 79 |
| 107 } // namespace content | 80 } // namespace content |
| 108 | 81 |
| 109 #endif // CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ | 82 #endif // CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_ |
| OLD | NEW |