blob: df75245f276d039b7af827f3470eda152a0c4e18 [file] [log] [blame]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001/*
kjellander65c7f672016-02-12 00:05:01 -08002 * Copyright 2004 The WebRTC project authors. All Rights Reserved.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003 *
kjellander65c7f672016-02-12 00:05:01 -08004 * 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.org28e20752013-07-10 00:45:36 +00009 */
10
perkjc11b1842016-03-07 17:34:13 -080011#ifndef WEBRTC_PC_CHANNEL_H_
12#define WEBRTC_PC_CHANNEL_H_
henrike@webrtc.org28e20752013-07-10 00:45:36 +000013
deadbeefcbecd352015-09-23 11:50:27 -070014#include <map>
kwiberg31022942016-03-11 14:18:21 -080015#include <memory>
deadbeefcbecd352015-09-23 11:50:27 -070016#include <set>
kjellandera96e2d72016-02-04 23:52:28 -080017#include <string>
deadbeefcbecd352015-09-23 11:50:27 -070018#include <utility>
kjellandera96e2d72016-02-04 23:52:28 -080019#include <vector>
henrike@webrtc.org28e20752013-07-10 00:45:36 +000020
kjellander@webrtc.org7ffeab52016-02-26 22:46:09 +010021#include "webrtc/audio_sink.h"
Danil Chapovalov33b01f22016-05-11 19:55:27 +020022#include "webrtc/base/asyncinvoker.h"
buildbot@webrtc.orga09a9992014-08-13 17:26:08 +000023#include "webrtc/base/asyncudpsocket.h"
24#include "webrtc/base/criticalsection.h"
25#include "webrtc/base/network.h"
26#include "webrtc/base/sigslot.h"
27#include "webrtc/base/window.h"
kjellandera96e2d72016-02-04 23:52:28 -080028#include "webrtc/media/base/mediachannel.h"
29#include "webrtc/media/base/mediaengine.h"
30#include "webrtc/media/base/streamparams.h"
nisse08582ff2016-02-04 01:24:52 -080031#include "webrtc/media/base/videosinkinterface.h"
nisse2ded9b12016-04-08 02:23:55 -070032#include "webrtc/media/base/videosourceinterface.h"
Tommif888bb52015-12-12 01:37:01 +010033#include "webrtc/p2p/base/transportcontroller.h"
34#include "webrtc/p2p/client/socketmonitor.h"
kjellander@webrtc.org9b8df252016-02-12 06:47:59 +010035#include "webrtc/pc/audiomonitor.h"
36#include "webrtc/pc/bundlefilter.h"
37#include "webrtc/pc/mediamonitor.h"
38#include "webrtc/pc/mediasession.h"
39#include "webrtc/pc/rtcpmuxfilter.h"
40#include "webrtc/pc/srtpfilter.h"
Tommif888bb52015-12-12 01:37:01 +010041
42namespace webrtc {
43class AudioSinkInterface;
44} // namespace webrtc
henrike@webrtc.org28e20752013-07-10 00:45:36 +000045
46namespace cricket {
47
48struct CryptoParams;
49class MediaContentDescription;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000050
henrike@webrtc.org28e20752013-07-10 00:45:36 +000051// BaseChannel contains logic common to voice and video, including
Danil Chapovalov33b01f22016-05-11 19:55:27 +020052// enable, marshaling calls to a worker and network threads, and
henrike@webrtc.org28e20752013-07-10 00:45:36 +000053// connection and media monitors.
Danil Chapovalov33b01f22016-05-11 19:55:27 +020054// BaseChannel assumes signaling and other threads are allowed to make
55// synchronous calls to the worker thread, the worker thread makes synchronous
56// calls only to the network thread, and the network thread can't be blocked by
57// other threads.
58// All methods with _n suffix must be called on network thread,
59// methods with _w suffix - on worker thread
60// and methods with _s suffix on signaling thread.
61// Network and worker threads may be the same thread.
wu@webrtc.org78187522013-10-07 23:32:02 +000062//
63// WARNING! SUBCLASSES MUST CALL Deinit() IN THEIR DESTRUCTORS!
64// This is required to avoid a data race between the destructor modifying the
65// vtable, and the media channel's thread using BaseChannel as the
66// NetworkInterface.
67
henrike@webrtc.org28e20752013-07-10 00:45:36 +000068class BaseChannel
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000069 : public rtc::MessageHandler, public sigslot::has_slots<>,
pthatcher@webrtc.orgb4aac132015-03-13 18:25:21 +000070 public MediaChannel::NetworkInterface,
71 public ConnectionStatsGetter {
henrike@webrtc.org28e20752013-07-10 00:45:36 +000072 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +020073 BaseChannel(rtc::Thread* worker_thread,
74 rtc::Thread* network_thread,
deadbeefcbecd352015-09-23 11:50:27 -070075 MediaChannel* channel,
76 TransportController* transport_controller,
77 const std::string& content_name,
78 bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +000079 virtual ~BaseChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +020080 bool Init_w();
81 // Deinit may be called multiple times and is simply ignored if it's already
wu@webrtc.org78187522013-10-07 23:32:02 +000082 // done.
83 void Deinit();
henrike@webrtc.org28e20752013-07-10 00:45:36 +000084
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000085 rtc::Thread* worker_thread() const { return worker_thread_; }
Danil Chapovalov33b01f22016-05-11 19:55:27 +020086 rtc::Thread* network_thread() const { return network_thread_; }
deadbeefcbecd352015-09-23 11:50:27 -070087 const std::string& content_name() const { return content_name_; }
88 const std::string& transport_name() const { return transport_name_; }
henrike@webrtc.org28e20752013-07-10 00:45:36 +000089 bool enabled() const { return enabled_; }
henrike@webrtc.org28e20752013-07-10 00:45:36 +000090
91 // This function returns true if we are using SRTP.
92 bool secure() const { return srtp_filter_.IsActive(); }
93 // The following function returns true if we are using
94 // DTLS-based keying. If you turned off SRTP later, however
95 // you could have secure() == false and dtls_secure() == true.
96 bool secure_dtls() const { return dtls_keyed_; }
97 // This function returns true if we require secure channel for call setup.
98 bool secure_required() const { return secure_required_; }
99
100 bool writable() const { return writable_; }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000101
Peter Thatcheraf55ccc2015-05-21 07:48:41 -0700102 // Activate RTCP mux, regardless of the state so far. Once
103 // activated, it can not be deactivated, and if the remote
104 // description doesn't support RTCP mux, setting the remote
105 // description will fail.
106 void ActivateRtcpMux();
deadbeefcbecd352015-09-23 11:50:27 -0700107 bool SetTransport(const std::string& transport_name);
pthatcher@webrtc.org592470b2015-03-16 21:15:37 +0000108 bool PushdownLocalDescription(const SessionDescription* local_desc,
109 ContentAction action,
110 std::string* error_desc);
111 bool PushdownRemoteDescription(const SessionDescription* remote_desc,
112 ContentAction action,
113 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000114 // Channel control
115 bool SetLocalContent(const MediaContentDescription* content,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000116 ContentAction action,
117 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000118 bool SetRemoteContent(const MediaContentDescription* content,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000119 ContentAction action,
120 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000121
122 bool Enable(bool enable);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000123
124 // Multiplexing
125 bool AddRecvStream(const StreamParams& sp);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200126 bool RemoveRecvStream(uint32_t ssrc);
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000127 bool AddSendStream(const StreamParams& sp);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200128 bool RemoveSendStream(uint32_t ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000129
130 // Monitoring
131 void StartConnectionMonitor(int cms);
132 void StopConnectionMonitor();
pthatcher@webrtc.orgb4aac132015-03-13 18:25:21 +0000133 // For ConnectionStatsGetter, used by ConnectionMonitor
deadbeefcbecd352015-09-23 11:50:27 -0700134 bool GetConnectionStats(ConnectionInfos* infos) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000135
buildbot@webrtc.org5ee0f052014-05-05 20:18:08 +0000136 BundleFilter* bundle_filter() { return &bundle_filter_; }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000137
138 const std::vector<StreamParams>& local_streams() const {
139 return local_streams_;
140 }
141 const std::vector<StreamParams>& remote_streams() const {
142 return remote_streams_;
143 }
144
pthatcher@webrtc.org4eeef582015-03-16 19:34:23 +0000145 sigslot::signal2<BaseChannel*, bool> SignalDtlsSetupFailure;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200146 void SignalDtlsSetupFailure_n(bool rtcp);
pthatcher@webrtc.org4eeef582015-03-16 19:34:23 +0000147 void SignalDtlsSetupFailure_s(bool rtcp);
148
buildbot@webrtc.org6bfd6192014-05-15 16:15:59 +0000149 // Used for latency measurements.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000150 sigslot::signal1<BaseChannel*> SignalFirstPacketReceived;
151
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200152 // Forward TransportChannel SignalSentPacket to worker thread.
153 sigslot::signal1<const rtc::SentPacket&> SignalSentPacket;
154
155 // Only public for unit tests. Otherwise, consider private.
156 TransportChannel* transport_channel() const { return transport_channel_; }
157 TransportChannel* rtcp_transport_channel() const {
158 return rtcp_transport_channel_;
159 }
160
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000161 // Made public for easier testing.
deadbeefcbecd352015-09-23 11:50:27 -0700162 void SetReadyToSend(bool rtcp, bool ready);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000163
guoweis@webrtc.org4f852882015-03-12 20:09:44 +0000164 // Only public for unit tests. Otherwise, consider protected.
rlesterec9d1872015-10-27 14:22:16 -0700165 int SetOption(SocketType type, rtc::Socket::Option o, int val)
166 override;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200167 int SetOption_n(SocketType type, rtc::Socket::Option o, int val);
guoweis@webrtc.org4f852882015-03-12 20:09:44 +0000168
solenberg5b14b422015-10-01 04:10:31 -0700169 SrtpFilter* srtp_filter() { return &srtp_filter_; }
170
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000171 protected:
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000172 virtual MediaChannel* media_channel() const { return media_channel_; }
deadbeefcbecd352015-09-23 11:50:27 -0700173 // Sets the |transport_channel_| (and |rtcp_transport_channel_|, if |rtcp_| is
174 // true). Gets the transport channels from |transport_controller_|.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200175 bool SetTransport_n(const std::string& transport_name);
guoweis46383312015-12-17 16:45:59 -0800176
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200177 void SetTransportChannel_n(TransportChannel* transport);
178 void SetRtcpTransportChannel_n(TransportChannel* transport,
179 bool update_writablity);
guoweis46383312015-12-17 16:45:59 -0800180
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000181 bool was_ever_writable() const { return was_ever_writable_; }
182 void set_local_content_direction(MediaContentDirection direction) {
183 local_content_direction_ = direction;
184 }
185 void set_remote_content_direction(MediaContentDirection direction) {
186 remote_content_direction_ = direction;
187 }
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700188 void set_secure_required(bool secure_required) {
189 secure_required_ = secure_required;
190 }
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200191 bool IsReadyToReceive_w() const;
192 bool IsReadyToSend_w() const;
deadbeefcbecd352015-09-23 11:50:27 -0700193 rtc::Thread* signaling_thread() {
194 return transport_controller_->signaling_thread();
195 }
deadbeefcbecd352015-09-23 11:50:27 -0700196 bool rtcp_transport_enabled() const { return rtcp_transport_enabled_; }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000197
pthatcher@webrtc.org6ad507a2015-03-16 20:19:12 +0000198 void ConnectToTransportChannel(TransportChannel* tc);
199 void DisconnectFromTransportChannel(TransportChannel* tc);
200
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200201 void FlushRtcpMessages_n();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000202
203 // NetworkInterface implementation, called by MediaEngine
jbaucheec21bd2016-03-20 06:15:43 -0700204 bool SendPacket(rtc::CopyOnWriteBuffer* packet,
205 const rtc::PacketOptions& options) override;
206 bool SendRtcp(rtc::CopyOnWriteBuffer* packet,
207 const rtc::PacketOptions& options) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000208
209 // From TransportChannel
210 void OnWritableState(TransportChannel* channel);
wu@webrtc.orga9890802013-12-13 00:21:03 +0000211 virtual void OnChannelRead(TransportChannel* channel,
212 const char* data,
213 size_t len,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000214 const rtc::PacketTime& packet_time,
wu@webrtc.orga9890802013-12-13 00:21:03 +0000215 int flags);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000216 void OnReadyToSend(TransportChannel* channel);
217
Guo-wei Shieh1218d7a2015-12-05 09:59:56 -0800218 void OnDtlsState(TransportChannel* channel, DtlsTransportState state);
219
Honghai Zhangcc411c02016-03-29 17:27:21 -0700220 void OnSelectedCandidatePairChanged(
221 TransportChannel* channel,
Honghai Zhang52dce732016-03-31 12:37:31 -0700222 CandidatePairInterface* selected_candidate_pair,
223 int last_sent_packet_id);
Honghai Zhangcc411c02016-03-29 17:27:21 -0700224
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000225 bool PacketIsRtcp(const TransportChannel* channel, const char* data,
226 size_t len);
stefanc1aeaf02015-10-15 07:26:07 -0700227 bool SendPacket(bool rtcp,
jbaucheec21bd2016-03-20 06:15:43 -0700228 rtc::CopyOnWriteBuffer* packet,
stefanc1aeaf02015-10-15 07:26:07 -0700229 const rtc::PacketOptions& options);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200230
jbaucheec21bd2016-03-20 06:15:43 -0700231 virtual bool WantsPacket(bool rtcp, const rtc::CopyOnWriteBuffer* packet);
232 void HandlePacket(bool rtcp, rtc::CopyOnWriteBuffer* packet,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000233 const rtc::PacketTime& packet_time);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200234 void OnPacketReceived(bool rtcp,
235 const rtc::CopyOnWriteBuffer& packet,
236 const rtc::PacketTime& packet_time);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000237
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000238 void EnableMedia_w();
239 void DisableMedia_w();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200240 void UpdateWritableState_n();
241 void ChannelWritable_n();
242 void ChannelNotWritable_n();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000243 bool AddRecvStream_w(const StreamParams& sp);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200244 bool RemoveRecvStream_w(uint32_t ssrc);
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000245 bool AddSendStream_w(const StreamParams& sp);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200246 bool RemoveSendStream_w(uint32_t ssrc);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200247 virtual bool ShouldSetupDtlsSrtp_n() const;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000248 // Do the DTLS key expansion and impose it on the SRTP/SRTCP filters.
249 // |rtcp_channel| indicates whether to set up the RTP or RTCP filter.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200250 bool SetupDtlsSrtp_n(bool rtcp_channel);
251 void MaybeSetupDtlsSrtp_n();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000252 // Set the DTLS-SRTP cipher policy on this channel as appropriate.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200253 bool SetDtlsSrtpCryptoSuites_n(TransportChannel* tc, bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000254
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200255 void ChangeState();
256 virtual void ChangeState_w() = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000257
258 // Gets the content info appropriate to the channel (audio or video).
259 virtual const ContentInfo* GetFirstContent(
260 const SessionDescription* sdesc) = 0;
261 bool UpdateLocalStreams_w(const std::vector<StreamParams>& streams,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000262 ContentAction action,
263 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000264 bool UpdateRemoteStreams_w(const std::vector<StreamParams>& streams,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000265 ContentAction action,
266 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000267 virtual bool SetLocalContent_w(const MediaContentDescription* content,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000268 ContentAction action,
269 std::string* error_desc) = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000270 virtual bool SetRemoteContent_w(const MediaContentDescription* content,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000271 ContentAction action,
272 std::string* error_desc) = 0;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200273 bool SetRtpTransportParameters(const MediaContentDescription* content,
274 ContentAction action,
275 ContentSource src,
276 std::string* error_desc);
277 bool SetRtpTransportParameters_n(const MediaContentDescription* content,
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700278 ContentAction action,
279 ContentSource src,
280 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000281
henrike@webrtc.orgd43aa9d2014-02-21 23:43:24 +0000282 // Helper method to get RTP Absoulute SendTime extension header id if
283 // present in remote supported extensions list.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200284 void MaybeCacheRtpAbsSendTimeHeaderExtension_w(
stefanc1aeaf02015-10-15 07:26:07 -0700285 const std::vector<RtpHeaderExtension>& extensions);
henrike@webrtc.orgd43aa9d2014-02-21 23:43:24 +0000286
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200287 bool CheckSrtpConfig_n(const std::vector<CryptoParams>& cryptos,
288 bool* dtls,
289 std::string* error_desc);
290 bool SetSrtp_n(const std::vector<CryptoParams>& params,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000291 ContentAction action,
292 ContentSource src,
293 std::string* error_desc);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200294 void ActivateRtcpMux_n();
295 bool SetRtcpMux_n(bool enable,
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000296 ContentAction action,
297 ContentSource src,
298 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000299
300 // From MessageHandler
rlesterec9d1872015-10-27 14:22:16 -0700301 void OnMessage(rtc::Message* pmsg) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000302
303 // Handled in derived classes
Guo-wei Shieh521ed7b2015-11-18 19:41:53 -0800304 // Get the SRTP crypto suites to use for RTP media
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200305 virtual void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const = 0;
pthatcher@webrtc.orgb4aac132015-03-13 18:25:21 +0000306 virtual void OnConnectionMonitorUpdate(ConnectionMonitor* monitor,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000307 const std::vector<ConnectionInfo>& infos) = 0;
308
sergeyu@chromium.org9cf037b2014-02-07 19:03:26 +0000309 // Helper function for invoking bool-returning methods on the worker thread.
310 template <class FunctorT>
311 bool InvokeOnWorker(const FunctorT& functor) {
312 return worker_thread_->Invoke<bool>(functor);
313 }
314
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000315 private:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200316 bool InitNetwork_n();
317 void DeinitNetwork_n();
318 void SignalSentPacket_n(TransportChannel* channel,
319 const rtc::SentPacket& sent_packet);
320 void SignalSentPacket_w(const rtc::SentPacket& sent_packet);
321 bool IsTransportReadyToSend_n() const;
322 void CacheRtpAbsSendTimeHeaderExtension_n(int rtp_abs_sendtime_extn_id);
323
324 rtc::Thread* const worker_thread_;
325 rtc::Thread* const network_thread_;
326 rtc::AsyncInvoker invoker_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000327
pthatcher@webrtc.org990a00c2015-03-13 18:20:33 +0000328 const std::string content_name_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200329 std::unique_ptr<ConnectionMonitor> connection_monitor_;
330
331 // Transport related members that should be accessed from network thread.
332 TransportController* const transport_controller_;
deadbeefcbecd352015-09-23 11:50:27 -0700333 std::string transport_name_;
334 bool rtcp_transport_enabled_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000335 TransportChannel* transport_channel_;
deadbeefcbecd352015-09-23 11:50:27 -0700336 std::vector<std::pair<rtc::Socket::Option, int> > socket_options_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000337 TransportChannel* rtcp_transport_channel_;
deadbeefcbecd352015-09-23 11:50:27 -0700338 std::vector<std::pair<rtc::Socket::Option, int> > rtcp_socket_options_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000339 SrtpFilter srtp_filter_;
340 RtcpMuxFilter rtcp_mux_filter_;
buildbot@webrtc.org5ee0f052014-05-05 20:18:08 +0000341 BundleFilter bundle_filter_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000342 bool rtp_ready_to_send_;
343 bool rtcp_ready_to_send_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200344 bool writable_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000345 bool was_ever_writable_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000346 bool has_received_packet_;
347 bool dtls_keyed_;
348 bool secure_required_;
henrike@webrtc.orgd43aa9d2014-02-21 23:43:24 +0000349 int rtp_abs_sendtime_extn_id_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200350
351 // MediaChannel related members that should be access from worker thread.
352 MediaChannel* const media_channel_;
353 // Currently enabled_ flag accessed from signaling thread too, but it can
354 // be changed only when signaling thread does sunchronious call to worker
355 // thread, so it should be safe.
356 bool enabled_;
357 std::vector<StreamParams> local_streams_;
358 std::vector<StreamParams> remote_streams_;
359 MediaContentDirection local_content_direction_;
360 MediaContentDirection remote_content_direction_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000361};
362
363// VoiceChannel is a specialization that adds support for early media, DTMF,
364// and input/output level monitoring.
365class VoiceChannel : public BaseChannel {
366 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200367 VoiceChannel(rtc::Thread* worker_thread,
368 rtc::Thread* network_thread,
deadbeefcbecd352015-09-23 11:50:27 -0700369 MediaEngineInterface* media_engine,
370 VoiceMediaChannel* channel,
371 TransportController* transport_controller,
372 const std::string& content_name,
373 bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000374 ~VoiceChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200375 bool Init_w();
solenberg1dd98f32015-09-10 01:57:14 -0700376
377 // Configure sending media on the stream with SSRC |ssrc|
378 // If there is only one sending stream SSRC 0 can be used.
Peter Boström0c4e06b2015-10-07 12:23:21 +0200379 bool SetAudioSend(uint32_t ssrc,
solenbergdfc8f4f2015-10-01 02:31:10 -0700380 bool enable,
deadbeefcbecd352015-09-23 11:50:27 -0700381 const AudioOptions* options,
Taylor Brandstetter1a018dc2016-03-08 12:37:39 -0800382 AudioSource* source);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000383
384 // downcasts a MediaChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200385 VoiceMediaChannel* media_channel() const override {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000386 return static_cast<VoiceMediaChannel*>(BaseChannel::media_channel());
387 }
388
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000389 void SetEarlyMedia(bool enable);
390 // This signal is emitted when we have gone a period of time without
391 // receiving early media. When received, a UI should start playing its
392 // own ringing sound
393 sigslot::signal1<VoiceChannel*> SignalEarlyMediaTimeout;
394
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000395 // Returns if the telephone-event has been negotiated.
396 bool CanInsertDtmf();
397 // Send and/or play a DTMF |event| according to the |flags|.
398 // The DTMF out-of-band signal will be used on sending.
399 // The |ssrc| should be either 0 or a valid send stream ssrc.
henrike@webrtc.org9de257d2013-07-17 14:42:53 +0000400 // The valid value for the |event| are 0 which corresponding to DTMF
401 // event 0-9, *, #, A-D.
solenberg1d63dd02015-12-02 12:35:09 -0800402 bool InsertDtmf(uint32_t ssrc, int event_code, int duration);
solenberg4bac9c52015-10-09 02:32:53 -0700403 bool SetOutputVolume(uint32_t ssrc, double volume);
deadbeef2d110be2016-01-13 12:00:26 -0800404 void SetRawAudioSink(uint32_t ssrc,
kwiberg31022942016-03-11 14:18:21 -0800405 std::unique_ptr<webrtc::AudioSinkInterface> sink);
skvladdc1c62c2016-03-16 19:07:43 -0700406 webrtc::RtpParameters GetRtpParameters(uint32_t ssrc) const;
407 bool SetRtpParameters(uint32_t ssrc, const webrtc::RtpParameters& parameters);
Tommif888bb52015-12-12 01:37:01 +0100408
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000409 // Get statistics about the current media session.
410 bool GetStats(VoiceMediaInfo* stats);
411
412 // Monitoring functions
413 sigslot::signal2<VoiceChannel*, const std::vector<ConnectionInfo>&>
414 SignalConnectionMonitor;
415
416 void StartMediaMonitor(int cms);
417 void StopMediaMonitor();
418 sigslot::signal2<VoiceChannel*, const VoiceMediaInfo&> SignalMediaMonitor;
419
420 void StartAudioMonitor(int cms);
421 void StopAudioMonitor();
422 bool IsAudioMonitorRunning() const;
423 sigslot::signal2<VoiceChannel*, const AudioInfo&> SignalAudioMonitor;
424
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000425 int GetInputLevel_w();
426 int GetOutputLevel_w();
427 void GetActiveStreams_w(AudioInfo::StreamList* actives);
skvladdc1c62c2016-03-16 19:07:43 -0700428 webrtc::RtpParameters GetRtpParameters_w(uint32_t ssrc) const;
429 bool SetRtpParameters_w(uint32_t ssrc, webrtc::RtpParameters parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000430
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000431 private:
432 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200433 void OnChannelRead(TransportChannel* channel,
434 const char* data,
435 size_t len,
436 const rtc::PacketTime& packet_time,
437 int flags) override;
438 void ChangeState_w() override;
439 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
440 bool SetLocalContent_w(const MediaContentDescription* content,
441 ContentAction action,
442 std::string* error_desc) override;
443 bool SetRemoteContent_w(const MediaContentDescription* content,
444 ContentAction action,
445 std::string* error_desc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000446 void HandleEarlyMediaTimeout();
solenberg1d63dd02015-12-02 12:35:09 -0800447 bool InsertDtmf_w(uint32_t ssrc, int event, int duration);
solenberg4bac9c52015-10-09 02:32:53 -0700448 bool SetOutputVolume_w(uint32_t ssrc, double volume);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000449 bool GetStats_w(VoiceMediaInfo* stats);
450
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200451 void OnMessage(rtc::Message* pmsg) override;
452 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
453 void OnConnectionMonitorUpdate(
454 ConnectionMonitor* monitor,
455 const std::vector<ConnectionInfo>& infos) override;
456 void OnMediaMonitorUpdate(VoiceMediaChannel* media_channel,
457 const VoiceMediaInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000458 void OnAudioMonitorUpdate(AudioMonitor* monitor, const AudioInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000459
460 static const int kEarlyMediaTimeout = 1000;
Fredrik Solenberg0c022642015-08-05 12:25:22 +0200461 MediaEngineInterface* media_engine_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000462 bool received_media_;
kwiberg31022942016-03-11 14:18:21 -0800463 std::unique_ptr<VoiceMediaMonitor> media_monitor_;
464 std::unique_ptr<AudioMonitor> audio_monitor_;
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700465
466 // Last AudioSendParameters sent down to the media_channel() via
467 // SetSendParameters.
468 AudioSendParameters last_send_params_;
469 // Last AudioRecvParameters sent down to the media_channel() via
470 // SetRecvParameters.
471 AudioRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000472};
473
474// VideoChannel is a specialization for video.
475class VideoChannel : public BaseChannel {
476 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200477 VideoChannel(rtc::Thread* worker_thread,
478 rtc::Thread* netwokr_thread,
deadbeefcbecd352015-09-23 11:50:27 -0700479 VideoMediaChannel* channel,
480 TransportController* transport_controller,
481 const std::string& content_name,
Fredrik Solenberg0c022642015-08-05 12:25:22 +0200482 bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000483 ~VideoChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200484 bool Init_w();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000485
Fredrik Solenberg4b60c732015-05-07 14:07:48 +0200486 // downcasts a MediaChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200487 VideoMediaChannel* media_channel() const override {
Fredrik Solenberg4b60c732015-05-07 14:07:48 +0200488 return static_cast<VideoMediaChannel*>(BaseChannel::media_channel());
489 }
490
nisse08582ff2016-02-04 01:24:52 -0800491 bool SetSink(uint32_t ssrc, rtc::VideoSinkInterface<VideoFrame>* sink);
nisse2ded9b12016-04-08 02:23:55 -0700492 // Register a source. The |ssrc| must correspond to a registered
493 // send stream.
494 void SetSource(uint32_t ssrc,
495 rtc::VideoSourceInterface<cricket::VideoFrame>* source);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000496 // Get statistics about the current media session.
pbos@webrtc.org058b1f12015-03-04 08:54:32 +0000497 bool GetStats(VideoMediaInfo* stats);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000498
499 sigslot::signal2<VideoChannel*, const std::vector<ConnectionInfo>&>
500 SignalConnectionMonitor;
501
502 void StartMediaMonitor(int cms);
503 void StopMediaMonitor();
504 sigslot::signal2<VideoChannel*, const VideoMediaInfo&> SignalMediaMonitor;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000505
Peter Boström0c4e06b2015-10-07 12:23:21 +0200506 bool SetVideoSend(uint32_t ssrc, bool enable, const VideoOptions* options);
skvladdc1c62c2016-03-16 19:07:43 -0700507 webrtc::RtpParameters GetRtpParameters(uint32_t ssrc) const;
508 bool SetRtpParameters(uint32_t ssrc, const webrtc::RtpParameters& parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000509
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000510 private:
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000511 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200512 void ChangeState_w() override;
513 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
514 bool SetLocalContent_w(const MediaContentDescription* content,
515 ContentAction action,
516 std::string* error_desc) override;
517 bool SetRemoteContent_w(const MediaContentDescription* content,
518 ContentAction action,
519 std::string* error_desc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000520 bool GetStats_w(VideoMediaInfo* stats);
skvladdc1c62c2016-03-16 19:07:43 -0700521 webrtc::RtpParameters GetRtpParameters_w(uint32_t ssrc) const;
522 bool SetRtpParameters_w(uint32_t ssrc, webrtc::RtpParameters parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000523
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200524 void OnMessage(rtc::Message* pmsg) override;
525 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
526 void OnConnectionMonitorUpdate(
527 ConnectionMonitor* monitor,
528 const std::vector<ConnectionInfo>& infos) override;
529 void OnMediaMonitorUpdate(VideoMediaChannel* media_channel,
530 const VideoMediaInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000531
kwiberg31022942016-03-11 14:18:21 -0800532 std::unique_ptr<VideoMediaMonitor> media_monitor_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000533
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700534 // Last VideoSendParameters sent down to the media_channel() via
535 // SetSendParameters.
536 VideoSendParameters last_send_params_;
537 // Last VideoRecvParameters sent down to the media_channel() via
538 // SetRecvParameters.
539 VideoRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000540};
541
542// DataChannel is a specialization for data.
543class DataChannel : public BaseChannel {
544 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200545 DataChannel(rtc::Thread* worker_thread,
546 rtc::Thread* network_thread,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000547 DataMediaChannel* media_channel,
deadbeefcbecd352015-09-23 11:50:27 -0700548 TransportController* transport_controller,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000549 const std::string& content_name,
550 bool rtcp);
551 ~DataChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200552 bool Init_w();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000553
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000554 virtual bool SendData(const SendDataParams& params,
jbaucheec21bd2016-03-20 06:15:43 -0700555 const rtc::CopyOnWriteBuffer& payload,
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000556 SendDataResult* result);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000557
558 void StartMediaMonitor(int cms);
559 void StopMediaMonitor();
560
wu@webrtc.org07a6fbe2013-11-04 18:41:34 +0000561 // Should be called on the signaling thread only.
562 bool ready_to_send_data() const {
563 return ready_to_send_data_;
564 }
565
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000566 sigslot::signal2<DataChannel*, const DataMediaInfo&> SignalMediaMonitor;
567 sigslot::signal2<DataChannel*, const std::vector<ConnectionInfo>&>
568 SignalConnectionMonitor;
jbaucheec21bd2016-03-20 06:15:43 -0700569 sigslot::signal3<DataChannel*, const ReceiveDataParams&,
570 const rtc::CopyOnWriteBuffer&> SignalDataReceived;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000571 // Signal for notifying when the channel becomes ready to send data.
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000572 // That occurs when the channel is enabled, the transport is writable,
573 // both local and remote descriptions are set, and the channel is unblocked.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000574 sigslot::signal1<bool> SignalReadyToSendData;
buildbot@webrtc.org1d66be22014-05-29 22:54:24 +0000575 // Signal for notifying that the remote side has closed the DataChannel.
Peter Boström0c4e06b2015-10-07 12:23:21 +0200576 sigslot::signal1<uint32_t> SignalStreamClosedRemotely;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000577
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000578 protected:
579 // downcasts a MediaChannel.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200580 DataMediaChannel* media_channel() const override {
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000581 return static_cast<DataMediaChannel*>(BaseChannel::media_channel());
582 }
583
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000584 private:
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000585 struct SendDataMessageData : public rtc::MessageData {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000586 SendDataMessageData(const SendDataParams& params,
jbaucheec21bd2016-03-20 06:15:43 -0700587 const rtc::CopyOnWriteBuffer* payload,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000588 SendDataResult* result)
589 : params(params),
590 payload(payload),
591 result(result),
592 succeeded(false) {
593 }
594
595 const SendDataParams& params;
jbaucheec21bd2016-03-20 06:15:43 -0700596 const rtc::CopyOnWriteBuffer* payload;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000597 SendDataResult* result;
598 bool succeeded;
599 };
600
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000601 struct DataReceivedMessageData : public rtc::MessageData {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000602 // We copy the data because the data will become invalid after we
603 // handle DataMediaChannel::SignalDataReceived but before we fire
604 // SignalDataReceived.
605 DataReceivedMessageData(
606 const ReceiveDataParams& params, const char* data, size_t len)
607 : params(params),
608 payload(data, len) {
609 }
610 const ReceiveDataParams params;
jbaucheec21bd2016-03-20 06:15:43 -0700611 const rtc::CopyOnWriteBuffer payload;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000612 };
613
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000614 typedef rtc::TypedMessageData<bool> DataChannelReadyToSendMessageData;
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000615
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000616 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200617 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000618 // If data_channel_type_ is DCT_NONE, set it. Otherwise, check that
619 // it's the same as what was set previously. Returns false if it's
620 // set to one type one type and changed to another type later.
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000621 bool SetDataChannelType(DataChannelType new_data_channel_type,
622 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000623 // Same as SetDataChannelType, but extracts the type from the
624 // DataContentDescription.
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000625 bool SetDataChannelTypeFromContent(const DataContentDescription* content,
626 std::string* error_desc);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200627 bool SetLocalContent_w(const MediaContentDescription* content,
628 ContentAction action,
629 std::string* error_desc) override;
630 bool SetRemoteContent_w(const MediaContentDescription* content,
631 ContentAction action,
632 std::string* error_desc) override;
633 void ChangeState_w() override;
634 bool WantsPacket(bool rtcp, const rtc::CopyOnWriteBuffer* packet) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000635
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200636 void OnMessage(rtc::Message* pmsg) override;
637 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
638 void OnConnectionMonitorUpdate(
639 ConnectionMonitor* monitor,
640 const std::vector<ConnectionInfo>& infos) override;
641 void OnMediaMonitorUpdate(DataMediaChannel* media_channel,
642 const DataMediaInfo& info);
643 bool ShouldSetupDtlsSrtp_n() const override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000644 void OnDataReceived(
645 const ReceiveDataParams& params, const char* data, size_t len);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200646 void OnDataChannelError(uint32_t ssrc, DataMediaChannel::Error error);
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000647 void OnDataChannelReadyToSend(bool writable);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200648 void OnStreamClosedRemotely(uint32_t sid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000649
kwiberg31022942016-03-11 14:18:21 -0800650 std::unique_ptr<DataMediaMonitor> media_monitor_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000651 // TODO(pthatcher): Make a separate SctpDataChannel and
652 // RtpDataChannel instead of using this.
653 DataChannelType data_channel_type_;
wu@webrtc.org07a6fbe2013-11-04 18:41:34 +0000654 bool ready_to_send_data_;
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700655
656 // Last DataSendParameters sent down to the media_channel() via
657 // SetSendParameters.
658 DataSendParameters last_send_params_;
659 // Last DataRecvParameters sent down to the media_channel() via
660 // SetRecvParameters.
661 DataRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000662};
663
664} // namespace cricket
665
perkjc11b1842016-03-07 17:34:13 -0800666#endif // WEBRTC_PC_CHANNEL_H_