blob: e179dadd5412aab455c6032ba81ae8a924327c12 [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
Ilya Nikolaevskiy8c4fe162018-02-27 15:49:47 +010058 int64_t MaxWaitingTime(int64_t render_time_ms,
59 int64_t now_ms) const override {
60 return render_time_ms - now_ms - kDecodeTime;
philipelbe7a9e52016-05-19 12:19:35 +020061 }
62
Johannes Kronbfd343b2019-07-01 10:07:50 +020063 bool GetTimings(int* max_decode_ms,
philipela45102f2017-02-22 05:30:39 -080064 int* current_delay_ms,
65 int* target_delay_ms,
66 int* jitter_buffer_ms,
67 int* min_playout_delay_ms,
68 int* render_delay_ms) const override {
69 return true;
70 }
71
Niels Möller7cca0422019-04-29 16:12:19 +020072 int GetCurrentJitter() {
Niels Möller7cca0422019-04-29 16:12:19 +020073 int max_decode_ms;
74 int current_delay_ms;
75 int target_delay_ms;
76 int jitter_buffer_ms;
77 int min_playout_delay_ms;
78 int render_delay_ms;
Johannes Kronbfd343b2019-07-01 10:07:50 +020079 VCMTiming::GetTimings(&max_decode_ms, &current_delay_ms, &target_delay_ms,
80 &jitter_buffer_ms, &min_playout_delay_ms,
81 &render_delay_ms);
Niels Möller7cca0422019-04-29 16:12:19 +020082 return jitter_buffer_ms;
83 }
84
philipelbe7a9e52016-05-19 12:19:35 +020085 private:
86 static constexpr int kDelayMs = 50;
87 static constexpr int kDecodeTime = kDelayMs / 2;
88 mutable uint32_t last_timestamp_ = 0;
89 mutable int64_t last_ms_ = -1;
90};
91
philipele7c891f2018-02-22 14:35:06 +010092class FrameObjectFake : public EncodedFrame {
philipelbe7a9e52016-05-19 12:19:35 +020093 public:
philipelb4d31082016-07-11 08:46:29 -070094 int64_t ReceivedTime() const override { return 0; }
95
96 int64_t RenderTime() const override { return _renderTimeMs; }
Niels Möller7cca0422019-04-29 16:12:19 +020097
98 bool delayed_by_retransmission() const override {
99 return delayed_by_retransmission_;
100 }
101 void set_delayed_by_retransmission(bool delayed) {
102 delayed_by_retransmission_ = delayed;
103 }
104
105 private:
106 bool delayed_by_retransmission_ = false;
philipela45102f2017-02-22 05:30:39 -0800107};
108
109class VCMReceiveStatisticsCallbackMock : public VCMReceiveStatisticsCallback {
110 public:
Danil Chapovalovf2c0f152020-05-19 13:20:27 +0200111 MOCK_METHOD(void,
112 OnCompleteFrame,
113 (bool is_keyframe,
114 size_t size_bytes,
115 VideoContentType content_type),
116 (override));
117 MOCK_METHOD(void, OnDroppedFrames, (uint32_t frames_dropped), (override));
118 MOCK_METHOD(void,
119 OnFrameBufferTimingsUpdated,
120 (int max_decode_ms,
121 int current_delay_ms,
122 int target_delay_ms,
123 int jitter_buffer_ms,
124 int min_playout_delay_ms,
125 int render_delay_ms),
126 (override));
127 MOCK_METHOD(void,
128 OnTimingFrameInfoUpdated,
129 (const TimingFrameInfo& info),
130 (override));
philipelbe7a9e52016-05-19 12:19:35 +0200131};
132
133class TestFrameBuffer2 : public ::testing::Test {
134 protected:
135 static constexpr int kMaxReferences = 5;
136 static constexpr int kFps1 = 1000;
137 static constexpr int kFps10 = kFps1 / 10;
138 static constexpr int kFps20 = kFps1 / 20;
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100139 static constexpr size_t kFrameSize = 10;
philipelbe7a9e52016-05-19 12:19:35 +0200140
141 TestFrameBuffer2()
Niels Möller7cca0422019-04-29 16:12:19 +0200142 : trial_("WebRTC-AddRttToPlayoutDelay/Enabled/"),
Danil Chapovalov55284022020-02-07 14:53:52 +0100143 time_controller_(Timestamp::Seconds(0)),
philipel19053972020-01-29 17:36:11 +0100144 time_task_queue_(
145 time_controller_.GetTaskQueueFactory()->CreateTaskQueue(
146 "extract queue",
147 TaskQueueFactory::Priority::NORMAL)),
148 timing_(time_controller_.GetClock()),
149 buffer_(new FrameBuffer(time_controller_.GetClock(),
150 &timing_,
151 &stats_callback_)),
152 rand_(0x34678213) {}
philipelbe7a9e52016-05-19 12:19:35 +0200153
154 template <typename... T>
Niels Möller7cca0422019-04-29 16:12:19 +0200155 std::unique_ptr<FrameObjectFake> CreateFrame(uint16_t picture_id,
156 uint8_t spatial_layer,
157 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200158 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200159 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200160 T... refs) {
philipelbe7a9e52016-05-19 12:19:35 +0200161 static_assert(sizeof...(refs) <= kMaxReferences,
philipele7c891f2018-02-22 14:35:06 +0100162 "To many references specified for EncodedFrame.");
kwiberg5b9746e2017-08-16 04:52:35 -0700163 std::array<uint16_t, sizeof...(refs)> references = {
164 {rtc::checked_cast<uint16_t>(refs)...}};
philipelbe7a9e52016-05-19 12:19:35 +0200165
Mirko Bonadei317a1f02019-09-17 17:06:18 +0200166 auto frame = std::make_unique<FrameObjectFake>();
philipel9aa9b8d2021-02-15 13:31:29 +0100167 frame->SetId(picture_id);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100168 frame->SetSpatialIndex(spatial_layer);
Niels Möller23775882018-08-16 10:24:12 +0200169 frame->SetTimestamp(ts_ms * 90);
philipelbe7a9e52016-05-19 12:19:35 +0200170 frame->num_references = references.size();
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100171 frame->is_last_spatial_layer = last_spatial_layer;
172 // Add some data to buffer.
Niels Möllerb9bfe652019-10-03 08:43:53 +0200173 frame->SetEncodedData(EncodedImageBuffer::Create(frame_size_bytes));
philipelbe7a9e52016-05-19 12:19:35 +0200174 for (size_t r = 0; r < references.size(); ++r)
175 frame->references[r] = references[r];
Niels Möller7cca0422019-04-29 16:12:19 +0200176 return frame;
177 }
philipelbe7a9e52016-05-19 12:19:35 +0200178
Niels Möller7cca0422019-04-29 16:12:19 +0200179 template <typename... T>
180 int InsertFrame(uint16_t picture_id,
181 uint8_t spatial_layer,
182 int64_t ts_ms,
Niels Möller7cca0422019-04-29 16:12:19 +0200183 bool last_spatial_layer,
Sergey Silkin2799e632019-05-17 09:51:39 +0200184 size_t frame_size_bytes,
Niels Möller7cca0422019-04-29 16:12:19 +0200185 T... refs) {
philipelcb327d92020-12-10 10:49:20 +0100186 return buffer_->InsertFrame(CreateFrame(picture_id, spatial_layer, ts_ms,
187 last_spatial_layer,
188 frame_size_bytes, refs...));
Niels Möller7cca0422019-04-29 16:12:19 +0200189 }
190
191 int InsertNackedFrame(uint16_t picture_id, int64_t ts_ms) {
192 std::unique_ptr<FrameObjectFake> frame =
philipelcb327d92020-12-10 10:49:20 +0100193 CreateFrame(picture_id, 0, ts_ms, true, kFrameSize);
Niels Möller7cca0422019-04-29 16:12:19 +0200194 frame->set_delayed_by_retransmission(true);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200195 return buffer_->InsertFrame(std::move(frame));
philipelbe7a9e52016-05-19 12:19:35 +0200196 }
197
philipel3042c2d2017-08-18 04:55:02 -0700198 void ExtractFrame(int64_t max_wait_time = 0, bool keyframe_required = false) {
philipel19053972020-01-29 17:36:11 +0100199 time_task_queue_.PostTask([this, max_wait_time, keyframe_required]() {
200 buffer_->NextFrame(
201 max_wait_time, keyframe_required, &time_task_queue_,
202 [this](std::unique_ptr<video_coding::EncodedFrame> frame,
203 video_coding::FrameBuffer::ReturnReason reason) {
204 if (reason != FrameBuffer::ReturnReason::kStopped) {
205 frames_.emplace_back(std::move(frame));
206 }
207 });
208 });
philipelbe7a9e52016-05-19 12:19:35 +0200209 if (max_wait_time == 0) {
Danil Chapovalov55284022020-02-07 14:53:52 +0100210 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200211 }
212 }
213
214 void CheckFrame(size_t index, int picture_id, int spatial_layer) {
philipelbe7a9e52016-05-19 12:19:35 +0200215 ASSERT_LT(index, frames_.size());
216 ASSERT_TRUE(frames_[index]);
philipel9aa9b8d2021-02-15 13:31:29 +0100217 ASSERT_EQ(picture_id, frames_[index]->Id());
philipelcb327d92020-12-10 10:49:20 +0100218 ASSERT_EQ(spatial_layer, frames_[index]->SpatialIndex().value_or(0));
philipelbe7a9e52016-05-19 12:19:35 +0200219 }
220
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100221 void CheckFrameSize(size_t index, size_t size) {
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100222 ASSERT_LT(index, frames_.size());
223 ASSERT_TRUE(frames_[index]);
224 ASSERT_EQ(frames_[index]->size(), size);
225 }
226
philipelbe7a9e52016-05-19 12:19:35 +0200227 void CheckNoFrame(size_t index) {
philipelbe7a9e52016-05-19 12:19:35 +0200228 ASSERT_LT(index, frames_.size());
229 ASSERT_FALSE(frames_[index]);
230 }
231
philipelbe7a9e52016-05-19 12:19:35 +0200232 uint32_t Rand() { return rand_.Rand<uint32_t>(); }
233
Niels Möller7cca0422019-04-29 16:12:19 +0200234 // The ProtectionMode tests depends on rtt-multiplier experiment.
235 test::ScopedFieldTrials trial_;
philipel19053972020-01-29 17:36:11 +0100236 webrtc::GlobalSimulatedTimeController time_controller_;
237 rtc::TaskQueue time_task_queue_;
philipelbe7a9e52016-05-19 12:19:35 +0200238 VCMTimingFake timing_;
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200239 std::unique_ptr<FrameBuffer> buffer_;
philipele7c891f2018-02-22 14:35:06 +0100240 std::vector<std::unique_ptr<EncodedFrame>> frames_;
philipelbe7a9e52016-05-19 12:19:35 +0200241 Random rand_;
philipela45102f2017-02-22 05:30:39 -0800242 ::testing::NiceMock<VCMReceiveStatisticsCallbackMock> stats_callback_;
philipelbe7a9e52016-05-19 12:19:35 +0200243};
244
Sergey Silkin2799e632019-05-17 09:51:39 +0200245// From https://en.cppreference.com/w/cpp/language/static: "If ... a constexpr
246// static data member (since C++11) is odr-used, a definition at namespace scope
247// is still required... This definition is deprecated for constexpr data members
248// since C++17."
249// kFrameSize is odr-used since it is passed by reference to EXPECT_EQ().
250#if __cplusplus < 201703L
251constexpr size_t TestFrameBuffer2::kFrameSize;
252#endif
253
philipelbe7a9e52016-05-19 12:19:35 +0200254TEST_F(TestFrameBuffer2, WaitForFrame) {
255 uint16_t pid = Rand();
256 uint32_t ts = Rand();
257
philipel6e8224f2016-05-19 17:07:44 +0200258 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100259 InsertFrame(pid, 0, ts, true, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100260 time_controller_.AdvanceTime(TimeDelta::Millis(50));
philipelbe7a9e52016-05-19 12:19:35 +0200261 CheckFrame(0, pid, 0);
262}
263
264TEST_F(TestFrameBuffer2, OneSuperFrame) {
265 uint16_t pid = Rand();
266 uint32_t ts = Rand();
267
philipelcb327d92020-12-10 10:49:20 +0100268 InsertFrame(pid, 0, ts, false, kFrameSize);
269 InsertFrame(pid + 1, 1, ts, true, kFrameSize);
philipele0b2f152016-09-28 10:23:49 +0200270 ExtractFrame();
271
Sergey Silkin61832dd2018-12-20 14:32:14 +0100272 CheckFrame(0, pid, 1);
philipele0b2f152016-09-28 10:23:49 +0200273}
274
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200275TEST_F(TestFrameBuffer2, ZeroPlayoutDelay) {
philipel19053972020-01-29 17:36:11 +0100276 VCMTiming timing(time_controller_.GetClock());
277 buffer_.reset(
278 new FrameBuffer(time_controller_.GetClock(), &timing, &stats_callback_));
Niels Möllerd381eed2020-09-02 15:34:40 +0200279 const VideoPlayoutDelay kPlayoutDelayMs = {0, 0};
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200280 std::unique_ptr<FrameObjectFake> test_frame(new FrameObjectFake());
philipel9aa9b8d2021-02-15 13:31:29 +0100281 test_frame->SetId(0);
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200282 test_frame->SetPlayoutDelay(kPlayoutDelayMs);
283 buffer_->InsertFrame(std::move(test_frame));
284 ExtractFrame(0, false);
285 CheckFrame(0, 0, 0);
286 EXPECT_EQ(0, frames_[0]->RenderTimeMs());
287}
288
aleloi3e005282017-01-26 05:38:00 -0800289// Flaky test, see bugs.webrtc.org/7068.
290TEST_F(TestFrameBuffer2, DISABLED_OneUnorderedSuperFrame) {
philipele0b2f152016-09-28 10:23:49 +0200291 uint16_t pid = Rand();
292 uint32_t ts = Rand();
293
philipel6e8224f2016-05-19 17:07:44 +0200294 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100295 InsertFrame(pid, 1, ts, true, kFrameSize);
296 InsertFrame(pid, 0, ts, false, kFrameSize);
Danil Chapovalov55284022020-02-07 14:53:52 +0100297 time_controller_.AdvanceTime(TimeDelta::Millis(0));
philipelbe7a9e52016-05-19 12:19:35 +0200298
299 CheckFrame(0, pid, 0);
300 CheckFrame(1, pid, 1);
301}
302
philipel94616b32016-05-20 10:43:01 +0200303TEST_F(TestFrameBuffer2, DISABLED_OneLayerStreamReordered) {
philipel6e8224f2016-05-19 17:07:44 +0200304 uint16_t pid = Rand();
305 uint32_t ts = Rand();
306
Sergey Silkin2799e632019-05-17 09:51:39 +0200307 InsertFrame(pid, 0, ts, false, true, kFrameSize);
philipel6e8224f2016-05-19 17:07:44 +0200308 ExtractFrame();
309 CheckFrame(0, pid, 0);
310 for (int i = 1; i < 10; i += 2) {
311 ExtractFrame(50);
philipelcb327d92020-12-10 10:49:20 +0100312 InsertFrame(pid + i + 1, 0, ts + (i + 1) * kFps10, true, kFrameSize,
Sergey Silkin2799e632019-05-17 09:51:39 +0200313 pid + i);
Danil Chapovalov55284022020-02-07 14:53:52 +0100314 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelcb327d92020-12-10 10:49:20 +0100315 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Danil Chapovalov55284022020-02-07 14:53:52 +0100316 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipel6e8224f2016-05-19 17:07:44 +0200317 ExtractFrame();
318 CheckFrame(i, pid + i, 0);
319 CheckFrame(i + 1, pid + i + 1, 0);
320 }
321}
philipel6e8224f2016-05-19 17:07:44 +0200322
323TEST_F(TestFrameBuffer2, ExtractFromEmptyBuffer) {
324 ExtractFrame();
325 CheckNoFrame(0);
326}
327
philipel93e451b2016-10-06 12:25:13 +0200328TEST_F(TestFrameBuffer2, MissingFrame) {
329 uint16_t pid = Rand();
330 uint32_t ts = Rand();
331
philipelcb327d92020-12-10 10:49:20 +0100332 InsertFrame(pid, 0, ts, true, kFrameSize);
333 InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid);
334 InsertFrame(pid + 3, 0, ts, true, kFrameSize, pid + 1, pid + 2);
philipel93e451b2016-10-06 12:25:13 +0200335 ExtractFrame();
336 ExtractFrame();
337 ExtractFrame();
338
339 CheckFrame(0, pid, 0);
340 CheckFrame(1, pid + 2, 0);
341 CheckNoFrame(2);
342}
343
philipelbe7a9e52016-05-19 12:19:35 +0200344TEST_F(TestFrameBuffer2, OneLayerStream) {
345 uint16_t pid = Rand();
346 uint32_t ts = Rand();
347
philipelcb327d92020-12-10 10:49:20 +0100348 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200349 ExtractFrame();
350 CheckFrame(0, pid, 0);
351 for (int i = 1; i < 10; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100352 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200353 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100354 time_controller_.AdvanceTime(TimeDelta::Millis(kFps10));
philipelbe7a9e52016-05-19 12:19:35 +0200355 CheckFrame(i, pid + i, 0);
356 }
357}
358
philipelbe7a9e52016-05-19 12:19:35 +0200359TEST_F(TestFrameBuffer2, DropTemporalLayerSlowDecoder) {
360 uint16_t pid = Rand();
361 uint32_t ts = Rand();
362
philipelcb327d92020-12-10 10:49:20 +0100363 InsertFrame(pid, 0, ts, true, kFrameSize);
364 InsertFrame(pid + 1, 0, ts + kFps20, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200365 for (int i = 2; i < 10; i += 2) {
366 uint32_t ts_tl0 = ts + i / 2 * kFps10;
philipelcb327d92020-12-10 10:49:20 +0100367 InsertFrame(pid + i, 0, ts_tl0, true, kFrameSize, pid + i - 2);
368 InsertFrame(pid + i + 1, 0, ts_tl0 + kFps20, true, kFrameSize, pid + i,
369 pid + i - 1);
philipelbe7a9e52016-05-19 12:19:35 +0200370 }
371
Johannes Kron0c141c52019-08-26 15:04:43 +0200372 EXPECT_CALL(stats_callback_, OnDroppedFrames(1)).Times(3);
373
philipelbe7a9e52016-05-19 12:19:35 +0200374 for (int i = 0; i < 10; ++i) {
375 ExtractFrame();
Danil Chapovalov55284022020-02-07 14:53:52 +0100376 time_controller_.AdvanceTime(TimeDelta::Millis(70));
philipelbe7a9e52016-05-19 12:19:35 +0200377 }
378
379 CheckFrame(0, pid, 0);
380 CheckFrame(1, pid + 1, 0);
381 CheckFrame(2, pid + 2, 0);
382 CheckFrame(3, pid + 4, 0);
383 CheckFrame(4, pid + 6, 0);
384 CheckFrame(5, pid + 8, 0);
385 CheckNoFrame(6);
386 CheckNoFrame(7);
387 CheckNoFrame(8);
388 CheckNoFrame(9);
389}
390
Johannes Kron0c141c52019-08-26 15:04:43 +0200391TEST_F(TestFrameBuffer2, DropFramesIfSystemIsStalled) {
392 uint16_t pid = Rand();
393 uint32_t ts = Rand();
394
philipelcb327d92020-12-10 10:49:20 +0100395 InsertFrame(pid, 0, ts, true, kFrameSize);
396 InsertFrame(pid + 1, 0, ts + 1 * kFps10, true, kFrameSize, pid);
397 InsertFrame(pid + 2, 0, ts + 2 * kFps10, true, kFrameSize, pid + 1);
398 InsertFrame(pid + 3, 0, ts + 3 * kFps10, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200399
400 ExtractFrame();
401 // Jump forward in time, simulating the system being stalled for some reason.
Danil Chapovalov55284022020-02-07 14:53:52 +0100402 time_controller_.AdvanceTime(TimeDelta::Millis(3) * kFps10);
Johannes Kron0c141c52019-08-26 15:04:43 +0200403 // Extract one more frame, expect second and third frame to be dropped.
404 EXPECT_CALL(stats_callback_, OnDroppedFrames(2)).Times(1);
405 ExtractFrame();
406
407 CheckFrame(0, pid + 0, 0);
408 CheckFrame(1, pid + 3, 0);
409}
410
411TEST_F(TestFrameBuffer2, DroppedFramesCountedOnClear) {
412 uint16_t pid = Rand();
413 uint32_t ts = Rand();
414
philipelcb327d92020-12-10 10:49:20 +0100415 InsertFrame(pid, 0, ts, true, kFrameSize);
Johannes Kron0c141c52019-08-26 15:04:43 +0200416 for (int i = 1; i < 5; ++i) {
philipelcb327d92020-12-10 10:49:20 +0100417 InsertFrame(pid + i, 0, ts + i * kFps10, true, kFrameSize, pid + i - 1);
Johannes Kron0c141c52019-08-26 15:04:43 +0200418 }
419
420 // All frames should be dropped when Clear is called.
421 EXPECT_CALL(stats_callback_, OnDroppedFrames(5)).Times(1);
422 buffer_->Clear();
423}
424
philipelbe7a9e52016-05-19 12:19:35 +0200425TEST_F(TestFrameBuffer2, InsertLateFrame) {
426 uint16_t pid = Rand();
427 uint32_t ts = Rand();
428
philipelcb327d92020-12-10 10:49:20 +0100429 InsertFrame(pid, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200430 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100431 InsertFrame(pid + 2, 0, ts, true, kFrameSize);
philipelbe7a9e52016-05-19 12:19:35 +0200432 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100433 InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid);
philipelbe7a9e52016-05-19 12:19:35 +0200434 ExtractFrame();
435
436 CheckFrame(0, pid, 0);
437 CheckFrame(1, pid + 2, 0);
438 CheckNoFrame(2);
439}
440
Niels Möller7cca0422019-04-29 16:12:19 +0200441TEST_F(TestFrameBuffer2, ProtectionModeNackFEC) {
philipel4f6cd6a2016-08-03 10:59:32 +0200442 uint16_t pid = Rand();
443 uint32_t ts = Rand();
Niels Möller7cca0422019-04-29 16:12:19 +0200444 constexpr int64_t kRttMs = 200;
445 buffer_->UpdateRtt(kRttMs);
philipel4f6cd6a2016-08-03 10:59:32 +0200446
Niels Möller7cca0422019-04-29 16:12:19 +0200447 // Jitter estimate unaffected by RTT in this protection mode.
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200448 buffer_->SetProtectionMode(kProtectionNackFEC);
Niels Möller7cca0422019-04-29 16:12:19 +0200449 InsertNackedFrame(pid, ts);
450 InsertNackedFrame(pid + 1, ts + 100);
451 InsertNackedFrame(pid + 2, ts + 200);
philipelcb327d92020-12-10 10:49:20 +0100452 InsertFrame(pid + 3, 0, ts + 300, true, kFrameSize);
philipel4f6cd6a2016-08-03 10:59:32 +0200453 ExtractFrame();
Niels Möller7cca0422019-04-29 16:12:19 +0200454 ExtractFrame();
455 ExtractFrame();
456 ExtractFrame();
457 ASSERT_EQ(4u, frames_.size());
458 EXPECT_LT(timing_.GetCurrentJitter(), kRttMs);
459}
460
461TEST_F(TestFrameBuffer2, ProtectionModeNack) {
462 uint16_t pid = Rand();
463 uint32_t ts = Rand();
464 constexpr int64_t kRttMs = 200;
465
466 buffer_->UpdateRtt(kRttMs);
467
468 // Jitter estimate includes RTT (after 3 retransmitted packets)
469 buffer_->SetProtectionMode(kProtectionNack);
470 InsertNackedFrame(pid, ts);
471 InsertNackedFrame(pid + 1, ts + 100);
472 InsertNackedFrame(pid + 2, ts + 200);
philipelcb327d92020-12-10 10:49:20 +0100473 InsertFrame(pid + 3, 0, ts + 300, true, kFrameSize);
Niels Möller7cca0422019-04-29 16:12:19 +0200474 ExtractFrame();
475 ExtractFrame();
476 ExtractFrame();
477 ExtractFrame();
478 ASSERT_EQ(4u, frames_.size());
479
480 EXPECT_GT(timing_.GetCurrentJitter(), kRttMs);
philipel4f6cd6a2016-08-03 10:59:32 +0200481}
482
philipele0b2f152016-09-28 10:23:49 +0200483TEST_F(TestFrameBuffer2, NoContinuousFrame) {
484 uint16_t pid = Rand();
485 uint32_t ts = Rand();
486
philipelcb327d92020-12-10 10:49:20 +0100487 EXPECT_EQ(-1, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
philipele0b2f152016-09-28 10:23:49 +0200488}
489
490TEST_F(TestFrameBuffer2, LastContinuousFrameSingleLayer) {
491 uint16_t pid = Rand();
492 uint32_t ts = Rand();
493
philipelcb327d92020-12-10 10:49:20 +0100494 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
495 EXPECT_EQ(pid, InsertFrame(pid + 2, 0, ts, true, kFrameSize, pid + 1));
496 EXPECT_EQ(pid + 2, InsertFrame(pid + 1, 0, ts, true, kFrameSize, pid));
497 EXPECT_EQ(pid + 2, InsertFrame(pid + 4, 0, ts, true, kFrameSize, pid + 3));
498 EXPECT_EQ(pid + 5, InsertFrame(pid + 5, 0, ts, true, kFrameSize));
philipele0b2f152016-09-28 10:23:49 +0200499}
500
501TEST_F(TestFrameBuffer2, LastContinuousFrameTwoLayers) {
502 uint16_t pid = Rand();
503 uint32_t ts = Rand();
504
philipelcb327d92020-12-10 10:49:20 +0100505 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, false, kFrameSize));
506 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 1, ts, true, kFrameSize));
507 EXPECT_EQ(pid + 1,
508 InsertFrame(pid + 3, 1, ts, true, kFrameSize, pid + 1, pid + 2));
509 EXPECT_EQ(pid + 1, InsertFrame(pid + 4, 0, ts, false, kFrameSize, pid + 2));
510 EXPECT_EQ(pid + 1,
511 InsertFrame(pid + 5, 1, ts, true, kFrameSize, pid + 3, pid + 4));
512 EXPECT_EQ(pid + 1, InsertFrame(pid + 6, 0, ts, false, kFrameSize, pid + 4));
513 EXPECT_EQ(pid + 6, InsertFrame(pid + 2, 0, ts, false, kFrameSize, pid));
514 EXPECT_EQ(pid + 7,
515 InsertFrame(pid + 7, 1, ts, true, kFrameSize, pid + 5, pid + 6));
philipele0b2f152016-09-28 10:23:49 +0200516}
517
philipelfcc60062017-01-18 05:35:20 -0800518TEST_F(TestFrameBuffer2, PictureIdJumpBack) {
519 uint16_t pid = Rand();
520 uint32_t ts = Rand();
521
philipelcb327d92020-12-10 10:49:20 +0100522 EXPECT_EQ(pid, InsertFrame(pid, 0, ts, true, kFrameSize));
523 EXPECT_EQ(pid + 1, InsertFrame(pid + 1, 0, ts + 1, true, kFrameSize, pid));
philipelfcc60062017-01-18 05:35:20 -0800524 ExtractFrame();
525 CheckFrame(0, pid, 0);
526
527 // Jump back in pid but increase ts.
philipelcb327d92020-12-10 10:49:20 +0100528 EXPECT_EQ(pid - 1, InsertFrame(pid - 1, 0, ts + 2, true, kFrameSize));
philipelfcc60062017-01-18 05:35:20 -0800529 ExtractFrame();
530 ExtractFrame();
531 CheckFrame(1, pid - 1, 0);
532 CheckNoFrame(2);
533}
534
philipela45102f2017-02-22 05:30:39 -0800535TEST_F(TestFrameBuffer2, StatsCallback) {
536 uint16_t pid = Rand();
537 uint32_t ts = Rand();
538 const int kFrameSize = 5000;
539
ilnik6d5b4d62017-08-30 03:32:14 -0700540 EXPECT_CALL(stats_callback_,
541 OnCompleteFrame(true, kFrameSize, VideoContentType::UNSPECIFIED));
Johannes Kronbfd343b2019-07-01 10:07:50 +0200542 EXPECT_CALL(stats_callback_, OnFrameBufferTimingsUpdated(_, _, _, _, _, _));
philipela45102f2017-02-22 05:30:39 -0800543
544 {
545 std::unique_ptr<FrameObjectFake> frame(new FrameObjectFake());
Niels Möllerb9bfe652019-10-03 08:43:53 +0200546 frame->SetEncodedData(EncodedImageBuffer::Create(kFrameSize));
philipel9aa9b8d2021-02-15 13:31:29 +0100547 frame->SetId(pid);
Niels Möller23775882018-08-16 10:24:12 +0200548 frame->SetTimestamp(ts);
philipela45102f2017-02-22 05:30:39 -0800549 frame->num_references = 0;
philipela45102f2017-02-22 05:30:39 -0800550
Stefan Holmer812ceaf2018-05-15 13:00:10 +0200551 EXPECT_EQ(buffer_->InsertFrame(std::move(frame)), pid);
philipela45102f2017-02-22 05:30:39 -0800552 }
553
554 ExtractFrame();
555 CheckFrame(0, pid, 0);
556}
557
philipel146a48b2017-04-20 04:04:38 -0700558TEST_F(TestFrameBuffer2, ForwardJumps) {
philipelcb327d92020-12-10 10:49:20 +0100559 EXPECT_EQ(5453, InsertFrame(5453, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700560 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100561 EXPECT_EQ(5454, InsertFrame(5454, 0, 1, true, kFrameSize, 5453));
philipel146a48b2017-04-20 04:04:38 -0700562 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100563 EXPECT_EQ(15670, InsertFrame(15670, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700564 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100565 EXPECT_EQ(29804, InsertFrame(29804, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700566 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100567 EXPECT_EQ(29805, InsertFrame(29805, 0, 1, true, kFrameSize, 29804));
philipel146a48b2017-04-20 04:04:38 -0700568 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100569 EXPECT_EQ(29806, InsertFrame(29806, 0, 1, true, kFrameSize, 29805));
philipel146a48b2017-04-20 04:04:38 -0700570 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100571 EXPECT_EQ(33819, InsertFrame(33819, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700572 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100573 EXPECT_EQ(41248, InsertFrame(41248, 0, 1, true, kFrameSize));
philipel146a48b2017-04-20 04:04:38 -0700574 ExtractFrame();
575}
576
philipelf6842692017-04-28 03:29:15 -0700577TEST_F(TestFrameBuffer2, DuplicateFrames) {
philipelcb327d92020-12-10 10:49:20 +0100578 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700579 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100580 EXPECT_EQ(22256, InsertFrame(22256, 0, 1, true, kFrameSize));
philipelf6842692017-04-28 03:29:15 -0700581}
582
philipel112adf92017-06-15 09:06:21 -0700583// TODO(philipel): implement more unittests related to invalid references.
584TEST_F(TestFrameBuffer2, InvalidReferences) {
philipelcb327d92020-12-10 10:49:20 +0100585 EXPECT_EQ(-1, InsertFrame(0, 0, 1000, true, kFrameSize, 2));
586 EXPECT_EQ(1, InsertFrame(1, 0, 2000, true, kFrameSize));
philipel112adf92017-06-15 09:06:21 -0700587 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100588 EXPECT_EQ(2, InsertFrame(2, 0, 3000, true, kFrameSize, 1));
philipel112adf92017-06-15 09:06:21 -0700589}
590
philipel3042c2d2017-08-18 04:55:02 -0700591TEST_F(TestFrameBuffer2, KeyframeRequired) {
philipelcb327d92020-12-10 10:49:20 +0100592 EXPECT_EQ(1, InsertFrame(1, 0, 1000, true, kFrameSize));
593 EXPECT_EQ(2, InsertFrame(2, 0, 2000, true, kFrameSize, 1));
594 EXPECT_EQ(3, InsertFrame(3, 0, 3000, true, kFrameSize));
philipel3042c2d2017-08-18 04:55:02 -0700595 ExtractFrame();
596 ExtractFrame(0, true);
597 ExtractFrame();
598
599 CheckFrame(0, 1, 0);
600 CheckFrame(1, 3, 0);
601 CheckNoFrame(2);
602}
603
philipel9771c502018-03-02 11:06:27 +0100604TEST_F(TestFrameBuffer2, KeyframeClearsFullBuffer) {
605 const int kMaxBufferSize = 600;
606
607 for (int i = 1; i <= kMaxBufferSize; ++i)
philipelcb327d92020-12-10 10:49:20 +0100608 EXPECT_EQ(-1, InsertFrame(i, 0, i * 1000, true, kFrameSize, i - 1));
philipel9771c502018-03-02 11:06:27 +0100609 ExtractFrame();
610 CheckNoFrame(0);
611
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100612 EXPECT_EQ(kMaxBufferSize + 1,
613 InsertFrame(kMaxBufferSize + 1, 0, (kMaxBufferSize + 1) * 1000,
philipelcb327d92020-12-10 10:49:20 +0100614 true, kFrameSize));
philipel9771c502018-03-02 11:06:27 +0100615 ExtractFrame();
616 CheckFrame(1, kMaxBufferSize + 1, 0);
617}
618
philipel798b2822018-06-11 13:10:14 +0200619TEST_F(TestFrameBuffer2, DontUpdateOnUndecodableFrame) {
philipelcb327d92020-12-10 10:49:20 +0100620 InsertFrame(1, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200621 ExtractFrame(0, true);
philipelcb327d92020-12-10 10:49:20 +0100622 InsertFrame(3, 0, 0, true, kFrameSize, 2, 0);
623 InsertFrame(3, 0, 0, true, kFrameSize, 0);
624 InsertFrame(2, 0, 0, true, kFrameSize);
philipel798b2822018-06-11 13:10:14 +0200625 ExtractFrame(0, true);
626 ExtractFrame(0, true);
627}
628
philipel6d216502018-10-22 14:36:45 +0200629TEST_F(TestFrameBuffer2, DontDecodeOlderTimestamp) {
philipelcb327d92020-12-10 10:49:20 +0100630 InsertFrame(2, 0, 1, true, kFrameSize);
631 InsertFrame(1, 0, 2, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200632 kFrameSize); // Older picture id but newer timestamp.
philipel6d216502018-10-22 14:36:45 +0200633 ExtractFrame(0);
634 ExtractFrame(0);
635 CheckFrame(0, 1, 0);
636 CheckNoFrame(1);
637
philipelcb327d92020-12-10 10:49:20 +0100638 InsertFrame(3, 0, 4, true, kFrameSize);
639 InsertFrame(4, 0, 3, true,
Sergey Silkin2799e632019-05-17 09:51:39 +0200640 kFrameSize); // Newer picture id but older timestamp.
philipel6d216502018-10-22 14:36:45 +0200641 ExtractFrame(0);
642 ExtractFrame(0);
643 CheckFrame(2, 3, 0);
644 CheckNoFrame(3);
645}
646
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100647TEST_F(TestFrameBuffer2, CombineFramesToSuperframe) {
648 uint16_t pid = Rand();
649 uint32_t ts = Rand();
650
philipelcb327d92020-12-10 10:49:20 +0100651 InsertFrame(pid, 0, ts, false, kFrameSize);
652 InsertFrame(pid + 1, 1, ts, true, 2 * kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100653 ExtractFrame(0);
654 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100655 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100656 CheckNoFrame(1);
657 // Two frames should be combined and returned together.
Sergey Silkin2799e632019-05-17 09:51:39 +0200658 CheckFrameSize(0, 3 * kFrameSize);
659
660 EXPECT_EQ(frames_[0]->SpatialIndex(), 1);
661 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(0), kFrameSize);
662 EXPECT_EQ(frames_[0]->SpatialLayerFrameSize(1), 2 * kFrameSize);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100663}
664
665TEST_F(TestFrameBuffer2, HigherSpatialLayerNonDecodable) {
666 uint16_t pid = Rand();
667 uint32_t ts = Rand();
668
philipelcb327d92020-12-10 10:49:20 +0100669 InsertFrame(pid, 0, ts, false, kFrameSize);
670 InsertFrame(pid + 1, 1, ts, true, kFrameSize, pid);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100671
672 ExtractFrame(0);
Sergey Silkin61832dd2018-12-20 14:32:14 +0100673 CheckFrame(0, pid, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100674
philipelcb327d92020-12-10 10:49:20 +0100675 InsertFrame(pid + 3, 1, ts + kFps20, true, kFrameSize, pid);
676 InsertFrame(pid + 4, 0, ts + kFps10, false, kFrameSize, pid);
677 InsertFrame(pid + 5, 1, ts + kFps10, true, kFrameSize, pid + 3, pid + 4);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100678
Danil Chapovalov55284022020-02-07 14:53:52 +0100679 time_controller_.AdvanceTime(TimeDelta::Millis(1000));
philipelcb327d92020-12-10 10:49:20 +0100680 // Frame pid+3 is decodable but too late.
681 // In superframe pid+4 is decodable, but frame pid+5 is not.
682 // Incorrect implementation might skip pid+2 frame and output undecodable
683 // pid+5 instead.
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100684 ExtractFrame();
685 ExtractFrame();
philipelcb327d92020-12-10 10:49:20 +0100686 CheckFrame(1, pid + 3, 1);
687 CheckFrame(2, pid + 4, 1);
Ilya Nikolaevskiy5546aef2018-12-04 15:54:52 +0100688}
689
philipelbe7a9e52016-05-19 12:19:35 +0200690} // namespace video_coding
691} // namespace webrtc