blob: 86b9a09d19e23cff64b4d00c81d87c072e36c5c2 [file] [log] [blame]
pbos@webrtc.org29d58392013-05-16 12:08:03 +00001/*
2 * Copyright (c) 2013 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 "video/video_receive_stream.h"
pbos@webrtc.org29d58392013-05-16 12:08:03 +000012
pbos@webrtc.org12dc1a32013-08-05 16:22:53 +000013#include <stdlib.h>
Yves Gerey3e707812018-11-28 16:47:49 +010014#include <string.h>
Niels Möller46879152019-01-07 15:54:47 +010015#include <algorithm>
mflodmand1590b22015-12-09 07:07:59 -080016#include <set>
mflodman@webrtc.orgb429e512013-12-18 09:46:22 +000017#include <string>
Erik Språng737336d2016-07-29 12:59:36 +020018#include <utility>
mflodman@webrtc.orgb429e512013-12-18 09:46:22 +000019
Steve Antonbd631a02019-03-28 10:51:27 -070020#include "absl/algorithm/container.h"
Karl Wiberg918f50c2018-07-05 11:40:33 +020021#include "absl/memory/memory.h"
Danil Chapovalovb9b146c2018-06-15 12:28:07 +020022#include "absl/types/optional.h"
Yves Gerey3e707812018-11-28 16:47:49 +010023#include "api/array_view.h"
Steve Anton10542f22019-01-11 09:11:00 -080024#include "api/crypto/frame_decryptor_interface.h"
Yves Gerey3e707812018-11-28 16:47:49 +010025#include "api/video/encoded_image.h"
26#include "api/video_codecs/sdp_video_format.h"
27#include "api/video_codecs/video_codec.h"
Niels Möllercbcbc222018-09-28 09:07:24 +020028#include "api/video_codecs/video_decoder_factory.h"
Yves Gerey3e707812018-11-28 16:47:49 +010029#include "api/video_codecs/video_encoder.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020030#include "call/rtp_stream_receiver_controller_interface.h"
31#include "call/rtx_receive_stream.h"
Patrik Höglundbe214a22018-01-04 12:14:35 +010032#include "common_video/include/incoming_video_stream.h"
Yves Gerey3e707812018-11-28 16:47:49 +010033#include "media/base/h264_profile_level_id.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "modules/utility/include/process_thread.h"
Yves Gerey3e707812018-11-28 16:47:49 +010035#include "modules/video_coding/include/video_codec_interface.h"
36#include "modules/video_coding/include/video_coding_defines.h"
37#include "modules/video_coding/include/video_error_codes.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020038#include "modules/video_coding/jitter_estimator.h"
39#include "modules/video_coding/timing.h"
Niels Möller147013a2018-10-01 15:56:33 +020040#include "modules/video_coding/utility/vp8_header_parser.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020041#include "rtc_base/checks.h"
Rasmus Brandt3dde4502019-03-21 11:46:17 +010042#include "rtc_base/experiments/keyframe_interval_settings.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020043#include "rtc_base/location.h"
44#include "rtc_base/logging.h"
Erik Språng96965ae2018-10-23 15:42:37 +020045#include "rtc_base/platform_file.h"
46#include "rtc_base/strings/string_builder.h"
Karl Wibergab036382019-03-12 18:01:51 +010047#include "rtc_base/system/thread_registry.h"
Steve Anton10542f22019-01-11 09:11:00 -080048#include "rtc_base/time_utils.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020049#include "rtc_base/trace_event.h"
50#include "system_wrappers/include/clock.h"
51#include "system_wrappers/include/field_trial.h"
52#include "video/call_stats.h"
Erik Språng96965ae2018-10-23 15:42:37 +020053#include "video/frame_dumping_decoder.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020054#include "video/receive_statistics_proxy.h"
pbos@webrtc.org29d58392013-05-16 12:08:03 +000055
56namespace webrtc {
mflodmana20de202015-10-18 22:08:19 -070057
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000058namespace {
Ruslan Burakov493a6502019-02-27 15:32:48 +010059constexpr int kMinBaseMinimumDelayMs = 0;
60constexpr int kMaxBaseMinimumDelayMs = 10000;
61
Rasmus Brandt3dde4502019-03-21 11:46:17 +010062constexpr int kMaxWaitForKeyFrameMs = 200;
63constexpr int kMaxWaitForFrameMs = 3000;
64
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000065VideoCodec CreateDecoderVideoCodec(const VideoReceiveStream::Decoder& decoder) {
66 VideoCodec codec;
67 memset(&codec, 0, sizeof(codec));
68
69 codec.plType = decoder.payload_type;
Niels Möllercb7e1d22018-09-11 15:56:04 +020070 codec.codecType = PayloadStringToCodecType(decoder.video_format.name);
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000071
72 if (codec.codecType == kVideoCodecVP8) {
hta257dc392016-10-25 09:05:06 -070073 *(codec.VP8()) = VideoEncoder::GetDefaultVp8Settings();
ivica05cfcd32015-09-07 06:04:16 -070074 } else if (codec.codecType == kVideoCodecVP9) {
hta257dc392016-10-25 09:05:06 -070075 *(codec.VP9()) = VideoEncoder::GetDefaultVp9Settings();
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000076 } else if (codec.codecType == kVideoCodecH264) {
hta257dc392016-10-25 09:05:06 -070077 *(codec.H264()) = VideoEncoder::GetDefaultH264Settings();
magjede69a1a92016-11-25 10:06:31 -080078 codec.H264()->profile =
Niels Möllercb7e1d22018-09-11 15:56:04 +020079 H264::ParseSdpProfileLevelId(decoder.video_format.parameters)->profile;
Emircan Uysalerd7ae3c32018-01-25 13:01:09 -080080 } else if (codec.codecType == kVideoCodecMultiplex) {
Emircan Uysaler0a375472017-12-11 12:21:02 +053081 VideoReceiveStream::Decoder associated_decoder = decoder;
Niels Möllercb7e1d22018-09-11 15:56:04 +020082 associated_decoder.video_format =
83 SdpVideoFormat(CodecTypeToPayloadString(kVideoCodecVP9));
Emircan Uysaler0a375472017-12-11 12:21:02 +053084 VideoCodec associated_codec = CreateDecoderVideoCodec(associated_decoder);
Emircan Uysalerd7ae3c32018-01-25 13:01:09 -080085 associated_codec.codecType = kVideoCodecMultiplex;
Emircan Uysaler0a375472017-12-11 12:21:02 +053086 return associated_codec;
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000087 }
88
89 codec.width = 320;
90 codec.height = 180;
stefanb4bc65b2016-11-02 10:10:20 -070091 const int kDefaultStartBitrate = 300;
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000092 codec.startBitrate = codec.minBitrate = codec.maxBitrate =
stefanb4bc65b2016-11-02 10:10:20 -070093 kDefaultStartBitrate;
pbos@webrtc.org776e6f22014-10-29 15:28:39 +000094
95 return codec;
96}
Niels Möllercbcbc222018-09-28 09:07:24 +020097
98// Video decoder class to be used for unknown codecs. Doesn't support decoding
99// but logs messages to LS_ERROR.
100class NullVideoDecoder : public webrtc::VideoDecoder {
101 public:
102 int32_t InitDecode(const webrtc::VideoCodec* codec_settings,
103 int32_t number_of_cores) override {
104 RTC_LOG(LS_ERROR) << "Can't initialize NullVideoDecoder.";
105 return WEBRTC_VIDEO_CODEC_OK;
106 }
107
108 int32_t Decode(const webrtc::EncodedImage& input_image,
109 bool missing_frames,
Jeroen de Borst2c7b9822019-03-07 19:40:07 +0000110 const webrtc::CodecSpecificInfo* codec_specific_info,
Niels Möllercbcbc222018-09-28 09:07:24 +0200111 int64_t render_time_ms) override {
112 RTC_LOG(LS_ERROR) << "The NullVideoDecoder doesn't support decoding.";
113 return WEBRTC_VIDEO_CODEC_OK;
114 }
115
116 int32_t RegisterDecodeCompleteCallback(
117 webrtc::DecodedImageCallback* callback) override {
118 RTC_LOG(LS_ERROR)
119 << "Can't register decode complete callback on NullVideoDecoder.";
120 return WEBRTC_VIDEO_CODEC_OK;
121 }
122
123 int32_t Release() override { return WEBRTC_VIDEO_CODEC_OK; }
124
125 const char* ImplementationName() const override { return "NullVideoDecoder"; }
126};
127
Niels Möller46879152019-01-07 15:54:47 +0100128// Inherit video_coding::EncodedFrame, which is the class used by
129// video_coding::FrameBuffer and other components in the receive pipeline. It's
130// a subclass of EncodedImage, and it always owns the buffer.
131class EncodedFrameForMediaTransport : public video_coding::EncodedFrame {
132 public:
133 explicit EncodedFrameForMediaTransport(
134 MediaTransportEncodedVideoFrame frame) {
Niels Möller938dd9f2019-02-07 00:02:17 +0100135 // TODO(nisse): This is ugly. We copy the EncodedImage (a base class of
136 // ours, in several steps), to get all the meta data. We should be using
137 // std::move in some way. Then we also need to handle the case of an unowned
138 // buffer, in which case we need to make an owned copy.
Niels Möller46879152019-01-07 15:54:47 +0100139 *static_cast<class EncodedImage*>(this) = frame.encoded_image();
Niels Möller46879152019-01-07 15:54:47 +0100140
Niels Möller69bb3af2019-02-13 10:05:49 +0100141 // If we don't already own the buffer, make a copy.
142 Retain();
Niels Möller46879152019-01-07 15:54:47 +0100143
144 _payloadType = static_cast<uint8_t>(frame.payload_type());
145
146 // TODO(nisse): frame_id and picture_id are probably not the same thing. For
147 // a single layer, this should be good enough.
148 id.picture_id = frame.frame_id();
149 id.spatial_layer = frame.encoded_image().SpatialIndex().value_or(0);
150 num_references = std::min(static_cast<size_t>(kMaxFrameReferences),
151 frame.referenced_frame_ids().size());
152 for (size_t i = 0; i < num_references; i++) {
153 references[i] = frame.referenced_frame_ids()[i];
154 }
155 }
156
157 // TODO(nisse): Implement. Not sure how they are used.
158 int64_t ReceivedTime() const override { return 0; }
159 int64_t RenderTime() const override { return 0; }
160};
161
Ilya Nikolaevskiye6a2d942018-11-07 14:32:28 +0100162// TODO(https://bugs.webrtc.org/9974): Consider removing this workaround.
163// Maximum time between frames before resetting the FrameBuffer to avoid RTP
164// timestamps wraparound to affect FrameBuffer.
165constexpr int kInactiveStreamThresholdMs = 600000; // 10 minutes.
166
pbos@webrtc.org776e6f22014-10-29 15:28:39 +0000167} // namespace
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000168
Peter Boströmca835252016-02-11 15:59:46 +0100169namespace internal {
tommi2e82f382016-06-21 00:26:43 -0700170
nisse0f15f922017-06-21 01:05:22 -0700171VideoReceiveStream::VideoReceiveStream(
Sebastian Jansson74682c12019-03-01 11:50:20 +0100172 TaskQueueFactory* task_queue_factory,
nisse0f15f922017-06-21 01:05:22 -0700173 RtpStreamReceiverControllerInterface* receiver_controller,
174 int num_cpu_cores,
175 PacketRouter* packet_router,
176 VideoReceiveStream::Config config,
177 ProcessThread* process_thread,
Ruslan Burakov493a6502019-02-27 15:32:48 +0100178 CallStats* call_stats,
179 Clock* clock,
180 VCMTiming* timing)
Sebastian Jansson74682c12019-03-01 11:50:20 +0100181 : task_queue_factory_(task_queue_factory),
182 transport_adapter_(config.rtcp_send_transport),
Tommi733b5472016-06-10 17:58:01 +0200183 config_(std::move(config)),
sprang113bdca2016-10-11 03:10:10 -0700184 num_cpu_cores_(num_cpu_cores),
Peter Boström1d04ac62016-02-05 11:25:46 +0100185 process_thread_(process_thread),
Ruslan Burakov493a6502019-02-27 15:32:48 +0100186 clock_(clock),
tommic8ece432017-06-20 02:44:38 -0700187 decode_thread_(&DecodeThreadFunction,
188 this,
189 "DecodingThread",
190 rtc::kHighestPriority),
Peter Boström1d04ac62016-02-05 11:25:46 +0100191 call_stats_(call_stats),
Danil Chapovalov8ce0d2b2018-11-23 11:03:25 +0100192 stats_proxy_(&config_, clock_),
193 rtp_receive_statistics_(
194 ReceiveStatistics::Create(clock_, &stats_proxy_, &stats_proxy_)),
Ruslan Burakov493a6502019-02-27 15:32:48 +0100195 timing_(timing),
Niels Möllerdb64d992019-03-29 14:30:53 +0100196 video_receiver_(clock_, timing_.get()),
Sebastian Jansson8026d602019-03-04 19:39:01 +0100197 rtp_video_stream_receiver_(clock_,
198 &transport_adapter_,
Tommi38c5d932018-03-27 23:11:09 +0200199 call_stats,
nisseb1f2ff92017-06-09 04:01:55 -0700200 packet_router,
201 &config_,
nisseca5706d2017-09-11 02:32:16 -0700202 rtp_receive_statistics_.get(),
nisseb1f2ff92017-06-09 04:01:55 -0700203 &stats_proxy_,
204 process_thread_,
Benjamin Wright192eeec2018-10-17 17:27:25 -0700205 this, // NackSender
206 this, // KeyFrameRequestSender
207 this, // OnCompleteFrameCallback
208 config_.frame_decryptor),
Rasmus Brandt3dde4502019-03-21 11:46:17 +0100209 rtp_stream_sync_(this),
210 max_wait_for_keyframe_ms_(KeyframeIntervalSettings::ParseFromFieldTrials()
211 .MaxWaitForKeyframeMs()
212 .value_or(kMaxWaitForKeyFrameMs)),
213 max_wait_for_frame_ms_(KeyframeIntervalSettings::ParseFromFieldTrials()
214 .MaxWaitForFrameMs()
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000215 .value_or(kMaxWaitForFrameMs)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100216 RTC_LOG(LS_INFO) << "VideoReceiveStream: " << config_.ToString();
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000217
Rasmus Brandt1e27fec2019-01-23 09:47:50 +0100218 RTC_DCHECK(config_.renderer);
Stefan Holmer58c664c2016-02-08 14:31:30 +0100219 RTC_DCHECK(process_thread_);
Stefan Holmer58c664c2016-02-08 14:31:30 +0100220 RTC_DCHECK(call_stats_);
mflodmancfc8e3b2016-05-03 21:22:04 -0700221
eladalona28122f2017-08-18 04:02:48 -0700222 module_process_sequence_checker_.Detach();
Ruslan Burakov493a6502019-02-27 15:32:48 +0100223 network_sequence_checker_.Detach();
solenberg3ebbcb52017-01-31 03:58:40 -0800224
henrikg91d6ede2015-09-17 00:24:34 -0700225 RTC_DCHECK(!config_.decoders.empty());
Peter Boström521af4e2015-11-27 16:35:04 +0100226 std::set<int> decoder_payload_types;
Peter Boströmb1ae3a42016-02-15 17:52:40 +0100227 for (const Decoder& decoder : config_.decoders) {
Niels Möllercbcbc222018-09-28 09:07:24 +0200228 RTC_CHECK(decoder.decoder_factory);
Peter Boström521af4e2015-11-27 16:35:04 +0100229 RTC_CHECK(decoder_payload_types.find(decoder.payload_type) ==
230 decoder_payload_types.end())
231 << "Duplicate payload type (" << decoder.payload_type
232 << ") for different decoders.";
233 decoder_payload_types.insert(decoder.payload_type);
pbos@webrtc.org0181b5f2013-09-09 08:26:30 +0000234 }
235
nisseca5706d2017-09-11 02:32:16 -0700236 video_receiver_.SetRenderDelay(config_.render_delay_ms);
Peter Boström1d04ac62016-02-05 11:25:46 +0100237
philipela45102f2017-02-22 05:30:39 -0800238 jitter_estimator_.reset(new VCMJitterEstimator(clock_));
239 frame_buffer_.reset(new video_coding::FrameBuffer(
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000240 clock_, jitter_estimator_.get(), timing_.get(), &stats_proxy_));
philipelfd5a20f2016-11-15 00:57:57 -0800241
tommidea489f2017-03-03 03:20:24 -0800242 process_thread_->RegisterModule(&rtp_stream_sync_, RTC_FROM_HERE);
nisse0f15f922017-06-21 01:05:22 -0700243
Niels Möller46879152019-01-07 15:54:47 +0100244 if (config_.media_transport) {
245 config_.media_transport->SetReceiveVideoSink(this);
246 config_.media_transport->AddRttObserver(this);
Niels Möller5304a322018-08-27 13:27:05 +0200247 } else {
Niels Möller46879152019-01-07 15:54:47 +0100248 // Register with RtpStreamReceiverController.
249 media_receiver_ = receiver_controller->CreateReceiver(
250 config_.rtp.remote_ssrc, &rtp_video_stream_receiver_);
251 if (config_.rtp.rtx_ssrc) {
252 rtx_receive_stream_ = absl::make_unique<RtxReceiveStream>(
253 &rtp_video_stream_receiver_, config.rtp.rtx_associated_payload_types,
254 config_.rtp.remote_ssrc, rtp_receive_statistics_.get());
255 rtx_receiver_ = receiver_controller->CreateReceiver(
256 config_.rtp.rtx_ssrc, rtx_receive_stream_.get());
257 } else {
258 rtp_receive_statistics_->EnableRetransmitDetection(config.rtp.remote_ssrc,
259 true);
260 }
nisse0f15f922017-06-21 01:05:22 -0700261 }
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000262}
263
Ruslan Burakov493a6502019-02-27 15:32:48 +0100264VideoReceiveStream::VideoReceiveStream(
Sebastian Jansson74682c12019-03-01 11:50:20 +0100265 TaskQueueFactory* task_queue_factory,
Ruslan Burakov493a6502019-02-27 15:32:48 +0100266 RtpStreamReceiverControllerInterface* receiver_controller,
267 int num_cpu_cores,
268 PacketRouter* packet_router,
269 VideoReceiveStream::Config config,
270 ProcessThread* process_thread,
Sebastian Jansson8026d602019-03-04 19:39:01 +0100271 CallStats* call_stats,
272 Clock* clock)
Sebastian Jansson74682c12019-03-01 11:50:20 +0100273 : VideoReceiveStream(task_queue_factory,
274 receiver_controller,
Ruslan Burakov493a6502019-02-27 15:32:48 +0100275 num_cpu_cores,
276 packet_router,
277 std::move(config),
278 process_thread,
279 call_stats,
Sebastian Jansson8026d602019-03-04 19:39:01 +0100280 clock,
281 new VCMTiming(clock)) {}
Ruslan Burakov493a6502019-02-27 15:32:48 +0100282
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000283VideoReceiveStream::~VideoReceiveStream() {
eladalona28122f2017-08-18 04:02:48 -0700284 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
Mirko Bonadei675513b2017-11-09 11:09:25 +0100285 RTC_LOG(LS_INFO) << "~VideoReceiveStream: " << config_.ToString();
Peter Boströmca835252016-02-11 15:59:46 +0100286 Stop();
Niels Möller46879152019-01-07 15:54:47 +0100287 if (config_.media_transport) {
288 config_.media_transport->SetReceiveVideoSink(nullptr);
289 config_.media_transport->RemoveRttObserver(this);
290 }
mflodman4cd27902016-08-05 06:28:45 -0700291 process_thread_->DeRegisterModule(&rtp_stream_sync_);
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000292}
293
pbos1ba8d392016-05-01 20:18:34 -0700294void VideoReceiveStream::SignalNetworkState(NetworkState state) {
eladalona28122f2017-08-18 04:02:48 -0700295 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
nisseb1f2ff92017-06-09 04:01:55 -0700296 rtp_video_stream_receiver_.SignalNetworkState(state);
pbos1ba8d392016-05-01 20:18:34 -0700297}
298
pbos1ba8d392016-05-01 20:18:34 -0700299bool VideoReceiveStream::DeliverRtcp(const uint8_t* packet, size_t length) {
nisseb1f2ff92017-06-09 04:01:55 -0700300 return rtp_video_stream_receiver_.DeliverRtcp(packet, length);
pbos1ba8d392016-05-01 20:18:34 -0700301}
302
solenberg3ebbcb52017-01-31 03:58:40 -0800303void VideoReceiveStream::SetSync(Syncable* audio_syncable) {
eladalona28122f2017-08-18 04:02:48 -0700304 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
solenberg3ebbcb52017-01-31 03:58:40 -0800305 rtp_stream_sync_.ConfigureSync(audio_syncable);
brandtr090c9402017-01-25 08:28:02 -0800306}
307
pbos@webrtc.orga5c8d2c2014-04-24 11:13:21 +0000308void VideoReceiveStream::Start() {
eladalona28122f2017-08-18 04:02:48 -0700309 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
brandtrfb45c6c2017-01-27 06:47:55 -0800310
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000311 if (decode_thread_.IsRunning()) {
Rasmus Brandt1e27fec2019-01-23 09:47:50 +0100312 return;
313 }
314
315 const bool protected_by_fec = config_.rtp.protected_by_flexfec ||
316 rtp_video_stream_receiver_.IsUlpfecEnabled();
brandtrfb45c6c2017-01-27 06:47:55 -0800317
philipela45102f2017-02-22 05:30:39 -0800318 frame_buffer_->Start();
philipelfd5a20f2016-11-15 00:57:57 -0800319
nisseb1f2ff92017-06-09 04:01:55 -0700320 if (rtp_video_stream_receiver_.IsRetransmissionsEnabled() &&
321 protected_by_fec) {
philipela45102f2017-02-22 05:30:39 -0800322 frame_buffer_->SetProtectionMode(kProtectionNackFEC);
philipelfd5a20f2016-11-15 00:57:57 -0800323 }
philipela45102f2017-02-22 05:30:39 -0800324
sprang@webrtc.orgd9b95602014-01-27 13:03:02 +0000325 transport_adapter_.Enable();
tommi2e82f382016-06-21 00:26:43 -0700326 rtc::VideoSinkInterface<VideoFrame>* renderer = nullptr;
Rasmus Brandt1e27fec2019-01-23 09:47:50 +0100327 if (config_.enable_prerenderer_smoothing) {
Sebastian Jansson74682c12019-03-01 11:50:20 +0100328 incoming_video_stream_.reset(new IncomingVideoStream(
329 task_queue_factory_, config_.render_delay_ms, this));
Rasmus Brandt1e27fec2019-01-23 09:47:50 +0100330 renderer = incoming_video_stream_.get();
331 } else {
332 renderer = this;
tommi2e82f382016-06-21 00:26:43 -0700333 }
334
sprang113bdca2016-10-11 03:10:10 -0700335 for (const Decoder& decoder : config_.decoders) {
Niels Möllercbcbc222018-09-28 09:07:24 +0200336 std::unique_ptr<VideoDecoder> video_decoder =
337 decoder.decoder_factory->LegacyCreateVideoDecoder(decoder.video_format,
338 config_.stream_id);
339 // If we still have no valid decoder, we have to create a "Null" decoder
340 // that ignores all calls. The reason we can get into this state is that the
341 // old decoder factory interface doesn't have a way to query supported
342 // codecs.
343 if (!video_decoder) {
344 video_decoder = absl::make_unique<NullVideoDecoder>();
345 }
Erik Språng96965ae2018-10-23 15:42:37 +0200346
347 std::string decoded_output_file =
348 field_trial::FindFullName("WebRTC-DecoderDataDumpDirectory");
Ilya Nikolaevskiyc0321092019-03-11 11:18:26 +0100349 // Because '/' can't be used inside a field trial parameter, we use ':'
350 // instead.
Steve Antonbd631a02019-03-28 10:51:27 -0700351 absl::c_replace(decoded_output_file, ':', '/');
Erik Språng96965ae2018-10-23 15:42:37 +0200352 if (!decoded_output_file.empty()) {
353 char filename_buffer[256];
354 rtc::SimpleStringBuilder ssb(filename_buffer);
355 ssb << decoded_output_file << "/webrtc_receive_stream_"
Ilya Nikolaevskiyc0321092019-03-11 11:18:26 +0100356 << this->config_.rtp.remote_ssrc << "-" << rtc::TimeMicros()
357 << ".ivf";
Erik Språng96965ae2018-10-23 15:42:37 +0200358 video_decoder = absl::make_unique<FrameDumpingDecoder>(
Niels Möllerb7edf692019-02-08 16:40:53 +0100359 std::move(video_decoder), FileWrapper::OpenWriteOnly(ssb.str()));
Erik Språng96965ae2018-10-23 15:42:37 +0200360 }
361
Niels Möllercbcbc222018-09-28 09:07:24 +0200362 video_decoders_.push_back(std::move(video_decoder));
363
364 video_receiver_.RegisterExternalDecoder(video_decoders_.back().get(),
sprang113bdca2016-10-11 03:10:10 -0700365 decoder.payload_type);
sprang113bdca2016-10-11 03:10:10 -0700366 VideoCodec codec = CreateDecoderVideoCodec(decoder);
Niels Möllercb7e1d22018-09-11 15:56:04 +0200367 rtp_video_stream_receiver_.AddReceiveCodec(codec,
368 decoder.video_format.parameters);
sprang113bdca2016-10-11 03:10:10 -0700369 RTC_CHECK_EQ(VCM_OK, video_receiver_.RegisterReceiveCodec(
370 &codec, num_cpu_cores_, false));
371 }
372
Rasmus Brandt1e27fec2019-01-23 09:47:50 +0100373 RTC_DCHECK(renderer != nullptr);
tommi2e82f382016-06-21 00:26:43 -0700374 video_stream_decoder_.reset(new VideoStreamDecoder(
nisseb1f2ff92017-06-09 04:01:55 -0700375 &video_receiver_, &rtp_video_stream_receiver_,
nisseb1f2ff92017-06-09 04:01:55 -0700376 rtp_video_stream_receiver_.IsRetransmissionsEnabled(), protected_by_fec,
nisse76bc8e82017-02-07 09:37:41 -0800377 &stats_proxy_, renderer));
tommic8ece432017-06-20 02:44:38 -0700378
Tommief3e28a2018-03-30 08:42:39 +0200379 // Make sure we register as a stats observer *after* we've prepared the
380 // |video_stream_decoder_|.
381 call_stats_->RegisterStatsObserver(this);
382
Niels Möllerad31c982019-03-14 11:20:30 +0100383 // NOTE: *Not* registering video_receiver_ on process_thread_. Its Process
384 // method does nothing that is useful for us, since we no longer use the old
385 // jitter buffer.
tommic8ece432017-06-20 02:44:38 -0700386
Peter Boströmca835252016-02-11 15:59:46 +0100387 // Start the decode thread
Tommifbf3bce2018-02-21 15:56:05 +0100388 video_receiver_.DecoderThreadStarting();
Tommi132e28e2018-02-24 17:57:33 +0100389 stats_proxy_.DecoderThreadStarting();
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000390 decode_thread_.Start();
nisseb1f2ff92017-06-09 04:01:55 -0700391 rtp_video_stream_receiver_.StartReceive();
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000392}
393
pbos@webrtc.orga5c8d2c2014-04-24 11:13:21 +0000394void VideoReceiveStream::Stop() {
eladalona28122f2017-08-18 04:02:48 -0700395 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
nisseb1f2ff92017-06-09 04:01:55 -0700396 rtp_video_stream_receiver_.StopReceive();
philipelfd5a20f2016-11-15 00:57:57 -0800397
Ilya Nikolaevskiyd397a0d2018-02-21 15:57:09 +0100398 stats_proxy_.OnUniqueFramesCounted(
399 rtp_video_stream_receiver_.GetUniqueFramesSeen());
400
philipela45102f2017-02-22 05:30:39 -0800401 frame_buffer_->Stop();
philipele21be1d2017-09-25 06:37:12 -0700402 call_stats_->DeregisterStatsObserver(this);
philipelfd5a20f2016-11-15 00:57:57 -0800403
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000404 if (decode_thread_.IsRunning()) {
tommic8ece432017-06-20 02:44:38 -0700405 // TriggerDecoderShutdown will release any waiting decoder thread and make
406 // it stop immediately, instead of waiting for a timeout. Needs to be called
407 // before joining the decoder thread.
408 video_receiver_.TriggerDecoderShutdown();
409
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000410 decode_thread_.Stop();
Tommifbf3bce2018-02-21 15:56:05 +0100411 video_receiver_.DecoderThreadStopped();
Tommi132e28e2018-02-24 17:57:33 +0100412 stats_proxy_.DecoderThreadStopped();
sprang0d348d62016-10-07 08:28:39 -0700413 // Deregister external decoders so they are no longer running during
414 // destruction. This effectively stops the VCM since the decoder thread is
415 // stopped, the VCM is deregistered and no asynchronous decoder threads are
416 // running.
417 for (const Decoder& decoder : config_.decoders)
418 video_receiver_.RegisterExternalDecoder(nullptr, decoder.payload_type);
419 }
philipelfd5a20f2016-11-15 00:57:57 -0800420
tommi2e82f382016-06-21 00:26:43 -0700421 video_stream_decoder_.reset();
422 incoming_video_stream_.reset();
sprang@webrtc.orgd9b95602014-01-27 13:03:02 +0000423 transport_adapter_.Disable();
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000424}
425
sprang@webrtc.org9510e532014-02-07 15:32:45 +0000426VideoReceiveStream::Stats VideoReceiveStream::GetStats() const {
Peter Boströmf751bf82016-02-05 14:00:53 +0100427 return stats_proxy_.GetStats();
sprang@webrtc.org09315702014-02-07 12:06:29 +0000428}
429
eladalonc0d481a2017-08-02 07:39:07 -0700430void VideoReceiveStream::AddSecondarySink(RtpPacketSinkInterface* sink) {
431 rtp_video_stream_receiver_.AddSecondarySink(sink);
432}
433
434void VideoReceiveStream::RemoveSecondarySink(
435 const RtpPacketSinkInterface* sink) {
436 rtp_video_stream_receiver_.RemoveSecondarySink(sink);
437}
438
Ruslan Burakov493a6502019-02-27 15:32:48 +0100439bool VideoReceiveStream::SetBaseMinimumPlayoutDelayMs(int delay_ms) {
440 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
441 if (delay_ms < kMinBaseMinimumDelayMs || delay_ms > kMaxBaseMinimumDelayMs) {
442 return false;
443 }
444
445 rtc::CritScope cs(&playout_delay_lock_);
446 base_minimum_playout_delay_ms_ = delay_ms;
447 UpdatePlayoutDelays();
448 return true;
449}
450
451int VideoReceiveStream::GetBaseMinimumPlayoutDelayMs() const {
452 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
453
454 rtc::CritScope cs(&playout_delay_lock_);
455 return base_minimum_playout_delay_ms_;
456}
457
tommi2e82f382016-06-21 00:26:43 -0700458// TODO(tommi): This method grabs a lock 6 times.
Tommibd3380f2016-06-10 17:38:17 +0200459void VideoReceiveStream::OnFrame(const VideoFrame& video_frame) {
asaperssonf8cdd182016-03-15 01:00:47 -0700460 int64_t sync_offset_ms;
asaperssonde9e5ff2016-11-02 07:14:03 -0700461 double estimated_freq_khz;
tommi2e82f382016-06-21 00:26:43 -0700462 // TODO(tommi): GetStreamSyncOffsetInMs grabs three locks. One inside the
463 // function itself, another in GetChannel() and a third in
464 // GetPlayoutTimestamp. Seems excessive. Anyhow, I'm assuming the function
465 // succeeds most of the time, which leads to grabbing a fourth lock.
Yves Gerey665174f2018-06-19 15:03:05 +0200466 if (rtp_stream_sync_.GetStreamSyncOffsetInMs(
467 video_frame.timestamp(), video_frame.render_time_ms(),
468 &sync_offset_ms, &estimated_freq_khz)) {
tommi2e82f382016-06-21 00:26:43 -0700469 // TODO(tommi): OnSyncOffsetUpdated grabs a lock.
asaperssonde9e5ff2016-11-02 07:14:03 -0700470 stats_proxy_.OnSyncOffsetUpdated(sync_offset_ms, estimated_freq_khz);
tommi2e82f382016-06-21 00:26:43 -0700471 }
tommi2e82f382016-06-21 00:26:43 -0700472 config_.renderer->OnFrame(video_frame);
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000473
tommi2e82f382016-06-21 00:26:43 -0700474 // TODO(tommi): OnRenderFrame grabs a lock too.
asapersson1490f7a2016-09-23 02:09:46 -0700475 stats_proxy_.OnRenderedFrame(video_frame);
pbos@webrtc.org29d58392013-05-16 12:08:03 +0000476}
pbos@webrtc.org26c0c412014-09-03 16:17:12 +0000477
brandtr090c9402017-01-25 08:28:02 -0800478void VideoReceiveStream::SendNack(
479 const std::vector<uint16_t>& sequence_numbers) {
nisseb1f2ff92017-06-09 04:01:55 -0700480 rtp_video_stream_receiver_.RequestPacketRetransmit(sequence_numbers);
brandtr090c9402017-01-25 08:28:02 -0800481}
482
483void VideoReceiveStream::RequestKeyFrame() {
Niels Möller46879152019-01-07 15:54:47 +0100484 if (config_.media_transport) {
485 config_.media_transport->RequestKeyFrame(config_.rtp.remote_ssrc);
486 } else {
487 rtp_video_stream_receiver_.RequestKeyFrame();
488 }
brandtr090c9402017-01-25 08:28:02 -0800489}
490
491void VideoReceiveStream::OnCompleteFrame(
philipele7c891f2018-02-22 14:35:06 +0100492 std::unique_ptr<video_coding::EncodedFrame> frame) {
Ruslan Burakov493a6502019-02-27 15:32:48 +0100493 RTC_DCHECK_CALLED_SEQUENTIALLY(&network_sequence_checker_);
Ilya Nikolaevskiye6a2d942018-11-07 14:32:28 +0100494 // TODO(https://bugs.webrtc.org/9974): Consider removing this workaround.
495 int64_t time_now_ms = rtc::TimeMillis();
496 if (last_complete_frame_time_ms_ > 0 &&
497 time_now_ms - last_complete_frame_time_ms_ > kInactiveStreamThresholdMs) {
498 frame_buffer_->Clear();
499 }
500 last_complete_frame_time_ms_ = time_now_ms;
501
Ruslan Burakov493a6502019-02-27 15:32:48 +0100502 const PlayoutDelay& playout_delay = frame->EncodedImage().playout_delay_;
503 if (playout_delay.min_ms >= 0) {
504 rtc::CritScope cs(&playout_delay_lock_);
505 frame_minimum_playout_delay_ms_ = playout_delay.min_ms;
506 UpdatePlayoutDelays();
507 }
508
509 if (playout_delay.max_ms >= 0) {
510 rtc::CritScope cs(&playout_delay_lock_);
511 frame_maximum_playout_delay_ms_ = playout_delay.max_ms;
512 UpdatePlayoutDelays();
513 }
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000514
515 int64_t last_continuous_pid = frame_buffer_->InsertFrame(std::move(frame));
516 if (last_continuous_pid != -1)
517 rtp_video_stream_receiver_.FrameContinuous(last_continuous_pid);
brandtr090c9402017-01-25 08:28:02 -0800518}
519
Niels Möller46879152019-01-07 15:54:47 +0100520void VideoReceiveStream::OnData(uint64_t channel_id,
521 MediaTransportEncodedVideoFrame frame) {
522 OnCompleteFrame(
523 absl::make_unique<EncodedFrameForMediaTransport>(std::move(frame)));
524}
525
philipele21be1d2017-09-25 06:37:12 -0700526void VideoReceiveStream::OnRttUpdate(int64_t avg_rtt_ms, int64_t max_rtt_ms) {
Tommi81de14f2018-03-25 22:19:25 +0200527 RTC_DCHECK_CALLED_SEQUENTIALLY(&module_process_sequence_checker_);
philipele21be1d2017-09-25 06:37:12 -0700528 frame_buffer_->UpdateRtt(max_rtt_ms);
Tommi81de14f2018-03-25 22:19:25 +0200529 rtp_video_stream_receiver_.UpdateRtt(max_rtt_ms);
philipele21be1d2017-09-25 06:37:12 -0700530}
531
Niels Möller46879152019-01-07 15:54:47 +0100532void VideoReceiveStream::OnRttUpdated(int64_t rtt_ms) {
533 frame_buffer_->UpdateRtt(rtt_ms);
534}
535
solenberg3ebbcb52017-01-31 03:58:40 -0800536int VideoReceiveStream::id() const {
eladalona28122f2017-08-18 04:02:48 -0700537 RTC_DCHECK_CALLED_SEQUENTIALLY(&worker_sequence_checker_);
solenberg3ebbcb52017-01-31 03:58:40 -0800538 return config_.rtp.remote_ssrc;
539}
540
Danil Chapovalovb9b146c2018-06-15 12:28:07 +0200541absl::optional<Syncable::Info> VideoReceiveStream::GetInfo() const {
eladalona28122f2017-08-18 04:02:48 -0700542 RTC_DCHECK_CALLED_SEQUENTIALLY(&module_process_sequence_checker_);
Niels Möllerdf9e9ae2018-07-31 08:29:53 +0200543 absl::optional<Syncable::Info> info =
544 rtp_video_stream_receiver_.GetSyncInfo();
solenberg3ebbcb52017-01-31 03:58:40 -0800545
Niels Möllerdf9e9ae2018-07-31 08:29:53 +0200546 if (!info)
Danil Chapovalovb9b146c2018-06-15 12:28:07 +0200547 return absl::nullopt;
solenberg3ebbcb52017-01-31 03:58:40 -0800548
Niels Möllerdf9e9ae2018-07-31 08:29:53 +0200549 info->current_delay_ms = video_receiver_.Delay();
Oskar Sundbom8e07c132018-01-08 16:45:42 +0100550 return info;
solenberg3ebbcb52017-01-31 03:58:40 -0800551}
552
553uint32_t VideoReceiveStream::GetPlayoutTimestamp() const {
554 RTC_NOTREACHED();
555 return 0;
556}
557
558void VideoReceiveStream::SetMinimumPlayoutDelay(int delay_ms) {
eladalona28122f2017-08-18 04:02:48 -0700559 RTC_DCHECK_CALLED_SEQUENTIALLY(&module_process_sequence_checker_);
Ruslan Burakov493a6502019-02-27 15:32:48 +0100560 rtc::CritScope cs(&playout_delay_lock_);
561 syncable_minimum_playout_delay_ms_ = delay_ms;
562 UpdatePlayoutDelays();
solenberg3ebbcb52017-01-31 03:58:40 -0800563}
564
tommic8ece432017-06-20 02:44:38 -0700565void VideoReceiveStream::DecodeThreadFunction(void* ptr) {
Karl Wibergab036382019-03-12 18:01:51 +0100566 ScopedRegisterThreadForDebugging thread_dbg(RTC_FROM_HERE);
tommic8ece432017-06-20 02:44:38 -0700567 while (static_cast<VideoReceiveStream*>(ptr)->Decode()) {
568 }
Peter Boströmca835252016-02-11 15:59:46 +0100569}
570
philipel2dfea3e2017-02-28 07:19:43 -0800571bool VideoReceiveStream::Decode() {
tommidb23ea62017-03-03 07:21:18 -0800572 TRACE_EVENT0("webrtc", "VideoReceiveStream::Decode");
philipel3042c2d2017-08-18 04:55:02 -0700573
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000574 const int wait_ms =
575 keyframe_required_ ? max_wait_for_keyframe_ms_ : max_wait_for_frame_ms_;
philipele7c891f2018-02-22 14:35:06 +0100576 std::unique_ptr<video_coding::EncodedFrame> frame;
philipel3042c2d2017-08-18 04:55:02 -0700577 // TODO(philipel): Call NextFrame with |keyframe_required| argument when
578 // downstream project has been fixed.
guidouc3372582017-04-04 07:16:21 -0700579 video_coding::FrameBuffer::ReturnReason res =
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000580 frame_buffer_->NextFrame(wait_ms, &frame);
581
582 if (res == video_coding::FrameBuffer::ReturnReason::kStopped) {
philipel2dfea3e2017-02-28 07:19:43 -0800583 return false;
guidouc3372582017-04-04 07:16:21 -0700584 }
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000585
philipela45102f2017-02-22 05:30:39 -0800586 if (frame) {
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000587 int64_t now_ms = clock_->TimeInMilliseconds();
588 RTC_DCHECK_EQ(res, video_coding::FrameBuffer::ReturnReason::kFrameFound);
589
590 // Current OnPreDecode only cares about QP for VP8.
591 int qp = -1;
592 if (frame->CodecSpecific()->codecType == kVideoCodecVP8) {
593 if (!vp8::GetQp(frame->data(), frame->size(), &qp)) {
594 RTC_LOG(LS_WARNING) << "Failed to extract QP from VP8 video frame";
595 }
596 }
597 stats_proxy_.OnPreDecode(frame->CodecSpecific()->codecType, qp);
598
599 int decode_result = video_receiver_.Decode(frame.get());
600 if (decode_result == WEBRTC_VIDEO_CODEC_OK ||
601 decode_result == WEBRTC_VIDEO_CODEC_OK_REQUEST_KEYFRAME) {
602 keyframe_required_ = false;
603 frame_decoded_ = true;
604 rtp_video_stream_receiver_.FrameDecoded(frame->id.picture_id);
605
606 if (decode_result == WEBRTC_VIDEO_CODEC_OK_REQUEST_KEYFRAME)
607 RequestKeyFrame();
608 } else if (!frame_decoded_ || !keyframe_required_ ||
609 (last_keyframe_request_ms_ + max_wait_for_keyframe_ms_ <
610 now_ms)) {
611 keyframe_required_ = true;
612 // TODO(philipel): Remove this keyframe request when downstream project
613 // has been fixed.
614 RequestKeyFrame();
615 last_keyframe_request_ms_ = now_ms;
616 }
philipelfd5a20f2016-11-15 00:57:57 -0800617 } else {
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000618 RTC_DCHECK_EQ(res, video_coding::FrameBuffer::ReturnReason::kTimeout);
619 int64_t now_ms = clock_->TimeInMilliseconds();
620 absl::optional<int64_t> last_packet_ms =
621 rtp_video_stream_receiver_.LastReceivedPacketMs();
622 absl::optional<int64_t> last_keyframe_packet_ms =
623 rtp_video_stream_receiver_.LastReceivedKeyframePacketMs();
Jonas Oreland49ac5952018-09-26 16:04:32 +0200624
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000625 // To avoid spamming keyframe requests for a stream that is not active we
626 // check if we have received a packet within the last 5 seconds.
627 bool stream_is_active = last_packet_ms && now_ms - *last_packet_ms < 5000;
628 if (!stream_is_active)
629 stats_proxy_.OnStreamInactive();
Sebastian Jansson13943b72019-04-02 15:08:14 +0200630
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000631 // If we recently have been receiving packets belonging to a keyframe then
632 // we assume a keyframe is currently being received.
633 bool receiving_keyframe =
634 last_keyframe_packet_ms &&
635 now_ms - *last_keyframe_packet_ms < max_wait_for_keyframe_ms_;
636
637 if (stream_is_active && !receiving_keyframe &&
638 (!config_.crypto_options.sframe.require_frame_encryption ||
639 rtp_video_stream_receiver_.IsDecryptable())) {
640 RTC_LOG(LS_WARNING) << "No decodable frame in " << wait_ms
641 << " ms, requesting keyframe.";
642 RequestKeyFrame();
Sebastian Jansson13943b72019-04-02 15:08:14 +0200643 }
644 }
Henrik Boströmc680c4a2019-04-03 10:27:36 +0000645 return true;
Sebastian Jansson13943b72019-04-02 15:08:14 +0200646}
647
Ruslan Burakov493a6502019-02-27 15:32:48 +0100648void VideoReceiveStream::UpdatePlayoutDelays() const {
649 const int minimum_delay_ms =
650 std::max({frame_minimum_playout_delay_ms_, base_minimum_playout_delay_ms_,
651 syncable_minimum_playout_delay_ms_});
652 if (minimum_delay_ms >= 0) {
653 timing_->set_min_playout_delay(minimum_delay_ms);
654 }
655
656 const int maximum_delay_ms = frame_maximum_playout_delay_ms_;
657 if (maximum_delay_ms >= 0) {
658 timing_->set_max_playout_delay(maximum_delay_ms);
659 }
660}
661
Jonas Oreland49ac5952018-09-26 16:04:32 +0200662std::vector<webrtc::RtpSource> VideoReceiveStream::GetSources() const {
663 return rtp_video_stream_receiver_.GetSources();
664}
665
mflodman@webrtc.orgf3973e82013-12-13 09:40:45 +0000666} // namespace internal
667} // namespace webrtc