blob: 2f66f12c137d02185d1a03b221bb43f9b069098c [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();
Danil Chapovalovdae07ba2016-05-14 01:43:50 +0200317 void DisconnectTransportChannels_n();
318 void DestroyTransportChannels_n();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200319 void SignalSentPacket_n(TransportChannel* channel,
320 const rtc::SentPacket& sent_packet);
321 void SignalSentPacket_w(const rtc::SentPacket& sent_packet);
322 bool IsTransportReadyToSend_n() const;
323 void CacheRtpAbsSendTimeHeaderExtension_n(int rtp_abs_sendtime_extn_id);
324
325 rtc::Thread* const worker_thread_;
326 rtc::Thread* const network_thread_;
327 rtc::AsyncInvoker invoker_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000328
pthatcher@webrtc.org990a00c2015-03-13 18:20:33 +0000329 const std::string content_name_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200330 std::unique_ptr<ConnectionMonitor> connection_monitor_;
331
332 // Transport related members that should be accessed from network thread.
333 TransportController* const transport_controller_;
deadbeefcbecd352015-09-23 11:50:27 -0700334 std::string transport_name_;
335 bool rtcp_transport_enabled_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000336 TransportChannel* transport_channel_;
deadbeefcbecd352015-09-23 11:50:27 -0700337 std::vector<std::pair<rtc::Socket::Option, int> > socket_options_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000338 TransportChannel* rtcp_transport_channel_;
deadbeefcbecd352015-09-23 11:50:27 -0700339 std::vector<std::pair<rtc::Socket::Option, int> > rtcp_socket_options_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000340 SrtpFilter srtp_filter_;
341 RtcpMuxFilter rtcp_mux_filter_;
buildbot@webrtc.org5ee0f052014-05-05 20:18:08 +0000342 BundleFilter bundle_filter_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000343 bool rtp_ready_to_send_;
344 bool rtcp_ready_to_send_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200345 bool writable_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000346 bool was_ever_writable_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000347 bool has_received_packet_;
348 bool dtls_keyed_;
349 bool secure_required_;
henrike@webrtc.orgd43aa9d2014-02-21 23:43:24 +0000350 int rtp_abs_sendtime_extn_id_;
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200351
352 // MediaChannel related members that should be access from worker thread.
353 MediaChannel* const media_channel_;
354 // Currently enabled_ flag accessed from signaling thread too, but it can
355 // be changed only when signaling thread does sunchronious call to worker
356 // thread, so it should be safe.
357 bool enabled_;
358 std::vector<StreamParams> local_streams_;
359 std::vector<StreamParams> remote_streams_;
360 MediaContentDirection local_content_direction_;
361 MediaContentDirection remote_content_direction_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000362};
363
364// VoiceChannel is a specialization that adds support for early media, DTMF,
365// and input/output level monitoring.
366class VoiceChannel : public BaseChannel {
367 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200368 VoiceChannel(rtc::Thread* worker_thread,
369 rtc::Thread* network_thread,
deadbeefcbecd352015-09-23 11:50:27 -0700370 MediaEngineInterface* media_engine,
371 VoiceMediaChannel* channel,
372 TransportController* transport_controller,
373 const std::string& content_name,
374 bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000375 ~VoiceChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200376 bool Init_w();
solenberg1dd98f32015-09-10 01:57:14 -0700377
378 // Configure sending media on the stream with SSRC |ssrc|
379 // If there is only one sending stream SSRC 0 can be used.
Peter Boström0c4e06b2015-10-07 12:23:21 +0200380 bool SetAudioSend(uint32_t ssrc,
solenbergdfc8f4f2015-10-01 02:31:10 -0700381 bool enable,
deadbeefcbecd352015-09-23 11:50:27 -0700382 const AudioOptions* options,
Taylor Brandstetter1a018dc2016-03-08 12:37:39 -0800383 AudioSource* source);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000384
385 // downcasts a MediaChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200386 VoiceMediaChannel* media_channel() const override {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000387 return static_cast<VoiceMediaChannel*>(BaseChannel::media_channel());
388 }
389
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000390 void SetEarlyMedia(bool enable);
391 // This signal is emitted when we have gone a period of time without
392 // receiving early media. When received, a UI should start playing its
393 // own ringing sound
394 sigslot::signal1<VoiceChannel*> SignalEarlyMediaTimeout;
395
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000396 // Returns if the telephone-event has been negotiated.
397 bool CanInsertDtmf();
398 // Send and/or play a DTMF |event| according to the |flags|.
399 // The DTMF out-of-band signal will be used on sending.
400 // The |ssrc| should be either 0 or a valid send stream ssrc.
henrike@webrtc.org9de257d2013-07-17 14:42:53 +0000401 // The valid value for the |event| are 0 which corresponding to DTMF
402 // event 0-9, *, #, A-D.
solenberg1d63dd02015-12-02 12:35:09 -0800403 bool InsertDtmf(uint32_t ssrc, int event_code, int duration);
solenberg4bac9c52015-10-09 02:32:53 -0700404 bool SetOutputVolume(uint32_t ssrc, double volume);
deadbeef2d110be2016-01-13 12:00:26 -0800405 void SetRawAudioSink(uint32_t ssrc,
kwiberg31022942016-03-11 14:18:21 -0800406 std::unique_ptr<webrtc::AudioSinkInterface> sink);
skvladdc1c62c2016-03-16 19:07:43 -0700407 webrtc::RtpParameters GetRtpParameters(uint32_t ssrc) const;
408 bool SetRtpParameters(uint32_t ssrc, const webrtc::RtpParameters& parameters);
Tommif888bb52015-12-12 01:37:01 +0100409
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000410 // Get statistics about the current media session.
411 bool GetStats(VoiceMediaInfo* stats);
412
413 // Monitoring functions
414 sigslot::signal2<VoiceChannel*, const std::vector<ConnectionInfo>&>
415 SignalConnectionMonitor;
416
417 void StartMediaMonitor(int cms);
418 void StopMediaMonitor();
419 sigslot::signal2<VoiceChannel*, const VoiceMediaInfo&> SignalMediaMonitor;
420
421 void StartAudioMonitor(int cms);
422 void StopAudioMonitor();
423 bool IsAudioMonitorRunning() const;
424 sigslot::signal2<VoiceChannel*, const AudioInfo&> SignalAudioMonitor;
425
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000426 int GetInputLevel_w();
427 int GetOutputLevel_w();
428 void GetActiveStreams_w(AudioInfo::StreamList* actives);
skvladdc1c62c2016-03-16 19:07:43 -0700429 webrtc::RtpParameters GetRtpParameters_w(uint32_t ssrc) const;
430 bool SetRtpParameters_w(uint32_t ssrc, webrtc::RtpParameters parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000431
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000432 private:
433 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200434 void OnChannelRead(TransportChannel* channel,
435 const char* data,
436 size_t len,
437 const rtc::PacketTime& packet_time,
438 int flags) override;
439 void ChangeState_w() override;
440 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
441 bool SetLocalContent_w(const MediaContentDescription* content,
442 ContentAction action,
443 std::string* error_desc) override;
444 bool SetRemoteContent_w(const MediaContentDescription* content,
445 ContentAction action,
446 std::string* error_desc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000447 void HandleEarlyMediaTimeout();
solenberg1d63dd02015-12-02 12:35:09 -0800448 bool InsertDtmf_w(uint32_t ssrc, int event, int duration);
solenberg4bac9c52015-10-09 02:32:53 -0700449 bool SetOutputVolume_w(uint32_t ssrc, double volume);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000450 bool GetStats_w(VoiceMediaInfo* stats);
451
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200452 void OnMessage(rtc::Message* pmsg) override;
453 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
454 void OnConnectionMonitorUpdate(
455 ConnectionMonitor* monitor,
456 const std::vector<ConnectionInfo>& infos) override;
457 void OnMediaMonitorUpdate(VoiceMediaChannel* media_channel,
458 const VoiceMediaInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000459 void OnAudioMonitorUpdate(AudioMonitor* monitor, const AudioInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000460
461 static const int kEarlyMediaTimeout = 1000;
Fredrik Solenberg0c022642015-08-05 12:25:22 +0200462 MediaEngineInterface* media_engine_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000463 bool received_media_;
kwiberg31022942016-03-11 14:18:21 -0800464 std::unique_ptr<VoiceMediaMonitor> media_monitor_;
465 std::unique_ptr<AudioMonitor> audio_monitor_;
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700466
467 // Last AudioSendParameters sent down to the media_channel() via
468 // SetSendParameters.
469 AudioSendParameters last_send_params_;
470 // Last AudioRecvParameters sent down to the media_channel() via
471 // SetRecvParameters.
472 AudioRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000473};
474
475// VideoChannel is a specialization for video.
476class VideoChannel : public BaseChannel {
477 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200478 VideoChannel(rtc::Thread* worker_thread,
479 rtc::Thread* netwokr_thread,
deadbeefcbecd352015-09-23 11:50:27 -0700480 VideoMediaChannel* channel,
481 TransportController* transport_controller,
482 const std::string& content_name,
Fredrik Solenberg0c022642015-08-05 12:25:22 +0200483 bool rtcp);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000484 ~VideoChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200485 bool Init_w();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000486
Fredrik Solenberg4b60c732015-05-07 14:07:48 +0200487 // downcasts a MediaChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200488 VideoMediaChannel* media_channel() const override {
Fredrik Solenberg4b60c732015-05-07 14:07:48 +0200489 return static_cast<VideoMediaChannel*>(BaseChannel::media_channel());
490 }
491
nisse08582ff2016-02-04 01:24:52 -0800492 bool SetSink(uint32_t ssrc, rtc::VideoSinkInterface<VideoFrame>* sink);
nisse2ded9b12016-04-08 02:23:55 -0700493 // Register a source. The |ssrc| must correspond to a registered
494 // send stream.
495 void SetSource(uint32_t ssrc,
496 rtc::VideoSourceInterface<cricket::VideoFrame>* source);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000497 // Get statistics about the current media session.
pbos@webrtc.org058b1f12015-03-04 08:54:32 +0000498 bool GetStats(VideoMediaInfo* stats);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000499
500 sigslot::signal2<VideoChannel*, const std::vector<ConnectionInfo>&>
501 SignalConnectionMonitor;
502
503 void StartMediaMonitor(int cms);
504 void StopMediaMonitor();
505 sigslot::signal2<VideoChannel*, const VideoMediaInfo&> SignalMediaMonitor;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000506
Peter Boström0c4e06b2015-10-07 12:23:21 +0200507 bool SetVideoSend(uint32_t ssrc, bool enable, const VideoOptions* options);
skvladdc1c62c2016-03-16 19:07:43 -0700508 webrtc::RtpParameters GetRtpParameters(uint32_t ssrc) const;
509 bool SetRtpParameters(uint32_t ssrc, const webrtc::RtpParameters& parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000510
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000511 private:
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000512 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200513 void ChangeState_w() override;
514 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
515 bool SetLocalContent_w(const MediaContentDescription* content,
516 ContentAction action,
517 std::string* error_desc) override;
518 bool SetRemoteContent_w(const MediaContentDescription* content,
519 ContentAction action,
520 std::string* error_desc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000521 bool GetStats_w(VideoMediaInfo* stats);
skvladdc1c62c2016-03-16 19:07:43 -0700522 webrtc::RtpParameters GetRtpParameters_w(uint32_t ssrc) const;
523 bool SetRtpParameters_w(uint32_t ssrc, webrtc::RtpParameters parameters);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000524
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200525 void OnMessage(rtc::Message* pmsg) override;
526 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
527 void OnConnectionMonitorUpdate(
528 ConnectionMonitor* monitor,
529 const std::vector<ConnectionInfo>& infos) override;
530 void OnMediaMonitorUpdate(VideoMediaChannel* media_channel,
531 const VideoMediaInfo& info);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000532
kwiberg31022942016-03-11 14:18:21 -0800533 std::unique_ptr<VideoMediaMonitor> media_monitor_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000534
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700535 // Last VideoSendParameters sent down to the media_channel() via
536 // SetSendParameters.
537 VideoSendParameters last_send_params_;
538 // Last VideoRecvParameters sent down to the media_channel() via
539 // SetRecvParameters.
540 VideoRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000541};
542
543// DataChannel is a specialization for data.
544class DataChannel : public BaseChannel {
545 public:
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200546 DataChannel(rtc::Thread* worker_thread,
547 rtc::Thread* network_thread,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000548 DataMediaChannel* media_channel,
deadbeefcbecd352015-09-23 11:50:27 -0700549 TransportController* transport_controller,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000550 const std::string& content_name,
551 bool rtcp);
552 ~DataChannel();
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200553 bool Init_w();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000554
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000555 virtual bool SendData(const SendDataParams& params,
jbaucheec21bd2016-03-20 06:15:43 -0700556 const rtc::CopyOnWriteBuffer& payload,
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000557 SendDataResult* result);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000558
559 void StartMediaMonitor(int cms);
560 void StopMediaMonitor();
561
wu@webrtc.org07a6fbe2013-11-04 18:41:34 +0000562 // Should be called on the signaling thread only.
563 bool ready_to_send_data() const {
564 return ready_to_send_data_;
565 }
566
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000567 sigslot::signal2<DataChannel*, const DataMediaInfo&> SignalMediaMonitor;
568 sigslot::signal2<DataChannel*, const std::vector<ConnectionInfo>&>
569 SignalConnectionMonitor;
jbaucheec21bd2016-03-20 06:15:43 -0700570 sigslot::signal3<DataChannel*, const ReceiveDataParams&,
571 const rtc::CopyOnWriteBuffer&> SignalDataReceived;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000572 // Signal for notifying when the channel becomes ready to send data.
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000573 // That occurs when the channel is enabled, the transport is writable,
574 // both local and remote descriptions are set, and the channel is unblocked.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000575 sigslot::signal1<bool> SignalReadyToSendData;
buildbot@webrtc.org1d66be22014-05-29 22:54:24 +0000576 // Signal for notifying that the remote side has closed the DataChannel.
Peter Boström0c4e06b2015-10-07 12:23:21 +0200577 sigslot::signal1<uint32_t> SignalStreamClosedRemotely;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000578
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000579 protected:
580 // downcasts a MediaChannel.
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200581 DataMediaChannel* media_channel() const override {
wu@webrtc.orgcadf9042013-08-30 21:24:16 +0000582 return static_cast<DataMediaChannel*>(BaseChannel::media_channel());
583 }
584
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000585 private:
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000586 struct SendDataMessageData : public rtc::MessageData {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000587 SendDataMessageData(const SendDataParams& params,
jbaucheec21bd2016-03-20 06:15:43 -0700588 const rtc::CopyOnWriteBuffer* payload,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000589 SendDataResult* result)
590 : params(params),
591 payload(payload),
592 result(result),
593 succeeded(false) {
594 }
595
596 const SendDataParams& params;
jbaucheec21bd2016-03-20 06:15:43 -0700597 const rtc::CopyOnWriteBuffer* payload;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000598 SendDataResult* result;
599 bool succeeded;
600 };
601
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000602 struct DataReceivedMessageData : public rtc::MessageData {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000603 // We copy the data because the data will become invalid after we
604 // handle DataMediaChannel::SignalDataReceived but before we fire
605 // SignalDataReceived.
606 DataReceivedMessageData(
607 const ReceiveDataParams& params, const char* data, size_t len)
608 : params(params),
609 payload(data, len) {
610 }
611 const ReceiveDataParams params;
jbaucheec21bd2016-03-20 06:15:43 -0700612 const rtc::CopyOnWriteBuffer payload;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000613 };
614
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000615 typedef rtc::TypedMessageData<bool> DataChannelReadyToSendMessageData;
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000616
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000617 // overrides from BaseChannel
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200618 const ContentInfo* GetFirstContent(const SessionDescription* sdesc) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000619 // If data_channel_type_ is DCT_NONE, set it. Otherwise, check that
620 // it's the same as what was set previously. Returns false if it's
621 // set to one type one type and changed to another type later.
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000622 bool SetDataChannelType(DataChannelType new_data_channel_type,
623 std::string* error_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000624 // Same as SetDataChannelType, but extracts the type from the
625 // DataContentDescription.
sergeyu@chromium.org4b26e2e2014-01-15 23:15:54 +0000626 bool SetDataChannelTypeFromContent(const DataContentDescription* content,
627 std::string* error_desc);
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200628 bool SetLocalContent_w(const MediaContentDescription* content,
629 ContentAction action,
630 std::string* error_desc) override;
631 bool SetRemoteContent_w(const MediaContentDescription* content,
632 ContentAction action,
633 std::string* error_desc) override;
634 void ChangeState_w() override;
635 bool WantsPacket(bool rtcp, const rtc::CopyOnWriteBuffer* packet) override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000636
Danil Chapovalov33b01f22016-05-11 19:55:27 +0200637 void OnMessage(rtc::Message* pmsg) override;
638 void GetSrtpCryptoSuites_n(std::vector<int>* crypto_suites) const override;
639 void OnConnectionMonitorUpdate(
640 ConnectionMonitor* monitor,
641 const std::vector<ConnectionInfo>& infos) override;
642 void OnMediaMonitorUpdate(DataMediaChannel* media_channel,
643 const DataMediaInfo& info);
644 bool ShouldSetupDtlsSrtp_n() const override;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000645 void OnDataReceived(
646 const ReceiveDataParams& params, const char* data, size_t len);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200647 void OnDataChannelError(uint32_t ssrc, DataMediaChannel::Error error);
wu@webrtc.orgd64719d2013-08-01 00:00:07 +0000648 void OnDataChannelReadyToSend(bool writable);
Peter Boström0c4e06b2015-10-07 12:23:21 +0200649 void OnStreamClosedRemotely(uint32_t sid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000650
kwiberg31022942016-03-11 14:18:21 -0800651 std::unique_ptr<DataMediaMonitor> media_monitor_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000652 // TODO(pthatcher): Make a separate SctpDataChannel and
653 // RtpDataChannel instead of using this.
654 DataChannelType data_channel_type_;
wu@webrtc.org07a6fbe2013-11-04 18:41:34 +0000655 bool ready_to_send_data_;
Peter Thatcherc2ee2c82015-08-07 16:05:34 -0700656
657 // Last DataSendParameters sent down to the media_channel() via
658 // SetSendParameters.
659 DataSendParameters last_send_params_;
660 // Last DataRecvParameters sent down to the media_channel() via
661 // SetRecvParameters.
662 DataRecvParameters last_recv_params_;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000663};
664
665} // namespace cricket
666
perkjc11b1842016-03-07 17:34:13 -0800667#endif // WEBRTC_PC_CHANNEL_H_