Index: media/base/video_capturer_source.h |
diff --git a/media/base/video_capturer_source.h b/media/base/video_capturer_source.h |
deleted file mode 100644 |
index 760530176d13ac0682a4ca5b1fb7821956652ee7..0000000000000000000000000000000000000000 |
--- a/media/base/video_capturer_source.h |
+++ /dev/null |
@@ -1,121 +0,0 @@ |
-// Copyright 2015 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_BASE_VIDEO_CAPTURER_SOURCE_H_ |
-#define MEDIA_BASE_VIDEO_CAPTURER_SOURCE_H_ |
- |
-#include <string> |
-#include <vector> |
- |
-#include "base/callback.h" |
-#include "base/memory/ref_counted.h" |
-#include "base/time/time.h" |
-#include "media/base/media_export.h" |
-#include "media/base/video_capture_types.h" |
- |
-namespace media { |
- |
-class VideoFrame; |
- |
-// VideoCapturerSource is an interface representing the source for captured |
-// video. An implementation will periodically call the frame callback with new |
-// video frames. |
-class MEDIA_EXPORT VideoCapturerSource { |
- public: |
- virtual ~VideoCapturerSource(); |
- |
- // This callback is used to deliver video frames. |
- // |
- // |estimated_capture_time| - The capture time of the delivered video |
- // frame. This field represents the local time at which either: 1) the frame |
- // was generated, if it was done so locally; or 2) the targeted play-out time |
- // of the frame, if it was generated from a remote source. Either way, an |
- // implementation should not present the frame before this point-in-time. This |
- // value is NOT a high-resolution timestamp, and so it should not be used as a |
- // presentation time; but, instead, it should be used for buffering playback |
- // and for A/V synchronization purposes. NOTE: It is possible for this value |
- // to be null if the current implementation lacks this timing information. |
- // |
- // |video_frame->timestamp()| gives the presentation timestamp of the video |
- // frame relative to the first frame generated by the corresponding source. |
- // Because a source can start generating frames before a subscriber is added, |
- // the first video frame delivered may not have timestamp equal to 0. |
- using VideoCaptureDeliverFrameCB = |
- base::Callback<void(const scoped_refptr<media::VideoFrame>& video_frame, |
- base::TimeTicks estimated_capture_time)>; |
- |
- using VideoCaptureDeviceFormatsCB = |
- base::Callback<void(const media::VideoCaptureFormats&)>; |
- |
- using RunningCallback = base::Callback<void(bool)>; |
- |
- // Collects the formats that can currently be used. |
- // |max_requested_height|, |max_requested_width|, and |
- // |max_requested_frame_rate| is used by Tab and Screen capture to decide what |
- // resolution/framerate to generate. |callback| is triggered when the formats |
- // have been collected. |
- virtual void GetCurrentSupportedFormats( |
- int max_requested_width, |
- int max_requested_height, |
- double max_requested_frame_rate, |
- const VideoCaptureDeviceFormatsCB& callback) = 0; |
- |
- // Starts capturing frames using the capture |params|. |new_frame_callback| is |
- // triggered when a new video frame is available. |
- // If capturing is started successfully then |running_callback| will be |
- // called with a parameter of true. Note that some implementations may |
- // simply reject StartCapture (by calling running_callback with a false |
- // argument) if called with the wrong task runner. |
- // If capturing fails to start or stopped due to an external event then |
- // |running_callback| will be called with a parameter of false. |
- // |running_callback| will always be called on the same thread as the |
- // StartCapture. |
- virtual void StartCapture( |
- const media::VideoCaptureParams& params, |
- const VideoCaptureDeliverFrameCB& new_frame_callback, |
- const RunningCallback& running_callback) = 0; |
- |
- // Asks source to send a refresh frame. In cases where source does not provide |
- // a continuous rate of new frames (e.g. canvas capture, screen capture where |
- // the screen's content has not changed in a while), consumers may request a |
- // "refresh frame" to be delivered. For instance, this would be needed when |
- // a new sink is added to a MediaStreamTrack. |
- // |
- // The default implementation is a no-op and implementations are not required |
- // to honor this request. If they decide to and capturing is started |
- // successfully, then |new_frame_callback| should be called with a frame. |
- // |
- // Note: This should only be called after StartCapture() and before |
- // StopCapture(). Otherwise, its behavior is undefined. |
- virtual void RequestRefreshFrame() {} |
- |
- // Optionally suspends frame delivery. The source may or may not honor this |
- // request. Thus, the caller cannot assume frame delivery will actually |
- // stop. Even if frame delivery is suspended, this might not take effect |
- // immediately. |
- // |
- // The purpose of this is to allow minimizing resource usage while |
- // there are no frame consumers present. |
- // |
- // Note: This should only be called after StartCapture() and before |
- // StopCapture(). Otherwise, its behavior is undefined. |
- virtual void MaybeSuspend() {} |
- |
- // Resumes frame delivery, if it was suspended. If frame delivery was not |
- // suspended, this is a no-op, and frame delivery will continue. |
- // |
- // Note: This should only be called after StartCapture() and before |
- // StopCapture(). Otherwise, its behavior is undefined. |
- virtual void Resume() {} |
- |
- // Stops capturing frames and clears all callbacks including the |
- // SupportedFormatsCallback callback. Note that queued frame callbacks |
- // may still occur after this call, so the caller must take care to |
- // use refcounted or weak references in |new_frame_callback|. |
- virtual void StopCapture() = 0; |
-}; |
- |
-} // namespace media |
- |
-#endif // MEDIA_BASE_VIDEO_CAPTURER_SOURCE_H_ |