1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111 |
- /*
- * 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 PC_PEER_CONNECTION_H_
- #define PC_PEER_CONNECTION_H_
- #include <functional>
- #include <map>
- #include <memory>
- #include <set>
- #include <string>
- #include <utility>
- #include <vector>
- #include "api/peer_connection_interface.h"
- #include "api/transport/data_channel_transport_interface.h"
- #include "api/turn_customizer.h"
- #include "pc/data_channel_controller.h"
- #include "pc/ice_server_parsing.h"
- #include "pc/jsep_transport_controller.h"
- #include "pc/peer_connection_factory.h"
- #include "pc/peer_connection_internal.h"
- #include "pc/rtc_stats_collector.h"
- #include "pc/rtp_sender.h"
- #include "pc/rtp_transceiver.h"
- #include "pc/sctp_transport.h"
- #include "pc/sdp_offer_answer.h"
- #include "pc/stats_collector.h"
- #include "pc/stream_collection.h"
- #include "pc/transceiver_list.h"
- #include "pc/webrtc_session_description_factory.h"
- #include "rtc_base/experiments/field_trial_parser.h"
- #include "rtc_base/operations_chain.h"
- #include "rtc_base/race_checker.h"
- #include "rtc_base/task_utils/pending_task_safety_flag.h"
- #include "rtc_base/unique_id_generator.h"
- #include "rtc_base/weak_ptr.h"
- namespace webrtc {
- class MediaStreamObserver;
- class VideoRtpReceiver;
- class RtcEventLog;
- class SdpOfferAnswerHandler;
- // PeerConnection is the implementation of the PeerConnection object as defined
- // by the PeerConnectionInterface API surface.
- // The class currently is solely responsible for the following:
- // - Managing the session state machine (signaling state).
- // - Creating and initializing lower-level objects, like PortAllocator and
- // BaseChannels.
- // - Owning and managing the life cycle of the RtpSender/RtpReceiver and track
- // objects.
- // - Tracking the current and pending local/remote session descriptions.
- // The class currently is jointly responsible for the following:
- // - Parsing and interpreting SDP.
- // - Generating offers and answers based on the current state.
- // - The ICE state machine.
- // - Generating stats.
- class PeerConnection : public PeerConnectionInternal,
- public JsepTransportController::Observer,
- public RtpSenderBase::SetStreamsObserver,
- public rtc::MessageHandler,
- public sigslot::has_slots<> {
- public:
- // A bit in the usage pattern is registered when its defining event occurs at
- // least once.
- enum class UsageEvent : int {
- TURN_SERVER_ADDED = 0x01,
- STUN_SERVER_ADDED = 0x02,
- DATA_ADDED = 0x04,
- AUDIO_ADDED = 0x08,
- VIDEO_ADDED = 0x10,
- // |SetLocalDescription| returns successfully.
- SET_LOCAL_DESCRIPTION_SUCCEEDED = 0x20,
- // |SetRemoteDescription| returns successfully.
- SET_REMOTE_DESCRIPTION_SUCCEEDED = 0x40,
- // A local candidate (with type host, server-reflexive, or relay) is
- // collected.
- CANDIDATE_COLLECTED = 0x80,
- // A remote candidate is successfully added via |AddIceCandidate|.
- ADD_ICE_CANDIDATE_SUCCEEDED = 0x100,
- ICE_STATE_CONNECTED = 0x200,
- CLOSE_CALLED = 0x400,
- // A local candidate with private IP is collected.
- PRIVATE_CANDIDATE_COLLECTED = 0x800,
- // A remote candidate with private IP is added, either via AddiceCandidate
- // or from the remote description.
- REMOTE_PRIVATE_CANDIDATE_ADDED = 0x1000,
- // A local mDNS candidate is collected.
- MDNS_CANDIDATE_COLLECTED = 0x2000,
- // A remote mDNS candidate is added, either via AddIceCandidate or from the
- // remote description.
- REMOTE_MDNS_CANDIDATE_ADDED = 0x4000,
- // A local candidate with IPv6 address is collected.
- IPV6_CANDIDATE_COLLECTED = 0x8000,
- // A remote candidate with IPv6 address is added, either via AddIceCandidate
- // or from the remote description.
- REMOTE_IPV6_CANDIDATE_ADDED = 0x10000,
- // A remote candidate (with type host, server-reflexive, or relay) is
- // successfully added, either via AddIceCandidate or from the remote
- // description.
- REMOTE_CANDIDATE_ADDED = 0x20000,
- // An explicit host-host candidate pair is selected, i.e. both the local and
- // the remote candidates have the host type. This does not include candidate
- // pairs formed with equivalent prflx remote candidates, e.g. a host-prflx
- // pair where the prflx candidate has the same base as a host candidate of
- // the remote peer.
- DIRECT_CONNECTION_SELECTED = 0x40000,
- MAX_VALUE = 0x80000,
- };
- explicit PeerConnection(PeerConnectionFactory* factory,
- std::unique_ptr<RtcEventLog> event_log,
- std::unique_ptr<Call> call);
- bool Initialize(
- const PeerConnectionInterface::RTCConfiguration& configuration,
- PeerConnectionDependencies dependencies);
- rtc::scoped_refptr<StreamCollectionInterface> local_streams() override;
- rtc::scoped_refptr<StreamCollectionInterface> remote_streams() override;
- bool AddStream(MediaStreamInterface* local_stream) override;
- void RemoveStream(MediaStreamInterface* local_stream) override;
- RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrack(
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const std::vector<std::string>& stream_ids) override;
- bool RemoveTrack(RtpSenderInterface* sender) override;
- RTCError RemoveTrackNew(
- rtc::scoped_refptr<RtpSenderInterface> sender) override;
- RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver(
- rtc::scoped_refptr<MediaStreamTrackInterface> track) override;
- RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver(
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const RtpTransceiverInit& init) override;
- RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver(
- cricket::MediaType media_type) override;
- RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver(
- cricket::MediaType media_type,
- const RtpTransceiverInit& init) override;
- // Gets the DTLS SSL certificate associated with the audio transport on the
- // remote side. This will become populated once the DTLS connection with the
- // peer has been completed, as indicated by the ICE connection state
- // transitioning to kIceConnectionCompleted.
- // Note that this will be removed once we implement RTCDtlsTransport which
- // has standardized method for getting this information.
- // See https://www.w3.org/TR/webrtc/#rtcdtlstransport-interface
- std::unique_ptr<rtc::SSLCertificate> GetRemoteAudioSSLCertificate();
- // Version of the above method that returns the full certificate chain.
- std::unique_ptr<rtc::SSLCertChain> GetRemoteAudioSSLCertChain();
- rtc::scoped_refptr<RtpSenderInterface> CreateSender(
- const std::string& kind,
- const std::string& stream_id) override;
- std::vector<rtc::scoped_refptr<RtpSenderInterface>> GetSenders()
- const override;
- std::vector<rtc::scoped_refptr<RtpReceiverInterface>> GetReceivers()
- const override;
- std::vector<rtc::scoped_refptr<RtpTransceiverInterface>> GetTransceivers()
- const override;
- rtc::scoped_refptr<DataChannelInterface> CreateDataChannel(
- const std::string& label,
- const DataChannelInit* config) override;
- // WARNING: LEGACY. See peerconnectioninterface.h
- bool GetStats(StatsObserver* observer,
- webrtc::MediaStreamTrackInterface* track,
- StatsOutputLevel level) override;
- // Spec-complaint GetStats(). See peerconnectioninterface.h
- void GetStats(RTCStatsCollectorCallback* callback) override;
- void GetStats(
- rtc::scoped_refptr<RtpSenderInterface> selector,
- rtc::scoped_refptr<RTCStatsCollectorCallback> callback) override;
- void GetStats(
- rtc::scoped_refptr<RtpReceiverInterface> selector,
- rtc::scoped_refptr<RTCStatsCollectorCallback> callback) override;
- void ClearStatsCache() override;
- SignalingState signaling_state() override;
- IceConnectionState ice_connection_state() override;
- IceConnectionState standardized_ice_connection_state() override;
- PeerConnectionState peer_connection_state() override;
- IceGatheringState ice_gathering_state() override;
- absl::optional<bool> can_trickle_ice_candidates() override;
- const SessionDescriptionInterface* local_description() const override;
- const SessionDescriptionInterface* remote_description() const override;
- const SessionDescriptionInterface* current_local_description() const override;
- const SessionDescriptionInterface* current_remote_description()
- const override;
- const SessionDescriptionInterface* pending_local_description() const override;
- const SessionDescriptionInterface* pending_remote_description()
- const override;
- void RestartIce() override;
- // JSEP01
- void CreateOffer(CreateSessionDescriptionObserver* observer,
- const RTCOfferAnswerOptions& options) override;
- void CreateAnswer(CreateSessionDescriptionObserver* observer,
- const RTCOfferAnswerOptions& options) override;
- void SetLocalDescription(
- std::unique_ptr<SessionDescriptionInterface> desc,
- rtc::scoped_refptr<SetLocalDescriptionObserverInterface> observer)
- override;
- void SetLocalDescription(
- rtc::scoped_refptr<SetLocalDescriptionObserverInterface> observer)
- override;
- // TODO(https://crbug.com/webrtc/11798): Delete these methods in favor of the
- // ones taking SetLocalDescriptionObserverInterface as argument.
- void SetLocalDescription(SetSessionDescriptionObserver* observer,
- SessionDescriptionInterface* desc) override;
- void SetLocalDescription(SetSessionDescriptionObserver* observer) override;
- void SetRemoteDescription(
- std::unique_ptr<SessionDescriptionInterface> desc,
- rtc::scoped_refptr<SetRemoteDescriptionObserverInterface> observer)
- override;
- // TODO(https://crbug.com/webrtc/11798): Delete this methods in favor of the
- // ones taking SetRemoteDescriptionObserverInterface as argument.
- void SetRemoteDescription(SetSessionDescriptionObserver* observer,
- SessionDescriptionInterface* desc) override;
- PeerConnectionInterface::RTCConfiguration GetConfiguration() override;
- RTCError SetConfiguration(
- const PeerConnectionInterface::RTCConfiguration& configuration) override;
- bool AddIceCandidate(const IceCandidateInterface* candidate) override;
- void AddIceCandidate(std::unique_ptr<IceCandidateInterface> candidate,
- std::function<void(RTCError)> callback) override;
- bool RemoveIceCandidates(
- const std::vector<cricket::Candidate>& candidates) override;
- RTCError SetBitrate(const BitrateSettings& bitrate) override;
- void SetAudioPlayout(bool playout) override;
- void SetAudioRecording(bool recording) override;
- rtc::scoped_refptr<DtlsTransportInterface> LookupDtlsTransportByMid(
- const std::string& mid) override;
- rtc::scoped_refptr<DtlsTransport> LookupDtlsTransportByMidInternal(
- const std::string& mid);
- rtc::scoped_refptr<SctpTransportInterface> GetSctpTransport() const override;
- void AddAdaptationResource(rtc::scoped_refptr<Resource> resource) override;
- bool StartRtcEventLog(std::unique_ptr<RtcEventLogOutput> output,
- int64_t output_period_ms) override;
- bool StartRtcEventLog(std::unique_ptr<RtcEventLogOutput> output) override;
- void StopRtcEventLog() override;
- void Close() override;
- rtc::Thread* signaling_thread() const final {
- return factory_->signaling_thread();
- }
- // PeerConnectionInternal implementation.
- rtc::Thread* network_thread() const final {
- return factory_->network_thread();
- }
- rtc::Thread* worker_thread() const final { return factory_->worker_thread(); }
- std::string session_id() const override {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return session_id_;
- }
- bool initial_offerer() const override {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return transport_controller_ && transport_controller_->initial_offerer();
- }
- std::vector<
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>>
- GetTransceiversInternal() const override {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return transceivers_.List();
- }
- sigslot::signal1<RtpDataChannel*>& SignalRtpDataChannelCreated() override {
- return data_channel_controller_.SignalRtpDataChannelCreated();
- }
- sigslot::signal1<SctpDataChannel*>& SignalSctpDataChannelCreated() override {
- return data_channel_controller_.SignalSctpDataChannelCreated();
- }
- cricket::RtpDataChannel* rtp_data_channel() const override {
- return data_channel_controller_.rtp_data_channel();
- }
- std::vector<DataChannelStats> GetDataChannelStats() const override;
- absl::optional<std::string> sctp_transport_name() const override;
- cricket::CandidateStatsList GetPooledCandidateStats() const override;
- std::map<std::string, std::string> GetTransportNamesByMid() const override;
- std::map<std::string, cricket::TransportStats> GetTransportStatsByNames(
- const std::set<std::string>& transport_names) override;
- Call::Stats GetCallStats() override;
- bool GetLocalCertificate(
- const std::string& transport_name,
- rtc::scoped_refptr<rtc::RTCCertificate>* certificate) override;
- std::unique_ptr<rtc::SSLCertChain> GetRemoteSSLCertChain(
- const std::string& transport_name) override;
- bool IceRestartPending(const std::string& content_name) const override;
- bool NeedsIceRestart(const std::string& content_name) const override;
- bool GetSslRole(const std::string& content_name, rtc::SSLRole* role) override;
- // Functions needed by DataChannelController
- void NoteDataAddedEvent() { NoteUsageEvent(UsageEvent::DATA_ADDED); }
- // Returns the observer. Will crash on CHECK if the observer is removed.
- PeerConnectionObserver* Observer() const;
- bool IsClosed() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return sdp_handler_.signaling_state() == PeerConnectionInterface::kClosed;
- }
- // Get current SSL role used by SCTP's underlying transport.
- bool GetSctpSslRole(rtc::SSLRole* role);
- // Handler for the "channel closed" signal
- void OnSctpDataChannelClosed(DataChannelInterface* channel);
- bool ShouldFireNegotiationNeededEvent(uint32_t event_id) override;
- // Functions needed by SdpOfferAnswerHandler
- StatsCollector* stats() {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return stats_.get();
- }
- DataChannelController* data_channel_controller() {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return &data_channel_controller_;
- }
- bool dtls_enabled() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return dtls_enabled_;
- }
- const PeerConnectionInterface::RTCConfiguration* configuration() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return &configuration_;
- }
- rtc::scoped_refptr<StreamCollection> remote_streams_internal() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return remote_streams_;
- }
- rtc::UniqueStringGenerator* mid_generator() {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return &mid_generator_;
- }
- // Functions made public for testing.
- void ReturnHistogramVeryQuicklyForTesting() {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return_histogram_very_quickly_ = true;
- }
- void RequestUsagePatternReportForTesting();
- absl::optional<std::string> sctp_mid() {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return sctp_mid_s_;
- }
- protected:
- ~PeerConnection() override;
- private:
- // While refactoring: Allow access from SDP negotiation
- // TOOD(https://bugs.webrtc.org/11995): Remove friendship.
- friend class SdpOfferAnswerHandler;
- struct RtpSenderInfo {
- RtpSenderInfo() : first_ssrc(0) {}
- RtpSenderInfo(const std::string& stream_id,
- const std::string sender_id,
- uint32_t ssrc)
- : stream_id(stream_id), sender_id(sender_id), first_ssrc(ssrc) {}
- bool operator==(const RtpSenderInfo& other) {
- return this->stream_id == other.stream_id &&
- this->sender_id == other.sender_id &&
- this->first_ssrc == other.first_ssrc;
- }
- std::string stream_id;
- std::string sender_id;
- // An RtpSender can have many SSRCs. The first one is used as a sort of ID
- // for communicating with the lower layers.
- uint32_t first_ssrc;
- };
- // Implements MessageHandler.
- void OnMessage(rtc::Message* msg) override;
- // Plan B helpers for getting the voice/video media channels for the single
- // audio/video transceiver, if it exists.
- cricket::VoiceMediaChannel* voice_media_channel() const
- RTC_RUN_ON(signaling_thread());
- cricket::VideoMediaChannel* video_media_channel() const
- RTC_RUN_ON(signaling_thread());
- std::vector<rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>>>
- GetSendersInternal() const;
- std::vector<
- rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>>>
- GetReceiversInternal() const RTC_RUN_ON(signaling_thread());
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- GetAudioTransceiver() const;
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- GetVideoTransceiver() const;
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- GetFirstAudioTransceiver() const RTC_RUN_ON(signaling_thread());
- // Helper function to remove stopped transceivers.
- void RemoveStoppedTransceivers();
- void CreateAudioReceiver(MediaStreamInterface* stream,
- const RtpSenderInfo& remote_sender_info)
- RTC_RUN_ON(signaling_thread());
- void CreateVideoReceiver(MediaStreamInterface* stream,
- const RtpSenderInfo& remote_sender_info)
- RTC_RUN_ON(signaling_thread());
- rtc::scoped_refptr<RtpReceiverInterface> RemoveAndStopReceiver(
- const RtpSenderInfo& remote_sender_info) RTC_RUN_ON(signaling_thread());
- // May be called either by AddStream/RemoveStream, or when a track is
- // added/removed from a stream previously added via AddStream.
- void AddAudioTrack(AudioTrackInterface* track, MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void RemoveAudioTrack(AudioTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void AddVideoTrack(VideoTrackInterface* track, MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void RemoveVideoTrack(VideoTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- // AddTrack implementation when Unified Plan is specified.
- RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrackUnifiedPlan(
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const std::vector<std::string>& stream_ids)
- RTC_RUN_ON(signaling_thread());
- // AddTrack implementation when Plan B is specified.
- RTCErrorOr<rtc::scoped_refptr<RtpSenderInterface>> AddTrackPlanB(
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const std::vector<std::string>& stream_ids)
- RTC_RUN_ON(signaling_thread());
- // Returns the first RtpTransceiver suitable for a newly added track, if such
- // transceiver is available.
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- FindFirstTransceiverForAddedTrack(
- rtc::scoped_refptr<MediaStreamTrackInterface> track)
- RTC_RUN_ON(signaling_thread());
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- FindTransceiverBySender(rtc::scoped_refptr<RtpSenderInterface> sender)
- RTC_RUN_ON(signaling_thread());
- // Internal implementation for AddTransceiver family of methods. If
- // |fire_callback| is set, fires OnRenegotiationNeeded callback if successful.
- RTCErrorOr<rtc::scoped_refptr<RtpTransceiverInterface>> AddTransceiver(
- cricket::MediaType media_type,
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const RtpTransceiverInit& init,
- bool fire_callback = true) RTC_RUN_ON(signaling_thread());
- rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>>
- CreateSender(cricket::MediaType media_type,
- const std::string& id,
- rtc::scoped_refptr<MediaStreamTrackInterface> track,
- const std::vector<std::string>& stream_ids,
- const std::vector<RtpEncodingParameters>& send_encodings);
- rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>>
- CreateReceiver(cricket::MediaType media_type, const std::string& receiver_id);
- // Create a new RtpTransceiver of the given type and add it to the list of
- // transceivers.
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- CreateAndAddTransceiver(
- rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>> sender,
- rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>>
- receiver);
- void SetIceConnectionState(IceConnectionState new_state);
- void SetStandardizedIceConnectionState(
- PeerConnectionInterface::IceConnectionState new_state)
- RTC_RUN_ON(signaling_thread());
- void SetConnectionState(
- PeerConnectionInterface::PeerConnectionState new_state)
- RTC_RUN_ON(signaling_thread());
- // Called any time the IceGatheringState changes.
- void OnIceGatheringChange(IceGatheringState new_state)
- RTC_RUN_ON(signaling_thread());
- // New ICE candidate has been gathered.
- void OnIceCandidate(std::unique_ptr<IceCandidateInterface> candidate)
- RTC_RUN_ON(signaling_thread());
- // Gathering of an ICE candidate failed.
- void OnIceCandidateError(const std::string& address,
- int port,
- const std::string& url,
- int error_code,
- const std::string& error_text)
- RTC_RUN_ON(signaling_thread());
- // Some local ICE candidates have been removed.
- void OnIceCandidatesRemoved(const std::vector<cricket::Candidate>& candidates)
- RTC_RUN_ON(signaling_thread());
- void OnSelectedCandidatePairChanged(
- const cricket::CandidatePairChangeEvent& event)
- RTC_RUN_ON(signaling_thread());
- // Signals from MediaStreamObserver.
- void OnAudioTrackAdded(AudioTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void OnAudioTrackRemoved(AudioTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void OnVideoTrackAdded(VideoTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void OnVideoTrackRemoved(VideoTrackInterface* track,
- MediaStreamInterface* stream)
- RTC_RUN_ON(signaling_thread());
- void PostSetSessionDescriptionSuccess(
- SetSessionDescriptionObserver* observer);
- void PostSetSessionDescriptionFailure(SetSessionDescriptionObserver* observer,
- RTCError&& error);
- void PostCreateSessionDescriptionFailure(
- CreateSessionDescriptionObserver* observer,
- RTCError error);
- // Returns the RtpTransceiver, if found, that is associated to the given MID.
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- GetAssociatedTransceiver(const std::string& mid) const;
- // Returns the RtpTransceiver, if found, that was assigned to the given mline
- // index in CreateOffer.
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- GetTransceiverByMLineIndex(size_t mline_index) const;
- // Runs the algorithm **process the removal of a remote track** specified in
- // the WebRTC specification.
- // This method will update the following lists:
- // |remove_list| is the list of transceivers for which the receiving track is
- // being removed.
- // |removed_streams| is the list of streams which no longer have a receiving
- // track so should be removed.
- // https://w3c.github.io/webrtc-pc/#process-remote-track-removal
- void ProcessRemovalOfRemoteTrack(
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- transceiver,
- std::vector<rtc::scoped_refptr<RtpTransceiverInterface>>* remove_list,
- std::vector<rtc::scoped_refptr<MediaStreamInterface>>* removed_streams);
- void RemoveRemoteStreamsIfEmpty(
- const std::vector<rtc::scoped_refptr<MediaStreamInterface>>&
- remote_streams,
- std::vector<rtc::scoped_refptr<MediaStreamInterface>>* removed_streams);
- void OnNegotiationNeeded();
- RTCError HandleLegacyOfferOptions(const RTCOfferAnswerOptions& options);
- void RemoveRecvDirectionFromReceivingTransceiversOfType(
- cricket::MediaType media_type) RTC_RUN_ON(signaling_thread());
- void AddUpToOneReceivingTransceiverOfType(cricket::MediaType media_type);
- std::vector<
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>>
- GetReceivingTransceiversOfType(cricket::MediaType media_type)
- RTC_RUN_ON(signaling_thread());
- // Generates MediaDescriptionOptions for the |session_opts| based on existing
- // local description or remote description.
- void GenerateMediaDescriptionOptions(
- const SessionDescriptionInterface* session_desc,
- RtpTransceiverDirection audio_direction,
- RtpTransceiverDirection video_direction,
- absl::optional<size_t>* audio_index,
- absl::optional<size_t>* video_index,
- absl::optional<size_t>* data_index,
- cricket::MediaSessionOptions* session_options);
- // Generates the active MediaDescriptionOptions for the local data channel
- // given the specified MID.
- cricket::MediaDescriptionOptions GetMediaDescriptionOptionsForActiveData(
- const std::string& mid) const;
- // Generates the rejected MediaDescriptionOptions for the local data channel
- // given the specified MID.
- cricket::MediaDescriptionOptions GetMediaDescriptionOptionsForRejectedData(
- const std::string& mid) const;
- // Returns the MID for the data section associated with either the
- // RtpDataChannel or SCTP data channel, if it has been set. If no data
- // channels are configured this will return nullopt.
- absl::optional<std::string> GetDataMid() const;
- // Remove all local and remote senders of type |media_type|.
- // Called when a media type is rejected (m-line set to port 0).
- void RemoveSenders(cricket::MediaType media_type);
- // Makes sure a MediaStreamTrack is created for each StreamParam in |streams|,
- // and existing MediaStreamTracks are removed if there is no corresponding
- // StreamParam. If |default_track_needed| is true, a default MediaStreamTrack
- // is created if it doesn't exist; if false, it's removed if it exists.
- // |media_type| is the type of the |streams| and can be either audio or video.
- // If a new MediaStream is created it is added to |new_streams|.
- void UpdateRemoteSendersList(
- const std::vector<cricket::StreamParams>& streams,
- bool default_track_needed,
- cricket::MediaType media_type,
- StreamCollection* new_streams);
- // Triggered when a remote sender has been seen for the first time in a remote
- // session description. It creates a remote MediaStreamTrackInterface
- // implementation and triggers CreateAudioReceiver or CreateVideoReceiver.
- void OnRemoteSenderAdded(const RtpSenderInfo& sender_info,
- cricket::MediaType media_type)
- RTC_RUN_ON(signaling_thread());
- // Triggered when a remote sender has been removed from a remote session
- // description. It removes the remote sender with id |sender_id| from a remote
- // MediaStream and triggers DestroyAudioReceiver or DestroyVideoReceiver.
- void OnRemoteSenderRemoved(const RtpSenderInfo& sender_info,
- cricket::MediaType media_type)
- RTC_RUN_ON(signaling_thread());
- // Finds remote MediaStreams without any tracks and removes them from
- // |remote_streams_| and notifies the observer that the MediaStreams no longer
- // exist.
- void UpdateEndedRemoteMediaStreams();
- // Loops through the vector of |streams| and finds added and removed
- // StreamParams since last time this method was called.
- // For each new or removed StreamParam, OnLocalSenderSeen or
- // OnLocalSenderRemoved is invoked.
- void UpdateLocalSenders(const std::vector<cricket::StreamParams>& streams,
- cricket::MediaType media_type);
- // Triggered when a local sender has been seen for the first time in a local
- // session description.
- // This method triggers CreateAudioSender or CreateVideoSender if the rtp
- // streams in the local SessionDescription can be mapped to a MediaStreamTrack
- // in a MediaStream in |local_streams_|
- void OnLocalSenderAdded(const RtpSenderInfo& sender_info,
- cricket::MediaType media_type)
- RTC_RUN_ON(signaling_thread());
- // Triggered when a local sender has been removed from a local session
- // description.
- // This method triggers DestroyAudioSender or DestroyVideoSender if a stream
- // has been removed from the local SessionDescription and the stream can be
- // mapped to a MediaStreamTrack in a MediaStream in |local_streams_|.
- void OnLocalSenderRemoved(const RtpSenderInfo& sender_info,
- cricket::MediaType media_type)
- RTC_RUN_ON(signaling_thread());
- // Returns true if the PeerConnection is configured to use Unified Plan
- // semantics for creating offers/answers and setting local/remote
- // descriptions. If this is true the RtpTransceiver API will also be available
- // to the user. If this is false, Plan B semantics are assumed.
- // TODO(bugs.webrtc.org/8530): Flip the default to be Unified Plan once
- // sufficient time has passed.
- bool IsUnifiedPlan() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return configuration_.sdp_semantics == SdpSemantics::kUnifiedPlan;
- }
- // Return the RtpSender with the given track attached.
- rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>>
- FindSenderForTrack(MediaStreamTrackInterface* track) const
- RTC_RUN_ON(signaling_thread());
- // Return the RtpSender with the given id, or null if none exists.
- rtc::scoped_refptr<RtpSenderProxyWithInternal<RtpSenderInternal>>
- FindSenderById(const std::string& sender_id) const
- RTC_RUN_ON(signaling_thread());
- // Return the RtpReceiver with the given id, or null if none exists.
- rtc::scoped_refptr<RtpReceiverProxyWithInternal<RtpReceiverInternal>>
- FindReceiverById(const std::string& receiver_id) const
- RTC_RUN_ON(signaling_thread());
- std::vector<RtpSenderInfo>* GetRemoteSenderInfos(
- cricket::MediaType media_type);
- std::vector<RtpSenderInfo>* GetLocalSenderInfos(
- cricket::MediaType media_type);
- const RtpSenderInfo* FindSenderInfo(const std::vector<RtpSenderInfo>& infos,
- const std::string& stream_id,
- const std::string sender_id) const;
- // Returns the specified SCTP DataChannel in sctp_data_channels_,
- // or nullptr if not found.
- SctpDataChannel* FindDataChannelBySid(int sid) const
- RTC_RUN_ON(signaling_thread());
- // Called when first configuring the port allocator.
- struct InitializePortAllocatorResult {
- bool enable_ipv6;
- };
- InitializePortAllocatorResult InitializePortAllocator_n(
- const cricket::ServerAddresses& stun_servers,
- const std::vector<cricket::RelayServerConfig>& turn_servers,
- const RTCConfiguration& configuration);
- // Called when SetConfiguration is called to apply the supported subset
- // of the configuration on the network thread.
- bool ReconfigurePortAllocator_n(
- const cricket::ServerAddresses& stun_servers,
- const std::vector<cricket::RelayServerConfig>& turn_servers,
- IceTransportsType type,
- int candidate_pool_size,
- PortPrunePolicy turn_port_prune_policy,
- webrtc::TurnCustomizer* turn_customizer,
- absl::optional<int> stun_candidate_keepalive_interval,
- bool have_local_description);
- // Starts output of an RTC event log to the given output object.
- // This function should only be called from the worker thread.
- bool StartRtcEventLog_w(std::unique_ptr<RtcEventLogOutput> output,
- int64_t output_period_ms);
- // Stops recording an RTC event log.
- // This function should only be called from the worker thread.
- void StopRtcEventLog_w();
- // Ensures the configuration doesn't have any parameters with invalid values,
- // or values that conflict with other parameters.
- //
- // Returns RTCError::OK() if there are no issues.
- RTCError ValidateConfiguration(const RTCConfiguration& config) const;
- cricket::ChannelManager* channel_manager() const;
- enum class SessionError {
- kNone, // No error.
- kContent, // Error in BaseChannel SetLocalContent/SetRemoteContent.
- kTransport, // Error from the underlying transport.
- };
- // Returns the last error in the session. See the enum above for details.
- SessionError session_error() const {
- RTC_DCHECK_RUN_ON(signaling_thread());
- return session_error_;
- }
- const std::string& session_error_desc() const { return session_error_desc_; }
- cricket::ChannelInterface* GetChannel(const std::string& content_name);
- cricket::IceConfig ParseIceConfig(
- const PeerConnectionInterface::RTCConfiguration& config) const;
- cricket::DataChannelType data_channel_type() const;
- // Called when an RTCCertificate is generated or retrieved by
- // WebRTCSessionDescriptionFactory. Should happen before setLocalDescription.
- void OnCertificateReady(
- const rtc::scoped_refptr<rtc::RTCCertificate>& certificate);
- // Updates the error state, signaling if necessary.
- void SetSessionError(SessionError error, const std::string& error_desc);
- // Based on number of transceivers per media type, enabled or disable
- // payload type based demuxing in the affected channels.
- bool UpdatePayloadTypeDemuxingState(cricket::ContentSource source)
- RTC_RUN_ON(signaling_thread());
- // Push the media parts of the local or remote session description
- // down to all of the channels.
- RTCError PushdownMediaDescription(SdpType type,
- cricket::ContentSource source);
- RTCError PushdownTransportDescription(cricket::ContentSource source,
- SdpType type);
- // Returns true and the TransportInfo of the given |content_name|
- // from |description|. Returns false if it's not available.
- static bool GetTransportDescription(
- const cricket::SessionDescription* description,
- const std::string& content_name,
- cricket::TransportDescription* info);
- // Enables media channels to allow sending of media.
- // This enables media to flow on all configured audio/video channels and the
- // RtpDataChannel.
- void EnableSending();
- // Destroys all BaseChannels and destroys the SCTP data channel, if present.
- void DestroyAllChannels() RTC_RUN_ON(signaling_thread());
- // Returns the media index for a local ice candidate given the content name.
- // Returns false if the local session description does not have a media
- // content called |content_name|.
- bool GetLocalCandidateMediaIndex(const std::string& content_name,
- int* sdp_mline_index)
- RTC_RUN_ON(signaling_thread());
- // Uses all remote candidates in |remote_desc| in this session.
- bool UseCandidatesInSessionDescription(
- const SessionDescriptionInterface* remote_desc);
- // Uses |candidate| in this session.
- bool UseCandidate(const IceCandidateInterface* candidate);
- RTCErrorOr<const cricket::ContentInfo*> FindContentInfo(
- const SessionDescriptionInterface* description,
- const IceCandidateInterface* candidate) RTC_RUN_ON(signaling_thread());
- // Deletes the corresponding channel of contents that don't exist in |desc|.
- // |desc| can be null. This means that all channels are deleted.
- void RemoveUnusedChannels(const cricket::SessionDescription* desc);
- // Allocates media channels based on the |desc|. If |desc| doesn't have
- // the BUNDLE option, this method will disable BUNDLE in PortAllocator.
- // This method will also delete any existing media channels before creating.
- RTCError CreateChannels(const cricket::SessionDescription& desc);
- // Helper methods to create media channels.
- cricket::VoiceChannel* CreateVoiceChannel(const std::string& mid);
- cricket::VideoChannel* CreateVideoChannel(const std::string& mid);
- bool CreateDataChannel(const std::string& mid);
- bool SetupDataChannelTransport_n(const std::string& mid)
- RTC_RUN_ON(network_thread());
- void TeardownDataChannelTransport_n() RTC_RUN_ON(network_thread());
- bool ValidateBundleSettings(const cricket::SessionDescription* desc);
- bool HasRtcpMuxEnabled(const cricket::ContentInfo* content);
- // Verifies a=setup attribute as per RFC 5763.
- bool ValidateDtlsSetupAttribute(const cricket::SessionDescription* desc,
- SdpType type);
- // Returns true if we are ready to push down the remote candidate.
- // |remote_desc| is the new remote description, or NULL if the current remote
- // description should be used. Output |valid| is true if the candidate media
- // index is valid.
- bool ReadyToUseRemoteCandidate(const IceCandidateInterface* candidate,
- const SessionDescriptionInterface* remote_desc,
- bool* valid);
- // Returns true if SRTP (either using DTLS-SRTP or SDES) is required by
- // this session.
- bool SrtpRequired() const RTC_RUN_ON(signaling_thread());
- // JsepTransportController signal handlers.
- void OnTransportControllerConnectionState(cricket::IceConnectionState state)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerGatheringState(cricket::IceGatheringState state)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerCandidatesGathered(
- const std::string& transport_name,
- const std::vector<cricket::Candidate>& candidates)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerCandidateError(
- const cricket::IceCandidateErrorEvent& event)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerCandidatesRemoved(
- const std::vector<cricket::Candidate>& candidates)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerCandidateChanged(
- const cricket::CandidatePairChangeEvent& event)
- RTC_RUN_ON(signaling_thread());
- void OnTransportControllerDtlsHandshakeError(rtc::SSLHandshakeError error);
- const char* SessionErrorToString(SessionError error) const;
- std::string GetSessionErrorMsg();
- // Report the UMA metric SdpFormatReceived for the given remote offer.
- void ReportSdpFormatReceived(const SessionDescriptionInterface& remote_offer);
- // Report inferred negotiated SDP semantics from a local/remote answer to the
- // UMA observer.
- void ReportNegotiatedSdpSemantics(const SessionDescriptionInterface& answer);
- // Invoked when TransportController connection completion is signaled.
- // Reports stats for all transports in use.
- void ReportTransportStats() RTC_RUN_ON(signaling_thread());
- // Gather the usage of IPv4/IPv6 as best connection.
- void ReportBestConnectionState(const cricket::TransportStats& stats);
- void ReportNegotiatedCiphers(const cricket::TransportStats& stats,
- const std::set<cricket::MediaType>& media_types)
- RTC_RUN_ON(signaling_thread());
- void ReportIceCandidateCollected(const cricket::Candidate& candidate)
- RTC_RUN_ON(signaling_thread());
- void ReportRemoteIceCandidateAdded(const cricket::Candidate& candidate)
- RTC_RUN_ON(signaling_thread());
- void NoteUsageEvent(UsageEvent event);
- void ReportUsagePattern() const RTC_RUN_ON(signaling_thread());
- void OnSentPacket_w(const rtc::SentPacket& sent_packet);
- const std::string GetTransportName(const std::string& content_name)
- RTC_RUN_ON(signaling_thread());
- // Functions for dealing with transports.
- // Note that cricket code uses the term "channel" for what other code
- // refers to as "transport".
- // Destroys and clears the BaseChannel associated with the given transceiver,
- // if such channel is set.
- void DestroyTransceiverChannel(
- rtc::scoped_refptr<RtpTransceiverProxyWithInternal<RtpTransceiver>>
- transceiver);
- // Destroys the RTP data channel transport and/or the SCTP data channel
- // transport and clears it.
- void DestroyDataChannelTransport();
- // Destroys the given ChannelInterface.
- // The channel cannot be accessed after this method is called.
- void DestroyChannelInterface(cricket::ChannelInterface* channel);
- // JsepTransportController::Observer override.
- //
- // Called by |transport_controller_| when processing transport information
- // from a session description, and the mapping from m= sections to transports
- // changed (as a result of BUNDLE negotiation, or m= sections being
- // rejected).
- bool OnTransportChanged(
- const std::string& mid,
- RtpTransportInternal* rtp_transport,
- rtc::scoped_refptr<DtlsTransport> dtls_transport,
- DataChannelTransportInterface* data_channel_transport) override;
- // RtpSenderBase::SetStreamsObserver override.
- void OnSetStreams() override;
- // Returns the CryptoOptions for this PeerConnection. This will always
- // return the RTCConfiguration.crypto_options if set and will only default
- // back to the PeerConnectionFactory settings if nothing was set.
- CryptoOptions GetCryptoOptions();
- // Returns rtp transport, result can not be nullptr.
- RtpTransportInternal* GetRtpTransport(const std::string& mid)
- RTC_RUN_ON(signaling_thread()) {
- auto rtp_transport = transport_controller_->GetRtpTransport(mid);
- RTC_DCHECK(rtp_transport);
- return rtp_transport;
- }
- std::function<void(const rtc::CopyOnWriteBuffer& packet,
- int64_t packet_time_us)>
- InitializeRtcpCallback();
- // Storing the factory as a scoped reference pointer ensures that the memory
- // in the PeerConnectionFactoryImpl remains available as long as the
- // PeerConnection is running. It is passed to PeerConnection as a raw pointer.
- // However, since the reference counting is done in the
- // PeerConnectionFactoryInterface all instances created using the raw pointer
- // will refer to the same reference count.
- const rtc::scoped_refptr<PeerConnectionFactory> factory_;
- PeerConnectionObserver* observer_ RTC_GUARDED_BY(signaling_thread()) =
- nullptr;
- // The EventLog needs to outlive |call_| (and any other object that uses it).
- std::unique_ptr<RtcEventLog> event_log_ RTC_GUARDED_BY(worker_thread());
- // Points to the same thing as `event_log_`. Since it's const, we may read the
- // pointer (but not touch the object) from any thread.
- RtcEventLog* const event_log_ptr_ RTC_PT_GUARDED_BY(worker_thread());
- IceConnectionState ice_connection_state_ RTC_GUARDED_BY(signaling_thread()) =
- kIceConnectionNew;
- PeerConnectionInterface::IceConnectionState standardized_ice_connection_state_
- RTC_GUARDED_BY(signaling_thread()) = kIceConnectionNew;
- PeerConnectionInterface::PeerConnectionState connection_state_
- RTC_GUARDED_BY(signaling_thread()) = PeerConnectionState::kNew;
- IceGatheringState ice_gathering_state_ RTC_GUARDED_BY(signaling_thread()) =
- kIceGatheringNew;
- PeerConnectionInterface::RTCConfiguration configuration_
- RTC_GUARDED_BY(signaling_thread());
- // TODO(zstein): |async_resolver_factory_| can currently be nullptr if it
- // is not injected. It should be required once chromium supplies it.
- std::unique_ptr<AsyncResolverFactory> async_resolver_factory_
- RTC_GUARDED_BY(signaling_thread());
- std::unique_ptr<rtc::PacketSocketFactory> packet_socket_factory_;
- std::unique_ptr<cricket::PortAllocator>
- port_allocator_; // TODO(bugs.webrtc.org/9987): Accessed on both
- // signaling and network thread.
- std::unique_ptr<webrtc::IceTransportFactory>
- ice_transport_factory_; // TODO(bugs.webrtc.org/9987): Accessed on the
- // signaling thread but the underlying raw
- // pointer is given to
- // |jsep_transport_controller_| and used on the
- // network thread.
- std::unique_ptr<rtc::SSLCertificateVerifier>
- tls_cert_verifier_; // TODO(bugs.webrtc.org/9987): Accessed on both
- // signaling and network thread.
- // One PeerConnection has only one RTCP CNAME.
- // https://tools.ietf.org/html/draft-ietf-rtcweb-rtp-usage-26#section-4.9
- const std::string rtcp_cname_;
- // Streams added via AddStream.
- const rtc::scoped_refptr<StreamCollection> local_streams_
- RTC_GUARDED_BY(signaling_thread());
- // Streams created as a result of SetRemoteDescription.
- const rtc::scoped_refptr<StreamCollection> remote_streams_
- RTC_GUARDED_BY(signaling_thread());
- std::vector<std::unique_ptr<MediaStreamObserver>> stream_observers_
- RTC_GUARDED_BY(signaling_thread());
- // These lists store sender info seen in local/remote descriptions.
- std::vector<RtpSenderInfo> remote_audio_sender_infos_
- RTC_GUARDED_BY(signaling_thread());
- std::vector<RtpSenderInfo> remote_video_sender_infos_
- RTC_GUARDED_BY(signaling_thread());
- std::vector<RtpSenderInfo> local_audio_sender_infos_
- RTC_GUARDED_BY(signaling_thread());
- std::vector<RtpSenderInfo> local_video_sender_infos_
- RTC_GUARDED_BY(signaling_thread());
- // The unique_ptr belongs to the worker thread, but the Call object manages
- // its own thread safety.
- std::unique_ptr<Call> call_ RTC_GUARDED_BY(worker_thread());
- std::unique_ptr<ScopedTaskSafety> call_safety_
- RTC_GUARDED_BY(worker_thread());
- // Points to the same thing as `call_`. Since it's const, we may read the
- // pointer from any thread.
- // TODO(bugs.webrtc.org/11992): Remove this workaround (and potential dangling
- // pointer).
- Call* const call_ptr_;
- std::unique_ptr<StatsCollector> stats_
- RTC_GUARDED_BY(signaling_thread()); // A pointer is passed to senders_
- rtc::scoped_refptr<RTCStatsCollector> stats_collector_
- RTC_GUARDED_BY(signaling_thread());
- TransceiverList transceivers_;
- // MIDs will be generated using this generator which will keep track of
- // all the MIDs that have been seen over the life of the PeerConnection.
- rtc::UniqueStringGenerator mid_generator_ RTC_GUARDED_BY(signaling_thread());
- SessionError session_error_ RTC_GUARDED_BY(signaling_thread()) =
- SessionError::kNone;
- std::string session_error_desc_ RTC_GUARDED_BY(signaling_thread());
- std::string session_id_ RTC_GUARDED_BY(signaling_thread());
- std::unique_ptr<JsepTransportController>
- transport_controller_; // TODO(bugs.webrtc.org/9987): Accessed on both
- // signaling and network thread.
- // |sctp_mid_| is the content name (MID) in SDP.
- // Note: this is used as the data channel MID by both SCTP and data channel
- // transports. It is set when either transport is initialized and unset when
- // both transports are deleted.
- // There is one copy on the signaling thread and another copy on the
- // networking thread. Changes are always initiated from the signaling
- // thread, but applied first on the networking thread via an invoke().
- absl::optional<std::string> sctp_mid_s_ RTC_GUARDED_BY(signaling_thread());
- absl::optional<std::string> sctp_mid_n_ RTC_GUARDED_BY(network_thread());
- // The machinery for handling offers and answers.
- SdpOfferAnswerHandler sdp_handler_ RTC_GUARDED_BY(signaling_thread());
- bool dtls_enabled_ RTC_GUARDED_BY(signaling_thread()) = false;
- // Member variables for caching global options.
- cricket::AudioOptions audio_options_ RTC_GUARDED_BY(signaling_thread());
- cricket::VideoOptions video_options_ RTC_GUARDED_BY(signaling_thread());
- int usage_event_accumulator_ RTC_GUARDED_BY(signaling_thread()) = 0;
- bool return_histogram_very_quickly_ RTC_GUARDED_BY(signaling_thread()) =
- false;
- // This object should be used to generate any SSRC that is not explicitly
- // specified by the user (or by the remote party).
- // The generator is not used directly, instead it is passed on to the
- // channel manager and the session description factory.
- rtc::UniqueRandomIdGenerator ssrc_generator_
- RTC_GUARDED_BY(signaling_thread());
- // A video bitrate allocator factory.
- // This can injected using the PeerConnectionDependencies,
- // or else the CreateBuiltinVideoBitrateAllocatorFactory() will be called.
- // Note that one can still choose to override this in a MediaEngine
- // if one wants too.
- std::unique_ptr<webrtc::VideoBitrateAllocatorFactory>
- video_bitrate_allocator_factory_;
- DataChannelController data_channel_controller_;
- };
- } // namespace webrtc
- #endif // PC_PEER_CONNECTION_H_
|