Index: webrtc/p2p/base/transportchannel.h |
diff --git a/webrtc/p2p/base/transportchannel.h b/webrtc/p2p/base/transportchannel.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..7c13f92ee703ecbbf54dae94c676670453ae7ae0 |
--- /dev/null |
+++ b/webrtc/p2p/base/transportchannel.h |
@@ -0,0 +1,163 @@ |
+/* |
+ * Copyright 2004 The WebRTC Project Authors. All rights reserved. |
+ * |
+ * Use of this source code is governed by a BSD-style license |
+ * that can be found in the LICENSE file in the root of the source |
+ * tree. An additional intellectual property rights grant can be found |
+ * in the file PATENTS. All contributing project authors may |
+ * be found in the AUTHORS file in the root of the source tree. |
+ */ |
+ |
+#ifndef WEBRTC_P2P_BASE_TRANSPORTCHANNEL_H_ |
+#define WEBRTC_P2P_BASE_TRANSPORTCHANNEL_H_ |
+ |
+#include <memory> |
+#include <string> |
+#include <vector> |
+ |
+#include "webrtc/base/asyncpacketsocket.h" |
+#include "webrtc/base/basictypes.h" |
+#include "webrtc/base/constructormagic.h" |
+#include "webrtc/base/dscp.h" |
+#include "webrtc/base/sigslot.h" |
+#include "webrtc/base/socket.h" |
+#include "webrtc/base/sslidentity.h" |
+#include "webrtc/base/sslstreamadapter.h" |
+#include "webrtc/p2p/base/candidate.h" |
+#include "webrtc/p2p/base/candidatepairinterface.h" |
+#include "webrtc/p2p/base/icetransportinternal.h" |
+#include "webrtc/p2p/base/jseptransport.h" |
+#include "webrtc/p2p/base/packettransportinterface.h" |
+#include "webrtc/p2p/base/transportdescription.h" |
+ |
+namespace cricket { |
+ |
+class Candidate; |
+ |
+// Flags for SendPacket/SignalReadPacket. |
+enum PacketFlags { |
+ PF_NORMAL = 0x00, // A normal packet. |
+ PF_SRTP_BYPASS = 0x01, // An encrypted SRTP packet; bypass any additional |
+ // crypto provided by the transport (e.g. DTLS) |
+}; |
+ |
+// A TransportChannel represents one logical stream of packets that are sent |
+// between the two sides of a session. |
+// TODO(deadbeef): This interface currently represents the unity of an ICE |
+// transport and a DTLS transport. They need to be separated apart. |
+class TransportChannel : public rtc::PacketTransportInterface { |
+ public: |
+ TransportChannel(const std::string& transport_name, int component) |
+ : transport_name_(transport_name), |
+ component_(component), |
+ writable_(false), |
+ receiving_(false) {} |
+ virtual ~TransportChannel() {} |
+ |
+ // TODO(guoweis) - Make this pure virtual once all subclasses of |
+ // TransportChannel have this defined. |
+ virtual IceTransportState GetState() const { |
+ return IceTransportState::STATE_CONNECTING; |
+ } |
+ |
+ const std::string& transport_name() const { return transport_name_; } |
+ int component() const { return component_; } |
+ const std::string debug_name() const override { |
+ return transport_name() + " " + std::to_string(component()); |
+ } |
+ |
+ // Returns the states of this channel. Each time one of these states changes, |
+ // a signal is raised. These states are aggregated by the TransportManager. |
+ bool writable() const override { return writable_; } |
+ bool receiving() const override { return receiving_; } |
+ DtlsTransportState dtls_state() const { return dtls_state_; } |
+ // Emitted whenever DTLS-SRTP is setup which will require setting up a new |
+ // SRTP context. |
+ sigslot::signal2<TransportChannel*, DtlsTransportState> SignalDtlsState; |
+ |
+ // Returns the current stats for this connection. |
+ virtual bool GetStats(ConnectionInfos* infos) = 0; |
+ |
+ // Is DTLS active? |
+ virtual bool IsDtlsActive() const = 0; |
+ |
+ // Default implementation. |
+ virtual bool GetSslRole(rtc::SSLRole* role) const = 0; |
+ |
+ // Sets up the ciphers to use for DTLS-SRTP. TODO(guoweis): Make this pure |
+ // virtual once all dependencies have implementation. |
+ virtual bool SetSrtpCryptoSuites(const std::vector<int>& ciphers); |
+ |
+ // Keep the original one for backward compatibility until all dependencies |
+ // move away. TODO(guoweis): Remove this function. |
+ virtual bool SetSrtpCiphers(const std::vector<std::string>& ciphers); |
+ |
+ // Finds out which DTLS-SRTP cipher was negotiated. |
+ // TODO(guoweis): Remove this once all dependencies implement this. |
+ virtual bool GetSrtpCryptoSuite(int* cipher) { return false; } |
+ |
+ // Finds out which DTLS cipher was negotiated. |
+ // TODO(guoweis): Remove this once all dependencies implement this. |
+ virtual bool GetSslCipherSuite(int* cipher) { return false; } |
+ |
+ // Gets the local RTCCertificate used for DTLS. |
+ virtual rtc::scoped_refptr<rtc::RTCCertificate> |
+ GetLocalCertificate() const = 0; |
+ |
+ // Gets a copy of the remote side's SSL certificate. |
+ virtual std::unique_ptr<rtc::SSLCertificate> GetRemoteSSLCertificate() |
+ const = 0; |
+ |
+ // Allows key material to be extracted for external encryption. |
+ virtual bool ExportKeyingMaterial(const std::string& label, |
+ const uint8_t* context, |
+ size_t context_len, |
+ bool use_context, |
+ uint8_t* result, |
+ size_t result_len) = 0; |
+ |
+ // Deprecated by SignalSelectedCandidatePairChanged |
+ // This signal occurs when there is a change in the way that packets are |
+ // being routed, i.e. to a different remote location. The candidate |
+ // indicates where and how we are currently sending media. |
+ sigslot::signal2<TransportChannel*, const Candidate&> SignalRouteChange; |
+ |
+ // Signalled when the current selected candidate pair has changed. |
+ // The first parameter is the transport channel that signals the event. |
+ // The second parameter is the new selected candidate pair. The third |
+ // parameter is the last packet id sent on the previous candidate pair. |
+ // The fourth parameter is a boolean which is true if the TransportChannel |
+ // is ready to send with this candidate pair. |
+ sigslot::signal4<TransportChannel*, CandidatePairInterface*, int, bool> |
+ SignalSelectedCandidatePairChanged; |
+ |
+ // Invoked when the channel is being destroyed. |
+ sigslot::signal1<TransportChannel*> SignalDestroyed; |
+ |
+ // Debugging description of this transport channel. |
+ std::string ToString() const; |
+ |
+ protected: |
+ // Sets the writable state, signaling if necessary. |
+ void set_writable(bool writable); |
+ |
+ // Sets the receiving state, signaling if necessary. |
+ void set_receiving(bool receiving); |
+ |
+ // Sets the DTLS state, signaling if necessary. |
+ void set_dtls_state(DtlsTransportState state); |
+ |
+ private: |
+ // Used mostly for debugging. |
+ std::string transport_name_; |
+ int component_; |
+ bool writable_; |
+ bool receiving_; |
+ DtlsTransportState dtls_state_ = DTLS_TRANSPORT_NEW; |
+ |
+ RTC_DISALLOW_COPY_AND_ASSIGN(TransportChannel); |
+}; |
+ |
+} // namespace cricket |
+ |
+#endif // WEBRTC_P2P_BASE_TRANSPORTCHANNEL_H_ |