blob: d37efda57bd2b89835ea20122beee182b57ad07b [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
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020019#include "modules/video_coding/frame_object.h"
20#include "modules/video_coding/jitter_estimator.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "modules/video_coding/timing.h"
Bjorn Tereliusa194e582017-10-25 13:07:09 +020022#include "rtc_base/numerics/sequence_number_util.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020023#include "rtc_base/platform_thread.h"
24#include "rtc_base/random.h"
25#include "system_wrappers/include/clock.h"
Niels Möller7cca0422019-04-29 16:12:19 +020026#include "test/field_trial.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "test/gmock.h"
28#include "test/gtest.h"
philipel19053972020-01-29 17:36:11 +010029#include "test/time_controller/simulated_time_controller.h"
philipelbe7a9e52016-05-19 12:19:35 +020030
Mirko Bonadei6a489f22019-04-09 15:11:12 +020031using ::testing::_;
32using ::testing::Return;
philipela45102f2017-02-22 05:30:39 -080033
philipelbe7a9e52016-05-19 12:19:35 +020034namespace webrtc {
35namespace video_coding {
36
37class VCMTimingFake : public VCMTiming {
38 public:
39 explicit VCMTimingFake(Clock* clock) : VCMTiming(clock) {}
40
41 int64_t RenderTimeMs(uint32_t frame_timestamp,
42 int64_t now_ms) const override {
43 if (last_ms_ == -1) {
44 last_ms_ = now_ms + kDelayMs;
45 last_timestamp_ = frame_timestamp;
46 }
47
48 uint32_t diff = MinDiff(frame_timestamp, last_timestamp_);
49 if (AheadOf(frame_timestamp, last_timestamp_))
50 last_ms_ += diff / 90;
51 else
52 last_ms_ -= diff / 90;
53
54 last_timestamp_ = frame_timestamp;
55 return last_ms_;
56 }
57
Johannes Kron985905d2021-06-29 11:37:06 +020058 int64_t MaxWaitingTime(int64_t render_time_ms, int64_t now_ms) override {
Ilya Nikolaevskiy8c4fe162018-02-27 15:49:47 +010059 return render_time_ms - now_ms - kDecodeTime;
philipelbe7a9e52016-05-19 12:19:35 +020060 }
61
Johannes Kronbfd343b2019-07-01 10:07:50 +020062 bool GetTimings(int* max_decode_ms,
philipela45102f2017-02-22 05:30:39 -080063 int* current_delay_ms,
64 int* target_delay_ms,
65 int* jitter_buffer_ms,
66 int* min_playout_delay_ms,
67 int* render_delay_ms) const override {
68 return true;
69 }
70
Niels Möller7cca0422019-04-29 16:12:19 +020071 int GetCurrentJitter() {
Niels Möller7cca0422019-04-29 16:12:19 +020072 int max_decode_ms;
73 int current_delay_ms;
74 int target_delay_ms;
75 int jitter_buffer_ms;
76 int min_playout_delay_ms;
77 int render_delay_ms;
Johannes Kronbfd343b2019-07-01 10:07:50 +020078 VCMTiming::GetTimings(&max_decode_ms, &current_delay_ms, &target_delay_ms,
79 &jitter_buffer_ms, &min_playout_delay_ms,
80 &render_delay_ms);
Niels Möller7cca0422019-04-29 16:12:19 +020081 return jitter_buffer_ms;
82 }
83
philipelbe7a9e52016-05-19 12:19:35 +020084 private:
85 static constexpr int kDelayMs = 50;
86 static constexpr int kDecodeTime = kDelayMs / 2;
87 mutable uint32_t last_timestamp_ = 0;
88 mutable int64_t last_ms_ = -1;
89};
90
philipele7c891f2018-02-22 14:35:06 +010091class FrameObjectFake : public EncodedFrame {
philipelbe7a9e52016-05-19 12:19:35 +020092 public:
philipelb4d31082016-07-11 08:46:29 -070093 int64_t ReceivedTime() const override { return 0; }
94
95 int64_t RenderTime() const override { return _renderTimeMs; }
Niels Möller7cca0422019-04-29 16:12:19 +020096
97 bool delayed_by_retransmission() const override {
98 return delayed_by_retransmission_;
99 }
100 void set_delayed_by_retransmission(bool delayed) {
101 delayed_by_retransmission_ = delayed;
102 }
103
104 private:
105 bool delayed_by_retransmission_ = false;
philipela45102f2017-02-22 05:30:39 -0800106};
107
108class VCMReceiveStatisticsCallbackMock : public VCMReceiveStatisticsCallback {
109 public:
Danil Chapovalovf2c0f152020-05-19 13:20:27 +0200110 MOCK_METHOD(void,
111 OnCompleteFrame,
112 (bool is_keyframe,
113 size_t size_bytes,
114 VideoContentType content_type),
115 (override));
116 MOCK_METHOD(void, OnDroppedFrames, (uint32_t frames_dropped), (override));
117 MOCK_METHOD(void,
118 OnFrameBufferTimingsUpdated,
119 (int max_decode_ms,
120 int current_delay_ms,
121 int target_delay_ms,
122 int jitter_buffer_ms,
123 int min_playout_delay_ms,
124 int render_delay_ms),
125 (override));
126 MOCK_METHOD(void,
127 OnTimingFrameInfoUpdated,
128 (const TimingFrameInfo& info),
129 (override));
philipelbe7a9e52016-05-19 12:19:35 +0200130};
131
132class TestFrameBuffer2 : public ::testing::Test {
133 protected:
134 static constexpr int kMaxReferences = 5;
135 static constexpr int kFps1 = 1000;
136 static constexpr int kFps10 = kFps1 / 10;
137 static constexpr int kFps20 = kFps1 / 20;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100138 static constexpr size_t kFrameSize = 10;
philipelbe7a9e52016-05-19 12:19:35 +0200139
140 TestFrameBuffer2()
Niels Möller7cca0422019-04-29 16:12:19 +0200141 : trial_("WebRTC-AddRttToPlayoutDelay/Enabled/"),
Danil Chapovalov55284022020-02-07 14:53:52 +0100142 time_controller_(Timestamp::Seconds(0)),
philipel19053972020-01-29 17:36:11 +0100143 time_task_queue_(
144 time_controller_.GetTaskQueueFactory()->CreateTaskQueue(
145 "extract queue",
146 TaskQueueFactory::Priority::NORMAL)),
147 timing_(time_controller_.GetClock()),
148 buffer_(new FrameBuffer(time_controller_.GetClock(),
149 &timing_,
150 &stats_callback_)),
151 rand_(0x34678213) {}
philipelbe7a9e52016-05-19 12:19:35 +0200152
153 template <typename... T>
Niels Möller7cca0422019-04-29 16:12:19 +0200154 std::unique_ptr<FrameObjectFake> CreateFrame(uint16_t picture_id,
155 uint8_t spatial_layer,
156 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200157 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200158 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200159 T... refs) {
philipelbe7a9e52016-05-19 12:19:35 +0200160 static_assert(sizeof...(refs) <= kMaxReferences,
philipele7c891f2018-02-22 14:35:06 +0100161 "To many references specified for EncodedFrame.");
kwiberg5b9746e2017-08-16 04:52:35 -0700162 std::array<uint16_t, sizeof...(refs)> references = {
163 {rtc::checked_cast<uint16_t>(refs)...}};
philipelbe7a9e52016-05-19 12:19:35 +0200164
Mirko Bonadei317a1f02019-09-17 17:06:18 +0200165 auto frame = std::make_unique<FrameObjectFake>();
philipel9aa9b8d2021-02-15 13:31:29 +0100166 frame->SetId(picture_id);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100167 frame->SetSpatialIndex(spatial_layer);
Niels Möller23775882018-08-16 10:24:12 +0200168 frame->SetTimestamp(ts_ms * 90);
philipelbe7a9e52016-05-19 12:19:35 +0200169 frame->num_references = references.size();
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100170 frame->is_last_spatial_layer = last_spatial_layer;
171 // Add some data to buffer.
Niels Möllerb9bfe652019-10-03 08:43:53 +0200172 frame->SetEncodedData(EncodedImageBuffer::Create(frame_size_bytes));
philipelbe7a9e52016-05-19 12:19:35 +0200173 for (size_t r = 0; r < references.size(); ++r)
174 frame->references[r] = references[r];
Niels Möller7cca0422019-04-29 16:12:19 +0200175 return frame;
176 }
philipelbe7a9e52016-05-19 12:19:35 +0200177
Niels Möller7cca0422019-04-29 16:12:19 +0200178 template <typename... T>
179 int InsertFrame(uint16_t picture_id,
180 uint8_t spatial_layer,
181 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200182 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200183 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200184 T... refs) {
philipelcb327d92020-12-10 10:49:20 +0100185 return buffer_->InsertFrame(CreateFrame(picture_id, spatial_layer, ts_ms,
186 last_spatial_layer,
187 frame_size_bytes, refs...));
Niels Möller7cca0422019-04-29 16:12:19 +0200188 }
189
190 int InsertNackedFrame(uint16_t picture_id, int64_t ts_ms) {
191 std::unique_ptr<FrameObjectFake> frame =
philipelcb327d92020-12-10 10:49:20 +0100192 CreateFrame(picture_id, 0, ts_ms, true, kFrameSize);
Niels Möller7cca0422019-04-29 16:12:19 +0200193 frame->set_delayed_by_retransmission(true);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200194 return buffer_->InsertFrame(std::move(frame));
philipelbe7a9e52016-05-19 12:19:35 +0200195 }
196
philipel3042c2d2017-08-18 04:55:02 -0700197 void ExtractFrame(int64_t max_wait_time = 0, bool keyframe_required = false) {
philipel19053972020-01-29 17:36:11 +0100198 time_task_queue_.PostTask([this, max_wait_time, keyframe_required]() {
199 buffer_->NextFrame(
200 max_wait_time, keyframe_required, &time_task_queue_,
philipelca188092021-03-23 12:00:49 +0100201 [this](std::unique_ptr<EncodedFrame> frame,
philipel19053972020-01-29 17:36:11 +0100202 video_coding::FrameBuffer::ReturnReason reason) {
203 if (reason != FrameBuffer::ReturnReason::kStopped) {
204 frames_.emplace_back(std::move(frame));
205 }
206 });
207 });
philipelbe7a9e52016-05-19 12:19:35 +0200208 if (max_wait_time == 0) {
Danil Chapovalov55284022020-02-07 14:53:52 +0100209 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200210 }
211 }
212
213 void CheckFrame(size_t index, int picture_id, int spatial_layer) {
philipelbe7a9e52016-05-19 12:19:35 +0200214 ASSERT_LT(index, frames_.size());
215 ASSERT_TRUE(frames_[index]);
philipel9aa9b8d2021-02-15 13:31:29 +0100216 ASSERT_EQ(picture_id, frames_[index]->Id());
philipelcb327d92020-12-10 10:49:20 +0100217 ASSERT_EQ(spatial_layer, frames_[index]->SpatialIndex().value_or(0));
philipelbe7a9e52016-05-19 12:19:35 +0200218 }
219
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100220 void CheckFrameSize(size_t index, size_t size) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100221 ASSERT_LT(index, frames_.size());
222 ASSERT_TRUE(frames_[index]);
223 ASSERT_EQ(frames_[index]->size(), size);
224 }
225
philipelbe7a9e52016-05-19 12:19:35 +0200226 void CheckNoFrame(size_t index) {
philipelbe7a9e52016-05-19 12:19:35 +0200227 ASSERT_LT(index, frames_.size());
228 ASSERT_FALSE(frames_[index]);
229 }
230
philipelbe7a9e52016-05-19 12:19:35 +0200231 uint32_t Rand() { return rand_.Rand<uint32_t>(); }
232
Niels Möller7cca0422019-04-29 16:12:19 +0200233 // The ProtectionMode tests depends on rtt-multiplier experiment.
234 test::ScopedFieldTrials trial_;
philipel19053972020-01-29 17:36:11 +0100235 webrtc::GlobalSimulatedTimeController time_controller_;
236 rtc::TaskQueue time_task_queue_;
philipelbe7a9e52016-05-19 12:19:35 +0200237 VCMTimingFake timing_;
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200238 std::unique_ptr<FrameBuffer> buffer_;
philipele7c891f2018-02-22 14:35:06 +0100239 std::vector<std::unique_ptr<EncodedFrame>> frames_;
philipelbe7a9e52016-05-19 12:19:35 +0200240 Random rand_;
philipela45102f2017-02-22 05:30:39 -0800241 ::testing::NiceMock<VCMReceiveStatisticsCallbackMock> stats_callback_;
philipelbe7a9e52016-05-19 12:19:35 +0200242};
243
Sergey Silkin2799e632019-05-17 09:51:39 +0200244// From https://en.cppreference.com/w/cpp/language/static: "If ... a constexpr
245// static data member (since C++11) is odr-used, a definition at namespace scope
246// is still required... This definition is deprecated for constexpr data members
247// since C++17."
248// kFrameSize is odr-used since it is passed by reference to EXPECT_EQ().
249#if __cplusplus < 201703L
250constexpr size_t TestFrameBuffer2::kFrameSize;
251#endif
252
philipelbe7a9e52016-05-19 12:19:35 +0200253TEST_F(TestFrameBuffer2, WaitForFrame) {
254 uint16_t pid = Rand();
255 uint32_t ts = Rand();
256
philipel6e8224f2016-05-19 17:07:44 +0200257 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100258 InsertFrame(pid, 0, ts, true, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100259 time_controller_.AdvanceTime(TimeDelta::Millis(50));
philipelbe7a9e52016-05-19 12:19:35 +0200260 CheckFrame(0, pid, 0);
261}
262
263TEST_F(TestFrameBuffer2, OneSuperFrame) {
264 uint16_t pid = Rand();
265 uint32_t ts = Rand();
266
philipelcb327d92020-12-10 10:49:20 +0100267 InsertFrame(pid, 0, ts, false, kFrameSize);
268 InsertFrame(pid + 1, 1, ts, true, kFrameSize);
philipele0b2f152016-09-28 10:23:49 +0200269 ExtractFrame();
270
Sergey Silkin61832dd2018-12-20 14:32:14 +0100271 CheckFrame(0, pid, 1);
philipele0b2f152016-09-28 10:23:49 +0200272}
273
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200274TEST_F(TestFrameBuffer2, ZeroPlayoutDelay) {
philipel19053972020-01-29 17:36:11 +0100275 VCMTiming timing(time_controller_.GetClock());
276 buffer_.reset(
277 new FrameBuffer(time_controller_.GetClock(), &timing, &stats_callback_));
Niels Möllerd381eed2020-09-02 15:34:40 +0200278 const VideoPlayoutDelay kPlayoutDelayMs = {0, 0};
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200279 std::unique_ptr<FrameObjectFake> test_frame(new FrameObjectFake());
philipel9aa9b8d2021-02-15 13:31:29 +0100280 test_frame->SetId(0);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200281 test_frame->SetPlayoutDelay(kPlayoutDelayMs);
282 buffer_->InsertFrame(std::move(test_frame));
283 ExtractFrame(0, false);
284 CheckFrame(0, 0, 0);
285 EXPECT_EQ(0, frames_[0]->RenderTimeMs());
286}
287
aleloi3e005282017-01-26 05:38:00 -0800288// Flaky test, see bugs.webrtc.org/7068.
289TEST_F(TestFrameBuffer2, DISABLED_OneUnorderedSuperFrame) {
philipele0b2f152016-09-28 10:23:49 +0200290 uint16_t pid = Rand();
291 uint32_t ts = Rand();
292
philipel6e8224f2016-05-19 17:07:44 +0200293 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100294 InsertFrame(pid, 1, ts, true, kFrameSize);
295 InsertFrame(pid, 0, ts, false, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100296 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200297
298 CheckFrame(0, pid, 0);
299 CheckFrame(1, pid, 1);
300}
301
philipel94616b32016-05-20 10:43:01 +0200302TEST_F(TestFrameBuffer2, DISABLED_OneLayerStreamReordered) {
philipel6e8224f2016-05-19 17:07:44 +0200303 uint16_t pid = Rand();
304 uint32_t ts = Rand();
305
Sergey Silkin2799e632019-05-17 09:51:39 +0200306 InsertFrame(pid, 0, ts, false, true, kFrameSize);
philipel6e8224f2016-05-19 17:07:44 +0200307 ExtractFrame();
308 CheckFrame(0, pid, 0);
309 for (int i = 1; i < 10; i += 2) {
310 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100311 InsertFrame(pid + i + 1, 0, ts + (i + 1) * kFps10, true, kFrameSize,
Sergey Silkin2799e632019-05-17 09:51:39 +0200312 pid + i);
Danil Chapovalov55284022020-02-07 14:53:52 +0100313 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelcb327d92020-12-10 10:49:20 +0100314 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Danil Chapovalov55284022020-02-07 14:53:52 +0100315 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipel6e8224f2016-05-19 17:07:44 +0200316 ExtractFrame();
317 CheckFrame(i, pid + i, 0);
318 CheckFrame(i + 1, pid + i + 1, 0);
319 }
320}
philipel6e8224f2016-05-19 17:07:44 +0200321
322TEST_F(TestFrameBuffer2, ExtractFromEmptyBuffer) {
323 ExtractFrame();
324 CheckNoFrame(0);
325}
326
philipel93e451b2016-10-06 12:25:13 +0200327TEST_F(TestFrameBuffer2, MissingFrame) {
328 uint16_t pid = Rand();
329 uint32_t ts = Rand();
330
philipelcb327d92020-12-10 10:49:20 +0100331 InsertFrame(pid, 0, ts, true, kFrameSize);
332 InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid);
333 InsertFrame(pid + 3, 0, ts, true, kFrameSize, pid + 1, pid + 2);
philipel93e451b2016-10-06 12:25:13 +0200334 ExtractFrame();
335 ExtractFrame();
336 ExtractFrame();
337
338 CheckFrame(0, pid, 0);
339 CheckFrame(1, pid + 2, 0);
340 CheckNoFrame(2);
341}
342
philipelbe7a9e52016-05-19 12:19:35 +0200343TEST_F(TestFrameBuffer2, OneLayerStream) {
344 uint16_t pid = Rand();
345 uint32_t ts = Rand();
346
philipelcb327d92020-12-10 10:49:20 +0100347 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200348 ExtractFrame();
349 CheckFrame(0, pid, 0);
350 for (int i = 1; i < 10; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100351 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200352 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100353 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelbe7a9e52016-05-19 12:19:35 +0200354 CheckFrame(i, pid + i, 0);
355 }
356}
357
philipelbe7a9e52016-05-19 12:19:35 +0200358TEST_F(TestFrameBuffer2, DropTemporalLayerSlowDecoder) {
359 uint16_t pid = Rand();
360 uint32_t ts = Rand();
361
philipelcb327d92020-12-10 10:49:20 +0100362 InsertFrame(pid, 0, ts, true, kFrameSize);
363 InsertFrame(pid + 1, 0, ts + kFps20, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200364 for (int i = 2; i < 10; i += 2) {
365 uint32_t ts_tl0 = ts + i / 2 * kFps10;
philipelcb327d92020-12-10 10:49:20 +0100366 InsertFrame(pid + i, 0, ts_tl0, true, kFrameSize, pid + i - 2);
367 InsertFrame(pid + i + 1, 0, ts_tl0 + kFps20, true, kFrameSize, pid + i,
368 pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200369 }
370
Johannes Kron0c141c52019-08-26 15:04:43 +0200371 EXPECT_CALL(stats_callback_, OnDroppedFrames(1)).Times(3);
372
philipelbe7a9e52016-05-19 12:19:35 +0200373 for (int i = 0; i < 10; ++i) {
374 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100375 time_controller_.AdvanceTime(TimeDelta::Millis(70));
philipelbe7a9e52016-05-19 12:19:35 +0200376 }
377
378 CheckFrame(0, pid, 0);
379 CheckFrame(1, pid + 1, 0);
380 CheckFrame(2, pid + 2, 0);
381 CheckFrame(3, pid + 4, 0);
382 CheckFrame(4, pid + 6, 0);
383 CheckFrame(5, pid + 8, 0);
384 CheckNoFrame(6);
385 CheckNoFrame(7);
386 CheckNoFrame(8);
387 CheckNoFrame(9);
388}
389
Johannes Kron0c141c52019-08-26 15:04:43 +0200390TEST_F(TestFrameBuffer2, DropFramesIfSystemIsStalled) {
391 uint16_t pid = Rand();
392 uint32_t ts = Rand();
393
philipelcb327d92020-12-10 10:49:20 +0100394 InsertFrame(pid, 0, ts, true, kFrameSize);
395 InsertFrame(pid + 1, 0, ts + 1 * kFps10, true, kFrameSize, pid);
396 InsertFrame(pid + 2, 0, ts + 2 * kFps10, true, kFrameSize, pid + 1);
397 InsertFrame(pid + 3, 0, ts + 3 * kFps10, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200398
399 ExtractFrame();
400 // Jump forward in time, simulating the system being stalled for some reason.
Danil Chapovalov55284022020-02-07 14:53:52 +0100401 time_controller_.AdvanceTime(TimeDelta::Millis(3) * kFps10);
Johannes Kron0c141c52019-08-26 15:04:43 +0200402 // Extract one more frame, expect second and third frame to be dropped.
403 EXPECT_CALL(stats_callback_, OnDroppedFrames(2)).Times(1);
404 ExtractFrame();
405
406 CheckFrame(0, pid + 0, 0);
407 CheckFrame(1, pid + 3, 0);
408}
409
410TEST_F(TestFrameBuffer2, DroppedFramesCountedOnClear) {
411 uint16_t pid = Rand();
412 uint32_t ts = Rand();
413
philipelcb327d92020-12-10 10:49:20 +0100414 InsertFrame(pid, 0, ts, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200415 for (int i = 1; i < 5; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100416 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Johannes Kron0c141c52019-08-26 15:04:43 +0200417 }
418
419 // All frames should be dropped when Clear is called.
420 EXPECT_CALL(stats_callback_, OnDroppedFrames(5)).Times(1);
421 buffer_->Clear();
422}
423
philipelbe7a9e52016-05-19 12:19:35 +0200424TEST_F(TestFrameBuffer2, InsertLateFrame) {
425 uint16_t pid = Rand();
426 uint32_t ts = Rand();
427
philipelcb327d92020-12-10 10:49:20 +0100428 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200429 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100430 InsertFrame(pid + 2, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200431 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100432 InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200433 ExtractFrame();
434
435 CheckFrame(0, pid, 0);
436 CheckFrame(1, pid + 2, 0);
437 CheckNoFrame(2);
438}
439
Niels Möller7cca0422019-04-29 16:12:19 +0200440TEST_F(TestFrameBuffer2, ProtectionModeNackFEC) {
philipel4f6cd6a2016-08-03 10:59:32 +0200441 uint16_t pid = Rand();
442 uint32_t ts = Rand();
Niels Möller7cca0422019-04-29 16:12:19 +0200443 constexpr int64_t kRttMs = 200;
444 buffer_->UpdateRtt(kRttMs);
philipel4f6cd6a2016-08-03 10:59:32 +0200445
Niels Möller7cca0422019-04-29 16:12:19 +0200446 // Jitter estimate unaffected by RTT in this protection mode.
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200447 buffer_->SetProtectionMode(kProtectionNackFEC);
Niels Möller7cca0422019-04-29 16:12:19 +0200448 InsertNackedFrame(pid, ts);
449 InsertNackedFrame(pid + 1, ts + 100);
450 InsertNackedFrame(pid + 2, ts + 200);
philipelcb327d92020-12-10 10:49:20 +0100451 InsertFrame(pid + 3, 0, ts + 300, true, kFrameSize);
philipel4f6cd6a2016-08-03 10:59:32 +0200452 ExtractFrame();
Niels Möller7cca0422019-04-29 16:12:19 +0200453 ExtractFrame();
454 ExtractFrame();
455 ExtractFrame();
456 ASSERT_EQ(4u, frames_.size());
457 EXPECT_LT(timing_.GetCurrentJitter(), kRttMs);
458}
459
460TEST_F(TestFrameBuffer2, ProtectionModeNack) {
461 uint16_t pid = Rand();
462 uint32_t ts = Rand();
463 constexpr int64_t kRttMs = 200;
464
465 buffer_->UpdateRtt(kRttMs);
466
467 // Jitter estimate includes RTT (after 3 retransmitted packets)
468 buffer_->SetProtectionMode(kProtectionNack);
469 InsertNackedFrame(pid, ts);
470 InsertNackedFrame(pid + 1, ts + 100);
471 InsertNackedFrame(pid + 2, ts + 200);
philipelcb327d92020-12-10 10:49:20 +0100472 InsertFrame(pid + 3, 0, ts + 300, true, kFrameSize);
Niels Möller7cca0422019-04-29 16:12:19 +0200473 ExtractFrame();
474 ExtractFrame();
475 ExtractFrame();
476 ExtractFrame();
477 ASSERT_EQ(4u, frames_.size());
478
479 EXPECT_GT(timing_.GetCurrentJitter(), kRttMs);
philipel4f6cd6a2016-08-03 10:59:32 +0200480}
481
philipele0b2f152016-09-28 10:23:49 +0200482TEST_F(TestFrameBuffer2, NoContinuousFrame) {
483 uint16_t pid = Rand();
484 uint32_t ts = Rand();
485
philipelcb327d92020-12-10 10:49:20 +0100486 EXPECT_EQ(-1, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
philipele0b2f152016-09-28 10:23:49 +0200487}
488
489TEST_F(TestFrameBuffer2, LastContinuousFrameSingleLayer) {
490 uint16_t pid = Rand();
491 uint32_t ts = Rand();
492
philipelcb327d92020-12-10 10:49:20 +0100493 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
494 EXPECT_EQ(pid, InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid + 1));
495 EXPECT_EQ(pid + 2, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
496 EXPECT_EQ(pid + 2, InsertFrame(pid + 4, 0, ts, true, kFrameSize, pid + 3));
497 EXPECT_EQ(pid + 5, InsertFrame(pid + 5, 0, ts, true, kFrameSize));
philipele0b2f152016-09-28 10:23:49 +0200498}
499
500TEST_F(TestFrameBuffer2, LastContinuousFrameTwoLayers) {
501 uint16_t pid = Rand();
502 uint32_t ts = Rand();
503
philipelcb327d92020-12-10 10:49:20 +0100504 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, false, kFrameSize));
505 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 1, ts, true, kFrameSize));
506 EXPECT_EQ(pid + 1,
507 InsertFrame(pid + 3, 1, ts, true, kFrameSize, pid + 1, pid + 2));
508 EXPECT_EQ(pid + 1, InsertFrame(pid + 4, 0, ts, false, kFrameSize, pid + 2));
509 EXPECT_EQ(pid + 1,
510 InsertFrame(pid + 5, 1, ts, true, kFrameSize, pid + 3, pid + 4));
511 EXPECT_EQ(pid + 1, InsertFrame(pid + 6, 0, ts, false, kFrameSize, pid + 4));
512 EXPECT_EQ(pid + 6, InsertFrame(pid + 2, 0, ts, false, kFrameSize, pid));
513 EXPECT_EQ(pid + 7,
514 InsertFrame(pid + 7, 1, ts, true, kFrameSize, pid + 5, pid + 6));
philipele0b2f152016-09-28 10:23:49 +0200515}
516
philipelfcc60062017-01-18 05:35:20 -0800517TEST_F(TestFrameBuffer2, PictureIdJumpBack) {
518 uint16_t pid = Rand();
519 uint32_t ts = Rand();
520
philipelcb327d92020-12-10 10:49:20 +0100521 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
522 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 0, ts + 1, true, kFrameSize, pid));
philipelfcc60062017-01-18 05:35:20 -0800523 ExtractFrame();
524 CheckFrame(0, pid, 0);
525
526 // Jump back in pid but increase ts.
philipelcb327d92020-12-10 10:49:20 +0100527 EXPECT_EQ(pid - 1, InsertFrame(pid - 1, 0, ts + 2, true, kFrameSize));
philipelfcc60062017-01-18 05:35:20 -0800528 ExtractFrame();
529 ExtractFrame();
530 CheckFrame(1, pid - 1, 0);
531 CheckNoFrame(2);
532}
533
philipela45102f2017-02-22 05:30:39 -0800534TEST_F(TestFrameBuffer2, StatsCallback) {
535 uint16_t pid = Rand();
536 uint32_t ts = Rand();
537 const int kFrameSize = 5000;
538
ilnik6d5b4d62017-08-30 03:32:14 -0700539 EXPECT_CALL(stats_callback_,
540 OnCompleteFrame(true, kFrameSize, VideoContentType::UNSPECIFIED));
Johannes Kronbfd343b2019-07-01 10:07:50 +0200541 EXPECT_CALL(stats_callback_, OnFrameBufferTimingsUpdated(_, _, _, _, _, _));
philipela45102f2017-02-22 05:30:39 -0800542
543 {
544 std::unique_ptr<FrameObjectFake> frame(new FrameObjectFake());
Niels Möllerb9bfe652019-10-03 08:43:53 +0200545 frame->SetEncodedData(EncodedImageBuffer::Create(kFrameSize));
philipel9aa9b8d2021-02-15 13:31:29 +0100546 frame->SetId(pid);
Niels Möller23775882018-08-16 10:24:12 +0200547 frame->SetTimestamp(ts);
philipela45102f2017-02-22 05:30:39 -0800548 frame->num_references = 0;
philipela45102f2017-02-22 05:30:39 -0800549
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200550 EXPECT_EQ(buffer_->InsertFrame(std::move(frame)), pid);
philipela45102f2017-02-22 05:30:39 -0800551 }
552
553 ExtractFrame();
554 CheckFrame(0, pid, 0);
555}
556
philipel146a48b2017-04-20 04:04:38 -0700557TEST_F(TestFrameBuffer2, ForwardJumps) {
philipelcb327d92020-12-10 10:49:20 +0100558 EXPECT_EQ(5453, InsertFrame(5453, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700559 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100560 EXPECT_EQ(5454, InsertFrame(5454, 0, 1, true, kFrameSize, 5453));
philipel146a48b2017-04-20 04:04:38 -0700561 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100562 EXPECT_EQ(15670, InsertFrame(15670, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700563 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100564 EXPECT_EQ(29804, InsertFrame(29804, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700565 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100566 EXPECT_EQ(29805, InsertFrame(29805, 0, 1, true, kFrameSize, 29804));
philipel146a48b2017-04-20 04:04:38 -0700567 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100568 EXPECT_EQ(29806, InsertFrame(29806, 0, 1, true, kFrameSize, 29805));
philipel146a48b2017-04-20 04:04:38 -0700569 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100570 EXPECT_EQ(33819, InsertFrame(33819, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700571 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100572 EXPECT_EQ(41248, InsertFrame(41248, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700573 ExtractFrame();
574}
575
philipelf6842692017-04-28 03:29:15 -0700576TEST_F(TestFrameBuffer2, DuplicateFrames) {
philipelcb327d92020-12-10 10:49:20 +0100577 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700578 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100579 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700580}
581
philipel112adf92017-06-15 09:06:21 -0700582// TODO(philipel): implement more unittests related to invalid references.
583TEST_F(TestFrameBuffer2, InvalidReferences) {
philipelcb327d92020-12-10 10:49:20 +0100584 EXPECT_EQ(-1, InsertFrame(0, 0, 1000, true, kFrameSize, 2));
585 EXPECT_EQ(1, InsertFrame(1, 0, 2000, true, kFrameSize));
philipel112adf92017-06-15 09:06:21 -0700586 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100587 EXPECT_EQ(2, InsertFrame(2, 0, 3000, true, kFrameSize, 1));
philipel112adf92017-06-15 09:06:21 -0700588}
589
philipel3042c2d2017-08-18 04:55:02 -0700590TEST_F(TestFrameBuffer2, KeyframeRequired) {
philipelcb327d92020-12-10 10:49:20 +0100591 EXPECT_EQ(1, InsertFrame(1, 0, 1000, true, kFrameSize));
592 EXPECT_EQ(2, InsertFrame(2, 0, 2000, true, kFrameSize, 1));
593 EXPECT_EQ(3, InsertFrame(3, 0, 3000, true, kFrameSize));
philipel3042c2d2017-08-18 04:55:02 -0700594 ExtractFrame();
595 ExtractFrame(0, true);
596 ExtractFrame();
597
598 CheckFrame(0, 1, 0);
599 CheckFrame(1, 3, 0);
600 CheckNoFrame(2);
601}
602
philipel9771c502018-03-02 11:06:27 +0100603TEST_F(TestFrameBuffer2, KeyframeClearsFullBuffer) {
604 const int kMaxBufferSize = 600;
605
606 for (int i = 1; i <= kMaxBufferSize; ++i)
philipelcb327d92020-12-10 10:49:20 +0100607 EXPECT_EQ(-1, InsertFrame(i, 0, i * 1000, true, kFrameSize, i - 1));
philipel9771c502018-03-02 11:06:27 +0100608 ExtractFrame();
609 CheckNoFrame(0);
610
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100611 EXPECT_EQ(kMaxBufferSize + 1,
612 InsertFrame(kMaxBufferSize + 1, 0, (kMaxBufferSize + 1) * 1000,
philipelcb327d92020-12-10 10:49:20 +0100613 true, kFrameSize));
philipel9771c502018-03-02 11:06:27 +0100614 ExtractFrame();
615 CheckFrame(1, kMaxBufferSize + 1, 0);
616}
617
philipel798b2822018-06-11 13:10:14 +0200618TEST_F(TestFrameBuffer2, DontUpdateOnUndecodableFrame) {
philipelcb327d92020-12-10 10:49:20 +0100619 InsertFrame(1, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200620 ExtractFrame(0, true);
philipelcb327d92020-12-10 10:49:20 +0100621 InsertFrame(3, 0, 0, true, kFrameSize, 2, 0);
622 InsertFrame(3, 0, 0, true, kFrameSize, 0);
623 InsertFrame(2, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200624 ExtractFrame(0, true);
625 ExtractFrame(0, true);
626}
627
philipel6d216502018-10-22 14:36:45 +0200628TEST_F(TestFrameBuffer2, DontDecodeOlderTimestamp) {
philipelcb327d92020-12-10 10:49:20 +0100629 InsertFrame(2, 0, 1, true, kFrameSize);
630 InsertFrame(1, 0, 2, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200631 kFrameSize); // Older picture id but newer timestamp.
philipel6d216502018-10-22 14:36:45 +0200632 ExtractFrame(0);
633 ExtractFrame(0);
634 CheckFrame(0, 1, 0);
635 CheckNoFrame(1);
636
philipelcb327d92020-12-10 10:49:20 +0100637 InsertFrame(3, 0, 4, true, kFrameSize);
638 InsertFrame(4, 0, 3, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200639 kFrameSize); // Newer picture id but older timestamp.
philipel6d216502018-10-22 14:36:45 +0200640 ExtractFrame(0);
641 ExtractFrame(0);
642 CheckFrame(2, 3, 0);
643 CheckNoFrame(3);
644}
645
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100646TEST_F(TestFrameBuffer2, CombineFramesToSuperframe) {
647 uint16_t pid = Rand();
648 uint32_t ts = Rand();
649
philipelcb327d92020-12-10 10:49:20 +0100650 InsertFrame(pid, 0, ts, false, kFrameSize);
651 InsertFrame(pid + 1, 1, ts, true, 2 * kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100652 ExtractFrame(0);
653 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100654 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100655 CheckNoFrame(1);
656 // Two frames should be combined and returned together.
Sergey Silkin2799e632019-05-17 09:51:39 +0200657 CheckFrameSize(0, 3 * kFrameSize);
658
659 EXPECT_EQ(frames_[0]->SpatialIndex(), 1);
660 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(0), kFrameSize);
661 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(1), 2 * kFrameSize);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100662}
663
664TEST_F(TestFrameBuffer2, HigherSpatialLayerNonDecodable) {
665 uint16_t pid = Rand();
666 uint32_t ts = Rand();
667
philipelcb327d92020-12-10 10:49:20 +0100668 InsertFrame(pid, 0, ts, false, kFrameSize);
669 InsertFrame(pid + 1, 1, ts, true, kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100670
671 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100672 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100673
philipelcb327d92020-12-10 10:49:20 +0100674 InsertFrame(pid + 3, 1, ts + kFps20, true, kFrameSize, pid);
675 InsertFrame(pid + 4, 0, ts + kFps10, false, kFrameSize, pid);
676 InsertFrame(pid + 5, 1, ts + kFps10, true, kFrameSize, pid + 3, pid + 4);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100677
Danil Chapovalov55284022020-02-07 14:53:52 +0100678 time_controller_.AdvanceTime(TimeDelta::Millis(1000));
philipelcb327d92020-12-10 10:49:20 +0100679 // Frame pid+3 is decodable but too late.
680 // In superframe pid+4 is decodable, but frame pid+5 is not.
681 // Incorrect implementation might skip pid+2 frame and output undecodable
682 // pid+5 instead.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100683 ExtractFrame();
684 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100685 CheckFrame(1, pid + 3, 1);
686 CheckFrame(2, pid + 4, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100687}
688
philipelbe7a9e52016-05-19 12:19:35 +0200689} // namespace video_coding
690} // namespace webrtc