blob: 5e5ab6e4f335af6cc7aa3b2a59a543121decad78 [file] [log] [blame]
eladalonf1841382017-06-12 01:16:46 -07001/*
2 * Copyright (c) 2014 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
Steve Anton10542f22019-01-11 09:11:00 -080011#ifndef MEDIA_ENGINE_WEBRTC_VIDEO_ENGINE_H_
12#define MEDIA_ENGINE_WEBRTC_VIDEO_ENGINE_H_
eladalonf1841382017-06-12 01:16:46 -070013
14#include <map>
15#include <memory>
16#include <set>
17#include <string>
18#include <vector>
19
Danil Chapovalov00c71832018-06-15 15:58:38 +020020#include "absl/types/optional.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "api/call/transport.h"
Jiawei Ouc2ebe212018-11-08 10:02:56 -080022#include "api/video/video_bitrate_allocator_factory.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020023#include "api/video/video_frame.h"
Niels Möllerc6ce9c52018-05-11 11:15:30 +020024#include "api/video/video_sink_interface.h"
Niels Möller0327c2d2018-05-21 14:09:31 +020025#include "api/video/video_source_interface.h"
26#include "api/video_codecs/sdp_video_format.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "call/call.h"
28#include "call/flexfec_receive_stream.h"
29#include "call/video_receive_stream.h"
30#include "call/video_send_stream.h"
Steve Anton10542f22019-01-11 09:11:00 -080031#include "media/base/media_engine.h"
Ying Wang4271afb2019-08-27 12:16:38 +020032#include "media/engine/constants.h"
Jonas Oreland6d835922019-03-18 10:59:40 +010033#include "media/engine/unhandled_packets_buffer.h"
Steve Anton10542f22019-01-11 09:11:00 -080034#include "rtc_base/async_invoker.h"
35#include "rtc_base/critical_section.h"
36#include "rtc_base/network_route.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020037#include "rtc_base/thread_annotations.h"
38#include "rtc_base/thread_checker.h"
eladalonf1841382017-06-12 01:16:46 -070039
40namespace webrtc {
Magnus Jedvertd4b0c052017-09-14 10:24:54 +020041class VideoDecoderFactory;
Magnus Jedvertd4b0c052017-09-14 10:24:54 +020042class VideoEncoderFactory;
eladalonf1841382017-06-12 01:16:46 -070043struct MediaConfig;
Yves Gerey665174f2018-06-19 15:03:05 +020044} // namespace webrtc
eladalonf1841382017-06-12 01:16:46 -070045
46namespace rtc {
47class Thread;
48} // namespace rtc
49
50namespace cricket {
51
eladalonf1841382017-06-12 01:16:46 -070052class WebRtcVideoChannel;
eladalonf1841382017-06-12 01:16:46 -070053
eladalonf1841382017-06-12 01:16:46 -070054class UnsignalledSsrcHandler {
55 public:
56 enum Action {
57 kDropPacket,
58 kDeliverPacket,
59 };
60 virtual Action OnUnsignalledSsrc(WebRtcVideoChannel* channel,
61 uint32_t ssrc) = 0;
62 virtual ~UnsignalledSsrcHandler() = default;
63};
64
65// TODO(pbos): Remove, use external handlers only.
66class DefaultUnsignalledSsrcHandler : public UnsignalledSsrcHandler {
67 public:
68 DefaultUnsignalledSsrcHandler();
Yves Gerey665174f2018-06-19 15:03:05 +020069 Action OnUnsignalledSsrc(WebRtcVideoChannel* channel, uint32_t ssrc) override;
eladalonf1841382017-06-12 01:16:46 -070070
71 rtc::VideoSinkInterface<webrtc::VideoFrame>* GetDefaultSink() const;
72 void SetDefaultSink(WebRtcVideoChannel* channel,
73 rtc::VideoSinkInterface<webrtc::VideoFrame>* sink);
74
75 virtual ~DefaultUnsignalledSsrcHandler() = default;
76
77 private:
78 rtc::VideoSinkInterface<webrtc::VideoFrame>* default_sink_;
79};
80
81// WebRtcVideoEngine is used for the new native WebRTC Video API (webrtc:1667).
Sebastian Jansson84848f22018-11-16 10:40:36 +010082class WebRtcVideoEngine : public VideoEngineInterface {
eladalonf1841382017-06-12 01:16:46 -070083 public:
Magnus Jedvertd4b0c052017-09-14 10:24:54 +020084 // These video codec factories represents all video codecs, i.e. both software
85 // and external hardware codecs.
86 WebRtcVideoEngine(
87 std::unique_ptr<webrtc::VideoEncoderFactory> video_encoder_factory,
Jonas Orelanda3aa9bd2019-04-17 07:38:40 +020088 std::unique_ptr<webrtc::VideoDecoderFactory> video_decoder_factory);
Magnus Jedvertd4b0c052017-09-14 10:24:54 +020089
Sebastian Jansson84848f22018-11-16 10:40:36 +010090 ~WebRtcVideoEngine() override;
eladalonf1841382017-06-12 01:16:46 -070091
Sebastian Jansson84848f22018-11-16 10:40:36 +010092 VideoMediaChannel* CreateMediaChannel(
Benjamin Wrightbfb444c2018-10-15 10:20:24 -070093 webrtc::Call* call,
94 const MediaConfig& config,
95 const VideoOptions& options,
Jonas Orelanda3aa9bd2019-04-17 07:38:40 +020096 const webrtc::CryptoOptions& crypto_options,
97 webrtc::VideoBitrateAllocatorFactory* video_bitrate_allocator_factory)
98 override;
eladalonf1841382017-06-12 01:16:46 -070099
Sebastian Jansson84848f22018-11-16 10:40:36 +0100100 std::vector<VideoCodec> codecs() const override;
101 RtpCapabilities GetCapabilities() const override;
eladalonf1841382017-06-12 01:16:46 -0700102
eladalonf1841382017-06-12 01:16:46 -0700103 private:
Magnus Jedvert59ab3532018-09-03 18:07:56 +0200104 const std::unique_ptr<webrtc::VideoDecoderFactory> decoder_factory_;
Magnus Jedvert07e0d012017-10-31 11:24:54 +0100105 const std::unique_ptr<webrtc::VideoEncoderFactory> encoder_factory_;
Jiawei Ouc2ebe212018-11-08 10:02:56 -0800106 const std::unique_ptr<webrtc::VideoBitrateAllocatorFactory>
107 bitrate_allocator_factory_;
eladalonf1841382017-06-12 01:16:46 -0700108};
109
philipele8ed8302019-07-03 11:53:48 +0200110class WebRtcVideoChannel : public VideoMediaChannel,
111 public webrtc::Transport,
philipeld9cc8c02019-09-16 14:53:40 +0200112 public webrtc::EncoderSwitchRequestCallback {
eladalonf1841382017-06-12 01:16:46 -0700113 public:
Jiawei Ouc2ebe212018-11-08 10:02:56 -0800114 WebRtcVideoChannel(
115 webrtc::Call* call,
116 const MediaConfig& config,
117 const VideoOptions& options,
118 const webrtc::CryptoOptions& crypto_options,
119 webrtc::VideoEncoderFactory* encoder_factory,
120 webrtc::VideoDecoderFactory* decoder_factory,
121 webrtc::VideoBitrateAllocatorFactory* bitrate_allocator_factory);
eladalonf1841382017-06-12 01:16:46 -0700122 ~WebRtcVideoChannel() override;
123
124 // VideoMediaChannel implementation
eladalonf1841382017-06-12 01:16:46 -0700125 bool SetSendParameters(const VideoSendParameters& params) override;
126 bool SetRecvParameters(const VideoRecvParameters& params) override;
127 webrtc::RtpParameters GetRtpSendParameters(uint32_t ssrc) const override;
Zach Steinba37b4b2018-01-23 15:02:36 -0800128 webrtc::RTCError SetRtpSendParameters(
129 uint32_t ssrc,
130 const webrtc::RtpParameters& parameters) override;
eladalonf1841382017-06-12 01:16:46 -0700131 webrtc::RtpParameters GetRtpReceiveParameters(uint32_t ssrc) const override;
132 bool SetRtpReceiveParameters(
133 uint32_t ssrc,
134 const webrtc::RtpParameters& parameters) override;
135 bool GetSendCodec(VideoCodec* send_codec) override;
136 bool SetSend(bool send) override;
137 bool SetVideoSend(
138 uint32_t ssrc,
eladalonf1841382017-06-12 01:16:46 -0700139 const VideoOptions* options,
140 rtc::VideoSourceInterface<webrtc::VideoFrame>* source) override;
141 bool AddSendStream(const StreamParams& sp) override;
142 bool RemoveSendStream(uint32_t ssrc) override;
143 bool AddRecvStream(const StreamParams& sp) override;
144 bool AddRecvStream(const StreamParams& sp, bool default_stream);
145 bool RemoveRecvStream(uint32_t ssrc) override;
Saurav Dasff27da52019-09-20 11:05:30 -0700146 void ResetUnsignaledRecvStream() override;
eladalonf1841382017-06-12 01:16:46 -0700147 bool SetSink(uint32_t ssrc,
148 rtc::VideoSinkInterface<webrtc::VideoFrame>* sink) override;
149 void FillBitrateInfo(BandwidthEstimationInfo* bwe_info) override;
150 bool GetStats(VideoMediaInfo* info) override;
151
Amit Hilbuche7a5f7b2019-03-12 11:10:27 -0700152 void OnPacketReceived(rtc::CopyOnWriteBuffer packet,
Niels Möllere6933812018-11-05 13:01:41 +0100153 int64_t packet_time_us) override;
eladalonf1841382017-06-12 01:16:46 -0700154 void OnReadyToSend(bool ready) override;
155 void OnNetworkRouteChanged(const std::string& transport_name,
156 const rtc::NetworkRoute& network_route) override;
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700157 void SetInterface(
158 NetworkInterface* iface,
159 const webrtc::MediaTransportConfig& media_transport_config) override;
eladalonf1841382017-06-12 01:16:46 -0700160
Benjamin Wright192eeec2018-10-17 17:27:25 -0700161 // E2E Encrypted Video Frame API
162 // Set a frame decryptor to a particular ssrc that will intercept all
163 // incoming video frames and attempt to decrypt them before forwarding the
164 // result.
165 void SetFrameDecryptor(uint32_t ssrc,
166 rtc::scoped_refptr<webrtc::FrameDecryptorInterface>
167 frame_decryptor) override;
168 // Set a frame encryptor to a particular ssrc that will intercept all
169 // outgoing video frames and attempt to encrypt them and forward the result
170 // to the packetizer.
171 void SetFrameEncryptor(uint32_t ssrc,
172 rtc::scoped_refptr<webrtc::FrameEncryptorInterface>
173 frame_encryptor) override;
174
Ruslan Burakov493a6502019-02-27 15:32:48 +0100175 bool SetBaseMinimumPlayoutDelayMs(uint32_t ssrc, int delay_ms) override;
176
177 absl::optional<int> GetBaseMinimumPlayoutDelayMs(
178 uint32_t ssrc) const override;
179
eladalonf1841382017-06-12 01:16:46 -0700180 // Implemented for VideoMediaChannelTest.
Steve Antonef50b252019-03-01 15:15:38 -0800181 bool sending() const {
182 RTC_DCHECK_RUN_ON(&thread_checker_);
183 return sending_;
184 }
eladalonf1841382017-06-12 01:16:46 -0700185
Danil Chapovalov00c71832018-06-15 15:58:38 +0200186 absl::optional<uint32_t> GetDefaultReceiveStreamSsrc();
eladalonf1841382017-06-12 01:16:46 -0700187
Steve Antonef50b252019-03-01 15:15:38 -0800188 StreamParams unsignaled_stream_params() {
189 RTC_DCHECK_RUN_ON(&thread_checker_);
190 return unsignaled_stream_params_;
191 }
Seth Hampson5897a6e2018-04-03 11:16:33 -0700192
eladalonf1841382017-06-12 01:16:46 -0700193 // AdaptReason is used for expressing why a WebRtcVideoSendStream request
194 // a lower input frame size than the currently configured camera input frame
195 // size. There can be more than one reason OR:ed together.
196 enum AdaptReason {
197 ADAPTREASON_NONE = 0,
198 ADAPTREASON_CPU = 1,
199 ADAPTREASON_BANDWIDTH = 2,
200 };
201
sprang67561a62017-06-15 06:34:42 -0700202 static constexpr int kDefaultQpMax = 56;
203
Jonas Oreland49ac5952018-09-26 16:04:32 +0200204 std::vector<webrtc::RtpSource> GetSources(uint32_t ssrc) const override;
205
Jonas Oreland6d835922019-03-18 10:59:40 +0100206 // Take the buffered packets for |ssrcs| and feed them into DeliverPacket.
207 // This method does nothing unless unknown_ssrc_packet_buffer_ is configured.
208 void BackfillBufferedPackets(rtc::ArrayView<const uint32_t> ssrcs);
209
philipeld9cc8c02019-09-16 14:53:40 +0200210 // Implements webrtc::EncoderSwitchRequestCallback.
211 void RequestEncoderFallback() override;
212 void RequestEncoderSwitch(
213 const EncoderSwitchRequestCallback::Config& conf) override;
philipele8ed8302019-07-03 11:53:48 +0200214
eladalonf1841382017-06-12 01:16:46 -0700215 private:
216 class WebRtcVideoReceiveStream;
217 struct VideoCodecSettings {
218 VideoCodecSettings();
219
220 // Checks if all members of |*this| are equal to the corresponding members
221 // of |other|.
222 bool operator==(const VideoCodecSettings& other) const;
223 bool operator!=(const VideoCodecSettings& other) const;
224
225 // Checks if all members of |a|, except |flexfec_payload_type|, are equal
226 // to the corresponding members of |b|.
227 static bool EqualsDisregardingFlexfec(const VideoCodecSettings& a,
228 const VideoCodecSettings& b);
229
230 VideoCodec codec;
231 webrtc::UlpfecConfig ulpfec;
Steve Anton2d2bbb12019-08-07 09:57:59 -0700232 int flexfec_payload_type; // -1 if absent.
233 int rtx_payload_type; // -1 if absent.
eladalonf1841382017-06-12 01:16:46 -0700234 };
235
236 struct ChangedSendParameters {
237 // These optionals are unset if not changed.
philipele8ed8302019-07-03 11:53:48 +0200238 absl::optional<VideoCodecSettings> send_codec;
239 absl::optional<std::vector<VideoCodecSettings>> negotiated_codecs;
Danil Chapovalov00c71832018-06-15 15:58:38 +0200240 absl::optional<std::vector<webrtc::RtpExtension>> rtp_header_extensions;
241 absl::optional<std::string> mid;
Johannes Kron9190b822018-10-29 11:22:05 +0100242 absl::optional<bool> extmap_allow_mixed;
Danil Chapovalov00c71832018-06-15 15:58:38 +0200243 absl::optional<int> max_bandwidth_bps;
244 absl::optional<bool> conference_mode;
245 absl::optional<webrtc::RtcpMode> rtcp_mode;
eladalonf1841382017-06-12 01:16:46 -0700246 };
247
248 struct ChangedRecvParameters {
249 // These optionals are unset if not changed.
Danil Chapovalov00c71832018-06-15 15:58:38 +0200250 absl::optional<std::vector<VideoCodecSettings>> codec_settings;
251 absl::optional<std::vector<webrtc::RtpExtension>> rtp_header_extensions;
eladalonf1841382017-06-12 01:16:46 -0700252 // Keep track of the FlexFEC payload type separately from |codec_settings|.
253 // This allows us to recreate the FlexfecReceiveStream separately from the
254 // VideoReceiveStream when the FlexFEC payload type is changed.
Danil Chapovalov00c71832018-06-15 15:58:38 +0200255 absl::optional<int> flexfec_payload_type;
eladalonf1841382017-06-12 01:16:46 -0700256 };
257
258 bool GetChangedSendParameters(const VideoSendParameters& params,
Steve Antonef50b252019-03-01 15:15:38 -0800259 ChangedSendParameters* changed_params) const
260 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
philipele8ed8302019-07-03 11:53:48 +0200261 bool ApplyChangedParams(const ChangedSendParameters& changed_params);
eladalonf1841382017-06-12 01:16:46 -0700262 bool GetChangedRecvParameters(const VideoRecvParameters& params,
Steve Antonef50b252019-03-01 15:15:38 -0800263 ChangedRecvParameters* changed_params) const
264 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700265
eladalonf1841382017-06-12 01:16:46 -0700266 void ConfigureReceiverRtp(
267 webrtc::VideoReceiveStream::Config* config,
268 webrtc::FlexfecReceiveStream::Config* flexfec_config,
Steve Antonef50b252019-03-01 15:15:38 -0800269 const StreamParams& sp) const
270 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700271 bool ValidateSendSsrcAvailability(const StreamParams& sp) const
Steve Antonef50b252019-03-01 15:15:38 -0800272 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700273 bool ValidateReceiveSsrcAvailability(const StreamParams& sp) const
Steve Antonef50b252019-03-01 15:15:38 -0800274 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700275 void DeleteReceiveStream(WebRtcVideoReceiveStream* stream)
Steve Antonef50b252019-03-01 15:15:38 -0800276 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700277
278 static std::string CodecSettingsVectorToString(
279 const std::vector<VideoCodecSettings>& codecs);
280
281 // Wrapper for the sender part.
Christian Fremerey6c025412019-02-13 19:43:28 +0000282 class WebRtcVideoSendStream
283 : public rtc::VideoSourceInterface<webrtc::VideoFrame> {
eladalonf1841382017-06-12 01:16:46 -0700284 public:
285 WebRtcVideoSendStream(
286 webrtc::Call* call,
287 const StreamParams& sp,
288 webrtc::VideoSendStream::Config config,
289 const VideoOptions& options,
eladalonf1841382017-06-12 01:16:46 -0700290 bool enable_cpu_overuse_detection,
291 int max_bitrate_bps,
Danil Chapovalov00c71832018-06-15 15:58:38 +0200292 const absl::optional<VideoCodecSettings>& codec_settings,
293 const absl::optional<std::vector<webrtc::RtpExtension>>& rtp_extensions,
eladalonf1841382017-06-12 01:16:46 -0700294 const VideoSendParameters& send_params);
295 virtual ~WebRtcVideoSendStream();
296
297 void SetSendParameters(const ChangedSendParameters& send_params);
Zach Steinba37b4b2018-01-23 15:02:36 -0800298 webrtc::RTCError SetRtpParameters(const webrtc::RtpParameters& parameters);
eladalonf1841382017-06-12 01:16:46 -0700299 webrtc::RtpParameters GetRtpParameters() const;
300
Benjamin Wright192eeec2018-10-17 17:27:25 -0700301 void SetFrameEncryptor(
302 rtc::scoped_refptr<webrtc::FrameEncryptorInterface> frame_encryptor);
303
Christian Fremerey6c025412019-02-13 19:43:28 +0000304 // Implements rtc::VideoSourceInterface<webrtc::VideoFrame>.
305 // WebRtcVideoSendStream acts as a source to the webrtc::VideoSendStream
306 // in |stream_|. This is done to proxy VideoSinkWants from the encoder to
307 // the worker thread.
308 void AddOrUpdateSink(rtc::VideoSinkInterface<webrtc::VideoFrame>* sink,
309 const rtc::VideoSinkWants& wants) override;
310 void RemoveSink(rtc::VideoSinkInterface<webrtc::VideoFrame>* sink) override;
311
Niels Möllerff40b142018-04-09 08:49:14 +0200312 bool SetVideoSend(const VideoOptions* options,
eladalonf1841382017-06-12 01:16:46 -0700313 rtc::VideoSourceInterface<webrtc::VideoFrame>* source);
314
315 void SetSend(bool send);
316
317 const std::vector<uint32_t>& GetSsrcs() const;
318 VideoSenderInfo GetVideoSenderInfo(bool log_stats);
319 void FillBitrateInfo(BandwidthEstimationInfo* bwe_info);
320
321 private:
322 // Parameters needed to reconstruct the underlying stream.
323 // webrtc::VideoSendStream doesn't support setting a lot of options on the
324 // fly, so when those need to be changed we tear down and reconstruct with
325 // similar parameters depending on which options changed etc.
326 struct VideoSendStreamParameters {
327 VideoSendStreamParameters(
328 webrtc::VideoSendStream::Config config,
329 const VideoOptions& options,
330 int max_bitrate_bps,
Danil Chapovalov00c71832018-06-15 15:58:38 +0200331 const absl::optional<VideoCodecSettings>& codec_settings);
eladalonf1841382017-06-12 01:16:46 -0700332 webrtc::VideoSendStream::Config config;
333 VideoOptions options;
334 int max_bitrate_bps;
335 bool conference_mode;
Danil Chapovalov00c71832018-06-15 15:58:38 +0200336 absl::optional<VideoCodecSettings> codec_settings;
eladalonf1841382017-06-12 01:16:46 -0700337 // Sent resolutions + bitrates etc. by the underlying VideoSendStream,
338 // typically changes when setting a new resolution or reconfiguring
339 // bitrates.
340 webrtc::VideoEncoderConfig encoder_config;
341 };
342
eladalonf1841382017-06-12 01:16:46 -0700343 rtc::scoped_refptr<webrtc::VideoEncoderConfig::EncoderSpecificSettings>
344 ConfigureVideoEncoderSettings(const VideoCodec& codec);
Niels Möller5bf8ccd2018-03-15 14:16:11 +0100345 void SetCodec(const VideoCodecSettings& codec);
eladalonf1841382017-06-12 01:16:46 -0700346 void RecreateWebRtcStream();
347 webrtc::VideoEncoderConfig CreateVideoEncoderConfig(
348 const VideoCodec& codec) const;
349 void ReconfigureEncoder();
eladalonf1841382017-06-12 01:16:46 -0700350
351 // Calls Start or Stop according to whether or not |sending_| is true,
352 // and whether or not the encoding in |rtp_parameters_| is active.
353 void UpdateSendState();
354
Taylor Brandstetter49fcc102018-05-16 14:20:41 -0700355 webrtc::DegradationPreference GetDegradationPreference() const
356 RTC_EXCLUSIVE_LOCKS_REQUIRED(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700357
358 rtc::ThreadChecker thread_checker_;
eladalonf1841382017-06-12 01:16:46 -0700359 rtc::Thread* worker_thread_;
Niels Möller1e062892018-02-07 10:18:32 +0100360 const std::vector<uint32_t> ssrcs_ RTC_GUARDED_BY(&thread_checker_);
361 const std::vector<SsrcGroup> ssrc_groups_ RTC_GUARDED_BY(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700362 webrtc::Call* const call_;
363 const bool enable_cpu_overuse_detection_;
364 rtc::VideoSourceInterface<webrtc::VideoFrame>* source_
Niels Möller1e062892018-02-07 10:18:32 +0100365 RTC_GUARDED_BY(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700366
Niels Möller1e062892018-02-07 10:18:32 +0100367 webrtc::VideoSendStream* stream_ RTC_GUARDED_BY(&thread_checker_);
Christian Fremerey6c025412019-02-13 19:43:28 +0000368 rtc::VideoSinkInterface<webrtc::VideoFrame>* encoder_sink_
369 RTC_GUARDED_BY(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700370 // Contains settings that are the same for all streams in the MediaChannel,
371 // such as codecs, header extensions, and the global bitrate limit for the
372 // entire channel.
Niels Möller1e062892018-02-07 10:18:32 +0100373 VideoSendStreamParameters parameters_ RTC_GUARDED_BY(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700374 // Contains settings that are unique for each stream, such as max_bitrate.
375 // Does *not* contain codecs, however.
376 // TODO(skvlad): Move ssrcs_ and ssrc_groups_ into rtp_parameters_.
377 // TODO(skvlad): Combine parameters_ and rtp_parameters_ once we have only
378 // one stream per MediaChannel.
Niels Möller1e062892018-02-07 10:18:32 +0100379 webrtc::RtpParameters rtp_parameters_ RTC_GUARDED_BY(&thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700380
Niels Möller1e062892018-02-07 10:18:32 +0100381 bool sending_ RTC_GUARDED_BY(&thread_checker_);
philipel98cbb222019-06-14 11:28:51 +0200382
383 // In order for the |invoker_| to protect other members from being
384 // destructed as they are used in asynchronous tasks it has to be destructed
385 // first.
386 rtc::AsyncInvoker invoker_;
eladalonf1841382017-06-12 01:16:46 -0700387 };
388
389 // Wrapper for the receiver part, contains configs etc. that are needed to
390 // reconstruct the underlying VideoReceiveStream.
391 class WebRtcVideoReceiveStream
392 : public rtc::VideoSinkInterface<webrtc::VideoFrame> {
393 public:
394 WebRtcVideoReceiveStream(
Jonas Oreland6d835922019-03-18 10:59:40 +0100395 WebRtcVideoChannel* channel,
eladalonf1841382017-06-12 01:16:46 -0700396 webrtc::Call* call,
397 const StreamParams& sp,
398 webrtc::VideoReceiveStream::Config config,
Magnus Jedvert59ab3532018-09-03 18:07:56 +0200399 webrtc::VideoDecoderFactory* decoder_factory,
eladalonf1841382017-06-12 01:16:46 -0700400 bool default_stream,
401 const std::vector<VideoCodecSettings>& recv_codecs,
402 const webrtc::FlexfecReceiveStream::Config& flexfec_config);
403 ~WebRtcVideoReceiveStream();
404
405 const std::vector<uint32_t>& GetSsrcs() const;
Florent Castelliabe301f2018-06-12 18:33:49 +0200406
Jonas Oreland49ac5952018-09-26 16:04:32 +0200407 std::vector<webrtc::RtpSource> GetSources();
408
Florent Castelliabe301f2018-06-12 18:33:49 +0200409 // Does not return codecs, they are filled by the owning WebRtcVideoChannel.
410 webrtc::RtpParameters GetRtpParameters() const;
eladalonf1841382017-06-12 01:16:46 -0700411
412 void SetLocalSsrc(uint32_t local_ssrc);
413 // TODO(deadbeef): Move these feedback parameters into the recv parameters.
Elad Alonfadb1812019-05-24 13:40:02 +0200414 void SetFeedbackParameters(bool lntf_enabled,
415 bool nack_enabled,
eladalonf1841382017-06-12 01:16:46 -0700416 bool transport_cc_enabled,
417 webrtc::RtcpMode rtcp_mode);
418 void SetRecvParameters(const ChangedRecvParameters& recv_params);
419
420 void OnFrame(const webrtc::VideoFrame& frame) override;
421 bool IsDefaultStream() const;
422
Benjamin Wright192eeec2018-10-17 17:27:25 -0700423 void SetFrameDecryptor(
424 rtc::scoped_refptr<webrtc::FrameDecryptorInterface> frame_decryptor);
425
Ruslan Burakov493a6502019-02-27 15:32:48 +0100426 bool SetBaseMinimumPlayoutDelayMs(int delay_ms);
427
428 int GetBaseMinimumPlayoutDelayMs() const;
429
eladalonf1841382017-06-12 01:16:46 -0700430 void SetSink(rtc::VideoSinkInterface<webrtc::VideoFrame>* sink);
431
432 VideoReceiverInfo GetVideoReceiverInfo(bool log_stats);
433
434 private:
eladalonf1841382017-06-12 01:16:46 -0700435 void RecreateWebRtcVideoStream();
436 void MaybeRecreateWebRtcFlexfecStream();
437
eladalonc0d481a2017-08-02 07:39:07 -0700438 void MaybeAssociateFlexfecWithVideo();
439 void MaybeDissociateFlexfecFromVideo();
440
Niels Möllercbcbc222018-09-28 09:07:24 +0200441 void ConfigureCodecs(const std::vector<VideoCodecSettings>& recv_codecs);
eladalonf1841382017-06-12 01:16:46 -0700442 void ConfigureFlexfecCodec(int flexfec_payload_type);
eladalonf1841382017-06-12 01:16:46 -0700443
444 std::string GetCodecNameFromPayloadType(int payload_type);
445
Jonas Oreland6d835922019-03-18 10:59:40 +0100446 WebRtcVideoChannel* const channel_;
eladalonf1841382017-06-12 01:16:46 -0700447 webrtc::Call* const call_;
Niels Möllercbcbc222018-09-28 09:07:24 +0200448 const StreamParams stream_params_;
eladalonf1841382017-06-12 01:16:46 -0700449
450 // Both |stream_| and |flexfec_stream_| are managed by |this|. They are
451 // destroyed by calling call_->DestroyVideoReceiveStream and
452 // call_->DestroyFlexfecReceiveStream, respectively.
453 webrtc::VideoReceiveStream* stream_;
454 const bool default_stream_;
455 webrtc::VideoReceiveStream::Config config_;
456 webrtc::FlexfecReceiveStream::Config flexfec_config_;
457 webrtc::FlexfecReceiveStream* flexfec_stream_;
458
Niels Möllercbcbc222018-09-28 09:07:24 +0200459 webrtc::VideoDecoderFactory* const decoder_factory_;
eladalonf1841382017-06-12 01:16:46 -0700460
461 rtc::CriticalSection sink_lock_;
danilchapa37de392017-09-09 04:17:22 -0700462 rtc::VideoSinkInterface<webrtc::VideoFrame>* sink_
463 RTC_GUARDED_BY(sink_lock_);
eladalonf1841382017-06-12 01:16:46 -0700464 // Expands remote RTP timestamps to int64_t to be able to estimate how long
465 // the stream has been running.
466 rtc::TimestampWrapAroundHandler timestamp_wraparound_handler_
danilchapa37de392017-09-09 04:17:22 -0700467 RTC_GUARDED_BY(sink_lock_);
468 int64_t first_frame_timestamp_ RTC_GUARDED_BY(sink_lock_);
eladalonf1841382017-06-12 01:16:46 -0700469 // Start NTP time is estimated as current remote NTP time (estimated from
470 // RTCP) minus the elapsed time, as soon as remote NTP time is available.
danilchapa37de392017-09-09 04:17:22 -0700471 int64_t estimated_remote_start_ntp_time_ms_ RTC_GUARDED_BY(sink_lock_);
eladalonf1841382017-06-12 01:16:46 -0700472 };
473
474 void Construct(webrtc::Call* call, WebRtcVideoEngine* engine);
475
476 bool SendRtp(const uint8_t* data,
477 size_t len,
478 const webrtc::PacketOptions& options) override;
479 bool SendRtcp(const uint8_t* data, size_t len) override;
480
Steve Anton2d2bbb12019-08-07 09:57:59 -0700481 // Generate the list of codec parameters to pass down based on the negotiated
482 // "codecs". Note that VideoCodecSettings correspond to concrete codecs like
483 // VP8, VP9, H264 while VideoCodecs correspond also to "virtual" codecs like
484 // RTX, ULPFEC, FLEXFEC.
eladalonf1841382017-06-12 01:16:46 -0700485 static std::vector<VideoCodecSettings> MapCodecs(
486 const std::vector<VideoCodec>& codecs);
philipele8ed8302019-07-03 11:53:48 +0200487 // Get all codecs that are compatible with the receiver.
488 std::vector<VideoCodecSettings> SelectSendVideoCodecs(
Steve Antonef50b252019-03-01 15:15:38 -0800489 const std::vector<VideoCodecSettings>& remote_mapped_codecs) const
490 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700491
492 static bool NonFlexfecReceiveCodecsHaveChanged(
493 std::vector<VideoCodecSettings> before,
494 std::vector<VideoCodecSettings> after);
495
Steve Antonef50b252019-03-01 15:15:38 -0800496 void FillSenderStats(VideoMediaInfo* info, bool log_stats)
497 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
498 void FillReceiverStats(VideoMediaInfo* info, bool log_stats)
499 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700500 void FillBandwidthEstimationStats(const webrtc::Call::Stats& stats,
Steve Antonef50b252019-03-01 15:15:38 -0800501 VideoMediaInfo* info)
502 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
503 void FillSendAndReceiveCodecStats(VideoMediaInfo* video_media_info)
504 RTC_EXCLUSIVE_LOCKS_REQUIRED(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700505
philipele8ed8302019-07-03 11:53:48 +0200506 rtc::Thread* worker_thread_;
eladalonf1841382017-06-12 01:16:46 -0700507 rtc::ThreadChecker thread_checker_;
508
Steve Antonef50b252019-03-01 15:15:38 -0800509 uint32_t rtcp_receiver_report_ssrc_ RTC_GUARDED_BY(thread_checker_);
510 bool sending_ RTC_GUARDED_BY(thread_checker_);
511 webrtc::Call* const call_ RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700512
Steve Antonef50b252019-03-01 15:15:38 -0800513 DefaultUnsignalledSsrcHandler default_unsignalled_ssrc_handler_
514 RTC_GUARDED_BY(thread_checker_);
515 UnsignalledSsrcHandler* const unsignalled_ssrc_handler_
516 RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700517
Ruslan Burakov493a6502019-02-27 15:32:48 +0100518 // Delay for unsignaled streams, which may be set before the stream exists.
Steve Antonef50b252019-03-01 15:15:38 -0800519 int default_recv_base_minimum_delay_ms_ RTC_GUARDED_BY(thread_checker_) = 0;
Ruslan Burakov493a6502019-02-27 15:32:48 +0100520
Steve Antonef50b252019-03-01 15:15:38 -0800521 const MediaConfig::Video video_config_ RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700522
eladalonf1841382017-06-12 01:16:46 -0700523 // Using primary-ssrc (first ssrc) as key.
524 std::map<uint32_t, WebRtcVideoSendStream*> send_streams_
Steve Antonef50b252019-03-01 15:15:38 -0800525 RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700526 std::map<uint32_t, WebRtcVideoReceiveStream*> receive_streams_
Steve Antonef50b252019-03-01 15:15:38 -0800527 RTC_GUARDED_BY(thread_checker_);
528 std::set<uint32_t> send_ssrcs_ RTC_GUARDED_BY(thread_checker_);
529 std::set<uint32_t> receive_ssrcs_ RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700530
Steve Antonef50b252019-03-01 15:15:38 -0800531 absl::optional<VideoCodecSettings> send_codec_
532 RTC_GUARDED_BY(thread_checker_);
philipele8ed8302019-07-03 11:53:48 +0200533 std::vector<VideoCodecSettings> negotiated_codecs_
534 RTC_GUARDED_BY(thread_checker_);
535
Steve Antonef50b252019-03-01 15:15:38 -0800536 absl::optional<std::vector<webrtc::RtpExtension>> send_rtp_extensions_
537 RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700538
Steve Antonef50b252019-03-01 15:15:38 -0800539 webrtc::VideoEncoderFactory* const encoder_factory_
540 RTC_GUARDED_BY(thread_checker_);
541 webrtc::VideoDecoderFactory* const decoder_factory_
542 RTC_GUARDED_BY(thread_checker_);
543 webrtc::VideoBitrateAllocatorFactory* const bitrate_allocator_factory_
544 RTC_GUARDED_BY(thread_checker_);
545 std::vector<VideoCodecSettings> recv_codecs_ RTC_GUARDED_BY(thread_checker_);
546 std::vector<webrtc::RtpExtension> recv_rtp_extensions_
547 RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700548 // See reason for keeping track of the FlexFEC payload type separately in
549 // comment in WebRtcVideoChannel::ChangedRecvParameters.
Steve Antonef50b252019-03-01 15:15:38 -0800550 int recv_flexfec_payload_type_ RTC_GUARDED_BY(thread_checker_);
551 webrtc::BitrateConstraints bitrate_config_ RTC_GUARDED_BY(thread_checker_);
eladalonf1841382017-06-12 01:16:46 -0700552 // TODO(deadbeef): Don't duplicate information between
553 // send_params/recv_params, rtp_extensions, options, etc.
Steve Antonef50b252019-03-01 15:15:38 -0800554 VideoSendParameters send_params_ RTC_GUARDED_BY(thread_checker_);
Steve Antonef50b252019-03-01 15:15:38 -0800555 VideoOptions default_send_options_ RTC_GUARDED_BY(thread_checker_);
556 VideoRecvParameters recv_params_ RTC_GUARDED_BY(thread_checker_);
557 int64_t last_stats_log_ms_ RTC_GUARDED_BY(thread_checker_);
558 const bool discard_unknown_ssrc_packets_ RTC_GUARDED_BY(thread_checker_);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700559 // This is a stream param that comes from the remote description, but wasn't
560 // signaled with any a=ssrc lines. It holds information that was signaled
561 // before the unsignaled receive stream is created when the first packet is
562 // received.
Steve Antonef50b252019-03-01 15:15:38 -0800563 StreamParams unsignaled_stream_params_ RTC_GUARDED_BY(thread_checker_);
Benjamin Wright192eeec2018-10-17 17:27:25 -0700564 // Per peer connection crypto options that last for the lifetime of the peer
565 // connection.
Steve Antonef50b252019-03-01 15:15:38 -0800566 const webrtc::CryptoOptions crypto_options_ RTC_GUARDED_BY(thread_checker_);
Jonas Oreland6d835922019-03-18 10:59:40 +0100567
568 // Buffer for unhandled packets.
569 std::unique_ptr<UnhandledPacketsBuffer> unknown_ssrc_packet_buffer_
570 RTC_GUARDED_BY(thread_checker_);
philipele8ed8302019-07-03 11:53:48 +0200571
572 // In order for the |invoker_| to protect other members from being destructed
573 // as they are used in asynchronous tasks it has to be destructed first.
574 rtc::AsyncInvoker invoker_;
eladalonf1841382017-06-12 01:16:46 -0700575};
576
ilnik6b826ef2017-06-16 06:53:48 -0700577class EncoderStreamFactory
578 : public webrtc::VideoEncoderConfig::VideoStreamFactoryInterface {
579 public:
580 EncoderStreamFactory(std::string codec_name,
581 int max_qp,
Seth Hampson1370e302018-02-07 08:50:36 -0800582 bool is_screenshare,
Florent Castelli66b38602019-07-10 16:57:57 +0200583 bool conference_mode);
ilnik6b826ef2017-06-16 06:53:48 -0700584
585 private:
586 std::vector<webrtc::VideoStream> CreateEncoderStreams(
587 int width,
588 int height,
589 const webrtc::VideoEncoderConfig& encoder_config) override;
590
591 const std::string codec_name_;
592 const int max_qp_;
Seth Hampson1370e302018-02-07 08:50:36 -0800593 const bool is_screenshare_;
594 // Allows a screenshare specific configuration, which enables temporal
Florent Castelli66b38602019-07-10 16:57:57 +0200595 // layering and various settings.
596 const bool conference_mode_;
ilnik6b826ef2017-06-16 06:53:48 -0700597};
598
eladalonf1841382017-06-12 01:16:46 -0700599} // namespace cricket
600
Steve Anton10542f22019-01-11 09:11:00 -0800601#endif // MEDIA_ENGINE_WEBRTC_VIDEO_ENGINE_H_