philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 1 | /* |
| 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 Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #include "modules/video_coding/frame_buffer2.h" |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 12 | |
| 13 | #include <algorithm> |
Yves Gerey | 3e70781 | 2018-11-28 16:47:49 +0100 | [diff] [blame] | 14 | #include <cstdlib> |
| 15 | #include <iterator> |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 16 | #include <memory> |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 17 | #include <queue> |
Yves Gerey | 3e70781 | 2018-11-28 16:47:49 +0100 | [diff] [blame] | 18 | #include <utility> |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 19 | #include <vector> |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 20 | |
Evan Shrubsole | f83d426 | 2021-12-15 15:05:15 +0100 | [diff] [blame] | 21 | #include "absl/container/inlined_vector.h" |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 22 | #include "api/units/data_size.h" |
| 23 | #include "api/units/time_delta.h" |
Yves Gerey | 3e70781 | 2018-11-28 16:47:49 +0100 | [diff] [blame] | 24 | #include "api/video/encoded_image.h" |
| 25 | #include "api/video/video_timing.h" |
Evan Shrubsole | f83d426 | 2021-12-15 15:05:15 +0100 | [diff] [blame] | 26 | #include "modules/video_coding/frame_helpers.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 27 | #include "modules/video_coding/include/video_coding_defines.h" |
| 28 | #include "modules/video_coding/jitter_estimator.h" |
| 29 | #include "modules/video_coding/timing.h" |
| 30 | #include "rtc_base/checks.h" |
Yves Gerey | 3e70781 | 2018-11-28 16:47:49 +0100 | [diff] [blame] | 31 | #include "rtc_base/experiments/rtt_mult_experiment.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 32 | #include "rtc_base/logging.h" |
Yves Gerey | 3e70781 | 2018-11-28 16:47:49 +0100 | [diff] [blame] | 33 | #include "rtc_base/numerics/sequence_number_util.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 34 | #include "rtc_base/trace_event.h" |
| 35 | #include "system_wrappers/include/clock.h" |
philipel | 707f278 | 2017-10-02 14:10:28 +0200 | [diff] [blame] | 36 | #include "system_wrappers/include/field_trial.h" |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 37 | |
| 38 | namespace webrtc { |
| 39 | namespace video_coding { |
| 40 | |
| 41 | namespace { |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 42 | // Max number of frames the buffer will hold. |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 43 | constexpr size_t kMaxFramesBuffered = 800; |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 44 | |
Johannes Kron | 23bfff3 | 2021-09-28 21:31:46 +0200 | [diff] [blame] | 45 | // Default value for the maximum decode queue size that is used when the |
| 46 | // low-latency renderer is used. |
| 47 | constexpr size_t kZeroPlayoutDelayDefaultMaxDecodeQueueSize = 8; |
| 48 | |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 49 | // Max number of decoded frame info that will be saved. |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 50 | constexpr int kMaxFramesHistory = 1 << 13; |
philipel | 65e1f94 | 2017-07-24 08:26:53 -0700 | [diff] [blame] | 51 | |
Ilya Nikolaevskiy | 8c4fe16 | 2018-02-27 15:49:47 +0100 | [diff] [blame] | 52 | // The time it's allowed for a frame to be late to its rendering prediction and |
| 53 | // still be rendered. |
Ilya Nikolaevskiy | 7eef007 | 2018-02-28 09:59:26 +0100 | [diff] [blame] | 54 | constexpr int kMaxAllowedFrameDelayMs = 5; |
Ilya Nikolaevskiy | 8c4fe16 | 2018-02-27 15:49:47 +0100 | [diff] [blame] | 55 | |
philipel | 65e1f94 | 2017-07-24 08:26:53 -0700 | [diff] [blame] | 56 | constexpr int64_t kLogNonDecodedIntervalMs = 5000; |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 57 | } // namespace |
| 58 | |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 59 | FrameBuffer::FrameBuffer(Clock* clock, |
philipel | a45102f | 2017-02-22 05:30:39 -0800 | [diff] [blame] | 60 | VCMTiming* timing, |
| 61 | VCMReceiveStatisticsCallback* stats_callback) |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 62 | : decoded_frames_history_(kMaxFramesHistory), |
| 63 | clock_(clock), |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 64 | callback_queue_(nullptr), |
Niels Möller | d9c2d94 | 2019-04-30 09:16:36 +0200 | [diff] [blame] | 65 | jitter_estimator_(clock), |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 66 | timing_(timing), |
philipel | 4f6cd6a | 2016-08-03 10:59:32 +0200 | [diff] [blame] | 67 | inter_frame_delay_(clock_->TimeInMilliseconds()), |
philipel | 29f730e | 2017-03-15 08:10:08 -0700 | [diff] [blame] | 68 | stopped_(false), |
philipel | a45102f | 2017-02-22 05:30:39 -0800 | [diff] [blame] | 69 | protection_mode_(kProtectionNack), |
philipel | 65e1f94 | 2017-07-24 08:26:53 -0700 | [diff] [blame] | 70 | stats_callback_(stats_callback), |
Elad Alon | e4b5023 | 2019-01-14 18:56:14 +0100 | [diff] [blame] | 71 | last_log_non_decoded_ms_(-kLogNonDecodedIntervalMs), |
Johannes Kron | 2ddc39e | 2021-08-10 16:56:12 +0200 | [diff] [blame] | 72 | rtt_mult_settings_(RttMultExperiment::GetRttMultValue()), |
Johannes Kron | 23bfff3 | 2021-09-28 21:31:46 +0200 | [diff] [blame] | 73 | zero_playout_delay_max_decode_queue_size_( |
| 74 | "max_decode_queue_size", |
| 75 | kZeroPlayoutDelayDefaultMaxDecodeQueueSize) { |
Johannes Kron | 2ddc39e | 2021-08-10 16:56:12 +0200 | [diff] [blame] | 76 | ParseFieldTrial({&zero_playout_delay_max_decode_queue_size_}, |
| 77 | field_trial::FindFullName("WebRTC-ZeroPlayoutDelay")); |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 78 | callback_checker_.Detach(); |
| 79 | } |
philipel | 266f0a4 | 2016-11-28 08:49:07 -0800 | [diff] [blame] | 80 | |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 81 | FrameBuffer::~FrameBuffer() { |
| 82 | RTC_DCHECK_RUN_ON(&construction_checker_); |
| 83 | } |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 84 | |
Evan Shrubsole | 3d29efd | 2021-12-07 14:11:45 +0100 | [diff] [blame] | 85 | void FrameBuffer::NextFrame(int64_t max_wait_time_ms, |
| 86 | bool keyframe_required, |
| 87 | rtc::TaskQueue* callback_queue, |
| 88 | NextFrameCallback handler) { |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 89 | RTC_DCHECK_RUN_ON(&callback_checker_); |
| 90 | RTC_DCHECK(callback_queue->IsCurrent()); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 91 | TRACE_EVENT0("webrtc", "FrameBuffer::NextFrame"); |
| 92 | int64_t latest_return_time_ms = |
| 93 | clock_->TimeInMilliseconds() + max_wait_time_ms; |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 94 | |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 95 | MutexLock lock(&mutex_); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 96 | if (stopped_) { |
| 97 | return; |
| 98 | } |
| 99 | latest_return_time_ms_ = latest_return_time_ms; |
| 100 | keyframe_required_ = keyframe_required; |
| 101 | frame_handler_ = handler; |
| 102 | callback_queue_ = callback_queue; |
| 103 | StartWaitForNextFrameOnQueue(); |
| 104 | } |
| 105 | |
| 106 | void FrameBuffer::StartWaitForNextFrameOnQueue() { |
| 107 | RTC_DCHECK(callback_queue_); |
| 108 | RTC_DCHECK(!callback_task_.Running()); |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 109 | int64_t wait_ms = FindNextFrame(clock_->CurrentTime()); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 110 | callback_task_ = RepeatingTaskHandle::DelayedStart( |
Henrik Boström | 4c72f99 | 2022-01-25 08:15:50 +0100 | [diff] [blame] | 111 | callback_queue_->Get(), TimeDelta::Millis(wait_ms), |
| 112 | [this] { |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 113 | RTC_DCHECK_RUN_ON(&callback_checker_); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 114 | // If this task has not been cancelled, we did not get any new frames |
| 115 | // while waiting. Continue with frame delivery. |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 116 | std::unique_ptr<EncodedFrame> frame; |
Evan Shrubsole | 3d29efd | 2021-12-07 14:11:45 +0100 | [diff] [blame] | 117 | NextFrameCallback frame_handler; |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 118 | { |
| 119 | MutexLock lock(&mutex_); |
| 120 | if (!frames_to_decode_.empty()) { |
| 121 | // We have frames, deliver! |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 122 | frame = GetNextFrame(); |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 123 | timing_->SetLastDecodeScheduledTimestamp(clock_->CurrentTime()); |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 124 | } else if (clock_->TimeInMilliseconds() < latest_return_time_ms_) { |
| 125 | // If there's no frames to decode and there is still time left, it |
| 126 | // means that the frame buffer was cleared between creation and |
| 127 | // execution of this task. Continue waiting for the remaining time. |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 128 | int64_t wait_ms = FindNextFrame(clock_->CurrentTime()); |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 129 | return TimeDelta::Millis(wait_ms); |
| 130 | } |
| 131 | frame_handler = std::move(frame_handler_); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 132 | CancelCallback(); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 133 | } |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 134 | // Deliver frame, if any. Otherwise signal timeout. |
Evan Shrubsole | 3d29efd | 2021-12-07 14:11:45 +0100 | [diff] [blame] | 135 | frame_handler(std::move(frame)); |
Markus Handell | 334b1fd | 2020-12-14 00:08:11 +0100 | [diff] [blame] | 136 | return TimeDelta::Zero(); // Ignored. |
Henrik Boström | 4c72f99 | 2022-01-25 08:15:50 +0100 | [diff] [blame] | 137 | }, |
| 138 | TaskQueueBase::DelayPrecision::kHigh); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 139 | } |
| 140 | |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 141 | int64_t FrameBuffer::FindNextFrame(Timestamp now) { |
| 142 | int64_t wait_ms = latest_return_time_ms_ - now.ms(); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 143 | frames_to_decode_.clear(); |
| 144 | |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 145 | // `last_continuous_frame_` may be empty below, but nullopt is smaller |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 146 | // than everything else and loop will immediately terminate as expected. |
| 147 | for (auto frame_it = frames_.begin(); |
| 148 | frame_it != frames_.end() && frame_it->first <= last_continuous_frame_; |
| 149 | ++frame_it) { |
| 150 | if (!frame_it->second.continuous || |
| 151 | frame_it->second.num_missing_decodable > 0) { |
| 152 | continue; |
| 153 | } |
| 154 | |
| 155 | EncodedFrame* frame = frame_it->second.frame.get(); |
| 156 | |
| 157 | if (keyframe_required_ && !frame->is_keyframe()) |
| 158 | continue; |
| 159 | |
| 160 | auto last_decoded_frame_timestamp = |
| 161 | decoded_frames_history_.GetLastDecodedFrameTimestamp(); |
| 162 | |
| 163 | // TODO(https://bugs.webrtc.org/9974): consider removing this check |
| 164 | // as it may make a stream undecodable after a very long delay between |
| 165 | // frames. |
| 166 | if (last_decoded_frame_timestamp && |
| 167 | AheadOf(*last_decoded_frame_timestamp, frame->Timestamp())) { |
| 168 | continue; |
| 169 | } |
| 170 | |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 171 | // Gather all remaining frames for the same superframe. |
| 172 | std::vector<FrameMap::iterator> current_superframe; |
| 173 | current_superframe.push_back(frame_it); |
| 174 | bool last_layer_completed = frame_it->second.frame->is_last_spatial_layer; |
| 175 | FrameMap::iterator next_frame_it = frame_it; |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 176 | while (!last_layer_completed) { |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 177 | ++next_frame_it; |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 178 | |
| 179 | if (next_frame_it == frames_.end() || !next_frame_it->second.frame) { |
| 180 | break; |
| 181 | } |
| 182 | |
| 183 | if (next_frame_it->second.frame->Timestamp() != frame->Timestamp() || |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 184 | !next_frame_it->second.continuous) { |
| 185 | break; |
| 186 | } |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 187 | |
| 188 | if (next_frame_it->second.num_missing_decodable > 0) { |
philipel | cb327d9 | 2020-12-10 10:49:20 +0100 | [diff] [blame] | 189 | bool has_inter_layer_dependency = false; |
| 190 | for (size_t i = 0; i < EncodedFrame::kMaxFrameReferences && |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 191 | i < next_frame_it->second.frame->num_references; |
| 192 | ++i) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 193 | if (next_frame_it->second.frame->references[i] >= frame_it->first) { |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 194 | has_inter_layer_dependency = true; |
philipel | cb327d9 | 2020-12-10 10:49:20 +0100 | [diff] [blame] | 195 | break; |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 196 | } |
| 197 | } |
| 198 | |
| 199 | // If the frame has an undecoded dependency that is not within the same |
philipel | cb327d9 | 2020-12-10 10:49:20 +0100 | [diff] [blame] | 200 | // temporal unit then this frame is not yet ready to be decoded. If it |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 201 | // is within the same temporal unit then the not yet decoded dependency |
| 202 | // is just a lower spatial frame, which is ok. |
| 203 | if (!has_inter_layer_dependency || |
| 204 | next_frame_it->second.num_missing_decodable > 1) { |
| 205 | break; |
| 206 | } |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 207 | } |
philipel | a65d785 | 2020-11-20 17:49:24 +0100 | [diff] [blame] | 208 | |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 209 | current_superframe.push_back(next_frame_it); |
| 210 | last_layer_completed = next_frame_it->second.frame->is_last_spatial_layer; |
| 211 | } |
| 212 | // Check if the current superframe is complete. |
| 213 | // TODO(bugs.webrtc.org/10064): consider returning all available to |
| 214 | // decode frames even if the superframe is not complete yet. |
| 215 | if (!last_layer_completed) { |
| 216 | continue; |
| 217 | } |
| 218 | |
| 219 | frames_to_decode_ = std::move(current_superframe); |
| 220 | |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 221 | absl::optional<Timestamp> render_time = frame->RenderTimestamp(); |
| 222 | if (!render_time) { |
| 223 | render_time = timing_->RenderTime(frame->Timestamp(), now); |
| 224 | frame->SetRenderTime(render_time->ms()); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 225 | } |
Johannes Kron | 2ddc39e | 2021-08-10 16:56:12 +0200 | [diff] [blame] | 226 | bool too_many_frames_queued = |
| 227 | frames_.size() > zero_playout_delay_max_decode_queue_size_ ? true |
| 228 | : false; |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 229 | wait_ms = |
| 230 | timing_->MaxWaitingTime(*render_time, now, too_many_frames_queued).ms(); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 231 | |
| 232 | // This will cause the frame buffer to prefer high framerate rather |
| 233 | // than high resolution in the case of the decoder not decoding fast |
| 234 | // enough and the stream has multiple spatial and temporal layers. |
| 235 | // For multiple temporal layers it may cause non-base layer frames to be |
| 236 | // skipped if they are late. |
| 237 | if (wait_ms < -kMaxAllowedFrameDelayMs) |
| 238 | continue; |
| 239 | |
| 240 | break; |
| 241 | } |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 242 | wait_ms = std::min<int64_t>(wait_ms, latest_return_time_ms_ - now.ms()); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 243 | wait_ms = std::max<int64_t>(wait_ms, 0); |
| 244 | return wait_ms; |
| 245 | } |
| 246 | |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 247 | std::unique_ptr<EncodedFrame> FrameBuffer::GetNextFrame() { |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 248 | RTC_DCHECK_RUN_ON(&callback_checker_); |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 249 | Timestamp now = clock_->CurrentTime(); |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 250 | // TODO(ilnik): remove `frames_out` use frames_to_decode_ directly. |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 251 | std::vector<std::unique_ptr<EncodedFrame>> frames_out; |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 252 | |
| 253 | RTC_DCHECK(!frames_to_decode_.empty()); |
| 254 | bool superframe_delayed_by_retransmission = false; |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 255 | DataSize superframe_size = DataSize::Zero(); |
Evan Shrubsole | 5b9b9aa | 2021-11-01 10:28:31 +0100 | [diff] [blame] | 256 | const EncodedFrame& first_frame = *frames_to_decode_[0]->second.frame; |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 257 | absl::optional<Timestamp> render_time = first_frame.RenderTimestamp(); |
Evan Shrubsole | 5b9b9aa | 2021-11-01 10:28:31 +0100 | [diff] [blame] | 258 | int64_t receive_time_ms = first_frame.ReceivedTime(); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 259 | // Gracefully handle bad RTP timestamps and render time issues. |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 260 | if (!render_time || |
| 261 | FrameHasBadRenderTiming(*render_time, now, timing_->TargetVideoDelay())) { |
Niels Möller | d9c2d94 | 2019-04-30 09:16:36 +0200 | [diff] [blame] | 262 | jitter_estimator_.Reset(); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 263 | timing_->Reset(); |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 264 | render_time = timing_->RenderTime(first_frame.Timestamp(), now); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 265 | } |
| 266 | |
| 267 | for (FrameMap::iterator& frame_it : frames_to_decode_) { |
| 268 | RTC_DCHECK(frame_it != frames_.end()); |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 269 | std::unique_ptr<EncodedFrame> frame = std::move(frame_it->second.frame); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 270 | |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 271 | frame->SetRenderTime(render_time->ms()); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 272 | |
| 273 | superframe_delayed_by_retransmission |= frame->delayed_by_retransmission(); |
| 274 | receive_time_ms = std::max(receive_time_ms, frame->ReceivedTime()); |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 275 | superframe_size += DataSize::Bytes(frame->size()); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 276 | |
| 277 | PropagateDecodability(frame_it->second); |
| 278 | decoded_frames_history_.InsertDecoded(frame_it->first, frame->Timestamp()); |
| 279 | |
| 280 | // Remove decoded frame and all undecoded frames before it. |
Johannes Kron | 0c141c5 | 2019-08-26 15:04:43 +0200 | [diff] [blame] | 281 | if (stats_callback_) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 282 | unsigned int dropped_frames = |
| 283 | std::count_if(frames_.begin(), frame_it, |
| 284 | [](const std::pair<const int64_t, FrameInfo>& frame) { |
| 285 | return frame.second.frame != nullptr; |
| 286 | }); |
Johannes Kron | 0c141c5 | 2019-08-26 15:04:43 +0200 | [diff] [blame] | 287 | if (dropped_frames > 0) { |
| 288 | stats_callback_->OnDroppedFrames(dropped_frames); |
| 289 | } |
| 290 | } |
| 291 | |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 292 | frames_.erase(frames_.begin(), ++frame_it); |
| 293 | |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 294 | frames_out.emplace_back(std::move(frame)); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 295 | } |
| 296 | |
| 297 | if (!superframe_delayed_by_retransmission) { |
| 298 | int64_t frame_delay; |
| 299 | |
Evan Shrubsole | 5b9b9aa | 2021-11-01 10:28:31 +0100 | [diff] [blame] | 300 | if (inter_frame_delay_.CalculateDelay(first_frame.Timestamp(), &frame_delay, |
| 301 | receive_time_ms)) { |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 302 | jitter_estimator_.UpdateEstimate(TimeDelta::Millis(frame_delay), |
| 303 | superframe_size); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 304 | } |
| 305 | |
| 306 | float rtt_mult = protection_mode_ == kProtectionNackFEC ? 0.0 : 1.0; |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 307 | absl::optional<TimeDelta> rtt_mult_add_cap_ms = absl::nullopt; |
“Michael | d3a4ebe | 2019-06-07 03:55:01 -0500 | [diff] [blame] | 308 | if (rtt_mult_settings_.has_value()) { |
| 309 | rtt_mult = rtt_mult_settings_->rtt_mult_setting; |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 310 | rtt_mult_add_cap_ms = |
| 311 | TimeDelta::Millis(rtt_mult_settings_->rtt_mult_add_cap_ms); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 312 | } |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 313 | timing_->SetJitterDelay( |
| 314 | jitter_estimator_.GetJitterEstimate(rtt_mult, rtt_mult_add_cap_ms)); |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 315 | timing_->UpdateCurrentDelay(*render_time, now); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 316 | } else { |
Evan Shrubsole | 9146d76 | 2021-10-13 11:19:48 +0200 | [diff] [blame] | 317 | if (RttMultExperiment::RttMultEnabled()) |
Niels Möller | d9c2d94 | 2019-04-30 09:16:36 +0200 | [diff] [blame] | 318 | jitter_estimator_.FrameNacked(); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 319 | } |
| 320 | |
| 321 | UpdateJitterDelay(); |
| 322 | UpdateTimingFrameInfo(); |
| 323 | |
| 324 | if (frames_out.size() == 1) { |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 325 | return std::move(frames_out[0]); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 326 | } else { |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 327 | return CombineAndDeleteFrames(std::move(frames_out)); |
Sebastian Jansson | 1c747f5 | 2019-04-04 13:01:39 +0200 | [diff] [blame] | 328 | } |
| 329 | } |
| 330 | |
philipel | 4f6cd6a | 2016-08-03 10:59:32 +0200 | [diff] [blame] | 331 | void FrameBuffer::SetProtectionMode(VCMVideoProtection mode) { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 332 | TRACE_EVENT0("webrtc", "FrameBuffer::SetProtectionMode"); |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 333 | MutexLock lock(&mutex_); |
Henrik Boström | c680c4a | 2019-04-03 10:27:36 +0000 | [diff] [blame] | 334 | protection_mode_ = mode; |
philipel | 4f6cd6a | 2016-08-03 10:59:32 +0200 | [diff] [blame] | 335 | } |
| 336 | |
philipel | 504c47d | 2016-06-30 17:33:02 +0200 | [diff] [blame] | 337 | void FrameBuffer::Stop() { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 338 | TRACE_EVENT0("webrtc", "FrameBuffer::Stop"); |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 339 | MutexLock lock(&mutex_); |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 340 | if (stopped_) |
| 341 | return; |
Henrik Boström | c680c4a | 2019-04-03 10:27:36 +0000 | [diff] [blame] | 342 | stopped_ = true; |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 343 | |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 344 | CancelCallback(); |
philipel | 504c47d | 2016-06-30 17:33:02 +0200 | [diff] [blame] | 345 | } |
| 346 | |
Ilya Nikolaevskiy | e6a2d94 | 2018-11-07 14:32:28 +0100 | [diff] [blame] | 347 | void FrameBuffer::Clear() { |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 348 | MutexLock lock(&mutex_); |
Henrik Boström | c680c4a | 2019-04-03 10:27:36 +0000 | [diff] [blame] | 349 | ClearFramesAndHistory(); |
Ilya Nikolaevskiy | e6a2d94 | 2018-11-07 14:32:28 +0100 | [diff] [blame] | 350 | } |
| 351 | |
Johannes Kron | 111e981 | 2020-10-26 13:54:40 +0100 | [diff] [blame] | 352 | int FrameBuffer::Size() { |
| 353 | MutexLock lock(&mutex_); |
| 354 | return frames_.size(); |
| 355 | } |
| 356 | |
philipel | e21be1d | 2017-09-25 06:37:12 -0700 | [diff] [blame] | 357 | void FrameBuffer::UpdateRtt(int64_t rtt_ms) { |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 358 | MutexLock lock(&mutex_); |
Evan Shrubsole | 13e42a8 | 2022-03-07 13:21:51 +0100 | [diff] [blame] | 359 | jitter_estimator_.UpdateRtt(TimeDelta::Millis(rtt_ms)); |
philipel | e21be1d | 2017-09-25 06:37:12 -0700 | [diff] [blame] | 360 | } |
| 361 | |
philipel | e7c891f | 2018-02-22 14:35:06 +0100 | [diff] [blame] | 362 | bool FrameBuffer::ValidReferences(const EncodedFrame& frame) const { |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 363 | for (size_t i = 0; i < frame.num_references; ++i) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 364 | if (frame.references[i] >= frame.Id()) |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 365 | return false; |
philipel | 3b3c9c4 | 2017-09-11 09:38:36 -0700 | [diff] [blame] | 366 | |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 367 | for (size_t j = i + 1; j < frame.num_references; ++j) { |
| 368 | if (frame.references[i] == frame.references[j]) |
| 369 | return false; |
| 370 | } |
| 371 | } |
| 372 | |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 373 | return true; |
| 374 | } |
| 375 | |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 376 | void FrameBuffer::CancelCallback() { |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 377 | // Called from the callback queue or from within Stop(). |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 378 | frame_handler_ = {}; |
| 379 | callback_task_.Stop(); |
| 380 | callback_queue_ = nullptr; |
Tommi | 430951a | 2020-05-19 23:27:29 +0200 | [diff] [blame] | 381 | callback_checker_.Detach(); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 382 | } |
| 383 | |
philipel | e7c891f | 2018-02-22 14:35:06 +0100 | [diff] [blame] | 384 | int64_t FrameBuffer::InsertFrame(std::unique_ptr<EncodedFrame> frame) { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 385 | TRACE_EVENT0("webrtc", "FrameBuffer::InsertFrame"); |
philipel | 93e451b | 2016-10-06 12:25:13 +0200 | [diff] [blame] | 386 | RTC_DCHECK(frame); |
tommi | 0a73564 | 2017-03-14 06:23:57 -0700 | [diff] [blame] | 387 | |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 388 | MutexLock lock(&mutex_); |
philipel | 29f730e | 2017-03-15 08:10:08 -0700 | [diff] [blame] | 389 | |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 390 | int64_t last_continuous_frame_id = last_continuous_frame_.value_or(-1); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 391 | |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 392 | if (!ValidReferences(*frame)) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 393 | RTC_LOG(LS_WARNING) << "Frame " << frame->Id() |
philipel | f109193 | 2021-02-11 15:25:08 +0100 | [diff] [blame] | 394 | << " has invalid frame references, dropping frame."; |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 395 | return last_continuous_frame_id; |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 396 | } |
| 397 | |
Ilya Nikolaevskiy | 6551faf | 2019-01-10 15:16:47 +0100 | [diff] [blame] | 398 | if (frames_.size() >= kMaxFramesBuffered) { |
philipel | 9771c50 | 2018-03-02 11:06:27 +0100 | [diff] [blame] | 399 | if (frame->is_keyframe()) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 400 | RTC_LOG(LS_WARNING) << "Inserting keyframe " << frame->Id() |
philipel | f109193 | 2021-02-11 15:25:08 +0100 | [diff] [blame] | 401 | << " but buffer is full, clearing" |
Jonas Olsson | b2b2031 | 2020-01-14 12:11:31 +0100 | [diff] [blame] | 402 | " buffer and inserting the frame."; |
philipel | 9771c50 | 2018-03-02 11:06:27 +0100 | [diff] [blame] | 403 | ClearFramesAndHistory(); |
| 404 | } else { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 405 | RTC_LOG(LS_WARNING) << "Frame " << frame->Id() |
philipel | f109193 | 2021-02-11 15:25:08 +0100 | [diff] [blame] | 406 | << " could not be inserted due to the frame " |
Jonas Olsson | b2b2031 | 2020-01-14 12:11:31 +0100 | [diff] [blame] | 407 | "buffer being full, dropping frame."; |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 408 | return last_continuous_frame_id; |
philipel | 9771c50 | 2018-03-02 11:06:27 +0100 | [diff] [blame] | 409 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 410 | } |
| 411 | |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 412 | auto last_decoded_frame = decoded_frames_history_.GetLastDecodedFrameId(); |
| 413 | auto last_decoded_frame_timestamp = |
| 414 | decoded_frames_history_.GetLastDecodedFrameTimestamp(); |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 415 | if (last_decoded_frame && frame->Id() <= *last_decoded_frame) { |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 416 | if (AheadOf(frame->Timestamp(), *last_decoded_frame_timestamp) && |
philipel | 3042c2d | 2017-08-18 04:55:02 -0700 | [diff] [blame] | 417 | frame->is_keyframe()) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 418 | // If this frame has a newer timestamp but an earlier frame id then we |
| 419 | // assume there has been a jump in the frame id due to some encoder |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 420 | // reconfiguration or some other reason. Even though this is not according |
| 421 | // to spec we can still continue to decode from this frame if it is a |
| 422 | // keyframe. |
Mirko Bonadei | 675513b | 2017-11-09 11:09:25 +0100 | [diff] [blame] | 423 | RTC_LOG(LS_WARNING) |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 424 | << "A jump in frame id was detected, clearing buffer."; |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 425 | ClearFramesAndHistory(); |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 426 | last_continuous_frame_id = -1; |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 427 | } else { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 428 | RTC_LOG(LS_WARNING) << "Frame " << frame->Id() << " inserted after frame " |
| 429 | << *last_decoded_frame |
philipel | f109193 | 2021-02-11 15:25:08 +0100 | [diff] [blame] | 430 | << " was handed off for decoding, dropping frame."; |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 431 | return last_continuous_frame_id; |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 432 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 433 | } |
| 434 | |
philipel | 146a48b | 2017-04-20 04:04:38 -0700 | [diff] [blame] | 435 | // Test if inserting this frame would cause the order of the frames to become |
| 436 | // ambiguous (covering more than half the interval of 2^16). This can happen |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 437 | // when the frame id make large jumps mid stream. |
| 438 | if (!frames_.empty() && frame->Id() < frames_.begin()->first && |
| 439 | frames_.rbegin()->first < frame->Id()) { |
| 440 | RTC_LOG(LS_WARNING) << "A jump in frame id was detected, clearing buffer."; |
philipel | 146a48b | 2017-04-20 04:04:38 -0700 | [diff] [blame] | 441 | ClearFramesAndHistory(); |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 442 | last_continuous_frame_id = -1; |
philipel | 146a48b | 2017-04-20 04:04:38 -0700 | [diff] [blame] | 443 | } |
| 444 | |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 445 | auto info = frames_.emplace(frame->Id(), FrameInfo()).first; |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 446 | |
philipel | 93e451b | 2016-10-06 12:25:13 +0200 | [diff] [blame] | 447 | if (info->second.frame) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 448 | return last_continuous_frame_id; |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 449 | } |
| 450 | |
philipel | 93e451b | 2016-10-06 12:25:13 +0200 | [diff] [blame] | 451 | if (!UpdateFrameInfoWithIncomingFrame(*frame, info)) |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 452 | return last_continuous_frame_id; |
Ruslan Burakov | 493a650 | 2019-02-27 15:32:48 +0100 | [diff] [blame] | 453 | |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 454 | // If ReceiveTime is negative then it is not a valid timestamp. |
| 455 | if (!frame->delayed_by_retransmission() && frame->ReceivedTime() >= 0) |
| 456 | timing_->IncomingTimestamp(frame->Timestamp(), |
| 457 | Timestamp::Millis(frame->ReceivedTime())); |
philipel | 0a9f6de | 2018-02-28 11:29:47 +0100 | [diff] [blame] | 458 | |
philipel | 0cb7326 | 2020-12-08 17:36:53 +0100 | [diff] [blame] | 459 | // It can happen that a frame will be reported as fully received even if a |
| 460 | // lower spatial layer frame is missing. |
| 461 | if (stats_callback_ && frame->is_last_spatial_layer) { |
Johannes Kron | b88b44e | 2019-08-22 13:16:44 +0200 | [diff] [blame] | 462 | stats_callback_->OnCompleteFrame(frame->is_keyframe(), frame->size(), |
| 463 | frame->contentType()); |
| 464 | } |
| 465 | |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 466 | info->second.frame = std::move(frame); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 467 | |
| 468 | if (info->second.num_missing_continuous == 0) { |
| 469 | info->second.continuous = true; |
| 470 | PropagateContinuity(info); |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 471 | last_continuous_frame_id = *last_continuous_frame_; |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 472 | |
| 473 | // Since we now have new continuous frames there might be a better frame |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 474 | // to return from NextFrame. |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 475 | if (callback_queue_) { |
| 476 | callback_queue_->PostTask([this] { |
Markus Handell | 6deec38 | 2020-07-07 12:17:12 +0200 | [diff] [blame] | 477 | MutexLock lock(&mutex_); |
Sebastian Jansson | 11d0d7b | 2019-04-11 12:39:34 +0200 | [diff] [blame] | 478 | if (!callback_task_.Running()) |
| 479 | return; |
| 480 | RTC_CHECK(frame_handler_); |
| 481 | callback_task_.Stop(); |
| 482 | StartWaitForNextFrameOnQueue(); |
| 483 | }); |
| 484 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 485 | } |
| 486 | |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 487 | return last_continuous_frame_id; |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 488 | } |
| 489 | |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 490 | void FrameBuffer::PropagateContinuity(FrameMap::iterator start) { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 491 | TRACE_EVENT0("webrtc", "FrameBuffer::PropagateContinuity"); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 492 | RTC_DCHECK(start->second.continuous); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 493 | |
| 494 | std::queue<FrameMap::iterator> continuous_frames; |
| 495 | continuous_frames.push(start); |
| 496 | |
| 497 | // A simple BFS to traverse continuous frames. |
| 498 | while (!continuous_frames.empty()) { |
| 499 | auto frame = continuous_frames.front(); |
| 500 | continuous_frames.pop(); |
| 501 | |
Ilya Nikolaevskiy | 6551faf | 2019-01-10 15:16:47 +0100 | [diff] [blame] | 502 | if (!last_continuous_frame_ || *last_continuous_frame_ < frame->first) { |
| 503 | last_continuous_frame_ = frame->first; |
| 504 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 505 | |
| 506 | // Loop through all dependent frames, and if that frame no longer has |
| 507 | // any unfulfilled dependencies then that frame is continuous as well. |
Elad Alon | 69321dd | 2019-01-10 15:02:54 +0100 | [diff] [blame] | 508 | for (size_t d = 0; d < frame->second.dependent_frames.size(); ++d) { |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 509 | auto frame_ref = frames_.find(frame->second.dependent_frames[d]); |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 510 | RTC_DCHECK(frame_ref != frames_.end()); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 511 | |
philipel | 112adf9 | 2017-06-15 09:06:21 -0700 | [diff] [blame] | 512 | // TODO(philipel): Look into why we've seen this happen. |
| 513 | if (frame_ref != frames_.end()) { |
| 514 | --frame_ref->second.num_missing_continuous; |
| 515 | if (frame_ref->second.num_missing_continuous == 0) { |
| 516 | frame_ref->second.continuous = true; |
| 517 | continuous_frames.push(frame_ref); |
| 518 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 519 | } |
| 520 | } |
| 521 | } |
| 522 | } |
| 523 | |
| 524 | void FrameBuffer::PropagateDecodability(const FrameInfo& info) { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 525 | TRACE_EVENT0("webrtc", "FrameBuffer::PropagateDecodability"); |
Elad Alon | 69321dd | 2019-01-10 15:02:54 +0100 | [diff] [blame] | 526 | for (size_t d = 0; d < info.dependent_frames.size(); ++d) { |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 527 | auto ref_info = frames_.find(info.dependent_frames[d]); |
philipel | 93e451b | 2016-10-06 12:25:13 +0200 | [diff] [blame] | 528 | RTC_DCHECK(ref_info != frames_.end()); |
tommi | e95b78b | 2017-05-14 07:23:11 -0700 | [diff] [blame] | 529 | // TODO(philipel): Look into why we've seen this happen. |
| 530 | if (ref_info != frames_.end()) { |
| 531 | RTC_DCHECK_GT(ref_info->second.num_missing_decodable, 0U); |
| 532 | --ref_info->second.num_missing_decodable; |
| 533 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 534 | } |
| 535 | } |
| 536 | |
philipel | e7c891f | 2018-02-22 14:35:06 +0100 | [diff] [blame] | 537 | bool FrameBuffer::UpdateFrameInfoWithIncomingFrame(const EncodedFrame& frame, |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 538 | FrameMap::iterator info) { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 539 | TRACE_EVENT0("webrtc", "FrameBuffer::UpdateFrameInfoWithIncomingFrame"); |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 540 | auto last_decoded_frame = decoded_frames_history_.GetLastDecodedFrameId(); |
| 541 | RTC_DCHECK(!last_decoded_frame || *last_decoded_frame < info->first); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 542 | |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 543 | // In this function we determine how many missing dependencies this `frame` |
| 544 | // has to become continuous/decodable. If a frame that this `frame` depend |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 545 | // on has already been decoded then we can ignore that dependency since it has |
| 546 | // already been fulfilled. |
| 547 | // |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 548 | // For all other frames we will register a backwards reference to this `frame` |
| 549 | // so that `num_missing_continuous` and `num_missing_decodable` can be |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 550 | // decremented as frames become continuous/are decoded. |
| 551 | struct Dependency { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 552 | int64_t frame_id; |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 553 | bool continuous; |
| 554 | }; |
| 555 | std::vector<Dependency> not_yet_fulfilled_dependencies; |
| 556 | |
| 557 | // Find all dependencies that have not yet been fulfilled. |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 558 | for (size_t i = 0; i < frame.num_references; ++i) { |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 559 | // Does `frame` depend on a frame earlier than the last decoded one? |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 560 | if (last_decoded_frame && frame.references[i] <= *last_decoded_frame) { |
Artem Titov | dcd7fc7 | 2021-08-09 13:02:57 +0200 | [diff] [blame] | 561 | // Was that frame decoded? If not, this `frame` will never become |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 562 | // decodable. |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 563 | if (!decoded_frames_history_.WasDecoded(frame.references[i])) { |
philipel | 65e1f94 | 2017-07-24 08:26:53 -0700 | [diff] [blame] | 564 | int64_t now_ms = clock_->TimeInMilliseconds(); |
| 565 | if (last_log_non_decoded_ms_ + kLogNonDecodedIntervalMs < now_ms) { |
Mirko Bonadei | 675513b | 2017-11-09 11:09:25 +0100 | [diff] [blame] | 566 | RTC_LOG(LS_WARNING) |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 567 | << "Frame " << frame.Id() |
philipel | f109193 | 2021-02-11 15:25:08 +0100 | [diff] [blame] | 568 | << " depends on a non-decoded frame more previous than the last " |
| 569 | "decoded frame, dropping frame."; |
philipel | 65e1f94 | 2017-07-24 08:26:53 -0700 | [diff] [blame] | 570 | last_log_non_decoded_ms_ = now_ms; |
| 571 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 572 | return false; |
| 573 | } |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 574 | } else { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 575 | auto ref_info = frames_.find(frame.references[i]); |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 576 | bool ref_continuous = |
| 577 | ref_info != frames_.end() && ref_info->second.continuous; |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 578 | not_yet_fulfilled_dependencies.push_back( |
| 579 | {frame.references[i], ref_continuous}); |
philipel | e0b2f15 | 2016-09-28 10:23:49 +0200 | [diff] [blame] | 580 | } |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 581 | } |
| 582 | |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 583 | info->second.num_missing_continuous = not_yet_fulfilled_dependencies.size(); |
| 584 | info->second.num_missing_decodable = not_yet_fulfilled_dependencies.size(); |
| 585 | |
| 586 | for (const Dependency& dep : not_yet_fulfilled_dependencies) { |
| 587 | if (dep.continuous) |
| 588 | --info->second.num_missing_continuous; |
| 589 | |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 590 | frames_[dep.frame_id].dependent_frames.push_back(frame.Id()); |
philipel | 798b282 | 2018-06-11 13:10:14 +0200 | [diff] [blame] | 591 | } |
philipel | 93e451b | 2016-10-06 12:25:13 +0200 | [diff] [blame] | 592 | |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 593 | return true; |
| 594 | } |
| 595 | |
philipel | be74270 | 2016-11-30 01:31:40 -0800 | [diff] [blame] | 596 | void FrameBuffer::UpdateJitterDelay() { |
tommi | db23ea6 | 2017-03-03 07:21:18 -0800 | [diff] [blame] | 597 | TRACE_EVENT0("webrtc", "FrameBuffer::UpdateJitterDelay"); |
philipel | a45102f | 2017-02-22 05:30:39 -0800 | [diff] [blame] | 598 | if (!stats_callback_) |
| 599 | return; |
philipel | be74270 | 2016-11-30 01:31:40 -0800 | [diff] [blame] | 600 | |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 601 | TimeDelta max_decode = TimeDelta::Zero(); |
| 602 | TimeDelta current_delay = TimeDelta::Zero(); |
| 603 | TimeDelta target_delay = TimeDelta::Zero(); |
| 604 | TimeDelta jitter_buffer = TimeDelta::Zero(); |
| 605 | TimeDelta min_playout_delay = TimeDelta::Zero(); |
| 606 | TimeDelta render_delay = TimeDelta::Zero(); |
| 607 | if (timing_->GetTimings(&max_decode, ¤t_delay, &target_delay, |
| 608 | &jitter_buffer, &min_playout_delay, &render_delay)) { |
philipel | a45102f | 2017-02-22 05:30:39 -0800 | [diff] [blame] | 609 | stats_callback_->OnFrameBufferTimingsUpdated( |
Evan Shrubsole | d6cdf80 | 2022-03-02 15:13:55 +0100 | [diff] [blame] | 610 | max_decode.ms(), current_delay.ms(), target_delay.ms(), |
| 611 | jitter_buffer.ms(), min_playout_delay.ms(), render_delay.ms()); |
philipel | be74270 | 2016-11-30 01:31:40 -0800 | [diff] [blame] | 612 | } |
philipel | 266f0a4 | 2016-11-28 08:49:07 -0800 | [diff] [blame] | 613 | } |
| 614 | |
ilnik | 2edc684 | 2017-07-06 03:06:50 -0700 | [diff] [blame] | 615 | void FrameBuffer::UpdateTimingFrameInfo() { |
| 616 | TRACE_EVENT0("webrtc", "FrameBuffer::UpdateTimingFrameInfo"); |
Danil Chapovalov | 0040b66 | 2018-06-18 10:48:16 +0200 | [diff] [blame] | 617 | absl::optional<TimingFrameInfo> info = timing_->GetTimingFrameInfo(); |
philipel | 9718711 | 2018-03-23 10:43:21 +0100 | [diff] [blame] | 618 | if (info && stats_callback_) |
ilnik | 2edc684 | 2017-07-06 03:06:50 -0700 | [diff] [blame] | 619 | stats_callback_->OnTimingFrameInfoUpdated(*info); |
| 620 | } |
| 621 | |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 622 | void FrameBuffer::ClearFramesAndHistory() { |
ilnik | 2edc684 | 2017-07-06 03:06:50 -0700 | [diff] [blame] | 623 | TRACE_EVENT0("webrtc", "FrameBuffer::ClearFramesAndHistory"); |
Johannes Kron | 0c141c5 | 2019-08-26 15:04:43 +0200 | [diff] [blame] | 624 | if (stats_callback_) { |
philipel | 9aa9b8d | 2021-02-15 13:31:29 +0100 | [diff] [blame] | 625 | unsigned int dropped_frames = |
| 626 | std::count_if(frames_.begin(), frames_.end(), |
| 627 | [](const std::pair<const int64_t, FrameInfo>& frame) { |
| 628 | return frame.second.frame != nullptr; |
| 629 | }); |
Johannes Kron | 0c141c5 | 2019-08-26 15:04:43 +0200 | [diff] [blame] | 630 | if (dropped_frames > 0) { |
| 631 | stats_callback_->OnDroppedFrames(dropped_frames); |
| 632 | } |
| 633 | } |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 634 | frames_.clear(); |
Ilya Nikolaevskiy | 6551faf | 2019-01-10 15:16:47 +0100 | [diff] [blame] | 635 | last_continuous_frame_.reset(); |
Ilya Nikolaevskiy | 5546aef | 2018-12-04 15:54:52 +0100 | [diff] [blame] | 636 | frames_to_decode_.clear(); |
Ilya Nikolaevskiy | 1371784 | 2019-01-14 13:24:22 +0100 | [diff] [blame] | 637 | decoded_frames_history_.Clear(); |
philipel | fcc6006 | 2017-01-18 05:35:20 -0800 | [diff] [blame] | 638 | } |
| 639 | |
Niels Möller | ff2e215 | 2019-09-27 10:29:30 +0200 | [diff] [blame] | 640 | // TODO(philipel): Avoid the concatenation of frames here, by replacing |
| 641 | // NextFrame and GetNextFrame with methods returning multiple frames. |
Evan Shrubsole | 0072c21 | 2021-11-10 11:41:14 +0100 | [diff] [blame] | 642 | std::unique_ptr<EncodedFrame> FrameBuffer::CombineAndDeleteFrames( |
| 643 | std::vector<std::unique_ptr<EncodedFrame>> frames) const { |
Ilya Nikolaevskiy | 5546aef | 2018-12-04 15:54:52 +0100 | [diff] [blame] | 644 | RTC_DCHECK(!frames.empty()); |
Evan Shrubsole | f83d426 | 2021-12-15 15:05:15 +0100 | [diff] [blame] | 645 | absl::InlinedVector<std::unique_ptr<EncodedFrame>, 4> inlined; |
| 646 | for (auto& frame : frames) { |
| 647 | inlined.push_back(std::move(frame)); |
Ilya Nikolaevskiy | 5546aef | 2018-12-04 15:54:52 +0100 | [diff] [blame] | 648 | } |
Evan Shrubsole | f83d426 | 2021-12-15 15:05:15 +0100 | [diff] [blame] | 649 | return webrtc::CombineAndDeleteFrames(std::move(inlined)); |
Ilya Nikolaevskiy | 5546aef | 2018-12-04 15:54:52 +0100 | [diff] [blame] | 650 | } |
| 651 | |
Niels Möller | be682d4 | 2018-03-27 08:31:45 +0200 | [diff] [blame] | 652 | FrameBuffer::FrameInfo::FrameInfo() = default; |
| 653 | FrameBuffer::FrameInfo::FrameInfo(FrameInfo&&) = default; |
| 654 | FrameBuffer::FrameInfo::~FrameInfo() = default; |
| 655 | |
philipel | be7a9e5 | 2016-05-19 12:19:35 +0200 | [diff] [blame] | 656 | } // namespace video_coding |
| 657 | } // namespace webrtc |