Note: We no longer publish the latest version of our code here. We primarily use a kumc-bmi github organization. The heron ETL repository, in particular, is not public. Peers in the informatics community should see MultiSiteDev for details on requesting access.

source: webrtc/talk/app/webrtc/peerconnection.h @ 0:4bda6873e34c

pub_scrub_3792 tip
Last change on this file since 0:4bda6873e34c was 0:4bda6873e34c, checked in by Michael Prittie <mprittie@…>, 6 years ago

Scrubbed password for publication.

File size: 8.7 KB
Line 
1/*
2 * libjingle
3 * Copyright 2012, Google Inc.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are met:
7 *
8 *  1. Redistributions of source code must retain the above copyright notice,
9 *     this list of conditions and the following disclaimer.
10 *  2. Redistributions in binary form must reproduce the above copyright notice,
11 *     this list of conditions and the following disclaimer in the documentation
12 *     and/or other materials provided with the distribution.
13 *  3. The name of the author may not be used to endorse or promote products
14 *     derived from this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 */
27
28#ifndef TALK_APP_WEBRTC_PEERCONNECTION_H_
29#define TALK_APP_WEBRTC_PEERCONNECTION_H_
30
31#include <string>
32
33#include "talk/app/webrtc/mediastreamsignaling.h"
34#include "talk/app/webrtc/peerconnectioninterface.h"
35#include "talk/app/webrtc/peerconnectionfactory.h"
36#include "talk/app/webrtc/statscollector.h"
37#include "talk/app/webrtc/streamcollection.h"
38#include "talk/app/webrtc/webrtcsession.h"
39#include "talk/base/scoped_ptr.h"
40
41namespace webrtc {
42class MediaStreamHandlerContainer;
43
44typedef std::vector<PortAllocatorFactoryInterface::StunConfiguration>
45    StunConfigurations;
46typedef std::vector<PortAllocatorFactoryInterface::TurnConfiguration>
47    TurnConfigurations;
48
49// PeerConnectionImpl implements the PeerConnection interface.
50// It uses MediaStreamSignaling and WebRtcSession to implement
51// the PeerConnection functionality.
52class PeerConnection : public PeerConnectionInterface,
53                       public MediaStreamSignalingObserver,
54                       public IceObserver,
55                       public talk_base::MessageHandler,
56                       public sigslot::has_slots<> {
57 public:
58  explicit PeerConnection(PeerConnectionFactory* factory);
59
60  bool Initialize(const PeerConnectionInterface::IceServers& configuration,
61                  const MediaConstraintsInterface* constraints,
62                  PortAllocatorFactoryInterface* allocator_factory,
63                  DTLSIdentityServiceInterface* dtls_identity_service,
64                  PeerConnectionObserver* observer);
65  virtual talk_base::scoped_refptr<StreamCollectionInterface> local_streams();
66  virtual talk_base::scoped_refptr<StreamCollectionInterface> remote_streams();
67  virtual bool AddStream(MediaStreamInterface* local_stream,
68                         const MediaConstraintsInterface* constraints);
69  virtual void RemoveStream(MediaStreamInterface* local_stream);
70
71  virtual talk_base::scoped_refptr<DtmfSenderInterface> CreateDtmfSender(
72      AudioTrackInterface* track);
73
74  virtual talk_base::scoped_refptr<DataChannelInterface> CreateDataChannel(
75      const std::string& label,
76      const DataChannelInit* config);
77  virtual bool GetStats(StatsObserver* observer,
78                        webrtc::MediaStreamTrackInterface* track);
79
80  virtual SignalingState signaling_state();
81
82  // TODO(bemasc): Remove ice_state() when callers are removed.
83  virtual IceState ice_state();
84  virtual IceConnectionState ice_connection_state();
85  virtual IceGatheringState ice_gathering_state();
86
87  virtual const SessionDescriptionInterface* local_description() const;
88  virtual const SessionDescriptionInterface* remote_description() const;
89
90  // JSEP01
91  virtual void CreateOffer(CreateSessionDescriptionObserver* observer,
92                           const MediaConstraintsInterface* constraints);
93  virtual void CreateAnswer(CreateSessionDescriptionObserver* observer,
94                            const MediaConstraintsInterface* constraints);
95  virtual void SetLocalDescription(SetSessionDescriptionObserver* observer,
96                                   SessionDescriptionInterface* desc);
97  virtual void SetRemoteDescription(SetSessionDescriptionObserver* observer,
98                                    SessionDescriptionInterface* desc);
99  virtual bool UpdateIce(const IceServers& configuration,
100                         const MediaConstraintsInterface* constraints);
101  virtual bool AddIceCandidate(const IceCandidateInterface* candidate);
102
103  virtual void Close();
104
105 protected:
106  virtual ~PeerConnection();
107
108 private:
109  // Implements MessageHandler.
110  virtual void OnMessage(talk_base::Message* msg);
111
112  // Implements MediaStreamSignalingObserver.
113  virtual void OnAddRemoteStream(MediaStreamInterface* stream) OVERRIDE;
114  virtual void OnRemoveRemoteStream(MediaStreamInterface* stream) OVERRIDE;
115  virtual void OnAddDataChannel(DataChannelInterface* data_channel) OVERRIDE;
116  virtual void OnAddRemoteAudioTrack(MediaStreamInterface* stream,
117                                     AudioTrackInterface* audio_track,
118                                     uint32 ssrc) OVERRIDE;
119  virtual void OnAddRemoteVideoTrack(MediaStreamInterface* stream,
120                                     VideoTrackInterface* video_track,
121                                     uint32 ssrc) OVERRIDE;
122  virtual void OnRemoveRemoteAudioTrack(
123      MediaStreamInterface* stream,
124      AudioTrackInterface* audio_track) OVERRIDE;
125  virtual void OnRemoveRemoteVideoTrack(
126      MediaStreamInterface* stream,
127      VideoTrackInterface* video_track) OVERRIDE;
128  virtual void OnAddLocalAudioTrack(MediaStreamInterface* stream,
129                                    AudioTrackInterface* audio_track,
130                                    uint32 ssrc) OVERRIDE;
131  virtual void OnAddLocalVideoTrack(MediaStreamInterface* stream,
132                                    VideoTrackInterface* video_track,
133                                    uint32 ssrc) OVERRIDE;
134  virtual void OnRemoveLocalAudioTrack(
135      MediaStreamInterface* stream,
136      AudioTrackInterface* audio_track) OVERRIDE;
137  virtual void OnRemoveLocalVideoTrack(
138      MediaStreamInterface* stream,
139      VideoTrackInterface* video_track) OVERRIDE;
140  virtual void OnRemoveLocalStream(MediaStreamInterface* stream);
141
142  // Implements IceObserver
143  virtual void OnIceConnectionChange(IceConnectionState new_state);
144  virtual void OnIceGatheringChange(IceGatheringState new_state);
145  virtual void OnIceCandidate(const IceCandidateInterface* candidate);
146  virtual void OnIceComplete();
147
148  // Signals from WebRtcSession.
149  void OnSessionStateChange(cricket::BaseSession* session,
150                            cricket::BaseSession::State state);
151  void ChangeSignalingState(SignalingState signaling_state);
152
153  bool DoInitialize(const StunConfigurations& stun_config,
154                    const TurnConfigurations& turn_config,
155                    const MediaConstraintsInterface* constraints,
156                    PortAllocatorFactoryInterface* allocator_factory,
157                    DTLSIdentityServiceInterface* dtls_identity_service,
158                    PeerConnectionObserver* observer);
159
160  talk_base::Thread* signaling_thread() const {
161    return factory_->signaling_thread();
162  }
163
164  void PostSetSessionDescriptionFailure(SetSessionDescriptionObserver* observer,
165                                        const std::string& error);
166
167  bool IsClosed() const {
168    return signaling_state_ == PeerConnectionInterface::kClosed;
169  }
170
171  // Storing the factory as a scoped reference pointer ensures that the memory
172  // in the PeerConnectionFactoryImpl remains available as long as the
173  // PeerConnection is running. It is passed to PeerConnection as a raw pointer.
174  // However, since the reference counting is done in the
175  // PeerConnectionFactoryInteface all instances created using the raw pointer
176  // will refer to the same reference count.
177  talk_base::scoped_refptr<PeerConnectionFactory> factory_;
178  PeerConnectionObserver* observer_;
179  SignalingState signaling_state_;
180  // TODO(bemasc): Remove ice_state_.
181  IceState ice_state_;
182  IceConnectionState ice_connection_state_;
183  IceGatheringState ice_gathering_state_;
184
185  talk_base::scoped_ptr<cricket::PortAllocator> port_allocator_;
186  talk_base::scoped_ptr<WebRtcSession> session_;
187  talk_base::scoped_ptr<MediaStreamSignaling> mediastream_signaling_;
188  talk_base::scoped_ptr<MediaStreamHandlerContainer> stream_handler_container_;
189  StatsCollector stats_;
190};
191
192}  // namespace webrtc
193
194#endif  // TALK_APP_WEBRTC_PEERCONNECTION_H_
Note: See TracBrowser for help on using the repository browser.