| Index: content/renderer/media/video_capture_impl_manager.h
|
| diff --git a/content/renderer/media/video_capture_impl_manager.h b/content/renderer/media/video_capture_impl_manager.h
|
| index a03f609aea9462ae28f8a848217a8f1acb73c732..6b02825a7aa9e549fc72da4c79075f962f988fc5 100644
|
| --- a/content/renderer/media/video_capture_impl_manager.h
|
| +++ b/content/renderer/media/video_capture_impl_manager.h
|
| @@ -2,19 +2,17 @@
|
| // Use of this source code is governed by a BSD-style license that can be
|
| // found in the LICENSE file.
|
|
|
| -// TODO(hclam): This class should be renamed to VideoCaptureService.
|
| -
|
| -// This class provides access to a video capture device in the browser
|
| -// process through IPC. The main function is to deliver video frames
|
| -// to a client.
|
| +// VideoCaptureImplManager owns VideoCaptureImpl objects. Clients who
|
| +// want access to a video capture device call UseDevice() to get a handle
|
| +// to VideoCaptureImpl.
|
| //
|
| // THREADING
|
| //
|
| // VideoCaptureImplManager lives only on the render thread. All methods
|
| // must be called on this thread.
|
| //
|
| -// VideoFrames are delivered on the IO thread. Callbacks provided by
|
| -// a client are also called on the IO thread.
|
| +// The handle returned by UseDevice() is thread-safe. It ensures
|
| +// destruction is handled on the render thread.
|
|
|
| #ifndef CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_
|
| #define CONTENT_RENDERER_MEDIA_VIDEO_CAPTURE_IMPL_MANAGER_H_
|
| @@ -23,67 +21,60 @@
|
|
|
| #include "base/callback.h"
|
| #include "base/memory/linked_ptr.h"
|
| -#include "base/memory/ref_counted.h"
|
| #include "base/memory/scoped_ptr.h"
|
| #include "base/memory/weak_ptr.h"
|
| #include "base/message_loop/message_loop_proxy.h"
|
| #include "base/synchronization/lock.h"
|
| #include "base/threading/thread_checker.h"
|
| #include "content/common/content_export.h"
|
| -#include "content/common/media/video_capture.h"
|
| -#include "media/video/capture/video_capture_types.h"
|
| +#include "media/video/capture/video_capture.h"
|
|
|
| namespace content {
|
|
|
| class VideoCaptureImpl;
|
| +class VideoCaptureImplManager;
|
| class VideoCaptureMessageFilter;
|
| +
|
| +// Thread-safe wrapper for a media::VideoCapture object. During
|
| +// destruction |destruction_cb| is called. This mechanism is used
|
| +// by VideoCaptureImplManager to ensure de-initialization and
|
| +// destruction of the media::VideoCapture object happens on the render
|
| +// thread.
|
| +class CONTENT_EXPORT VideoCaptureHandle : media::VideoCapture {
|
| + public:
|
| + virtual ~VideoCaptureHandle();
|
| +
|
| + // media::VideoCapture implementations.
|
| + virtual void StartCapture(
|
| + EventHandler* handler,
|
| + const media::VideoCaptureParams& params) OVERRIDE;
|
| + virtual void StopCapture(EventHandler* handler) OVERRIDE;
|
| + virtual bool CaptureStarted() OVERRIDE;
|
| + virtual int CaptureFrameRate() OVERRIDE;
|
| + virtual void GetDeviceSupportedFormats(
|
| + const DeviceFormatsCallback& callback) OVERRIDE;
|
| + virtual void GetDeviceFormatsInUse(
|
| + const DeviceFormatsInUseCallback& callback) OVERRIDE;
|
| +
|
| + private:
|
| + friend class VideoCaptureImplManager;
|
| +
|
| + VideoCaptureHandle(media::VideoCapture* impl,
|
| + base::Closure destruction_cb);
|
| +
|
| + media::VideoCapture* impl_;
|
| + base::Closure destruction_cb_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(VideoCaptureHandle);
|
| +};
|
|
|
| class CONTENT_EXPORT VideoCaptureImplManager {
|
| public:
|
| VideoCaptureImplManager();
|
| virtual ~VideoCaptureImplManager();
|
|
|
| - // Open a device associated with the session ID.
|
| - // This method must be called before any methods with the same ID
|
| - // is used.
|
| - // Returns a callback that should be used to release the acquired
|
| - // resources.
|
| - base::Closure UseDevice(media::VideoCaptureSessionId id);
|
| -
|
| - // Start receiving video frames for the given session ID.
|
| - //
|
| - // |state_update_cb| will be called on the IO thread when capturing
|
| - // state changes.
|
| - // States will be one of the following four:
|
| - // * VIDEO_CAPTURE_STATE_STARTED
|
| - // * VIDEO_CAPTURE_STATE_STOPPED
|
| - // * VIDEO_CAPTURE_STATE_PAUSED
|
| - // * VIDEO_CAPTURE_STATE_ERROR
|
| - //
|
| - // |deliver_frame_cb| will be called on the IO thread when a video
|
| - // frame is ready.
|
| - //
|
| - // Returns a callback that is used to stop capturing. Note that stopping
|
| - // video capture is not synchronous. Client should handle the case where
|
| - // callbacks are called after capturing is instructed to stop, typically
|
| - // by binding the passed callbacks on a WeakPtr.
|
| - base::Closure StartCapture(
|
| - media::VideoCaptureSessionId id,
|
| - const media::VideoCaptureParams& params,
|
| - const VideoCaptureStateUpdateCB& state_update_cb,
|
| - const VideoCaptureDeliverFrameCB& deliver_frame_cb);
|
| -
|
| - // Get supported formats supported by the device for the given session
|
| - // ID. |callback| will be called on the IO thread.
|
| - void GetDeviceSupportedFormats(
|
| - media::VideoCaptureSessionId id,
|
| - const VideoCaptureDeviceFormatsCB& callback);
|
| -
|
| - // Get supported formats currently in use for the given session ID.
|
| - // |callback| will be called on the IO thread.
|
| - void GetDeviceFormatsInUse(
|
| - media::VideoCaptureSessionId id,
|
| - const VideoCaptureDeviceFormatsCB& callback);
|
| + // Returns a video capture device referenced by |id|.
|
| + scoped_ptr<VideoCaptureHandle> UseDevice(media::VideoCaptureSessionId id);
|
|
|
| // Make all existing VideoCaptureImpl instances stop/resume delivering
|
| // video frames to their clients, depends on flag |suspend|.
|
| @@ -94,26 +85,19 @@
|
| }
|
|
|
| protected:
|
| - virtual VideoCaptureImpl* CreateVideoCaptureImplForTesting(
|
| + // Used in tests to inject a mock VideoCaptureImpl.
|
| + virtual VideoCaptureImpl* CreateVideoCaptureImpl(
|
| media::VideoCaptureSessionId id,
|
| VideoCaptureMessageFilter* filter) const;
|
|
|
| private:
|
| - void StopCapture(int client_id, media::VideoCaptureSessionId id);
|
| void UnrefDevice(media::VideoCaptureSessionId id);
|
|
|
| // The int is used to count clients of the corresponding VideoCaptureImpl.
|
| - // VideoCaptureImpl objects are owned by this object. But they are
|
| - // destroyed on the IO thread. These are raw pointers because we destroy
|
| - // them manually.
|
| typedef std::map<media::VideoCaptureSessionId,
|
| - std::pair<int, VideoCaptureImpl*> >
|
| + std::pair<int, linked_ptr<VideoCaptureImpl> > >
|
| VideoCaptureDeviceMap;
|
| VideoCaptureDeviceMap devices_;
|
| -
|
| - // This is an internal ID for identifying clients of VideoCaptureImpl.
|
| - // The ID is global for the render process.
|
| - int next_client_id_;
|
|
|
| scoped_refptr<VideoCaptureMessageFilter> filter_;
|
|
|
|
|