blob: d8ba8633a58d4d0f465ecec3c4b8329c8af440a3 [file] [log] [blame]
philipelbe7a9e52016-05-19 12:19:35 +02001/*
2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "modules/video_coding/frame_buffer2.h"
philipelbe7a9e52016-05-19 12:19:35 +020012
13#include <algorithm>
14#include <cstring>
15#include <limits>
Mirko Bonadei317a1f02019-09-17 17:06:18 +020016#include <memory>
philipelbe7a9e52016-05-19 12:19:35 +020017#include <vector>
18
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010019#include "api/units/time_delta.h"
20#include "api/units/timestamp.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "modules/video_coding/frame_object.h"
22#include "modules/video_coding/jitter_estimator.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020023#include "modules/video_coding/timing.h"
Bjorn Tereliusa194e582017-10-25 13:07:09 +020024#include "rtc_base/numerics/sequence_number_util.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020025#include "rtc_base/platform_thread.h"
26#include "rtc_base/random.h"
27#include "system_wrappers/include/clock.h"
Niels Möller7cca0422019-04-29 16:12:19 +020028#include "test/field_trial.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020029#include "test/gmock.h"
30#include "test/gtest.h"
philipel19053972020-01-29 17:36:11 +010031#include "test/time_controller/simulated_time_controller.h"
philipelbe7a9e52016-05-19 12:19:35 +020032
Mirko Bonadei6a489f22019-04-09 15:11:12 +020033using ::testing::_;
Evan Shrubsole0b565632021-11-05 09:58:20 +010034using ::testing::IsEmpty;
Mirko Bonadei6a489f22019-04-09 15:11:12 +020035using ::testing::Return;
Evan Shrubsole0b565632021-11-05 09:58:20 +010036using ::testing::SizeIs;
philipela45102f2017-02-22 05:30:39 -080037
philipelbe7a9e52016-05-19 12:19:35 +020038namespace webrtc {
39namespace video_coding {
40
41class VCMTimingFake : public VCMTiming {
42 public:
43 explicit VCMTimingFake(Clock* clock) : VCMTiming(clock) {}
44
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010045 Timestamp RenderTime(uint32_t frame_timestamp, Timestamp now) const override {
46 if (last_render_time_.IsMinusInfinity()) {
47 last_render_time_ = now + kDelay;
philipelbe7a9e52016-05-19 12:19:35 +020048 last_timestamp_ = frame_timestamp;
49 }
50
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010051 auto diff = MinDiff(frame_timestamp, last_timestamp_);
52 auto timeDiff = TimeDelta::Millis(diff / 90);
philipelbe7a9e52016-05-19 12:19:35 +020053 if (AheadOf(frame_timestamp, last_timestamp_))
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010054 last_render_time_ += timeDiff;
philipelbe7a9e52016-05-19 12:19:35 +020055 else
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010056 last_render_time_ -= timeDiff;
philipelbe7a9e52016-05-19 12:19:35 +020057
58 last_timestamp_ = frame_timestamp;
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010059 return last_render_time_;
philipelbe7a9e52016-05-19 12:19:35 +020060 }
61
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010062 TimeDelta MaxWaitingTime(Timestamp render_time,
63 Timestamp now,
64 bool too_many_frames_queued) const override {
65 return render_time - now - kDecodeTime;
philipelbe7a9e52016-05-19 12:19:35 +020066 }
67
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010068 TimeDelta GetCurrentJitter() {
Evan Shrubsole92e89d72022-03-22 10:55:15 +010069 return VCMTiming::GetTimings().jitter_buffer_delay;
Niels Möller7cca0422019-04-29 16:12:19 +020070 }
71
philipelbe7a9e52016-05-19 12:19:35 +020072 private:
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010073 static constexpr TimeDelta kDelay = TimeDelta::Millis(50);
74 const TimeDelta kDecodeTime = kDelay / 2;
philipelbe7a9e52016-05-19 12:19:35 +020075 mutable uint32_t last_timestamp_ = 0;
Evan Shrubsoled6cdf802022-03-02 15:13:55 +010076 mutable Timestamp last_render_time_ = Timestamp::MinusInfinity();
philipelbe7a9e52016-05-19 12:19:35 +020077};
78
philipele7c891f2018-02-22 14:35:06 +010079class FrameObjectFake : public EncodedFrame {
philipelbe7a9e52016-05-19 12:19:35 +020080 public:
philipelb4d31082016-07-11 08:46:29 -070081 int64_t ReceivedTime() const override { return 0; }
82
83 int64_t RenderTime() const override { return _renderTimeMs; }
Niels Möller7cca0422019-04-29 16:12:19 +020084
85 bool delayed_by_retransmission() const override {
86 return delayed_by_retransmission_;
87 }
88 void set_delayed_by_retransmission(bool delayed) {
89 delayed_by_retransmission_ = delayed;
90 }
91
92 private:
93 bool delayed_by_retransmission_ = false;
philipela45102f2017-02-22 05:30:39 -080094};
95
96class VCMReceiveStatisticsCallbackMock : public VCMReceiveStatisticsCallback {
97 public:
Danil Chapovalovf2c0f152020-05-19 13:20:27 +020098 MOCK_METHOD(void,
99 OnCompleteFrame,
100 (bool is_keyframe,
101 size_t size_bytes,
102 VideoContentType content_type),
103 (override));
104 MOCK_METHOD(void, OnDroppedFrames, (uint32_t frames_dropped), (override));
105 MOCK_METHOD(void,
106 OnFrameBufferTimingsUpdated,
Evan Shrubsoled6cdf802022-03-02 15:13:55 +0100107 (int max_decode,
108 int current_delay,
109 int target_delay,
110 int jitter_buffer,
111 int min_playout_delay,
112 int render_delay),
Danil Chapovalovf2c0f152020-05-19 13:20:27 +0200113 (override));
114 MOCK_METHOD(void,
115 OnTimingFrameInfoUpdated,
116 (const TimingFrameInfo& info),
117 (override));
philipelbe7a9e52016-05-19 12:19:35 +0200118};
119
120class TestFrameBuffer2 : public ::testing::Test {
121 protected:
122 static constexpr int kMaxReferences = 5;
123 static constexpr int kFps1 = 1000;
124 static constexpr int kFps10 = kFps1 / 10;
125 static constexpr int kFps20 = kFps1 / 20;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100126 static constexpr size_t kFrameSize = 10;
philipelbe7a9e52016-05-19 12:19:35 +0200127
128 TestFrameBuffer2()
Evan Shrubsole9146d762021-10-13 11:19:48 +0200129 : time_controller_(Timestamp::Seconds(0)),
philipel19053972020-01-29 17:36:11 +0100130 time_task_queue_(
131 time_controller_.GetTaskQueueFactory()->CreateTaskQueue(
132 "extract queue",
133 TaskQueueFactory::Priority::NORMAL)),
134 timing_(time_controller_.GetClock()),
135 buffer_(new FrameBuffer(time_controller_.GetClock(),
136 &timing_,
137 &stats_callback_)),
138 rand_(0x34678213) {}
philipelbe7a9e52016-05-19 12:19:35 +0200139
140 template <typename... T>
Niels Möller7cca0422019-04-29 16:12:19 +0200141 std::unique_ptr<FrameObjectFake> CreateFrame(uint16_t picture_id,
142 uint8_t spatial_layer,
143 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200144 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200145 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200146 T... refs) {
philipelbe7a9e52016-05-19 12:19:35 +0200147 static_assert(sizeof...(refs) <= kMaxReferences,
philipele7c891f2018-02-22 14:35:06 +0100148 "To many references specified for EncodedFrame.");
kwiberg5b9746e2017-08-16 04:52:35 -0700149 std::array<uint16_t, sizeof...(refs)> references = {
150 {rtc::checked_cast<uint16_t>(refs)...}};
philipelbe7a9e52016-05-19 12:19:35 +0200151
Mirko Bonadei317a1f02019-09-17 17:06:18 +0200152 auto frame = std::make_unique<FrameObjectFake>();
philipel9aa9b8d2021-02-15 13:31:29 +0100153 frame->SetId(picture_id);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100154 frame->SetSpatialIndex(spatial_layer);
Niels Möller23775882018-08-16 10:24:12 +0200155 frame->SetTimestamp(ts_ms * 90);
philipelbe7a9e52016-05-19 12:19:35 +0200156 frame->num_references = references.size();
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100157 frame->is_last_spatial_layer = last_spatial_layer;
158 // Add some data to buffer.
Niels Möllerb9bfe652019-10-03 08:43:53 +0200159 frame->SetEncodedData(EncodedImageBuffer::Create(frame_size_bytes));
philipelbe7a9e52016-05-19 12:19:35 +0200160 for (size_t r = 0; r < references.size(); ++r)
161 frame->references[r] = references[r];
Niels Möller7cca0422019-04-29 16:12:19 +0200162 return frame;
163 }
philipelbe7a9e52016-05-19 12:19:35 +0200164
Niels Möller7cca0422019-04-29 16:12:19 +0200165 template <typename... T>
166 int InsertFrame(uint16_t picture_id,
167 uint8_t spatial_layer,
168 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200169 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200170 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200171 T... refs) {
philipelcb327d92020-12-10 10:49:20 +0100172 return buffer_->InsertFrame(CreateFrame(picture_id, spatial_layer, ts_ms,
173 last_spatial_layer,
174 frame_size_bytes, refs...));
Niels Möller7cca0422019-04-29 16:12:19 +0200175 }
176
177 int InsertNackedFrame(uint16_t picture_id, int64_t ts_ms) {
178 std::unique_ptr<FrameObjectFake> frame =
philipelcb327d92020-12-10 10:49:20 +0100179 CreateFrame(picture_id, 0, ts_ms, true, kFrameSize);
Niels Möller7cca0422019-04-29 16:12:19 +0200180 frame->set_delayed_by_retransmission(true);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200181 return buffer_->InsertFrame(std::move(frame));
philipelbe7a9e52016-05-19 12:19:35 +0200182 }
183
philipel3042c2d2017-08-18 04:55:02 -0700184 void ExtractFrame(int64_t max_wait_time = 0, bool keyframe_required = false) {
philipel19053972020-01-29 17:36:11 +0100185 time_task_queue_.PostTask([this, max_wait_time, keyframe_required]() {
Evan Shrubsole3d29efd2021-12-07 14:11:45 +0100186 buffer_->NextFrame(max_wait_time, keyframe_required, &time_task_queue_,
187 [this](std::unique_ptr<EncodedFrame> frame) {
188 frames_.emplace_back(std::move(frame));
189 });
philipel19053972020-01-29 17:36:11 +0100190 });
philipelbe7a9e52016-05-19 12:19:35 +0200191 if (max_wait_time == 0) {
Danil Chapovalov55284022020-02-07 14:53:52 +0100192 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200193 }
194 }
195
196 void CheckFrame(size_t index, int picture_id, int spatial_layer) {
philipelbe7a9e52016-05-19 12:19:35 +0200197 ASSERT_LT(index, frames_.size());
198 ASSERT_TRUE(frames_[index]);
philipel9aa9b8d2021-02-15 13:31:29 +0100199 ASSERT_EQ(picture_id, frames_[index]->Id());
philipelcb327d92020-12-10 10:49:20 +0100200 ASSERT_EQ(spatial_layer, frames_[index]->SpatialIndex().value_or(0));
philipelbe7a9e52016-05-19 12:19:35 +0200201 }
202
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100203 void CheckFrameSize(size_t index, size_t size) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100204 ASSERT_LT(index, frames_.size());
205 ASSERT_TRUE(frames_[index]);
206 ASSERT_EQ(frames_[index]->size(), size);
207 }
208
philipelbe7a9e52016-05-19 12:19:35 +0200209 void CheckNoFrame(size_t index) {
philipelbe7a9e52016-05-19 12:19:35 +0200210 ASSERT_LT(index, frames_.size());
211 ASSERT_FALSE(frames_[index]);
212 }
213
philipelbe7a9e52016-05-19 12:19:35 +0200214 uint32_t Rand() { return rand_.Rand<uint32_t>(); }
215
philipel19053972020-01-29 17:36:11 +0100216 webrtc::GlobalSimulatedTimeController time_controller_;
217 rtc::TaskQueue time_task_queue_;
philipelbe7a9e52016-05-19 12:19:35 +0200218 VCMTimingFake timing_;
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200219 std::unique_ptr<FrameBuffer> buffer_;
philipele7c891f2018-02-22 14:35:06 +0100220 std::vector<std::unique_ptr<EncodedFrame>> frames_;
philipelbe7a9e52016-05-19 12:19:35 +0200221 Random rand_;
philipela45102f2017-02-22 05:30:39 -0800222 ::testing::NiceMock<VCMReceiveStatisticsCallbackMock> stats_callback_;
philipelbe7a9e52016-05-19 12:19:35 +0200223};
224
Sergey Silkin2799e632019-05-17 09:51:39 +0200225// From https://en.cppreference.com/w/cpp/language/static: "If ... a constexpr
226// static data member (since C++11) is odr-used, a definition at namespace scope
227// is still required... This definition is deprecated for constexpr data members
228// since C++17."
229// kFrameSize is odr-used since it is passed by reference to EXPECT_EQ().
230#if __cplusplus < 201703L
231constexpr size_t TestFrameBuffer2::kFrameSize;
232#endif
233
philipelbe7a9e52016-05-19 12:19:35 +0200234TEST_F(TestFrameBuffer2, WaitForFrame) {
235 uint16_t pid = Rand();
236 uint32_t ts = Rand();
237
philipel6e8224f2016-05-19 17:07:44 +0200238 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100239 InsertFrame(pid, 0, ts, true, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100240 time_controller_.AdvanceTime(TimeDelta::Millis(50));
philipelbe7a9e52016-05-19 12:19:35 +0200241 CheckFrame(0, pid, 0);
242}
243
Evan Shrubsole0b565632021-11-05 09:58:20 +0100244TEST_F(TestFrameBuffer2, ClearWhileWaitingForFrame) {
245 const uint16_t pid = Rand();
246
247 // Insert a frame and wait for it for max 100ms.
248 InsertFrame(pid, 0, 25, true, kFrameSize);
249 ExtractFrame(100);
250 // After 10ms, clear the buffer.
251 time_controller_.AdvanceTime(TimeDelta::Millis(10));
252 buffer_->Clear();
253 // Confirm that the frame was not sent for rendering.
254 time_controller_.AdvanceTime(TimeDelta::Millis(15));
255 EXPECT_THAT(frames_, IsEmpty());
256
257 // We are still waiting for a frame, since 100ms has not passed. Insert a new
258 // frame. This new frame should be the one that is returned as the old frame
259 // was cleared.
260 const uint16_t new_pid = pid + 1;
261 InsertFrame(new_pid, 0, 50, true, kFrameSize);
262 time_controller_.AdvanceTime(TimeDelta::Millis(25));
263 ASSERT_THAT(frames_, SizeIs(1));
264 CheckFrame(0, new_pid, 0);
265}
266
philipelbe7a9e52016-05-19 12:19:35 +0200267TEST_F(TestFrameBuffer2, OneSuperFrame) {
268 uint16_t pid = Rand();
269 uint32_t ts = Rand();
270
philipelcb327d92020-12-10 10:49:20 +0100271 InsertFrame(pid, 0, ts, false, kFrameSize);
272 InsertFrame(pid + 1, 1, ts, true, kFrameSize);
philipele0b2f152016-09-28 10:23:49 +0200273 ExtractFrame();
274
Sergey Silkin61832dd2018-12-20 14:32:14 +0100275 CheckFrame(0, pid, 1);
philipele0b2f152016-09-28 10:23:49 +0200276}
277
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200278TEST_F(TestFrameBuffer2, ZeroPlayoutDelay) {
philipel19053972020-01-29 17:36:11 +0100279 VCMTiming timing(time_controller_.GetClock());
280 buffer_.reset(
281 new FrameBuffer(time_controller_.GetClock(), &timing, &stats_callback_));
Niels Möllerd381eed2020-09-02 15:34:40 +0200282 const VideoPlayoutDelay kPlayoutDelayMs = {0, 0};
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200283 std::unique_ptr<FrameObjectFake> test_frame(new FrameObjectFake());
philipel9aa9b8d2021-02-15 13:31:29 +0100284 test_frame->SetId(0);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200285 test_frame->SetPlayoutDelay(kPlayoutDelayMs);
286 buffer_->InsertFrame(std::move(test_frame));
287 ExtractFrame(0, false);
288 CheckFrame(0, 0, 0);
289 EXPECT_EQ(0, frames_[0]->RenderTimeMs());
290}
291
aleloi3e005282017-01-26 05:38:00 -0800292// Flaky test, see bugs.webrtc.org/7068.
293TEST_F(TestFrameBuffer2, DISABLED_OneUnorderedSuperFrame) {
philipele0b2f152016-09-28 10:23:49 +0200294 uint16_t pid = Rand();
295 uint32_t ts = Rand();
296
philipel6e8224f2016-05-19 17:07:44 +0200297 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100298 InsertFrame(pid, 1, ts, true, kFrameSize);
299 InsertFrame(pid, 0, ts, false, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100300 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200301
302 CheckFrame(0, pid, 0);
303 CheckFrame(1, pid, 1);
304}
305
philipel94616b32016-05-20 10:43:01 +0200306TEST_F(TestFrameBuffer2, DISABLED_OneLayerStreamReordered) {
philipel6e8224f2016-05-19 17:07:44 +0200307 uint16_t pid = Rand();
308 uint32_t ts = Rand();
309
Sergey Silkin2799e632019-05-17 09:51:39 +0200310 InsertFrame(pid, 0, ts, false, true, kFrameSize);
philipel6e8224f2016-05-19 17:07:44 +0200311 ExtractFrame();
312 CheckFrame(0, pid, 0);
313 for (int i = 1; i < 10; i += 2) {
314 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100315 InsertFrame(pid + i + 1, 0, ts + (i + 1) * kFps10, true, kFrameSize,
Sergey Silkin2799e632019-05-17 09:51:39 +0200316 pid + i);
Danil Chapovalov55284022020-02-07 14:53:52 +0100317 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelcb327d92020-12-10 10:49:20 +0100318 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Danil Chapovalov55284022020-02-07 14:53:52 +0100319 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipel6e8224f2016-05-19 17:07:44 +0200320 ExtractFrame();
321 CheckFrame(i, pid + i, 0);
322 CheckFrame(i + 1, pid + i + 1, 0);
323 }
324}
philipel6e8224f2016-05-19 17:07:44 +0200325
326TEST_F(TestFrameBuffer2, ExtractFromEmptyBuffer) {
327 ExtractFrame();
328 CheckNoFrame(0);
329}
330
philipel93e451b2016-10-06 12:25:13 +0200331TEST_F(TestFrameBuffer2, MissingFrame) {
332 uint16_t pid = Rand();
333 uint32_t ts = Rand();
334
philipelcb327d92020-12-10 10:49:20 +0100335 InsertFrame(pid, 0, ts, true, kFrameSize);
336 InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid);
337 InsertFrame(pid + 3, 0, ts, true, kFrameSize, pid + 1, pid + 2);
philipel93e451b2016-10-06 12:25:13 +0200338 ExtractFrame();
339 ExtractFrame();
340 ExtractFrame();
341
342 CheckFrame(0, pid, 0);
343 CheckFrame(1, pid + 2, 0);
344 CheckNoFrame(2);
345}
346
philipelbe7a9e52016-05-19 12:19:35 +0200347TEST_F(TestFrameBuffer2, OneLayerStream) {
348 uint16_t pid = Rand();
349 uint32_t ts = Rand();
350
philipelcb327d92020-12-10 10:49:20 +0100351 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200352 ExtractFrame();
353 CheckFrame(0, pid, 0);
354 for (int i = 1; i < 10; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100355 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200356 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100357 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelbe7a9e52016-05-19 12:19:35 +0200358 CheckFrame(i, pid + i, 0);
359 }
360}
361
philipelbe7a9e52016-05-19 12:19:35 +0200362TEST_F(TestFrameBuffer2, DropTemporalLayerSlowDecoder) {
363 uint16_t pid = Rand();
364 uint32_t ts = Rand();
365
philipelcb327d92020-12-10 10:49:20 +0100366 InsertFrame(pid, 0, ts, true, kFrameSize);
367 InsertFrame(pid + 1, 0, ts + kFps20, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200368 for (int i = 2; i < 10; i += 2) {
369 uint32_t ts_tl0 = ts + i / 2 * kFps10;
philipelcb327d92020-12-10 10:49:20 +0100370 InsertFrame(pid + i, 0, ts_tl0, true, kFrameSize, pid + i - 2);
371 InsertFrame(pid + i + 1, 0, ts_tl0 + kFps20, true, kFrameSize, pid + i,
372 pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200373 }
374
Johannes Kron0c141c52019-08-26 15:04:43 +0200375 EXPECT_CALL(stats_callback_, OnDroppedFrames(1)).Times(3);
376
philipelbe7a9e52016-05-19 12:19:35 +0200377 for (int i = 0; i < 10; ++i) {
378 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100379 time_controller_.AdvanceTime(TimeDelta::Millis(70));
philipelbe7a9e52016-05-19 12:19:35 +0200380 }
381
382 CheckFrame(0, pid, 0);
383 CheckFrame(1, pid + 1, 0);
384 CheckFrame(2, pid + 2, 0);
385 CheckFrame(3, pid + 4, 0);
386 CheckFrame(4, pid + 6, 0);
387 CheckFrame(5, pid + 8, 0);
388 CheckNoFrame(6);
389 CheckNoFrame(7);
390 CheckNoFrame(8);
391 CheckNoFrame(9);
392}
393
Johannes Kron0c141c52019-08-26 15:04:43 +0200394TEST_F(TestFrameBuffer2, DropFramesIfSystemIsStalled) {
395 uint16_t pid = Rand();
396 uint32_t ts = Rand();
397
philipelcb327d92020-12-10 10:49:20 +0100398 InsertFrame(pid, 0, ts, true, kFrameSize);
399 InsertFrame(pid + 1, 0, ts + 1 * kFps10, true, kFrameSize, pid);
400 InsertFrame(pid + 2, 0, ts + 2 * kFps10, true, kFrameSize, pid + 1);
401 InsertFrame(pid + 3, 0, ts + 3 * kFps10, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200402
403 ExtractFrame();
404 // Jump forward in time, simulating the system being stalled for some reason.
Danil Chapovalov55284022020-02-07 14:53:52 +0100405 time_controller_.AdvanceTime(TimeDelta::Millis(3) * kFps10);
Johannes Kron0c141c52019-08-26 15:04:43 +0200406 // Extract one more frame, expect second and third frame to be dropped.
407 EXPECT_CALL(stats_callback_, OnDroppedFrames(2)).Times(1);
408 ExtractFrame();
409
410 CheckFrame(0, pid + 0, 0);
411 CheckFrame(1, pid + 3, 0);
412}
413
414TEST_F(TestFrameBuffer2, DroppedFramesCountedOnClear) {
415 uint16_t pid = Rand();
416 uint32_t ts = Rand();
417
philipelcb327d92020-12-10 10:49:20 +0100418 InsertFrame(pid, 0, ts, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200419 for (int i = 1; i < 5; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100420 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Johannes Kron0c141c52019-08-26 15:04:43 +0200421 }
422
423 // All frames should be dropped when Clear is called.
424 EXPECT_CALL(stats_callback_, OnDroppedFrames(5)).Times(1);
425 buffer_->Clear();
426}
427
philipelbe7a9e52016-05-19 12:19:35 +0200428TEST_F(TestFrameBuffer2, InsertLateFrame) {
429 uint16_t pid = Rand();
430 uint32_t ts = Rand();
431
philipelcb327d92020-12-10 10:49:20 +0100432 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200433 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100434 InsertFrame(pid + 2, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200435 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100436 InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200437 ExtractFrame();
438
439 CheckFrame(0, pid, 0);
440 CheckFrame(1, pid + 2, 0);
441 CheckNoFrame(2);
442}
443
Niels Möller7cca0422019-04-29 16:12:19 +0200444TEST_F(TestFrameBuffer2, ProtectionModeNackFEC) {
philipel4f6cd6a2016-08-03 10:59:32 +0200445 uint16_t pid = Rand();
446 uint32_t ts = Rand();
Niels Möller7cca0422019-04-29 16:12:19 +0200447 constexpr int64_t kRttMs = 200;
448 buffer_->UpdateRtt(kRttMs);
philipel4f6cd6a2016-08-03 10:59:32 +0200449
Niels Möller7cca0422019-04-29 16:12:19 +0200450 // Jitter estimate unaffected by RTT in this protection mode.
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200451 buffer_->SetProtectionMode(kProtectionNackFEC);
Niels Möller7cca0422019-04-29 16:12:19 +0200452 InsertNackedFrame(pid, ts);
453 InsertNackedFrame(pid + 1, ts + 100);
454 InsertNackedFrame(pid + 2, ts + 200);
philipelcb327d92020-12-10 10:49:20 +0100455 InsertFrame(pid + 3, 0, ts + 300, true, kFrameSize);
philipel4f6cd6a2016-08-03 10:59:32 +0200456 ExtractFrame();
Niels Möller7cca0422019-04-29 16:12:19 +0200457 ExtractFrame();
458 ExtractFrame();
459 ExtractFrame();
460 ASSERT_EQ(4u, frames_.size());
Evan Shrubsoled6cdf802022-03-02 15:13:55 +0100461 EXPECT_LT(timing_.GetCurrentJitter().ms(), kRttMs);
Niels Möller7cca0422019-04-29 16:12:19 +0200462}
463
philipele0b2f152016-09-28 10:23:49 +0200464TEST_F(TestFrameBuffer2, NoContinuousFrame) {
465 uint16_t pid = Rand();
466 uint32_t ts = Rand();
467
philipelcb327d92020-12-10 10:49:20 +0100468 EXPECT_EQ(-1, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
philipele0b2f152016-09-28 10:23:49 +0200469}
470
471TEST_F(TestFrameBuffer2, LastContinuousFrameSingleLayer) {
472 uint16_t pid = Rand();
473 uint32_t ts = Rand();
474
philipelcb327d92020-12-10 10:49:20 +0100475 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
476 EXPECT_EQ(pid, InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid + 1));
477 EXPECT_EQ(pid + 2, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
478 EXPECT_EQ(pid + 2, InsertFrame(pid + 4, 0, ts, true, kFrameSize, pid + 3));
479 EXPECT_EQ(pid + 5, InsertFrame(pid + 5, 0, ts, true, kFrameSize));
philipele0b2f152016-09-28 10:23:49 +0200480}
481
482TEST_F(TestFrameBuffer2, LastContinuousFrameTwoLayers) {
483 uint16_t pid = Rand();
484 uint32_t ts = Rand();
485
philipelcb327d92020-12-10 10:49:20 +0100486 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, false, kFrameSize));
487 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 1, ts, true, kFrameSize));
488 EXPECT_EQ(pid + 1,
489 InsertFrame(pid + 3, 1, ts, true, kFrameSize, pid + 1, pid + 2));
490 EXPECT_EQ(pid + 1, InsertFrame(pid + 4, 0, ts, false, kFrameSize, pid + 2));
491 EXPECT_EQ(pid + 1,
492 InsertFrame(pid + 5, 1, ts, true, kFrameSize, pid + 3, pid + 4));
493 EXPECT_EQ(pid + 1, InsertFrame(pid + 6, 0, ts, false, kFrameSize, pid + 4));
494 EXPECT_EQ(pid + 6, InsertFrame(pid + 2, 0, ts, false, kFrameSize, pid));
495 EXPECT_EQ(pid + 7,
496 InsertFrame(pid + 7, 1, ts, true, kFrameSize, pid + 5, pid + 6));
philipele0b2f152016-09-28 10:23:49 +0200497}
498
philipelfcc60062017-01-18 05:35:20 -0800499TEST_F(TestFrameBuffer2, PictureIdJumpBack) {
500 uint16_t pid = Rand();
501 uint32_t ts = Rand();
502
philipelcb327d92020-12-10 10:49:20 +0100503 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
504 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 0, ts + 1, true, kFrameSize, pid));
philipelfcc60062017-01-18 05:35:20 -0800505 ExtractFrame();
506 CheckFrame(0, pid, 0);
507
508 // Jump back in pid but increase ts.
philipelcb327d92020-12-10 10:49:20 +0100509 EXPECT_EQ(pid - 1, InsertFrame(pid - 1, 0, ts + 2, true, kFrameSize));
philipelfcc60062017-01-18 05:35:20 -0800510 ExtractFrame();
511 ExtractFrame();
512 CheckFrame(1, pid - 1, 0);
513 CheckNoFrame(2);
514}
515
philipela45102f2017-02-22 05:30:39 -0800516TEST_F(TestFrameBuffer2, StatsCallback) {
517 uint16_t pid = Rand();
518 uint32_t ts = Rand();
519 const int kFrameSize = 5000;
520
ilnik6d5b4d62017-08-30 03:32:14 -0700521 EXPECT_CALL(stats_callback_,
522 OnCompleteFrame(true, kFrameSize, VideoContentType::UNSPECIFIED));
Johannes Kronbfd343b2019-07-01 10:07:50 +0200523 EXPECT_CALL(stats_callback_, OnFrameBufferTimingsUpdated(_, _, _, _, _, _));
Evan Shrubsole92e89d72022-03-22 10:55:15 +0100524 // Stats callback requires a previously decoded frame.
525 timing_.StopDecodeTimer(TimeDelta::Millis(1), Timestamp::Zero());
philipela45102f2017-02-22 05:30:39 -0800526
527 {
528 std::unique_ptr<FrameObjectFake> frame(new FrameObjectFake());
Niels Möllerb9bfe652019-10-03 08:43:53 +0200529 frame->SetEncodedData(EncodedImageBuffer::Create(kFrameSize));
philipel9aa9b8d2021-02-15 13:31:29 +0100530 frame->SetId(pid);
Niels Möller23775882018-08-16 10:24:12 +0200531 frame->SetTimestamp(ts);
philipela45102f2017-02-22 05:30:39 -0800532 frame->num_references = 0;
philipela45102f2017-02-22 05:30:39 -0800533
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200534 EXPECT_EQ(buffer_->InsertFrame(std::move(frame)), pid);
philipela45102f2017-02-22 05:30:39 -0800535 }
536
537 ExtractFrame();
538 CheckFrame(0, pid, 0);
539}
540
philipel146a48b2017-04-20 04:04:38 -0700541TEST_F(TestFrameBuffer2, ForwardJumps) {
philipelcb327d92020-12-10 10:49:20 +0100542 EXPECT_EQ(5453, InsertFrame(5453, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700543 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100544 EXPECT_EQ(5454, InsertFrame(5454, 0, 1, true, kFrameSize, 5453));
philipel146a48b2017-04-20 04:04:38 -0700545 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100546 EXPECT_EQ(15670, InsertFrame(15670, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700547 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100548 EXPECT_EQ(29804, InsertFrame(29804, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700549 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100550 EXPECT_EQ(29805, InsertFrame(29805, 0, 1, true, kFrameSize, 29804));
philipel146a48b2017-04-20 04:04:38 -0700551 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100552 EXPECT_EQ(29806, InsertFrame(29806, 0, 1, true, kFrameSize, 29805));
philipel146a48b2017-04-20 04:04:38 -0700553 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100554 EXPECT_EQ(33819, InsertFrame(33819, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700555 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100556 EXPECT_EQ(41248, InsertFrame(41248, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700557 ExtractFrame();
558}
559
philipelf6842692017-04-28 03:29:15 -0700560TEST_F(TestFrameBuffer2, DuplicateFrames) {
philipelcb327d92020-12-10 10:49:20 +0100561 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700562 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100563 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700564}
565
philipel112adf92017-06-15 09:06:21 -0700566// TODO(philipel): implement more unittests related to invalid references.
567TEST_F(TestFrameBuffer2, InvalidReferences) {
philipelcb327d92020-12-10 10:49:20 +0100568 EXPECT_EQ(-1, InsertFrame(0, 0, 1000, true, kFrameSize, 2));
569 EXPECT_EQ(1, InsertFrame(1, 0, 2000, true, kFrameSize));
philipel112adf92017-06-15 09:06:21 -0700570 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100571 EXPECT_EQ(2, InsertFrame(2, 0, 3000, true, kFrameSize, 1));
philipel112adf92017-06-15 09:06:21 -0700572}
573
philipel3042c2d2017-08-18 04:55:02 -0700574TEST_F(TestFrameBuffer2, KeyframeRequired) {
philipelcb327d92020-12-10 10:49:20 +0100575 EXPECT_EQ(1, InsertFrame(1, 0, 1000, true, kFrameSize));
576 EXPECT_EQ(2, InsertFrame(2, 0, 2000, true, kFrameSize, 1));
577 EXPECT_EQ(3, InsertFrame(3, 0, 3000, true, kFrameSize));
philipel3042c2d2017-08-18 04:55:02 -0700578 ExtractFrame();
579 ExtractFrame(0, true);
580 ExtractFrame();
581
582 CheckFrame(0, 1, 0);
583 CheckFrame(1, 3, 0);
584 CheckNoFrame(2);
585}
586
philipel9771c502018-03-02 11:06:27 +0100587TEST_F(TestFrameBuffer2, KeyframeClearsFullBuffer) {
588 const int kMaxBufferSize = 600;
589
590 for (int i = 1; i <= kMaxBufferSize; ++i)
philipelcb327d92020-12-10 10:49:20 +0100591 EXPECT_EQ(-1, InsertFrame(i, 0, i * 1000, true, kFrameSize, i - 1));
philipel9771c502018-03-02 11:06:27 +0100592 ExtractFrame();
593 CheckNoFrame(0);
594
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100595 EXPECT_EQ(kMaxBufferSize + 1,
596 InsertFrame(kMaxBufferSize + 1, 0, (kMaxBufferSize + 1) * 1000,
philipelcb327d92020-12-10 10:49:20 +0100597 true, kFrameSize));
philipel9771c502018-03-02 11:06:27 +0100598 ExtractFrame();
599 CheckFrame(1, kMaxBufferSize + 1, 0);
600}
601
philipel798b2822018-06-11 13:10:14 +0200602TEST_F(TestFrameBuffer2, DontUpdateOnUndecodableFrame) {
philipelcb327d92020-12-10 10:49:20 +0100603 InsertFrame(1, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200604 ExtractFrame(0, true);
philipelcb327d92020-12-10 10:49:20 +0100605 InsertFrame(3, 0, 0, true, kFrameSize, 2, 0);
606 InsertFrame(3, 0, 0, true, kFrameSize, 0);
607 InsertFrame(2, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200608 ExtractFrame(0, true);
609 ExtractFrame(0, true);
610}
611
philipel6d216502018-10-22 14:36:45 +0200612TEST_F(TestFrameBuffer2, DontDecodeOlderTimestamp) {
philipelcb327d92020-12-10 10:49:20 +0100613 InsertFrame(2, 0, 1, true, kFrameSize);
614 InsertFrame(1, 0, 2, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200615 kFrameSize); // Older picture id but newer timestamp.
philipel6d216502018-10-22 14:36:45 +0200616 ExtractFrame(0);
617 ExtractFrame(0);
618 CheckFrame(0, 1, 0);
619 CheckNoFrame(1);
620
philipelcb327d92020-12-10 10:49:20 +0100621 InsertFrame(3, 0, 4, true, kFrameSize);
622 InsertFrame(4, 0, 3, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200623 kFrameSize); // Newer picture id but older timestamp.
philipel6d216502018-10-22 14:36:45 +0200624 ExtractFrame(0);
625 ExtractFrame(0);
626 CheckFrame(2, 3, 0);
627 CheckNoFrame(3);
628}
629
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100630TEST_F(TestFrameBuffer2, CombineFramesToSuperframe) {
631 uint16_t pid = Rand();
632 uint32_t ts = Rand();
633
philipelcb327d92020-12-10 10:49:20 +0100634 InsertFrame(pid, 0, ts, false, kFrameSize);
635 InsertFrame(pid + 1, 1, ts, true, 2 * kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100636 ExtractFrame(0);
637 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100638 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100639 CheckNoFrame(1);
640 // Two frames should be combined and returned together.
Sergey Silkin2799e632019-05-17 09:51:39 +0200641 CheckFrameSize(0, 3 * kFrameSize);
642
643 EXPECT_EQ(frames_[0]->SpatialIndex(), 1);
644 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(0), kFrameSize);
645 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(1), 2 * kFrameSize);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100646}
647
648TEST_F(TestFrameBuffer2, HigherSpatialLayerNonDecodable) {
649 uint16_t pid = Rand();
650 uint32_t ts = Rand();
651
philipelcb327d92020-12-10 10:49:20 +0100652 InsertFrame(pid, 0, ts, false, kFrameSize);
653 InsertFrame(pid + 1, 1, ts, true, kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100654
655 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100656 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100657
philipelcb327d92020-12-10 10:49:20 +0100658 InsertFrame(pid + 3, 1, ts + kFps20, true, kFrameSize, pid);
659 InsertFrame(pid + 4, 0, ts + kFps10, false, kFrameSize, pid);
660 InsertFrame(pid + 5, 1, ts + kFps10, true, kFrameSize, pid + 3, pid + 4);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100661
Danil Chapovalov55284022020-02-07 14:53:52 +0100662 time_controller_.AdvanceTime(TimeDelta::Millis(1000));
philipelcb327d92020-12-10 10:49:20 +0100663 // Frame pid+3 is decodable but too late.
664 // In superframe pid+4 is decodable, but frame pid+5 is not.
665 // Incorrect implementation might skip pid+2 frame and output undecodable
666 // pid+5 instead.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100667 ExtractFrame();
668 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100669 CheckFrame(1, pid + 3, 1);
670 CheckFrame(2, pid + 4, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100671}
672
Evan Shrubsole0b565632021-11-05 09:58:20 +0100673TEST_F(TestFrameBuffer2, StopWhileWaitingForFrame) {
674 uint16_t pid = Rand();
675 uint32_t ts = Rand();
676
677 InsertFrame(pid, 0, ts, true, kFrameSize);
678 ExtractFrame(10);
679 buffer_->Stop();
680 time_controller_.AdvanceTime(TimeDelta::Millis(10));
681 EXPECT_THAT(frames_, IsEmpty());
682
683 // A new frame request should exit immediately and return no new frame.
684 ExtractFrame(0);
685 EXPECT_THAT(frames_, IsEmpty());
686}
687
philipelbe7a9e52016-05-19 12:19:35 +0200688} // namespace video_coding
689} // namespace webrtc