6cd6d8ecfd
Adds new class DecodeSynchronizer that will coalesce the decoding of received streams on the metronome. This feature is experimental and is backed by a field trial WebRTC-FrameBuffer3. This experiment now has 3 arms to it, "WebRTC-FrameBuffer3/arm:FrameBuffer2/": Default, uses old frame buffer. "WebRTC-FrameBuffer3/arm:FrameBuffer3/": Uses new frame buffer. "WebRTC-FrameBuffer3/arm:SyncDecoding/": Uses new frame buffer with frame scheduled on the metronome. The SyncDecoding arm will not work until it is wired up in the follow-up CL. This change also makes the following modifications, * Adds FakeMetronome utilities for tests using a metronome. * Makes FrameDecodeScheduler an interface. The default implementation is TaskQueueFrameDecodeScheduler. * FrameDecodeScheduler now has a Stop() method, which must be called before destruction. TBR=philipel@webrtc.org Change-Id: I58a306bb883604b0be3eb2a04b3d07dbdf185c71 Bug: webrtc:13658 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/250665 Reviewed-by: Henrik Boström <hbos@webrtc.org> Reviewed-by: Ilya Nikolaevskiy <ilnik@webrtc.org> Reviewed-by: Stefan Holmer <holmer@google.com> Reviewed-by: Stefan Holmer <stefan@webrtc.org> Commit-Queue: Evan Shrubsole <eshr@webrtc.org> Cr-Commit-Position: refs/heads/main@{#35988}
52 lines
1.6 KiB
C++
52 lines
1.6 KiB
C++
/*
|
|
* Copyright (c) 2022 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef VIDEO_FRAME_DECODE_SCHEDULER_H_
|
|
#define VIDEO_FRAME_DECODE_SCHEDULER_H_
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <functional>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/units/timestamp.h"
|
|
#include "video/frame_decode_timing.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class FrameDecodeScheduler {
|
|
public:
|
|
// Invoked when a frame with `rtp_timestamp` is ready for decoding.
|
|
using FrameReleaseCallback =
|
|
std::function<void(uint32_t rtp_timestamp, Timestamp render_time)>;
|
|
|
|
virtual ~FrameDecodeScheduler() = default;
|
|
|
|
// Returns the rtp timestamp of the next frame scheduled for release, or
|
|
// `nullopt` if no frame is currently scheduled.
|
|
virtual absl::optional<uint32_t> ScheduledRtpTimestamp() = 0;
|
|
|
|
// Shedules a frame for release based on `schedule`. When released, `callback`
|
|
// will be invoked with the `rtp` timestamp of the frame and the `render_time`
|
|
virtual void ScheduleFrame(uint32_t rtp,
|
|
FrameDecodeTiming::FrameSchedule schedule,
|
|
FrameReleaseCallback callback) = 0;
|
|
|
|
// Cancels all scheduled frames.
|
|
virtual void CancelOutstanding() = 0;
|
|
|
|
// Stop() Must be called before destruction.
|
|
virtual void Stop() = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // VIDEO_FRAME_DECODE_SCHEDULER_H_
|