/* * Copyright 2020 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 PC_CONNECTION_CONTEXT_H_ #define PC_CONNECTION_CONTEXT_H_ #include #include #include "api/call/call_factory_interface.h" #include "api/media_stream_interface.h" #include "api/peer_connection_interface.h" #include "api/scoped_refptr.h" #include "api/transport/sctp_transport_factory_interface.h" #include "api/transport/webrtc_key_value_config.h" #include "media/base/media_engine.h" #include "media/sctp/sctp_transport_internal.h" #include "p2p/base/basic_packet_socket_factory.h" #include "pc/channel_manager.h" #include "rtc_base/checks.h" #include "rtc_base/network.h" #include "rtc_base/network_monitor_factory.h" #include "rtc_base/ref_count.h" #include "rtc_base/rtc_certificate_generator.h" #include "rtc_base/synchronization/sequence_checker.h" #include "rtc_base/thread.h" #include "rtc_base/thread_annotations.h" namespace rtc { class BasicNetworkManager; class BasicPacketSocketFactory; } // namespace rtc namespace webrtc { class RtcEventLog; // This class contains resources needed by PeerConnection and associated // objects. A reference to this object is passed to each PeerConnection. The // methods on this object are assumed not to change the state in any way that // interferes with the operation of other PeerConnections. // // This class must be created and destroyed on the signaling thread. class ConnectionContext : public rtc::RefCountInterface { public: // Creates a ConnectionContext. May return null if initialization fails. // The Dependencies class allows simple management of all new dependencies // being added to the ConnectionContext. static rtc::scoped_refptr Create( PeerConnectionFactoryDependencies* dependencies); // This class is not copyable or movable. ConnectionContext(const ConnectionContext&) = delete; ConnectionContext& operator=(const ConnectionContext&) = delete; // Functions called from PeerConnection and friends SctpTransportFactoryInterface* sctp_transport_factory() const { RTC_DCHECK_RUN_ON(signaling_thread_); return sctp_factory_.get(); } cricket::ChannelManager* channel_manager() const; rtc::Thread* signaling_thread() { return signaling_thread_; } const rtc::Thread* signaling_thread() const { return signaling_thread_; } rtc::Thread* worker_thread() { return worker_thread_; } const rtc::Thread* worker_thread() const { return worker_thread_; } rtc::Thread* network_thread() { return network_thread_; } const rtc::Thread* network_thread() const { return network_thread_; } const WebRtcKeyValueConfig& trials() const { return *trials_.get(); } // Accessors only used from the PeerConnectionFactory class rtc::BasicNetworkManager* default_network_manager() { RTC_DCHECK_RUN_ON(signaling_thread_); return default_network_manager_.get(); } rtc::BasicPacketSocketFactory* default_socket_factory() { RTC_DCHECK_RUN_ON(signaling_thread_); return default_socket_factory_.get(); } CallFactoryInterface* call_factory() { RTC_DCHECK_RUN_ON(worker_thread_); return call_factory_.get(); } protected: explicit ConnectionContext(PeerConnectionFactoryDependencies* dependencies); virtual ~ConnectionContext(); private: // The following three variables are used to communicate between the // constructor and the destructor, and are never exposed externally. bool wraps_current_thread_; // Note: Since owned_network_thread_ and owned_worker_thread_ are used // in the initialization of network_thread_ and worker_thread_, they // must be declared before them, so that they are initialized first. std::unique_ptr owned_network_thread_ RTC_GUARDED_BY(signaling_thread_); std::unique_ptr owned_worker_thread_ RTC_GUARDED_BY(signaling_thread_); rtc::Thread* const network_thread_; rtc::Thread* const worker_thread_; rtc::Thread* const signaling_thread_; // channel_manager is accessed both on signaling thread and worker thread. std::unique_ptr channel_manager_; std::unique_ptr const network_monitor_factory_ RTC_GUARDED_BY(signaling_thread_); std::unique_ptr default_network_manager_ RTC_GUARDED_BY(signaling_thread_); std::unique_ptr const call_factory_ RTC_GUARDED_BY(worker_thread_); std::unique_ptr default_socket_factory_ RTC_GUARDED_BY(signaling_thread_); std::unique_ptr media_engine_ RTC_GUARDED_BY(signaling_thread_); std::unique_ptr const sctp_factory_ RTC_GUARDED_BY(signaling_thread_); // Accessed both on signaling thread and worker thread. std::unique_ptr const trials_; }; } // namespace webrtc #endif // PC_CONNECTION_CONTEXT_H_