Repo created
This commit is contained in:
parent
81b91f4139
commit
f8c34fa5ee
22732 changed files with 4815320 additions and 2 deletions
221
TMessagesProj/jni/voip/webrtc/p2p/base/port_interface.h
Normal file
221
TMessagesProj/jni/voip/webrtc/p2p/base/port_interface.h
Normal file
|
|
@ -0,0 +1,221 @@
|
|||
/*
|
||||
* Copyright 2012 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 P2P_BASE_PORT_INTERFACE_H_
|
||||
#define P2P_BASE_PORT_INTERFACE_H_
|
||||
|
||||
#include <memory>
|
||||
#include <string>
|
||||
#include <utility>
|
||||
#include <vector>
|
||||
|
||||
#include "absl/strings/string_view.h"
|
||||
#include "absl/types/optional.h"
|
||||
#include "api/candidate.h"
|
||||
#include "api/packet_socket_factory.h"
|
||||
#include "p2p/base/transport_description.h"
|
||||
#include "rtc_base/async_packet_socket.h"
|
||||
#include "rtc_base/callback_list.h"
|
||||
#include "rtc_base/proxy_info.h"
|
||||
#include "rtc_base/socket_address.h"
|
||||
|
||||
namespace rtc {
|
||||
class Network;
|
||||
struct PacketOptions;
|
||||
} // namespace rtc
|
||||
|
||||
namespace cricket {
|
||||
class Connection;
|
||||
class IceMessage;
|
||||
class StunMessage;
|
||||
class StunStats;
|
||||
|
||||
enum ProtocolType {
|
||||
PROTO_UDP,
|
||||
PROTO_TCP,
|
||||
PROTO_SSLTCP, // Pseudo-TLS.
|
||||
PROTO_TLS,
|
||||
PROTO_LAST = PROTO_TLS
|
||||
};
|
||||
|
||||
// Defines the interface for a port, which represents a local communication
|
||||
// mechanism that can be used to create connections to similar mechanisms of
|
||||
// the other client. Various types of ports will implement this interface.
|
||||
class PortInterface {
|
||||
public:
|
||||
virtual ~PortInterface();
|
||||
|
||||
virtual const absl::string_view Type() const = 0;
|
||||
virtual const rtc::Network* Network() const = 0;
|
||||
|
||||
// Methods to set/get ICE role and tiebreaker values.
|
||||
virtual void SetIceRole(IceRole role) = 0;
|
||||
virtual IceRole GetIceRole() const = 0;
|
||||
|
||||
virtual void SetIceTiebreaker(uint64_t tiebreaker) = 0;
|
||||
virtual uint64_t IceTiebreaker() const = 0;
|
||||
|
||||
virtual bool SharedSocket() const = 0;
|
||||
|
||||
virtual bool SupportsProtocol(absl::string_view protocol) const = 0;
|
||||
|
||||
// PrepareAddress will attempt to get an address for this port that other
|
||||
// clients can send to. It may take some time before the address is ready.
|
||||
// Once it is ready, we will send SignalAddressReady. If errors are
|
||||
// preventing the port from getting an address, it may send
|
||||
// SignalAddressError.
|
||||
virtual void PrepareAddress() = 0;
|
||||
|
||||
// Returns the connection to the given address or NULL if none exists.
|
||||
virtual Connection* GetConnection(const rtc::SocketAddress& remote_addr) = 0;
|
||||
|
||||
// Creates a new connection to the given address.
|
||||
enum CandidateOrigin { ORIGIN_THIS_PORT, ORIGIN_OTHER_PORT, ORIGIN_MESSAGE };
|
||||
virtual Connection* CreateConnection(const Candidate& remote_candidate,
|
||||
CandidateOrigin origin) = 0;
|
||||
|
||||
// Functions on the underlying socket(s).
|
||||
virtual int SetOption(rtc::Socket::Option opt, int value) = 0;
|
||||
virtual int GetOption(rtc::Socket::Option opt, int* value) = 0;
|
||||
virtual int GetError() = 0;
|
||||
|
||||
virtual ProtocolType GetProtocol() const = 0;
|
||||
|
||||
virtual const std::vector<Candidate>& Candidates() const = 0;
|
||||
|
||||
// Sends the given packet to the given address, provided that the address is
|
||||
// that of a connection or an address that has sent to us already.
|
||||
virtual int SendTo(const void* data,
|
||||
size_t size,
|
||||
const rtc::SocketAddress& addr,
|
||||
const rtc::PacketOptions& options,
|
||||
bool payload) = 0;
|
||||
|
||||
// Indicates that we received a successful STUN binding request from an
|
||||
// address that doesn't correspond to any current connection. To turn this
|
||||
// into a real connection, call CreateConnection.
|
||||
sigslot::signal6<PortInterface*,
|
||||
const rtc::SocketAddress&,
|
||||
ProtocolType,
|
||||
IceMessage*,
|
||||
const std::string&,
|
||||
bool>
|
||||
SignalUnknownAddress;
|
||||
|
||||
// Sends a response message (normal or error) to the given request. One of
|
||||
// these methods should be called as a response to SignalUnknownAddress.
|
||||
virtual void SendBindingErrorResponse(StunMessage* message,
|
||||
const rtc::SocketAddress& addr,
|
||||
int error_code,
|
||||
absl::string_view reason) = 0;
|
||||
|
||||
// Signaled when this port decides to delete itself because it no longer has
|
||||
// any usefulness.
|
||||
virtual void SubscribePortDestroyed(
|
||||
std::function<void(PortInterface*)> callback) = 0;
|
||||
|
||||
// Signaled when Port discovers ice role conflict with the peer.
|
||||
sigslot::signal1<PortInterface*> SignalRoleConflict;
|
||||
|
||||
// Normally, packets arrive through a connection (or they result signaling of
|
||||
// unknown address). Calling this method turns off delivery of packets
|
||||
// through their respective connection and instead delivers every packet
|
||||
// through this port.
|
||||
virtual void EnablePortPackets() = 0;
|
||||
sigslot::
|
||||
signal4<PortInterface*, const char*, size_t, const rtc::SocketAddress&>
|
||||
SignalReadPacket;
|
||||
|
||||
// Emitted each time a packet is sent on this port.
|
||||
sigslot::signal1<const rtc::SentPacket&> SignalSentPacket;
|
||||
|
||||
virtual std::string ToString() const = 0;
|
||||
|
||||
virtual void GetStunStats(absl::optional<StunStats>* stats) = 0;
|
||||
|
||||
// Removes and deletes a connection object. `DestroyConnection` will
|
||||
// delete the connection object directly whereas `DestroyConnectionAsync`
|
||||
// defers the `delete` operation to when the call stack has been unwound.
|
||||
// Async may be needed when deleting a connection object from within a
|
||||
// callback.
|
||||
virtual void DestroyConnection(Connection* conn) = 0;
|
||||
|
||||
virtual void DestroyConnectionAsync(Connection* conn) = 0;
|
||||
|
||||
// The thread on which this port performs its I/O.
|
||||
virtual webrtc::TaskQueueBase* thread() = 0;
|
||||
|
||||
// The factory used to create the sockets of this port.
|
||||
virtual rtc::PacketSocketFactory* socket_factory() const = 0;
|
||||
virtual const std::string& user_agent() = 0;
|
||||
virtual const rtc::ProxyInfo& proxy() = 0;
|
||||
|
||||
// Identifies the generation that this port was created in.
|
||||
virtual uint32_t generation() const = 0;
|
||||
virtual void set_generation(uint32_t generation) = 0;
|
||||
virtual bool send_retransmit_count_attribute() const = 0;
|
||||
// For debugging purposes.
|
||||
virtual const std::string& content_name() const = 0;
|
||||
|
||||
// Called when the Connection discovers a local peer reflexive candidate.
|
||||
virtual void AddPrflxCandidate(const Candidate& local) = 0;
|
||||
|
||||
// Foundation: An arbitrary string that is the same for two candidates
|
||||
// that have the same type, base IP address, protocol (UDP, TCP,
|
||||
// etc.), and STUN or TURN server. If any of these are different,
|
||||
// then the foundation will be different. Two candidate pairs with
|
||||
// the same foundation pairs are likely to have similar network
|
||||
// characteristics. Foundations are used in the frozen algorithm.
|
||||
virtual std::string ComputeFoundation(
|
||||
absl::string_view type,
|
||||
absl::string_view protocol,
|
||||
absl::string_view relay_protocol,
|
||||
const rtc::SocketAddress& base_address) = 0;
|
||||
|
||||
protected:
|
||||
PortInterface();
|
||||
virtual void UpdateNetworkCost() = 0;
|
||||
|
||||
// Returns DSCP value packets generated by the port itself should use.
|
||||
virtual rtc::DiffServCodePoint StunDscpValue() const = 0;
|
||||
|
||||
// If the given data comprises a complete and correct STUN message then the
|
||||
// return value is true, otherwise false. If the message username corresponds
|
||||
// with this port's username fragment, msg will contain the parsed STUN
|
||||
// message. Otherwise, the function may send a STUN response internally.
|
||||
// remote_username contains the remote fragment of the STUN username.
|
||||
virtual bool GetStunMessage(const char* data,
|
||||
size_t size,
|
||||
const rtc::SocketAddress& addr,
|
||||
std::unique_ptr<IceMessage>* out_msg,
|
||||
std::string* out_username) = 0;
|
||||
|
||||
// This method will return local and remote username fragements from the
|
||||
// stun username attribute if present.
|
||||
virtual bool ParseStunUsername(const StunMessage* stun_msg,
|
||||
std::string* local_username,
|
||||
std::string* remote_username) const = 0;
|
||||
virtual std::string CreateStunUsername(
|
||||
absl::string_view remote_username) const = 0;
|
||||
|
||||
virtual bool MaybeIceRoleConflict(const rtc::SocketAddress& addr,
|
||||
IceMessage* stun_msg,
|
||||
absl::string_view remote_ufrag) = 0;
|
||||
|
||||
virtual int16_t network_cost() const = 0;
|
||||
|
||||
// Connection and Port are entangled; functions exposed to Port only
|
||||
// should not be public.
|
||||
friend class Connection;
|
||||
};
|
||||
|
||||
} // namespace cricket
|
||||
|
||||
#endif // P2P_BASE_PORT_INTERFACE_H_
|
||||
Loading…
Add table
Add a link
Reference in a new issue