media/video/capture/video_capture_device_factory.h

   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 MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_DEVICE_FACTORY_H_
   6 #define MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_DEVICE_FACTORY_H_
   7
   8 #include "base/threading/thread_checker.h"
   9 #include "media/video/capture/video_capture_device.h"
  10
  11 namespace media {
  12
  13 // VideoCaptureDeviceFactory is the base class for creation of video capture
  14 // devices in the different platforms. VCDFs are created by MediaStreamManager
  15 // on IO thread and plugged into VideoCaptureManager, who owns and operates them
  16 // in Device Thread (a.k.a. Audio Thread).
  17 class MEDIA_EXPORT VideoCaptureDeviceFactory {
  18  public:
  19   static scoped_ptr<VideoCaptureDeviceFactory> CreateFactory();
  20
  21   VideoCaptureDeviceFactory();
  22   virtual ~VideoCaptureDeviceFactory();
  23
  24   // Creates a VideoCaptureDevice object. Returns NULL if something goes wrong.
  25   virtual scoped_ptr<VideoCaptureDevice> Create(
  26       scoped_refptr<base::SingleThreadTaskRunner> ui_task_runner,
  27       const VideoCaptureDevice::Name& device_name);
  28
  29   // Gets the names of all video capture devices connected to this computer.
  30   virtual void GetDeviceNames(VideoCaptureDevice::Names* device_names);
  31
  32   // Gets the supported formats of a particular device attached to the system.
  33   // This method should be called before allocating or starting a device. In
  34   // case format enumeration is not supported, or there was a problem, the
  35   // formats array will be empty.
  36   virtual void GetDeviceSupportedFormats(
  37       const VideoCaptureDevice::Name& device,
  38       VideoCaptureFormats* supported_formats);
  39
  40  protected:
  41   base::ThreadChecker thread_checker_;
  42
  43  private:
  44   DISALLOW_COPY_AND_ASSIGN(VideoCaptureDeviceFactory);
  45 };
  46
  47 }  // namespace media
  48
  49 #endif  // MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_DEVICE_FACTORY_H_