null_video_sink.h 3.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. // Copyright 2015 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. #ifndef MEDIA_BASE_NULL_VIDEO_SINK_H_
  5. #define MEDIA_BASE_NULL_VIDEO_SINK_H_
  6. #include "base/cancelable_callback.h"
  7. #include "base/memory/raw_ptr.h"
  8. #include "base/time/default_tick_clock.h"
  9. #include "base/time/tick_clock.h"
  10. #include "base/time/time.h"
  11. #include "media/base/media_export.h"
  12. #include "media/base/video_renderer_sink.h"
  13. namespace base {
  14. class SingleThreadTaskRunner;
  15. }
  16. namespace media {
  17. class MEDIA_EXPORT NullVideoSink : public VideoRendererSink {
  18. public:
  19. using NewFrameCB = base::RepeatingCallback<void(scoped_refptr<VideoFrame>)>;
  20. // Periodically calls |callback| every |interval| on |task_runner| once the
  21. // sink has been started. If |clockless| is true, the RenderCallback will
  22. // be called back to back by repeated post tasks. Optionally, if specified,
  23. // |new_frame_cb| will be called for each new frame received.
  24. NullVideoSink(bool clockless,
  25. base::TimeDelta interval,
  26. const NewFrameCB& new_frame_cb,
  27. const scoped_refptr<base::SingleThreadTaskRunner>& task_runner);
  28. NullVideoSink(const NullVideoSink&) = delete;
  29. NullVideoSink& operator=(const NullVideoSink&) = delete;
  30. ~NullVideoSink() override;
  31. // VideoRendererSink implementation.
  32. void Start(RenderCallback* callback) override;
  33. void Stop() override;
  34. void PaintSingleFrame(scoped_refptr<VideoFrame> frame,
  35. bool repaint_duplicate_frame) override;
  36. void set_tick_clock_for_testing(const base::TickClock* tick_clock) {
  37. tick_clock_ = tick_clock;
  38. }
  39. // Sets |stop_cb_|, which will be fired when Stop() is called.
  40. void set_stop_cb(base::OnceClosure stop_cb) { stop_cb_ = std::move(stop_cb); }
  41. bool is_started() const { return started_; }
  42. void set_background_render(bool is_background_rendering) {
  43. background_render_ = is_background_rendering;
  44. }
  45. void set_clockless(bool clockless) { clockless_ = clockless; }
  46. private:
  47. // Task that periodically calls Render() to consume video data.
  48. void CallRender();
  49. bool clockless_;
  50. const base::TimeDelta interval_;
  51. const NewFrameCB new_frame_cb_;
  52. scoped_refptr<base::SingleThreadTaskRunner> task_runner_;
  53. bool started_;
  54. raw_ptr<RenderCallback> callback_;
  55. // Manages cancellation of periodic Render() callback task.
  56. base::CancelableRepeatingClosure cancelable_worker_;
  57. // Used to determine when a new frame is received.
  58. scoped_refptr<VideoFrame> last_frame_;
  59. // Used to determine the interval given to RenderCallback::Render() as well as
  60. // to maintain stable periodicity of callbacks.
  61. base::TimeTicks current_render_time_;
  62. // Allow for an injectable tick clock for testing.
  63. base::TimeTicks last_now_;
  64. // If specified, used instead of a DefaultTickClock.
  65. raw_ptr<const base::TickClock> tick_clock_;
  66. // If set, called when Stop() is called.
  67. base::OnceClosure stop_cb_;
  68. // Value passed to RenderCallback::Render().
  69. bool background_render_;
  70. };
  71. } // namespace media
  72. #endif // MEDIA_BASE_NULL_VIDEO_SINK_H_