nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (c) 2017 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 | #ifndef CALL_RTP_TRANSPORT_CONTROLLER_SEND_INTERFACE_H_ |
| 12 | #define CALL_RTP_TRANSPORT_CONTROLLER_SEND_INTERFACE_H_ |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 13 | #include <stddef.h> |
| 14 | #include <stdint.h> |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 15 | |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 16 | #include <map> |
Stefan Holmer | 64be7fa | 2018-10-04 15:21:55 +0200 | [diff] [blame] | 17 | #include <memory> |
Sebastian Jansson | 97f61ea | 2018-02-21 13:01:55 +0100 | [diff] [blame] | 18 | #include <string> |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 19 | #include <vector> |
Sebastian Jansson | 97f61ea | 2018-02-21 13:01:55 +0100 | [diff] [blame] | 20 | |
Danil Chapovalov | b9b146c | 2018-06-15 12:28:07 +0200 | [diff] [blame] | 21 | #include "absl/types/optional.h" |
Steve Anton | 10542f2 | 2019-01-11 09:11:00 -0800 | [diff] [blame] | 22 | #include "api/crypto/crypto_options.h" |
Stefan Holmer | 64be7fa | 2018-10-04 15:21:55 +0200 | [diff] [blame] | 23 | #include "api/fec_controller.h" |
Danil Chapovalov | 83bbe91 | 2019-08-07 12:24:53 +0200 | [diff] [blame] | 24 | #include "api/rtc_event_log/rtc_event_log.h" |
Niels Möller | 0c4f7be | 2018-05-07 14:01:37 +0200 | [diff] [blame] | 25 | #include "api/transport/bitrate_settings.h" |
Erik Språng | 425d6aa | 2019-07-29 16:38:27 +0200 | [diff] [blame] | 26 | #include "api/units/timestamp.h" |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 27 | #include "call/rtp_config.h" |
Henrik Boström | 87e3f9d | 2019-05-27 10:44:24 +0200 | [diff] [blame] | 28 | #include "modules/rtp_rtcp/include/report_block_data.h" |
Niels Möller | 53382cb | 2018-11-27 14:05:08 +0100 | [diff] [blame] | 29 | #include "modules/rtp_rtcp/include/rtcp_statistics.h" |
Erik Språng | aa59eca | 2019-07-24 14:52:55 +0200 | [diff] [blame] | 30 | #include "modules/rtp_rtcp/include/rtp_packet_sender.h" |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 31 | #include "modules/rtp_rtcp/include/rtp_rtcp_defines.h" |
Ying Wang | 8b27910 | 2019-05-27 17:19:08 +0200 | [diff] [blame] | 32 | #include "modules/rtp_rtcp/source/rtp_packet_received.h" |
Sebastian Jansson | 97f61ea | 2018-02-21 13:01:55 +0100 | [diff] [blame] | 33 | |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 34 | namespace rtc { |
| 35 | struct SentPacket; |
| 36 | struct NetworkRoute; |
Sebastian Jansson | e625605 | 2018-05-04 14:08:15 +0200 | [diff] [blame] | 37 | class TaskQueue; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 38 | } // namespace rtc |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 39 | namespace webrtc { |
| 40 | |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 41 | class CallStatsObserver; |
Benjamin Wright | 192eeec | 2018-10-17 17:27:25 -0700 | [diff] [blame] | 42 | class FrameEncryptorInterface; |
Sebastian Jansson | 19704ec | 2018-03-12 15:59:12 +0100 | [diff] [blame] | 43 | class TargetTransferRateObserver; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 44 | class Transport; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 45 | class Module; |
Stefan Holmer | 5c8942a | 2017-08-22 16:16:44 +0200 | [diff] [blame] | 46 | class PacedSender; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 47 | class PacketRouter; |
Stefan Holmer | 9416ef8 | 2018-07-19 10:34:38 +0200 | [diff] [blame] | 48 | class RtpVideoSenderInterface; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 49 | class RateLimiter; |
| 50 | class RtcpBandwidthObserver; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 51 | class RtpPacketSender; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 52 | class SendDelayStats; |
| 53 | class SendStatisticsProxy; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 54 | |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 55 | struct RtpSenderObservers { |
| 56 | RtcpRttStats* rtcp_rtt_stats; |
| 57 | RtcpIntraFrameObserver* intra_frame_callback; |
Elad Alon | 0a8562e | 2019-04-09 11:55:13 +0200 | [diff] [blame] | 58 | RtcpLossNotificationObserver* rtcp_loss_notification_observer; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 59 | RtcpStatisticsCallback* rtcp_stats; |
Henrik Boström | 87e3f9d | 2019-05-27 10:44:24 +0200 | [diff] [blame] | 60 | ReportBlockDataObserver* report_block_data_observer; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 61 | StreamDataCountersCallback* rtp_stats; |
| 62 | BitrateStatisticsObserver* bitrate_observer; |
| 63 | FrameCountObserver* frame_count_observer; |
| 64 | RtcpPacketTypeCounterObserver* rtcp_type_observer; |
| 65 | SendSideDelayObserver* send_delay_observer; |
| 66 | SendPacketObserver* send_packet_observer; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 67 | }; |
| 68 | |
Benjamin Wright | 192eeec | 2018-10-17 17:27:25 -0700 | [diff] [blame] | 69 | struct RtpSenderFrameEncryptionConfig { |
| 70 | FrameEncryptorInterface* frame_encryptor = nullptr; |
| 71 | CryptoOptions crypto_options; |
| 72 | }; |
| 73 | |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 74 | // An RtpTransportController should own everything related to the RTP |
| 75 | // transport to/from a remote endpoint. We should have separate |
| 76 | // interfaces for send and receive side, even if they are implemented |
| 77 | // by the same class. This is an ongoing refactoring project. At some |
| 78 | // point, this class should be promoted to a public api under |
| 79 | // webrtc/api/rtp/. |
| 80 | // |
| 81 | // For a start, this object is just a collection of the objects needed |
| 82 | // by the VideoSendStream constructor. The plan is to move ownership |
| 83 | // of all RTP-related objects here, and add methods to create per-ssrc |
| 84 | // objects which would then be passed to VideoSendStream. Eventually, |
| 85 | // direct accessors like packet_router() should be removed. |
| 86 | // |
| 87 | // This should also have a reference to the underlying |
| 88 | // webrtc::Transport(s). Currently, webrtc::Transport is implemented by |
eladalon | f184138 | 2017-06-12 01:16:46 -0700 | [diff] [blame] | 89 | // WebRtcVideoChannel and WebRtcVoiceMediaChannel, and owned by |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 90 | // WebrtcSession. Video and audio always uses different transport |
| 91 | // objects, even in the common case where they are bundled over the |
| 92 | // same underlying transport. |
| 93 | // |
| 94 | // Extracting the logic of the webrtc::Transport from BaseChannel and |
| 95 | // subclasses into a separate class seems to be a prerequesite for |
| 96 | // moving the transport here. |
| 97 | class RtpTransportControllerSendInterface { |
| 98 | public: |
| 99 | virtual ~RtpTransportControllerSendInterface() {} |
Sebastian Jansson | e625605 | 2018-05-04 14:08:15 +0200 | [diff] [blame] | 100 | virtual rtc::TaskQueue* GetWorkerQueue() = 0; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 101 | virtual PacketRouter* packet_router() = 0; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 102 | |
Stefan Holmer | 9416ef8 | 2018-07-19 10:34:38 +0200 | [diff] [blame] | 103 | virtual RtpVideoSenderInterface* CreateRtpVideoSender( |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 104 | std::map<uint32_t, RtpState> suspended_ssrcs, |
| 105 | // TODO(holmer): Move states into RtpTransportControllerSend. |
| 106 | const std::map<uint32_t, RtpPayloadState>& states, |
| 107 | const RtpConfig& rtp_config, |
Jiawei Ou | 5571812 | 2018-11-09 13:17:39 -0800 | [diff] [blame] | 108 | int rtcp_report_interval_ms, |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 109 | Transport* send_transport, |
| 110 | const RtpSenderObservers& observers, |
Stefan Holmer | 64be7fa | 2018-10-04 15:21:55 +0200 | [diff] [blame] | 111 | RtcEventLog* event_log, |
Benjamin Wright | 192eeec | 2018-10-17 17:27:25 -0700 | [diff] [blame] | 112 | std::unique_ptr<FecController> fec_controller, |
| 113 | const RtpSenderFrameEncryptionConfig& frame_encryption_config) = 0; |
Stefan Holmer | 9416ef8 | 2018-07-19 10:34:38 +0200 | [diff] [blame] | 114 | virtual void DestroyRtpVideoSender( |
| 115 | RtpVideoSenderInterface* rtp_video_sender) = 0; |
Stefan Holmer | dbdb3a0 | 2018-07-17 16:03:46 +0200 | [diff] [blame] | 116 | |
Sebastian Jansson | e1795f4 | 2019-07-24 11:38:03 +0200 | [diff] [blame] | 117 | virtual NetworkStateEstimateObserver* network_state_estimate_observer() = 0; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 118 | virtual TransportFeedbackObserver* transport_feedback_observer() = 0; |
| 119 | |
Erik Språng | aa59eca | 2019-07-24 14:52:55 +0200 | [diff] [blame] | 120 | virtual RtpPacketSender* packet_sender() = 0; |
Stefan Holmer | 5c8942a | 2017-08-22 16:16:44 +0200 | [diff] [blame] | 121 | |
| 122 | // SetAllocatedSendBitrateLimits sets bitrates limits imposed by send codec |
| 123 | // settings. |
Sebastian Jansson | 93b1ea2 | 2019-09-18 18:31:52 +0200 | [diff] [blame] | 124 | virtual void SetAllocatedSendBitrateLimits( |
| 125 | BitrateAllocationLimits limits) = 0; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 126 | |
Sebastian Jansson | 4c1ffb8 | 2018-02-15 16:51:58 +0100 | [diff] [blame] | 127 | virtual void SetPacingFactor(float pacing_factor) = 0; |
| 128 | virtual void SetQueueTimeLimit(int limit_ms) = 0; |
| 129 | |
Sebastian Jansson | f298855 | 2019-10-29 17:18:51 +0100 | [diff] [blame] | 130 | virtual StreamFeedbackProvider* GetStreamFeedbackProvider() = 0; |
Sebastian Jansson | 19704ec | 2018-03-12 15:59:12 +0100 | [diff] [blame] | 131 | virtual void RegisterTargetTransferRateObserver( |
| 132 | TargetTransferRateObserver* observer) = 0; |
Sebastian Jansson | 97f61ea | 2018-02-21 13:01:55 +0100 | [diff] [blame] | 133 | virtual void OnNetworkRouteChanged( |
| 134 | const std::string& transport_name, |
| 135 | const rtc::NetworkRoute& network_route) = 0; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 136 | virtual void OnNetworkAvailability(bool network_available) = 0; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 137 | virtual RtcpBandwidthObserver* GetBandwidthObserver() = 0; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 138 | virtual int64_t GetPacerQueuingDelayMs() const = 0; |
Erik Språng | 425d6aa | 2019-07-29 16:38:27 +0200 | [diff] [blame] | 139 | virtual absl::optional<Timestamp> GetFirstPacketTime() const = 0; |
Sebastian Jansson | e4be6da | 2018-02-15 16:51:41 +0100 | [diff] [blame] | 140 | virtual void EnablePeriodicAlrProbing(bool enable) = 0; |
| 141 | virtual void OnSentPacket(const rtc::SentPacket& sent_packet) = 0; |
Sebastian Jansson | 607a6f1 | 2019-06-13 17:48:53 +0200 | [diff] [blame] | 142 | virtual void OnReceivedPacket(const ReceivedPacket& received_packet) = 0; |
Sebastian Jansson | 97f61ea | 2018-02-21 13:01:55 +0100 | [diff] [blame] | 143 | |
| 144 | virtual void SetSdpBitrateParameters( |
| 145 | const BitrateConstraints& constraints) = 0; |
| 146 | virtual void SetClientBitratePreferences( |
Niels Möller | 0c4f7be | 2018-05-07 14:01:37 +0200 | [diff] [blame] | 147 | const BitrateSettings& preferences) = 0; |
Alex Narest | bcf9180 | 2018-06-25 16:08:36 +0200 | [diff] [blame] | 148 | |
Stefan Holmer | 64be7fa | 2018-10-04 15:21:55 +0200 | [diff] [blame] | 149 | virtual void OnTransportOverheadChanged( |
| 150 | size_t transport_overhead_per_packet) = 0; |
Erik Språng | aa59eca | 2019-07-24 14:52:55 +0200 | [diff] [blame] | 151 | |
| 152 | virtual void AccountForAudioPacketsInPacedSender(bool account_for_audio) = 0; |
Sebastian Jansson | c3eb9fd | 2020-01-29 17:42:52 +0100 | [diff] [blame] | 153 | virtual void IncludeOverheadInPacedSender() = 0; |
nisse | cae45d0 | 2017-04-24 05:53:20 -0700 | [diff] [blame] | 154 | }; |
| 155 | |
| 156 | } // namespace webrtc |
| 157 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 158 | #endif // CALL_RTP_TRANSPORT_CONTROLLER_SEND_INTERFACE_H_ |