henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 1 | /* |
kjellander | b24317b | 2016-02-10 07:54:43 -0800 | [diff] [blame] | 2 | * Copyright 2012 The WebRTC project authors. All Rights Reserved. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 3 | * |
kjellander | b24317b | 2016-02-10 07:54:43 -0800 | [diff] [blame] | 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. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 9 | */ |
| 10 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #ifndef PC_PEERCONNECTION_H_ |
| 12 | #define PC_PEERCONNECTION_H_ |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 13 | |
perkj | d61bf80 | 2016-03-24 03:16:19 -0700 | [diff] [blame] | 14 | #include <map> |
kwiberg | d1fe281 | 2016-04-27 06:47:29 -0700 | [diff] [blame] | 15 | #include <memory> |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 16 | #include <set> |
| 17 | #include <string> |
perkj | d61bf80 | 2016-03-24 03:16:19 -0700 | [diff] [blame] | 18 | #include <vector> |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 19 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 20 | #include "api/peerconnectioninterface.h" |
Jonas Oreland | bdcee28 | 2017-10-10 14:01:40 +0200 | [diff] [blame] | 21 | #include "api/turncustomizer.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 22 | #include "pc/iceserverparsing.h" |
| 23 | #include "pc/peerconnectionfactory.h" |
| 24 | #include "pc/rtcstatscollector.h" |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 25 | #include "pc/rtptransceiver.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 26 | #include "pc/statscollector.h" |
| 27 | #include "pc/streamcollection.h" |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 28 | #include "pc/webrtcsessiondescriptionfactory.h" |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 29 | |
| 30 | namespace webrtc { |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 31 | |
deadbeef | eb45981 | 2015-12-15 19:24:43 -0800 | [diff] [blame] | 32 | class MediaStreamObserver; |
perkj | f0dcfe2 | 2016-03-10 18:32:00 +0100 | [diff] [blame] | 33 | class VideoRtpReceiver; |
skvlad | 11a9cbf | 2016-10-07 11:53:05 -0700 | [diff] [blame] | 34 | class RtcEventLog; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 35 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 36 | // Statistics for all the transports of the session. |
| 37 | // TODO(pthatcher): Think of a better name for this. We already have |
| 38 | // a TransportStats in transport.h. Perhaps TransportsStats? |
| 39 | struct SessionStats { |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 40 | std::map<std::string, cricket::TransportStats> transport_stats; |
| 41 | }; |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 42 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 43 | struct ChannelNamePair { |
| 44 | ChannelNamePair(const std::string& content_name, |
| 45 | const std::string& transport_name) |
| 46 | : content_name(content_name), transport_name(transport_name) {} |
| 47 | std::string content_name; |
| 48 | std::string transport_name; |
| 49 | }; |
| 50 | |
| 51 | struct ChannelNamePairs { |
| 52 | rtc::Optional<ChannelNamePair> voice; |
| 53 | rtc::Optional<ChannelNamePair> video; |
| 54 | rtc::Optional<ChannelNamePair> data; |
| 55 | }; |
| 56 | |
| 57 | // PeerConnection is the implementation of the PeerConnection object as defined |
| 58 | // by the PeerConnectionInterface API surface. |
| 59 | // The class currently is solely responsible for the following: |
| 60 | // - Managing the session state machine (signaling state). |
| 61 | // - Creating and initializing lower-level objects, like PortAllocator and |
| 62 | // BaseChannels. |
| 63 | // - Owning and managing the life cycle of the RtpSender/RtpReceiver and track |
| 64 | // objects. |
| 65 | // - Tracking the current and pending local/remote session descriptions. |
| 66 | // The class currently is jointly responsible for the following: |
| 67 | // - Parsing and interpreting SDP. |
| 68 | // - Generating offers and answers based on the current state. |
| 69 | // - The ICE state machine. |
| 70 | // - Generating stats. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 71 | class PeerConnection : public PeerConnectionInterface, |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 72 | public DataChannelProviderInterface, |
buildbot@webrtc.org | d4e598d | 2014-07-29 17:36:52 +0000 | [diff] [blame] | 73 | public rtc::MessageHandler, |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 74 | public sigslot::has_slots<> { |
| 75 | public: |
zhihuang | 38ede13 | 2017-06-15 12:52:32 -0700 | [diff] [blame] | 76 | explicit PeerConnection(PeerConnectionFactory* factory, |
| 77 | std::unique_ptr<RtcEventLog> event_log, |
| 78 | std::unique_ptr<Call> call); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 79 | |
deadbeef | 653b8e0 | 2015-11-11 12:55:10 -0800 | [diff] [blame] | 80 | bool Initialize( |
| 81 | const PeerConnectionInterface::RTCConfiguration& configuration, |
kwiberg | d1fe281 | 2016-04-27 06:47:29 -0700 | [diff] [blame] | 82 | std::unique_ptr<cricket::PortAllocator> allocator, |
Henrik Boström | d03c23b | 2016-06-01 11:44:18 +0200 | [diff] [blame] | 83 | std::unique_ptr<rtc::RTCCertificateGeneratorInterface> cert_generator, |
deadbeef | 653b8e0 | 2015-11-11 12:55:10 -0800 | [diff] [blame] | 84 | PeerConnectionObserver* observer); |
| 85 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 86 | rtc::scoped_refptr<StreamCollectionInterface> local_streams() override; |
| 87 | rtc::scoped_refptr<StreamCollectionInterface> remote_streams() override; |
| 88 | bool AddStream(MediaStreamInterface* local_stream) override; |
| 89 | void RemoveStream(MediaStreamInterface* local_stream) override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 90 | |
Steve Anton | 2d6c76a | 2018-01-05 17:10:52 -0800 | [diff] [blame] | 91 | RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrack( |
Steve Anton | f9381f0 | 2017-12-14 10:23:57 -0800 | [diff] [blame] | 92 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 93 | const std::vector<std::string>& stream_labels) override; |
deadbeef | e1f9d83 | 2016-01-14 15:35:42 -0800 | [diff] [blame] | 94 | rtc::scoped_refptr<RtpSenderInterface> AddTrack( |
| 95 | MediaStreamTrackInterface* track, |
| 96 | std::vector<MediaStreamInterface*> streams) override; |
| 97 | bool RemoveTrack(RtpSenderInterface* sender) override; |
| 98 | |
Steve Anton | 9158ef6 | 2017-11-27 13:01:52 -0800 | [diff] [blame] | 99 | RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver( |
| 100 | rtc::scoped_refptr<MediaStreamTrackInterface> track) override; |
| 101 | RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver( |
| 102 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 103 | const RtpTransceiverInit& init) override; |
| 104 | RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver( |
| 105 | cricket::MediaType media_type) override; |
| 106 | RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver( |
| 107 | cricket::MediaType media_type, |
| 108 | const RtpTransceiverInit& init) override; |
| 109 | |
Steve Anton | 8c0f7a7 | 2017-10-03 10:03:10 -0700 | [diff] [blame] | 110 | // Gets the DTLS SSL certificate associated with the audio transport on the |
| 111 | // remote side. This will become populated once the DTLS connection with the |
| 112 | // peer has been completed, as indicated by the ICE connection state |
| 113 | // transitioning to kIceConnectionCompleted. |
| 114 | // Note that this will be removed once we implement RTCDtlsTransport which |
| 115 | // has standardized method for getting this information. |
| 116 | // See https://www.w3.org/TR/webrtc/#rtcdtlstransport-interface |
| 117 | std::unique_ptr<rtc::SSLCertificate> GetRemoteAudioSSLCertificate(); |
| 118 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 119 | rtc::scoped_refptr<DtmfSenderInterface> CreateDtmfSender( |
| 120 | AudioTrackInterface* track) override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 121 | |
deadbeef | fac0655 | 2015-11-25 11:26:01 -0800 | [diff] [blame] | 122 | rtc::scoped_refptr<RtpSenderInterface> CreateSender( |
deadbeef | bd7d8f7 | 2015-12-18 16:58:44 -0800 | [diff] [blame] | 123 | const std::string& kind, |
| 124 | const std::string& stream_id) override; |
deadbeef | fac0655 | 2015-11-25 11:26:01 -0800 | [diff] [blame] | 125 | |
deadbeef | 70ab1a1 | 2015-09-28 16:53:55 -0700 | [diff] [blame] | 126 | std::vector<rtc::scoped_refptr<RtpSenderInterface>> GetSenders() |
| 127 | const override; |
| 128 | std::vector<rtc::scoped_refptr<RtpReceiverInterface>> GetReceivers() |
| 129 | const override; |
Steve Anton | 9158ef6 | 2017-11-27 13:01:52 -0800 | [diff] [blame] | 130 | std::vector<rtc::scoped_refptr<RtpTransceiverInterface>> GetTransceivers() |
| 131 | const override; |
deadbeef | 70ab1a1 | 2015-09-28 16:53:55 -0700 | [diff] [blame] | 132 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 133 | rtc::scoped_refptr<DataChannelInterface> CreateDataChannel( |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 134 | const std::string& label, |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 135 | const DataChannelInit* config) override; |
| 136 | bool GetStats(StatsObserver* observer, |
| 137 | webrtc::MediaStreamTrackInterface* track, |
| 138 | StatsOutputLevel level) override; |
hbos | 74e1a4f | 2016-09-15 23:33:01 -0700 | [diff] [blame] | 139 | void GetStats(RTCStatsCollectorCallback* callback) override; |
Harald Alvestrand | 8906187 | 2018-01-02 14:08:34 +0100 | [diff] [blame] | 140 | void ClearStatsCache() override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 141 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 142 | SignalingState signaling_state() override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 143 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 144 | IceConnectionState ice_connection_state() override; |
| 145 | IceGatheringState ice_gathering_state() override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 146 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 147 | const SessionDescriptionInterface* local_description() const override; |
| 148 | const SessionDescriptionInterface* remote_description() const override; |
deadbeef | fe4a8a4 | 2016-12-20 17:56:17 -0800 | [diff] [blame] | 149 | const SessionDescriptionInterface* current_local_description() const override; |
| 150 | const SessionDescriptionInterface* current_remote_description() |
| 151 | const override; |
| 152 | const SessionDescriptionInterface* pending_local_description() const override; |
| 153 | const SessionDescriptionInterface* pending_remote_description() |
| 154 | const override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 155 | |
| 156 | // JSEP01 |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 157 | // Deprecated, use version without constraints. |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 158 | void CreateOffer(CreateSessionDescriptionObserver* observer, |
| 159 | const MediaConstraintsInterface* constraints) override; |
| 160 | void CreateOffer(CreateSessionDescriptionObserver* observer, |
| 161 | const RTCOfferAnswerOptions& options) override; |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 162 | // Deprecated, use version without constraints. |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 163 | void CreateAnswer(CreateSessionDescriptionObserver* observer, |
| 164 | const MediaConstraintsInterface* constraints) override; |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 165 | void CreateAnswer(CreateSessionDescriptionObserver* observer, |
| 166 | const RTCOfferAnswerOptions& options) override; |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 167 | void SetLocalDescription(SetSessionDescriptionObserver* observer, |
| 168 | SessionDescriptionInterface* desc) override; |
Henrik Boström | a4ecf55 | 2017-11-23 14:17:07 +0000 | [diff] [blame] | 169 | void SetRemoteDescription(SetSessionDescriptionObserver* observer, |
| 170 | SessionDescriptionInterface* desc) override; |
Henrik Boström | 3163867 | 2017-11-23 17:48:32 +0100 | [diff] [blame] | 171 | void SetRemoteDescription( |
| 172 | std::unique_ptr<SessionDescriptionInterface> desc, |
| 173 | rtc::scoped_refptr<SetRemoteDescriptionObserverInterface> observer) |
| 174 | override; |
deadbeef | 46c7389 | 2016-11-16 19:42:04 -0800 | [diff] [blame] | 175 | PeerConnectionInterface::RTCConfiguration GetConfiguration() override; |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 176 | bool SetConfiguration( |
deadbeef | 293e926 | 2017-01-11 12:28:30 -0800 | [diff] [blame] | 177 | const PeerConnectionInterface::RTCConfiguration& configuration, |
| 178 | RTCError* error) override; |
| 179 | bool SetConfiguration( |
| 180 | const PeerConnectionInterface::RTCConfiguration& configuration) override { |
| 181 | return SetConfiguration(configuration, nullptr); |
| 182 | } |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 183 | bool AddIceCandidate(const IceCandidateInterface* candidate) override; |
Honghai Zhang | 7fb69db | 2016-03-14 11:59:18 -0700 | [diff] [blame] | 184 | bool RemoveIceCandidates( |
| 185 | const std::vector<cricket::Candidate>& candidates) override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 186 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 187 | void RegisterUMAObserver(UMAObserver* observer) override; |
buildbot@webrtc.org | 1567b8c | 2014-05-08 19:54:16 +0000 | [diff] [blame] | 188 | |
zstein | 4b97980 | 2017-06-02 14:37:37 -0700 | [diff] [blame] | 189 | RTCError SetBitrate(const BitrateParameters& bitrate) override; |
| 190 | |
Alex Narest | 78609d5 | 2017-10-20 10:37:47 +0200 | [diff] [blame] | 191 | void SetBitrateAllocationStrategy( |
| 192 | std::unique_ptr<rtc::BitrateAllocationStrategy> |
| 193 | bitrate_allocation_strategy) override; |
| 194 | |
henrika | 5f6bf24 | 2017-11-01 11:06:56 +0100 | [diff] [blame] | 195 | void SetAudioPlayout(bool playout) override; |
| 196 | void SetAudioRecording(bool recording) override; |
| 197 | |
Elad Alon | 99c3fe5 | 2017-10-13 16:29:40 +0200 | [diff] [blame] | 198 | RTC_DEPRECATED bool StartRtcEventLog(rtc::PlatformFile file, |
| 199 | int64_t max_size_bytes) override; |
Bjorn Terelius | de93943 | 2017-11-20 17:38:14 +0100 | [diff] [blame] | 200 | bool StartRtcEventLog(std::unique_ptr<RtcEventLogOutput> output, |
| 201 | int64_t output_period_ms) override; |
ivoc | 14d5dbe | 2016-07-04 07:06:55 -0700 | [diff] [blame] | 202 | void StopRtcEventLog() override; |
| 203 | |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 204 | void Close() override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 205 | |
hbos | 82ebe02 | 2016-11-14 01:41:09 -0800 | [diff] [blame] | 206 | sigslot::signal1<DataChannel*> SignalDataChannelCreated; |
| 207 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 208 | // Virtual for unit tests. |
| 209 | virtual const std::vector<rtc::scoped_refptr<DataChannel>>& |
| 210 | sctp_data_channels() const { |
| 211 | return sctp_data_channels_; |
perkj | d61bf80 | 2016-03-24 03:16:19 -0700 | [diff] [blame] | 212 | } |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 213 | |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 214 | rtc::Thread* network_thread() const { return factory_->network_thread(); } |
| 215 | rtc::Thread* worker_thread() const { return factory_->worker_thread(); } |
| 216 | rtc::Thread* signaling_thread() const { return factory_->signaling_thread(); } |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 217 | |
| 218 | // The SDP session ID as defined by RFC 3264. |
| 219 | virtual const std::string& session_id() const { return session_id_; } |
| 220 | |
| 221 | // Returns true if we were the initial offerer. |
| 222 | bool initial_offerer() const { return initial_offerer_ && *initial_offerer_; } |
| 223 | |
| 224 | // Returns stats for all channels of all transports. |
| 225 | // This avoids exposing the internal structures used to track them. |
| 226 | // The parameterless version creates |ChannelNamePairs| from |voice_channel|, |
| 227 | // |video_channel| and |voice_channel| if available - this requires it to be |
| 228 | // called on the signaling thread - and invokes the other |GetStats|. The |
| 229 | // other |GetStats| can be invoked on any thread; if not invoked on the |
| 230 | // network thread a thread hop will happen. |
| 231 | std::unique_ptr<SessionStats> GetSessionStats_s(); |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 232 | virtual std::unique_ptr<SessionStats> GetSessionStats( |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 233 | const ChannelNamePairs& channel_name_pairs); |
| 234 | |
| 235 | // virtual so it can be mocked in unit tests |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 236 | virtual bool GetLocalCertificate( |
| 237 | const std::string& transport_name, |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 238 | rtc::scoped_refptr<rtc::RTCCertificate>* certificate); |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 239 | virtual std::unique_ptr<rtc::SSLCertificate> GetRemoteSSLCertificate( |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 240 | const std::string& transport_name); |
| 241 | |
| 242 | virtual Call::Stats GetCallStats(); |
| 243 | |
| 244 | // Exposed for stats collecting. |
| 245 | // TODO(steveanton): Switch callers to use the plural form and remove these. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 246 | virtual cricket::VoiceChannel* voice_channel() const { |
Steve Anton | 3fe1b15 | 2017-12-12 10:20:08 -0800 | [diff] [blame] | 247 | if (IsUnifiedPlan()) { |
| 248 | // TODO(steveanton): Change stats collection to work with transceivers. |
| 249 | return nullptr; |
| 250 | } |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 251 | return static_cast<cricket::VoiceChannel*>( |
| 252 | GetAudioTransceiver()->internal()->channel()); |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 253 | } |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 254 | virtual cricket::VideoChannel* video_channel() const { |
Steve Anton | 3fe1b15 | 2017-12-12 10:20:08 -0800 | [diff] [blame] | 255 | if (IsUnifiedPlan()) { |
| 256 | // TODO(steveanton): Change stats collection to work with transceivers. |
| 257 | return nullptr; |
| 258 | } |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 259 | return static_cast<cricket::VideoChannel*>( |
| 260 | GetVideoTransceiver()->internal()->channel()); |
Steve Anton | d5585ca | 2017-10-23 14:49:26 -0700 | [diff] [blame] | 261 | } |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 262 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 263 | // Only valid when using deprecated RTP data channels. |
| 264 | virtual cricket::RtpDataChannel* rtp_data_channel() { |
| 265 | return rtp_data_channel_; |
Steve Anton | 978b876 | 2017-09-29 12:15:02 -0700 | [diff] [blame] | 266 | } |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 267 | virtual rtc::Optional<std::string> sctp_content_name() const { |
| 268 | return sctp_content_name_; |
| 269 | } |
| 270 | virtual rtc::Optional<std::string> sctp_transport_name() const { |
| 271 | return sctp_transport_name_; |
| 272 | } |
| 273 | |
| 274 | // Get the id used as a media stream track's "id" field from ssrc. |
| 275 | virtual bool GetLocalTrackIdBySsrc(uint32_t ssrc, std::string* track_id); |
| 276 | virtual bool GetRemoteTrackIdBySsrc(uint32_t ssrc, std::string* track_id); |
| 277 | |
| 278 | // Returns true if there was an ICE restart initiated by the remote offer. |
| 279 | bool IceRestartPending(const std::string& content_name) const; |
| 280 | |
| 281 | // Returns true if the ICE restart flag above was set, and no ICE restart has |
| 282 | // occurred yet for this transport (by applying a local description with |
| 283 | // changed ufrag/password). If the transport has been deleted as a result of |
| 284 | // bundling, returns false. |
| 285 | bool NeedsIceRestart(const std::string& content_name) const; |
| 286 | |
| 287 | // Get SSL role for an arbitrary m= section (handles bundling correctly). |
| 288 | // TODO(deadbeef): This is only used internally by the session description |
| 289 | // factory, it shouldn't really be public). |
| 290 | bool GetSslRole(const std::string& content_name, rtc::SSLRole* role); |
| 291 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 292 | protected: |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 293 | ~PeerConnection() override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 294 | |
| 295 | private: |
Henrik Boström | 3163867 | 2017-11-23 17:48:32 +0100 | [diff] [blame] | 296 | class SetRemoteDescriptionObserverAdapter; |
| 297 | friend class SetRemoteDescriptionObserverAdapter; |
| 298 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 299 | struct RtpSenderInfo { |
| 300 | RtpSenderInfo() : first_ssrc(0) {} |
| 301 | RtpSenderInfo(const std::string& stream_label, |
| 302 | const std::string sender_id, |
| 303 | uint32_t ssrc) |
| 304 | : stream_label(stream_label), sender_id(sender_id), first_ssrc(ssrc) {} |
| 305 | bool operator==(const RtpSenderInfo& other) { |
deadbeef | bda7e0b | 2015-12-08 17:13:40 -0800 | [diff] [blame] | 306 | return this->stream_label == other.stream_label && |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 307 | this->sender_id == other.sender_id && |
| 308 | this->first_ssrc == other.first_ssrc; |
deadbeef | bda7e0b | 2015-12-08 17:13:40 -0800 | [diff] [blame] | 309 | } |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 310 | std::string stream_label; |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 311 | std::string sender_id; |
| 312 | // An RtpSender can have many SSRCs. The first one is used as a sort of ID |
| 313 | // for communicating with the lower layers. |
| 314 | uint32_t first_ssrc; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 315 | }; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 316 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 317 | // Implements MessageHandler. |
deadbeef | a67696b | 2015-09-29 11:56:26 -0700 | [diff] [blame] | 318 | void OnMessage(rtc::Message* msg) override; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 319 | |
Steve Anton | 6077675 | 2018-01-10 11:51:34 -0800 | [diff] [blame] | 320 | cricket::VoiceMediaChannel* voice_media_channel() const { |
| 321 | return voice_channel() ? voice_channel()->media_channel() : nullptr; |
| 322 | } |
| 323 | |
| 324 | cricket::VideoMediaChannel* video_media_channel() const { |
| 325 | return video_channel() ? video_channel()->media_channel() : nullptr; |
| 326 | } |
| 327 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 328 | std::vector<rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>>> |
| 329 | GetSendersInternal() const; |
| 330 | std::vector< |
| 331 | rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>>> |
| 332 | GetReceiversInternal() const; |
| 333 | |
| 334 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 335 | GetAudioTransceiver() const; |
| 336 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 337 | GetVideoTransceiver() const; |
| 338 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 339 | void CreateAudioReceiver(MediaStreamInterface* stream, |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 340 | const RtpSenderInfo& remote_sender_info); |
perkj | f0dcfe2 | 2016-03-10 18:32:00 +0100 | [diff] [blame] | 341 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 342 | void CreateVideoReceiver(MediaStreamInterface* stream, |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 343 | const RtpSenderInfo& remote_sender_info); |
Henrik Boström | 933d8b0 | 2017-10-10 10:05:16 -0700 | [diff] [blame] | 344 | rtc::scoped_refptr<RtpReceiverInterface> RemoveAndStopReceiver( |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 345 | const RtpSenderInfo& remote_sender_info); |
korniltsev.anatoly | ec390b5 | 2017-07-24 17:00:25 -0700 | [diff] [blame] | 346 | |
| 347 | // May be called either by AddStream/RemoveStream, or when a track is |
| 348 | // added/removed from a stream previously added via AddStream. |
| 349 | void AddAudioTrack(AudioTrackInterface* track, MediaStreamInterface* stream); |
| 350 | void RemoveAudioTrack(AudioTrackInterface* track, |
| 351 | MediaStreamInterface* stream); |
| 352 | void AddVideoTrack(VideoTrackInterface* track, MediaStreamInterface* stream); |
| 353 | void RemoveVideoTrack(VideoTrackInterface* track, |
| 354 | MediaStreamInterface* stream); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 355 | |
Steve Anton | f9381f0 | 2017-12-14 10:23:57 -0800 | [diff] [blame] | 356 | // AddTrack implementation when Unified Plan is specified. |
| 357 | RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrackUnifiedPlan( |
| 358 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 359 | const std::vector<std::string>& stream_labels); |
| 360 | // AddTrack implementation when Plan B is specified. |
| 361 | RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrackPlanB( |
| 362 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 363 | const std::vector<std::string>& stream_labels); |
| 364 | |
| 365 | // Returns the first RtpTransceiver suitable for a newly added track, if such |
| 366 | // transceiver is available. |
| 367 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 368 | FindFirstTransceiverForAddedTrack( |
| 369 | rtc::scoped_refptr<MediaStreamTrackInterface> track); |
| 370 | |
| 371 | // RemoveTrack that returns an RTCError. |
| 372 | RTCError RemoveTrackInternal(rtc::scoped_refptr<RtpSenderInterface> sender); |
| 373 | |
| 374 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 375 | FindTransceiverBySender(rtc::scoped_refptr<RtpSenderInterface> sender); |
| 376 | |
Steve Anton | 9158ef6 | 2017-11-27 13:01:52 -0800 | [diff] [blame] | 377 | RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver( |
| 378 | cricket::MediaType media_type, |
| 379 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 380 | const RtpTransceiverInit& init); |
| 381 | |
Steve Anton | 02ee47c | 2018-01-10 16:26:06 -0800 | [diff] [blame^] | 382 | rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>> |
| 383 | CreateSender(cricket::MediaType media_type, |
| 384 | rtc::scoped_refptr<MediaStreamTrackInterface> track, |
| 385 | const std::vector<std::string>& stream_labels); |
| 386 | |
| 387 | rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>> |
| 388 | CreateReceiver(cricket::MediaType media_type, const std::string& receiver_id); |
| 389 | |
Steve Anton | f9381f0 | 2017-12-14 10:23:57 -0800 | [diff] [blame] | 390 | // Create a new RtpTransceiver of the given type and add it to the list of |
| 391 | // transceivers. |
| 392 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
Steve Anton | 02ee47c | 2018-01-10 16:26:06 -0800 | [diff] [blame^] | 393 | CreateAndAddTransceiver( |
| 394 | rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>> sender, |
| 395 | rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>> |
| 396 | receiver); |
Steve Anton | f9381f0 | 2017-12-14 10:23:57 -0800 | [diff] [blame] | 397 | |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 398 | void SetIceConnectionState(IceConnectionState new_state); |
| 399 | // Called any time the IceGatheringState changes |
| 400 | void OnIceGatheringChange(IceGatheringState new_state); |
| 401 | // New ICE candidate has been gathered. |
| 402 | void OnIceCandidate(std::unique_ptr<IceCandidateInterface> candidate); |
| 403 | // Some local ICE candidates have been removed. |
Honghai Zhang | 7fb69db | 2016-03-14 11:59:18 -0700 | [diff] [blame] | 404 | void OnIceCandidatesRemoved( |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 405 | const std::vector<cricket::Candidate>& candidates); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 406 | |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 407 | // Update the state, signaling if necessary. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 408 | void ChangeSignalingState(SignalingState signaling_state); |
| 409 | |
deadbeef | eb45981 | 2015-12-15 19:24:43 -0800 | [diff] [blame] | 410 | // Signals from MediaStreamObserver. |
| 411 | void OnAudioTrackAdded(AudioTrackInterface* track, |
| 412 | MediaStreamInterface* stream); |
| 413 | void OnAudioTrackRemoved(AudioTrackInterface* track, |
| 414 | MediaStreamInterface* stream); |
| 415 | void OnVideoTrackAdded(VideoTrackInterface* track, |
| 416 | MediaStreamInterface* stream); |
| 417 | void OnVideoTrackRemoved(VideoTrackInterface* track, |
| 418 | MediaStreamInterface* stream); |
| 419 | |
Henrik Boström | 3163867 | 2017-11-23 17:48:32 +0100 | [diff] [blame] | 420 | void PostSetSessionDescriptionSuccess( |
| 421 | SetSessionDescriptionObserver* observer); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 422 | void PostSetSessionDescriptionFailure(SetSessionDescriptionObserver* observer, |
| 423 | const std::string& error); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 424 | void PostCreateSessionDescriptionFailure( |
| 425 | CreateSessionDescriptionObserver* observer, |
| 426 | const std::string& error); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 427 | |
Steve Anton | 8a00691 | 2017-12-04 15:25:56 -0800 | [diff] [blame] | 428 | // Synchronous implementations of SetLocalDescription/SetRemoteDescription |
| 429 | // that return an RTCError instead of invoking a callback. |
| 430 | RTCError ApplyLocalDescription( |
| 431 | std::unique_ptr<SessionDescriptionInterface> desc); |
| 432 | RTCError ApplyRemoteDescription( |
| 433 | std::unique_ptr<SessionDescriptionInterface> desc); |
| 434 | |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 435 | // Updates the local RtpTransceivers according to the JSEP rules. Called as |
| 436 | // part of setting the local/remote description. |
| 437 | RTCError UpdateTransceiversAndDataChannels( |
| 438 | cricket::ContentSource source, |
| 439 | const SessionDescriptionInterface* old_session, |
| 440 | const SessionDescriptionInterface& new_session); |
| 441 | |
| 442 | // Either creates or destroys the transceiver's BaseChannel according to the |
| 443 | // given media section. |
| 444 | RTCError UpdateTransceiverChannel( |
| 445 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 446 | transceiver, |
| 447 | const cricket::ContentInfo& content, |
| 448 | const cricket::ContentGroup* bundle_group); |
| 449 | |
Steve Anton | fa2260d | 2017-12-28 16:38:23 -0800 | [diff] [blame] | 450 | // Either creates or destroys the local data channel according to the given |
| 451 | // media section. |
| 452 | RTCError UpdateDataChannel(cricket::ContentSource source, |
| 453 | const cricket::ContentInfo& content, |
| 454 | const cricket::ContentGroup* bundle_group); |
| 455 | |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 456 | // Associate the given transceiver according to the JSEP rules. |
| 457 | RTCErrorOr< |
| 458 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>> |
| 459 | AssociateTransceiver(cricket::ContentSource source, |
| 460 | size_t mline_index, |
| 461 | const cricket::ContentInfo& content, |
| 462 | const cricket::ContentInfo* old_content); |
| 463 | |
| 464 | // Returns the RtpTransceiver, if found, that is associated to the given MID. |
| 465 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 466 | GetAssociatedTransceiver(const std::string& mid) const; |
| 467 | |
| 468 | // Returns the RtpTransceiver, if found, that was assigned to the given mline |
| 469 | // index in CreateOffer. |
| 470 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 471 | GetTransceiverByMLineIndex(size_t mline_index) const; |
| 472 | |
| 473 | // Returns an RtpTransciever, if available, that can be used to receive the |
| 474 | // given media type according to JSEP rules. |
| 475 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 476 | FindAvailableTransceiverToReceive(cricket::MediaType media_type) const; |
| 477 | |
Steve Anton | ed10bd9 | 2017-12-05 10:52:59 -0800 | [diff] [blame] | 478 | // Returns the media section in the given session description that is |
| 479 | // associated with the RtpTransceiver. Returns null if none found or this |
| 480 | // RtpTransceiver is not associated. Logic varies depending on the |
| 481 | // SdpSemantics specified in the configuration. |
| 482 | const cricket::ContentInfo* FindMediaSectionForTransceiver( |
| 483 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 484 | transceiver, |
| 485 | const SessionDescriptionInterface* sdesc) const; |
| 486 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 487 | bool IsClosed() const { |
| 488 | return signaling_state_ == PeerConnectionInterface::kClosed; |
| 489 | } |
| 490 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 491 | // Returns a MediaSessionOptions struct with options decided by |options|, |
| 492 | // the local MediaStreams and DataChannels. |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 493 | void GetOptionsForOffer(const PeerConnectionInterface::RTCOfferAnswerOptions& |
| 494 | offer_answer_options, |
| 495 | cricket::MediaSessionOptions* session_options); |
| 496 | void GetOptionsForPlanBOffer( |
| 497 | const PeerConnectionInterface::RTCOfferAnswerOptions& |
| 498 | offer_answer_options, |
| 499 | cricket::MediaSessionOptions* session_options); |
| 500 | void GetOptionsForUnifiedPlanOffer( |
| 501 | const PeerConnectionInterface::RTCOfferAnswerOptions& |
| 502 | offer_answer_options, |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 503 | cricket::MediaSessionOptions* session_options); |
| 504 | |
| 505 | // Returns a MediaSessionOptions struct with options decided by |
| 506 | // |constraints|, the local MediaStreams and DataChannels. |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 507 | void GetOptionsForAnswer(const RTCOfferAnswerOptions& offer_answer_options, |
zhihuang | 1c378ed | 2017-08-17 14:10:50 -0700 | [diff] [blame] | 508 | cricket::MediaSessionOptions* session_options); |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 509 | void GetOptionsForPlanBAnswer( |
| 510 | const PeerConnectionInterface::RTCOfferAnswerOptions& |
| 511 | offer_answer_options, |
| 512 | cricket::MediaSessionOptions* session_options); |
| 513 | void GetOptionsForUnifiedPlanAnswer( |
| 514 | const PeerConnectionInterface::RTCOfferAnswerOptions& |
| 515 | offer_answer_options, |
| 516 | cricket::MediaSessionOptions* session_options); |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 517 | |
zhihuang | 1c378ed | 2017-08-17 14:10:50 -0700 | [diff] [blame] | 518 | // Generates MediaDescriptionOptions for the |session_opts| based on existing |
| 519 | // local description or remote description. |
| 520 | void GenerateMediaDescriptionOptions( |
| 521 | const SessionDescriptionInterface* session_desc, |
Steve Anton | 1d03a75 | 2017-11-27 14:30:09 -0800 | [diff] [blame] | 522 | RtpTransceiverDirection audio_direction, |
| 523 | RtpTransceiverDirection video_direction, |
zhihuang | 1c378ed | 2017-08-17 14:10:50 -0700 | [diff] [blame] | 524 | rtc::Optional<size_t>* audio_index, |
| 525 | rtc::Optional<size_t>* video_index, |
| 526 | rtc::Optional<size_t>* data_index, |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 527 | cricket::MediaSessionOptions* session_options); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 528 | |
Steve Anton | fa2260d | 2017-12-28 16:38:23 -0800 | [diff] [blame] | 529 | // Generates the active MediaDescriptionOptions for the local data channel |
| 530 | // given the specified MID. |
| 531 | cricket::MediaDescriptionOptions GetMediaDescriptionOptionsForActiveData( |
| 532 | const std::string& mid) const; |
| 533 | |
| 534 | // Generates the rejected MediaDescriptionOptions for the local data channel |
| 535 | // given the specified MID. |
| 536 | cricket::MediaDescriptionOptions GetMediaDescriptionOptionsForRejectedData( |
| 537 | const std::string& mid) const; |
| 538 | |
| 539 | // Returns the MID for the data section associated with either the |
| 540 | // RtpDataChannel or SCTP data channel, if it has been set. If no data |
| 541 | // channels are configured this will return nullopt. |
| 542 | rtc::Optional<std::string> GetDataMid() const; |
| 543 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 544 | // Remove all local and remote senders of type |media_type|. |
deadbeef | faac497 | 2015-11-12 15:33:07 -0800 | [diff] [blame] | 545 | // Called when a media type is rejected (m-line set to port 0). |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 546 | void RemoveSenders(cricket::MediaType media_type); |
deadbeef | faac497 | 2015-11-12 15:33:07 -0800 | [diff] [blame] | 547 | |
deadbeef | bda7e0b | 2015-12-08 17:13:40 -0800 | [diff] [blame] | 548 | // Makes sure a MediaStreamTrack is created for each StreamParam in |streams|, |
| 549 | // and existing MediaStreamTracks are removed if there is no corresponding |
| 550 | // StreamParam. If |default_track_needed| is true, a default MediaStreamTrack |
| 551 | // is created if it doesn't exist; if false, it's removed if it exists. |
| 552 | // |media_type| is the type of the |streams| and can be either audio or video. |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 553 | // If a new MediaStream is created it is added to |new_streams|. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 554 | void UpdateRemoteSendersList( |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 555 | const std::vector<cricket::StreamParams>& streams, |
deadbeef | bda7e0b | 2015-12-08 17:13:40 -0800 | [diff] [blame] | 556 | bool default_track_needed, |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 557 | cricket::MediaType media_type, |
| 558 | StreamCollection* new_streams); |
| 559 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 560 | // Triggered when a remote sender has been seen for the first time in a remote |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 561 | // session description. It creates a remote MediaStreamTrackInterface |
| 562 | // implementation and triggers CreateAudioReceiver or CreateVideoReceiver. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 563 | void OnRemoteSenderAdded(const RtpSenderInfo& sender_info, |
| 564 | cricket::MediaType media_type); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 565 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 566 | // Triggered when a remote sender has been removed from a remote session |
| 567 | // description. It removes the remote sender with id |sender_id| from a remote |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 568 | // MediaStream and triggers DestroyAudioReceiver or DestroyVideoReceiver. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 569 | void OnRemoteSenderRemoved(const RtpSenderInfo& sender_info, |
| 570 | cricket::MediaType media_type); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 571 | |
| 572 | // Finds remote MediaStreams without any tracks and removes them from |
| 573 | // |remote_streams_| and notifies the observer that the MediaStreams no longer |
| 574 | // exist. |
| 575 | void UpdateEndedRemoteMediaStreams(); |
| 576 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 577 | // Loops through the vector of |streams| and finds added and removed |
| 578 | // StreamParams since last time this method was called. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 579 | // For each new or removed StreamParam, OnLocalSenderSeen or |
| 580 | // OnLocalSenderRemoved is invoked. |
| 581 | void UpdateLocalSenders(const std::vector<cricket::StreamParams>& streams, |
| 582 | cricket::MediaType media_type); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 583 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 584 | // Triggered when a local sender has been seen for the first time in a local |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 585 | // session description. |
| 586 | // This method triggers CreateAudioSender or CreateVideoSender if the rtp |
| 587 | // streams in the local SessionDescription can be mapped to a MediaStreamTrack |
| 588 | // in a MediaStream in |local_streams_| |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 589 | void OnLocalSenderAdded(const RtpSenderInfo& sender_info, |
| 590 | cricket::MediaType media_type); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 591 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 592 | // Triggered when a local sender has been removed from a local session |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 593 | // description. |
| 594 | // This method triggers DestroyAudioSender or DestroyVideoSender if a stream |
| 595 | // has been removed from the local SessionDescription and the stream can be |
| 596 | // mapped to a MediaStreamTrack in a MediaStream in |local_streams_|. |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 597 | void OnLocalSenderRemoved(const RtpSenderInfo& sender_info, |
| 598 | cricket::MediaType media_type); |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 599 | |
| 600 | void UpdateLocalRtpDataChannels(const cricket::StreamParamsVec& streams); |
| 601 | void UpdateRemoteRtpDataChannels(const cricket::StreamParamsVec& streams); |
| 602 | void UpdateClosingRtpDataChannels( |
| 603 | const std::vector<std::string>& active_channels, |
| 604 | bool is_local_update); |
| 605 | void CreateRemoteRtpDataChannel(const std::string& label, |
| 606 | uint32_t remote_ssrc); |
| 607 | |
| 608 | // Creates channel and adds it to the collection of DataChannels that will |
| 609 | // be offered in a SessionDescription. |
| 610 | rtc::scoped_refptr<DataChannel> InternalCreateDataChannel( |
| 611 | const std::string& label, |
| 612 | const InternalDataChannelInit* config); |
| 613 | |
| 614 | // Checks if any data channel has been added. |
| 615 | bool HasDataChannels() const; |
| 616 | |
| 617 | void AllocateSctpSids(rtc::SSLRole role); |
| 618 | void OnSctpDataChannelClosed(DataChannel* channel); |
| 619 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 620 | void OnDataChannelDestroyed(); |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 621 | // Called when a valid data channel OPEN message is received. |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 622 | void OnDataChannelOpenMessage(const std::string& label, |
| 623 | const InternalDataChannelInit& config); |
| 624 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 625 | // Returns true if the PeerConnection is configured to use Unified Plan |
| 626 | // semantics for creating offers/answers and setting local/remote |
| 627 | // descriptions. If this is true the RtpTransceiver API will also be available |
| 628 | // to the user. If this is false, Plan B semantics are assumed. |
Steve Anton | 79e7960 | 2017-11-20 10:25:56 -0800 | [diff] [blame] | 629 | // TODO(bugs.webrtc.org/8530): Flip the default to be Unified Plan once |
| 630 | // sufficient time has passed. |
| 631 | bool IsUnifiedPlan() const { |
| 632 | return configuration_.sdp_semantics == SdpSemantics::kUnifiedPlan; |
| 633 | } |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 634 | |
| 635 | // Is there an RtpSender of the given type? |
zhihuang | 1c378ed | 2017-08-17 14:10:50 -0700 | [diff] [blame] | 636 | bool HasRtpSender(cricket::MediaType type) const; |
deadbeef | fac0655 | 2015-11-25 11:26:01 -0800 | [diff] [blame] | 637 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 638 | // Return the RtpSender with the given track attached. |
| 639 | rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>> |
| 640 | FindSenderForTrack(MediaStreamTrackInterface* track) const; |
deadbeef | 70ab1a1 | 2015-09-28 16:53:55 -0700 | [diff] [blame] | 641 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 642 | // Return the RtpSender with the given id, or null if none exists. |
| 643 | rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>> |
| 644 | FindSenderById(const std::string& sender_id) const; |
| 645 | |
| 646 | // Return the RtpReceiver with the given id, or null if none exists. |
| 647 | rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>> |
| 648 | FindReceiverById(const std::string& receiver_id) const; |
| 649 | |
| 650 | std::vector<RtpSenderInfo>* GetRemoteSenderInfos( |
| 651 | cricket::MediaType media_type); |
| 652 | std::vector<RtpSenderInfo>* GetLocalSenderInfos( |
| 653 | cricket::MediaType media_type); |
| 654 | const RtpSenderInfo* FindSenderInfo(const std::vector<RtpSenderInfo>& infos, |
| 655 | const std::string& stream_label, |
| 656 | const std::string sender_id) const; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 657 | |
| 658 | // Returns the specified SCTP DataChannel in sctp_data_channels_, |
| 659 | // or nullptr if not found. |
| 660 | DataChannel* FindDataChannelBySid(int sid) const; |
| 661 | |
Taylor Brandstetter | a1c3035 | 2016-05-13 08:15:11 -0700 | [diff] [blame] | 662 | // Called when first configuring the port allocator. |
deadbeef | 91dd567 | 2016-05-18 16:55:30 -0700 | [diff] [blame] | 663 | bool InitializePortAllocator_n(const RTCConfiguration& configuration); |
deadbeef | 293e926 | 2017-01-11 12:28:30 -0800 | [diff] [blame] | 664 | // Called when SetConfiguration is called to apply the supported subset |
| 665 | // of the configuration on the network thread. |
| 666 | bool ReconfigurePortAllocator_n( |
| 667 | const cricket::ServerAddresses& stun_servers, |
| 668 | const std::vector<cricket::RelayServerConfig>& turn_servers, |
| 669 | IceTransportsType type, |
| 670 | int candidate_pool_size, |
Jonas Oreland | bdcee28 | 2017-10-10 14:01:40 +0200 | [diff] [blame] | 671 | bool prune_turn_ports, |
| 672 | webrtc::TurnCustomizer* turn_customizer); |
Taylor Brandstetter | a1c3035 | 2016-05-13 08:15:11 -0700 | [diff] [blame] | 673 | |
Elad Alon | 99c3fe5 | 2017-10-13 16:29:40 +0200 | [diff] [blame] | 674 | // Starts output of an RTC event log to the given output object. |
ivoc | 14d5dbe | 2016-07-04 07:06:55 -0700 | [diff] [blame] | 675 | // This function should only be called from the worker thread. |
Bjorn Terelius | de93943 | 2017-11-20 17:38:14 +0100 | [diff] [blame] | 676 | bool StartRtcEventLog_w(std::unique_ptr<RtcEventLogOutput> output, |
| 677 | int64_t output_period_ms); |
Elad Alon | 99c3fe5 | 2017-10-13 16:29:40 +0200 | [diff] [blame] | 678 | |
Elad Alon | acb2417 | 2017-10-06 14:32:13 +0200 | [diff] [blame] | 679 | // Stops recording an RTC event log. |
ivoc | 14d5dbe | 2016-07-04 07:06:55 -0700 | [diff] [blame] | 680 | // This function should only be called from the worker thread. |
| 681 | void StopRtcEventLog_w(); |
| 682 | |
Steve Anton | 038834f | 2017-07-14 15:59:59 -0700 | [diff] [blame] | 683 | // Ensures the configuration doesn't have any parameters with invalid values, |
| 684 | // or values that conflict with other parameters. |
| 685 | // |
| 686 | // Returns RTCError::OK() if there are no issues. |
| 687 | RTCError ValidateConfiguration(const RTCConfiguration& config) const; |
| 688 | |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 689 | cricket::ChannelManager* channel_manager() const; |
| 690 | MetricsObserverInterface* metrics_observer() const; |
| 691 | |
Steve Anton | f847081 | 2017-12-04 10:46:21 -0800 | [diff] [blame] | 692 | enum class SessionError { |
| 693 | kNone, // No error. |
| 694 | kContent, // Error in BaseChannel SetLocalContent/SetRemoteContent. |
| 695 | kTransport, // Error from the underlying transport. |
| 696 | }; |
| 697 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 698 | // Returns the last error in the session. See the enum above for details. |
Steve Anton | f847081 | 2017-12-04 10:46:21 -0800 | [diff] [blame] | 699 | SessionError session_error() const { return session_error_; } |
| 700 | const std::string& session_error_desc() const { return session_error_desc_; } |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 701 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 702 | cricket::BaseChannel* GetChannel(const std::string& content_name); |
| 703 | |
| 704 | // Get current SSL role used by SCTP's underlying transport. |
| 705 | bool GetSctpSslRole(rtc::SSLRole* role); |
| 706 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 707 | cricket::IceConfig ParseIceConfig( |
| 708 | const PeerConnectionInterface::RTCConfiguration& config) const; |
| 709 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 710 | // Implements DataChannelProviderInterface. |
| 711 | bool SendData(const cricket::SendDataParams& params, |
| 712 | const rtc::CopyOnWriteBuffer& payload, |
| 713 | cricket::SendDataResult* result) override; |
| 714 | bool ConnectDataChannel(DataChannel* webrtc_data_channel) override; |
| 715 | void DisconnectDataChannel(DataChannel* webrtc_data_channel) override; |
| 716 | void AddSctpDataStream(int sid) override; |
| 717 | void RemoveSctpDataStream(int sid) override; |
| 718 | bool ReadyToSendData() const override; |
| 719 | |
| 720 | cricket::DataChannelType data_channel_type() const; |
| 721 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 722 | // Called when an RTCCertificate is generated or retrieved by |
| 723 | // WebRTCSessionDescriptionFactory. Should happen before setLocalDescription. |
| 724 | void OnCertificateReady( |
| 725 | const rtc::scoped_refptr<rtc::RTCCertificate>& certificate); |
| 726 | void OnDtlsSrtpSetupFailure(cricket::BaseChannel*, bool rtcp); |
| 727 | |
| 728 | cricket::TransportController* transport_controller() const { |
| 729 | return transport_controller_.get(); |
| 730 | } |
| 731 | |
| 732 | // Return all managed, non-null channels. |
| 733 | std::vector<cricket::BaseChannel*> Channels() const; |
| 734 | |
| 735 | // Non-const versions of local_description()/remote_description(), for use |
| 736 | // internally. |
| 737 | SessionDescriptionInterface* mutable_local_description() { |
| 738 | return pending_local_description_ ? pending_local_description_.get() |
| 739 | : current_local_description_.get(); |
| 740 | } |
| 741 | SessionDescriptionInterface* mutable_remote_description() { |
| 742 | return pending_remote_description_ ? pending_remote_description_.get() |
| 743 | : current_remote_description_.get(); |
| 744 | } |
| 745 | |
| 746 | // Updates the error state, signaling if necessary. |
Steve Anton | f847081 | 2017-12-04 10:46:21 -0800 | [diff] [blame] | 747 | void SetSessionError(SessionError error, const std::string& error_desc); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 748 | |
Steve Anton | 3828c06 | 2017-12-06 10:34:51 -0800 | [diff] [blame] | 749 | RTCError UpdateSessionState(SdpType type, cricket::ContentSource source); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 750 | // Push the media parts of the local or remote session description |
| 751 | // down to all of the channels. |
Steve Anton | 3828c06 | 2017-12-06 10:34:51 -0800 | [diff] [blame] | 752 | RTCError PushdownMediaDescription(SdpType type, |
Steve Anton | 8a00691 | 2017-12-04 15:25:56 -0800 | [diff] [blame] | 753 | cricket::ContentSource source); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 754 | bool PushdownSctpParameters_n(cricket::ContentSource source); |
| 755 | |
Steve Anton | 8a00691 | 2017-12-04 15:25:56 -0800 | [diff] [blame] | 756 | RTCError PushdownTransportDescription(cricket::ContentSource source, |
Steve Anton | 3828c06 | 2017-12-06 10:34:51 -0800 | [diff] [blame] | 757 | SdpType type); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 758 | |
| 759 | // Returns true and the TransportInfo of the given |content_name| |
| 760 | // from |description|. Returns false if it's not available. |
| 761 | static bool GetTransportDescription( |
| 762 | const cricket::SessionDescription* description, |
| 763 | const std::string& content_name, |
| 764 | cricket::TransportDescription* info); |
| 765 | |
Steve Anton | eda6ccd | 2017-12-04 10:21:55 -0800 | [diff] [blame] | 766 | // Returns the transport name for the given media section identified by |mid|. |
| 767 | // If BUNDLE is enabled and the media section is part of the bundle group, |
| 768 | // the transport name will be the first mid in the bundle group. Otherwise, |
| 769 | // the transport name will be the mid of the media section. |
| 770 | std::string GetTransportNameForMediaSection( |
| 771 | const std::string& mid, |
| 772 | const cricket::ContentGroup* bundle_group) const; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 773 | |
| 774 | // Cause all the BaseChannels in the bundle group to have the same |
| 775 | // transport channel. |
| 776 | bool EnableBundle(const cricket::ContentGroup& bundle); |
| 777 | |
| 778 | // Enables media channels to allow sending of media. |
Steve Anton | ed10bd9 | 2017-12-05 10:52:59 -0800 | [diff] [blame] | 779 | // This enables media to flow on all configured audio/video channels and the |
| 780 | // RtpDataChannel. |
| 781 | void EnableSending(); |
Steve Anton | 3fe1b15 | 2017-12-12 10:20:08 -0800 | [diff] [blame] | 782 | |
Steve Anton | 8af2186 | 2017-12-15 11:20:13 -0800 | [diff] [blame] | 783 | // Destroys all BaseChannels and destroys the SCTP data channel, if present. |
| 784 | void DestroyAllChannels(); |
Steve Anton | 3fe1b15 | 2017-12-12 10:20:08 -0800 | [diff] [blame] | 785 | |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 786 | // Returns the media index for a local ice candidate given the content name. |
| 787 | // Returns false if the local session description does not have a media |
| 788 | // content called |content_name|. |
| 789 | bool GetLocalCandidateMediaIndex(const std::string& content_name, |
| 790 | int* sdp_mline_index); |
| 791 | // Uses all remote candidates in |remote_desc| in this session. |
| 792 | bool UseCandidatesInSessionDescription( |
| 793 | const SessionDescriptionInterface* remote_desc); |
| 794 | // Uses |candidate| in this session. |
| 795 | bool UseCandidate(const IceCandidateInterface* candidate); |
| 796 | // Deletes the corresponding channel of contents that don't exist in |desc|. |
| 797 | // |desc| can be null. This means that all channels are deleted. |
| 798 | void RemoveUnusedChannels(const cricket::SessionDescription* desc); |
| 799 | |
| 800 | // Allocates media channels based on the |desc|. If |desc| doesn't have |
| 801 | // the BUNDLE option, this method will disable BUNDLE in PortAllocator. |
| 802 | // This method will also delete any existing media channels before creating. |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 803 | RTCError CreateChannels(const cricket::SessionDescription& desc); |
| 804 | |
| 805 | // If the BUNDLE policy is max-bundle, then we know for sure that all |
| 806 | // transports will be bundled from the start. This method returns the BUNDLE |
| 807 | // group if that's the case, or null if BUNDLE will be negotiated later. An |
| 808 | // error is returned if max-bundle is specified but the session description |
| 809 | // does not have a BUNDLE group. |
| 810 | RTCErrorOr<const cricket::ContentGroup*> GetEarlyBundleGroup( |
| 811 | const cricket::SessionDescription& desc) const; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 812 | |
| 813 | // Helper methods to create media channels. |
Steve Anton | eda6ccd | 2017-12-04 10:21:55 -0800 | [diff] [blame] | 814 | cricket::VoiceChannel* CreateVoiceChannel(const std::string& mid, |
| 815 | const std::string& transport_name); |
| 816 | cricket::VideoChannel* CreateVideoChannel(const std::string& mid, |
| 817 | const std::string& transport_name); |
| 818 | bool CreateDataChannel(const std::string& mid, |
| 819 | const std::string& transport_name); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 820 | |
| 821 | std::unique_ptr<SessionStats> GetSessionStats_n( |
| 822 | const ChannelNamePairs& channel_name_pairs); |
| 823 | |
| 824 | bool CreateSctpTransport_n(const std::string& content_name, |
| 825 | const std::string& transport_name); |
| 826 | // For bundling. |
| 827 | void ChangeSctpTransport_n(const std::string& transport_name); |
| 828 | void DestroySctpTransport_n(); |
| 829 | // SctpTransport signal handlers. Needed to marshal signals from the network |
| 830 | // to signaling thread. |
| 831 | void OnSctpTransportReadyToSendData_n(); |
| 832 | // This may be called with "false" if the direction of the m= section causes |
| 833 | // us to tear down the SCTP connection. |
| 834 | void OnSctpTransportReadyToSendData_s(bool ready); |
| 835 | void OnSctpTransportDataReceived_n(const cricket::ReceiveDataParams& params, |
| 836 | const rtc::CopyOnWriteBuffer& payload); |
| 837 | // Beyond just firing the signal to the signaling thread, listens to SCTP |
| 838 | // CONTROL messages on unused SIDs and processes them as OPEN messages. |
| 839 | void OnSctpTransportDataReceived_s(const cricket::ReceiveDataParams& params, |
| 840 | const rtc::CopyOnWriteBuffer& payload); |
| 841 | void OnSctpStreamClosedRemotely_n(int sid); |
| 842 | |
| 843 | bool ValidateBundleSettings(const cricket::SessionDescription* desc); |
| 844 | bool HasRtcpMuxEnabled(const cricket::ContentInfo* content); |
| 845 | // Below methods are helper methods which verifies SDP. |
Steve Anton | 8a00691 | 2017-12-04 15:25:56 -0800 | [diff] [blame] | 846 | RTCError ValidateSessionDescription(const SessionDescriptionInterface* sdesc, |
| 847 | cricket::ContentSource source); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 848 | |
Steve Anton | 3828c06 | 2017-12-06 10:34:51 -0800 | [diff] [blame] | 849 | // Check if a call to SetLocalDescription is acceptable with a session |
| 850 | // description of the given type. |
| 851 | bool ExpectSetLocalDescription(SdpType type); |
| 852 | // Check if a call to SetRemoteDescription is acceptable with a session |
| 853 | // description of the given type. |
| 854 | bool ExpectSetRemoteDescription(SdpType type); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 855 | // Verifies a=setup attribute as per RFC 5763. |
| 856 | bool ValidateDtlsSetupAttribute(const cricket::SessionDescription* desc, |
Steve Anton | 3828c06 | 2017-12-06 10:34:51 -0800 | [diff] [blame] | 857 | SdpType type); |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 858 | |
| 859 | // Returns true if we are ready to push down the remote candidate. |
| 860 | // |remote_desc| is the new remote description, or NULL if the current remote |
| 861 | // description should be used. Output |valid| is true if the candidate media |
| 862 | // index is valid. |
| 863 | bool ReadyToUseRemoteCandidate(const IceCandidateInterface* candidate, |
| 864 | const SessionDescriptionInterface* remote_desc, |
| 865 | bool* valid); |
| 866 | |
| 867 | // Returns true if SRTP (either using DTLS-SRTP or SDES) is required by |
| 868 | // this session. |
| 869 | bool SrtpRequired() const; |
| 870 | |
| 871 | // TransportController signal handlers. |
| 872 | void OnTransportControllerConnectionState(cricket::IceConnectionState state); |
| 873 | void OnTransportControllerGatheringState(cricket::IceGatheringState state); |
| 874 | void OnTransportControllerCandidatesGathered( |
| 875 | const std::string& transport_name, |
| 876 | const std::vector<cricket::Candidate>& candidates); |
| 877 | void OnTransportControllerCandidatesRemoved( |
| 878 | const std::vector<cricket::Candidate>& candidates); |
| 879 | void OnTransportControllerDtlsHandshakeError(rtc::SSLHandshakeError error); |
| 880 | |
Steve Anton | f847081 | 2017-12-04 10:46:21 -0800 | [diff] [blame] | 881 | const char* SessionErrorToString(SessionError error) const; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 882 | std::string GetSessionErrorMsg(); |
| 883 | |
| 884 | // Invoked when TransportController connection completion is signaled. |
| 885 | // Reports stats for all transports in use. |
| 886 | void ReportTransportStats(); |
| 887 | |
| 888 | // Gather the usage of IPv4/IPv6 as best connection. |
| 889 | void ReportBestConnectionState(const cricket::TransportStats& stats); |
| 890 | |
| 891 | void ReportNegotiatedCiphers(const cricket::TransportStats& stats); |
| 892 | |
| 893 | void OnSentPacket_w(const rtc::SentPacket& sent_packet); |
| 894 | |
| 895 | const std::string GetTransportName(const std::string& content_name); |
| 896 | |
| 897 | void DestroyRtcpTransport_n(const std::string& transport_name); |
Steve Anton | 6fec880 | 2017-12-04 10:37:29 -0800 | [diff] [blame] | 898 | |
| 899 | // Destroys and clears the BaseChannel associated with the given transceiver, |
| 900 | // if such channel is set. |
| 901 | void DestroyTransceiverChannel( |
| 902 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>> |
| 903 | transceiver); |
| 904 | |
| 905 | // Destroys the RTP data channel and/or the SCTP data channel and clears it. |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 906 | void DestroyDataChannel(); |
| 907 | |
Steve Anton | 6fec880 | 2017-12-04 10:37:29 -0800 | [diff] [blame] | 908 | // Destroys the given BaseChannel. The channel cannot be accessed after this |
| 909 | // method is called. |
| 910 | void DestroyBaseChannel(cricket::BaseChannel* channel); |
| 911 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 912 | // Storing the factory as a scoped reference pointer ensures that the memory |
| 913 | // in the PeerConnectionFactoryImpl remains available as long as the |
| 914 | // PeerConnection is running. It is passed to PeerConnection as a raw pointer. |
| 915 | // However, since the reference counting is done in the |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 916 | // PeerConnectionFactoryInterface all instances created using the raw pointer |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 917 | // will refer to the same reference count. |
buildbot@webrtc.org | d4e598d | 2014-07-29 17:36:52 +0000 | [diff] [blame] | 918 | rtc::scoped_refptr<PeerConnectionFactory> factory_; |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 919 | PeerConnectionObserver* observer_ = nullptr; |
| 920 | UMAObserver* uma_observer_ = nullptr; |
terelius | 3386025 | 2017-05-12 23:37:18 -0700 | [diff] [blame] | 921 | |
| 922 | // The EventLog needs to outlive |call_| (and any other object that uses it). |
| 923 | std::unique_ptr<RtcEventLog> event_log_; |
| 924 | |
Steve Anton | ba81867 | 2017-11-06 10:21:57 -0800 | [diff] [blame] | 925 | SignalingState signaling_state_ = kStable; |
| 926 | IceConnectionState ice_connection_state_ = kIceConnectionNew; |
| 927 | IceGatheringState ice_gathering_state_ = kIceGatheringNew; |
deadbeef | 46c7389 | 2016-11-16 19:42:04 -0800 | [diff] [blame] | 928 | PeerConnectionInterface::RTCConfiguration configuration_; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 929 | |
kwiberg | d1fe281 | 2016-04-27 06:47:29 -0700 | [diff] [blame] | 930 | std::unique_ptr<cricket::PortAllocator> port_allocator_; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 931 | |
zhihuang | 8f65cdf | 2016-05-06 18:40:30 -0700 | [diff] [blame] | 932 | // One PeerConnection has only one RTCP CNAME. |
| 933 | // https://tools.ietf.org/html/draft-ietf-rtcweb-rtp-usage-26#section-4.9 |
| 934 | std::string rtcp_cname_; |
| 935 | |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 936 | // Streams added via AddStream. |
| 937 | rtc::scoped_refptr<StreamCollection> local_streams_; |
| 938 | // Streams created as a result of SetRemoteDescription. |
| 939 | rtc::scoped_refptr<StreamCollection> remote_streams_; |
| 940 | |
kwiberg | d1fe281 | 2016-04-27 06:47:29 -0700 | [diff] [blame] | 941 | std::vector<std::unique_ptr<MediaStreamObserver>> stream_observers_; |
deadbeef | eb45981 | 2015-12-15 19:24:43 -0800 | [diff] [blame] | 942 | |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 943 | // These lists store sender info seen in local/remote descriptions. |
| 944 | std::vector<RtpSenderInfo> remote_audio_sender_infos_; |
| 945 | std::vector<RtpSenderInfo> remote_video_sender_infos_; |
| 946 | std::vector<RtpSenderInfo> local_audio_sender_infos_; |
| 947 | std::vector<RtpSenderInfo> local_video_sender_infos_; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 948 | |
| 949 | SctpSidAllocator sid_allocator_; |
| 950 | // label -> DataChannel |
| 951 | std::map<std::string, rtc::scoped_refptr<DataChannel>> rtp_data_channels_; |
| 952 | std::vector<rtc::scoped_refptr<DataChannel>> sctp_data_channels_; |
deadbeef | bd29246 | 2015-12-14 18:15:29 -0800 | [diff] [blame] | 953 | std::vector<rtc::scoped_refptr<DataChannel>> sctp_data_channels_to_free_; |
deadbeef | ab9b2d1 | 2015-10-14 11:33:11 -0700 | [diff] [blame] | 954 | |
deadbeef | bda7e0b | 2015-12-08 17:13:40 -0800 | [diff] [blame] | 955 | bool remote_peer_supports_msid_ = false; |
deadbeef | 70ab1a1 | 2015-09-28 16:53:55 -0700 | [diff] [blame] | 956 | |
terelius | 3386025 | 2017-05-12 23:37:18 -0700 | [diff] [blame] | 957 | std::unique_ptr<Call> call_; |
terelius | 3386025 | 2017-05-12 23:37:18 -0700 | [diff] [blame] | 958 | std::unique_ptr<StatsCollector> stats_; // A pointer is passed to senders_ |
| 959 | rtc::scoped_refptr<RTCStatsCollector> stats_collector_; |
| 960 | |
deadbeef | a601f5c | 2016-06-06 14:27:39 -0700 | [diff] [blame] | 961 | std::vector< |
Steve Anton | 4171afb | 2017-11-20 10:20:22 -0800 | [diff] [blame] | 962 | rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>> |
| 963 | transceivers_; |
Steve Anton | dcc3c02 | 2017-12-22 16:02:54 -0800 | [diff] [blame] | 964 | // MIDs that have been seen either by SetLocalDescription or |
| 965 | // SetRemoteDescription over the life of the PeerConnection. |
| 966 | std::set<std::string> seen_mids_; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 967 | |
Steve Anton | f847081 | 2017-12-04 10:46:21 -0800 | [diff] [blame] | 968 | SessionError session_error_ = SessionError::kNone; |
| 969 | std::string session_error_desc_; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 970 | |
| 971 | std::string session_id_; |
| 972 | rtc::Optional<bool> initial_offerer_; |
| 973 | |
| 974 | std::unique_ptr<cricket::TransportController> transport_controller_; |
| 975 | std::unique_ptr<cricket::SctpTransportInternalFactory> sctp_factory_; |
Steve Anton | 75737c0 | 2017-11-06 10:37:17 -0800 | [diff] [blame] | 976 | // |rtp_data_channel_| is used if in RTP data channel mode, |sctp_transport_| |
| 977 | // when using SCTP. |
| 978 | cricket::RtpDataChannel* rtp_data_channel_ = nullptr; |
| 979 | |
| 980 | std::unique_ptr<cricket::SctpTransportInternal> sctp_transport_; |
| 981 | // |sctp_transport_name_| keeps track of what DTLS transport the SCTP |
| 982 | // transport is using (which can change due to bundling). |
| 983 | rtc::Optional<std::string> sctp_transport_name_; |
| 984 | // |sctp_content_name_| is the content name (MID) in SDP. |
| 985 | rtc::Optional<std::string> sctp_content_name_; |
| 986 | // Value cached on signaling thread. Only updated when SctpReadyToSendData |
| 987 | // fires on the signaling thread. |
| 988 | bool sctp_ready_to_send_data_ = false; |
| 989 | // Same as signals provided by SctpTransport, but these are guaranteed to |
| 990 | // fire on the signaling thread, whereas SctpTransport fires on the networking |
| 991 | // thread. |
| 992 | // |sctp_invoker_| is used so that any signals queued on the signaling thread |
| 993 | // from the network thread are immediately discarded if the SctpTransport is |
| 994 | // destroyed (due to m= section being rejected). |
| 995 | // TODO(deadbeef): Use a proxy object to ensure that method calls/signals |
| 996 | // are marshalled to the right thread. Could almost use proxy.h for this, |
| 997 | // but it doesn't have a mechanism for marshalling sigslot::signals |
| 998 | std::unique_ptr<rtc::AsyncInvoker> sctp_invoker_; |
| 999 | sigslot::signal1<bool> SignalSctpReadyToSendData; |
| 1000 | sigslot::signal2<const cricket::ReceiveDataParams&, |
| 1001 | const rtc::CopyOnWriteBuffer&> |
| 1002 | SignalSctpDataReceived; |
| 1003 | sigslot::signal1<int> SignalSctpStreamClosedRemotely; |
| 1004 | |
| 1005 | std::unique_ptr<SessionDescriptionInterface> current_local_description_; |
| 1006 | std::unique_ptr<SessionDescriptionInterface> pending_local_description_; |
| 1007 | std::unique_ptr<SessionDescriptionInterface> current_remote_description_; |
| 1008 | std::unique_ptr<SessionDescriptionInterface> pending_remote_description_; |
| 1009 | bool dtls_enabled_ = false; |
| 1010 | // Specifies which kind of data channel is allowed. This is controlled |
| 1011 | // by the chrome command-line flag and constraints: |
| 1012 | // 1. If chrome command-line switch 'enable-sctp-data-channels' is enabled, |
| 1013 | // constraint kEnableDtlsSrtp is true, and constaint kEnableRtpDataChannels is |
| 1014 | // not set or false, SCTP is allowed (DCT_SCTP); |
| 1015 | // 2. If constraint kEnableRtpDataChannels is true, RTP is allowed (DCT_RTP); |
| 1016 | // 3. If both 1&2 are false, data channel is not allowed (DCT_NONE). |
| 1017 | cricket::DataChannelType data_channel_type_ = cricket::DCT_NONE; |
| 1018 | // List of content names for which the remote side triggered an ICE restart. |
| 1019 | std::set<std::string> pending_ice_restarts_; |
| 1020 | |
| 1021 | std::unique_ptr<WebRtcSessionDescriptionFactory> webrtc_session_desc_factory_; |
| 1022 | |
| 1023 | // Member variables for caching global options. |
| 1024 | cricket::AudioOptions audio_options_; |
| 1025 | cricket::VideoOptions video_options_; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 1026 | }; |
| 1027 | |
| 1028 | } // namespace webrtc |
| 1029 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 1030 | #endif // PC_PEERCONNECTION_H_ |