blob: 1cd26652af498ea63d4c258c2023ea0223542e93 [file] [log] [blame]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001/*
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
buildbot@webrtc.org41451d42014-05-03 05:39:45 +000060 bool Initialize(
61 const PeerConnectionInterface::RTCConfiguration& configuration,
62 const MediaConstraintsInterface* constraints,
63 PortAllocatorFactoryInterface* allocator_factory,
64 DTLSIdentityServiceInterface* dtls_identity_service,
65 PeerConnectionObserver* observer);
henrike@webrtc.org28e20752013-07-10 00:45:36 +000066 virtual talk_base::scoped_refptr<StreamCollectionInterface> local_streams();
67 virtual talk_base::scoped_refptr<StreamCollectionInterface> remote_streams();
68 virtual bool AddStream(MediaStreamInterface* local_stream,
69 const MediaConstraintsInterface* constraints);
70 virtual void RemoveStream(MediaStreamInterface* local_stream);
71
72 virtual talk_base::scoped_refptr<DtmfSenderInterface> CreateDtmfSender(
73 AudioTrackInterface* track);
74
75 virtual talk_base::scoped_refptr<DataChannelInterface> CreateDataChannel(
76 const std::string& label,
77 const DataChannelInit* config);
78 virtual bool GetStats(StatsObserver* observer,
wu@webrtc.orgb9a088b2014-02-13 23:18:49 +000079 webrtc::MediaStreamTrackInterface* track,
80 StatsOutputLevel level);
henrike@webrtc.org28e20752013-07-10 00:45:36 +000081
82 virtual SignalingState signaling_state();
83
84 // TODO(bemasc): Remove ice_state() when callers are removed.
85 virtual IceState ice_state();
86 virtual IceConnectionState ice_connection_state();
87 virtual IceGatheringState ice_gathering_state();
88
89 virtual const SessionDescriptionInterface* local_description() const;
90 virtual const SessionDescriptionInterface* remote_description() const;
91
92 // JSEP01
93 virtual void CreateOffer(CreateSessionDescriptionObserver* observer,
94 const MediaConstraintsInterface* constraints);
95 virtual void CreateAnswer(CreateSessionDescriptionObserver* observer,
96 const MediaConstraintsInterface* constraints);
97 virtual void SetLocalDescription(SetSessionDescriptionObserver* observer,
98 SessionDescriptionInterface* desc);
99 virtual void SetRemoteDescription(SetSessionDescriptionObserver* observer,
100 SessionDescriptionInterface* desc);
buildbot@webrtc.org41451d42014-05-03 05:39:45 +0000101 // TODO(mallinath) : Deprecated version, remove after all clients are updated.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000102 virtual bool UpdateIce(const IceServers& configuration,
103 const MediaConstraintsInterface* constraints);
buildbot@webrtc.org41451d42014-05-03 05:39:45 +0000104 virtual bool UpdateIce(
105 const PeerConnectionInterface::RTCConfiguration& config);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000106 virtual bool AddIceCandidate(const IceCandidateInterface* candidate);
107
108 virtual void Close();
109
110 protected:
111 virtual ~PeerConnection();
112
113 private:
114 // Implements MessageHandler.
115 virtual void OnMessage(talk_base::Message* msg);
116
117 // Implements MediaStreamSignalingObserver.
118 virtual void OnAddRemoteStream(MediaStreamInterface* stream) OVERRIDE;
119 virtual void OnRemoveRemoteStream(MediaStreamInterface* stream) OVERRIDE;
120 virtual void OnAddDataChannel(DataChannelInterface* data_channel) OVERRIDE;
121 virtual void OnAddRemoteAudioTrack(MediaStreamInterface* stream,
122 AudioTrackInterface* audio_track,
123 uint32 ssrc) OVERRIDE;
124 virtual void OnAddRemoteVideoTrack(MediaStreamInterface* stream,
125 VideoTrackInterface* video_track,
126 uint32 ssrc) OVERRIDE;
127 virtual void OnRemoveRemoteAudioTrack(
128 MediaStreamInterface* stream,
129 AudioTrackInterface* audio_track) OVERRIDE;
130 virtual void OnRemoveRemoteVideoTrack(
131 MediaStreamInterface* stream,
132 VideoTrackInterface* video_track) OVERRIDE;
133 virtual void OnAddLocalAudioTrack(MediaStreamInterface* stream,
134 AudioTrackInterface* audio_track,
135 uint32 ssrc) OVERRIDE;
136 virtual void OnAddLocalVideoTrack(MediaStreamInterface* stream,
137 VideoTrackInterface* video_track,
138 uint32 ssrc) OVERRIDE;
139 virtual void OnRemoveLocalAudioTrack(
140 MediaStreamInterface* stream,
henrike@webrtc.org40b3b682014-03-03 18:30:11 +0000141 AudioTrackInterface* audio_track,
142 uint32 ssrc) OVERRIDE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000143 virtual void OnRemoveLocalVideoTrack(
144 MediaStreamInterface* stream,
145 VideoTrackInterface* video_track) OVERRIDE;
146 virtual void OnRemoveLocalStream(MediaStreamInterface* stream);
147
148 // Implements IceObserver
149 virtual void OnIceConnectionChange(IceConnectionState new_state);
150 virtual void OnIceGatheringChange(IceGatheringState new_state);
151 virtual void OnIceCandidate(const IceCandidateInterface* candidate);
152 virtual void OnIceComplete();
153
154 // Signals from WebRtcSession.
155 void OnSessionStateChange(cricket::BaseSession* session,
156 cricket::BaseSession::State state);
157 void ChangeSignalingState(SignalingState signaling_state);
158
buildbot@webrtc.org41451d42014-05-03 05:39:45 +0000159 bool DoInitialize(IceTransportsType type,
160 const StunConfigurations& stun_config,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000161 const TurnConfigurations& turn_config,
162 const MediaConstraintsInterface* constraints,
wu@webrtc.org91053e72013-08-10 07:18:04 +0000163 PortAllocatorFactoryInterface* allocator_factory,
164 DTLSIdentityServiceInterface* dtls_identity_service,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000165 PeerConnectionObserver* observer);
166
167 talk_base::Thread* signaling_thread() const {
168 return factory_->signaling_thread();
169 }
170
171 void PostSetSessionDescriptionFailure(SetSessionDescriptionObserver* observer,
172 const std::string& error);
173
174 bool IsClosed() const {
175 return signaling_state_ == PeerConnectionInterface::kClosed;
176 }
177
178 // Storing the factory as a scoped reference pointer ensures that the memory
179 // in the PeerConnectionFactoryImpl remains available as long as the
180 // PeerConnection is running. It is passed to PeerConnection as a raw pointer.
181 // However, since the reference counting is done in the
182 // PeerConnectionFactoryInteface all instances created using the raw pointer
183 // will refer to the same reference count.
184 talk_base::scoped_refptr<PeerConnectionFactory> factory_;
185 PeerConnectionObserver* observer_;
186 SignalingState signaling_state_;
187 // TODO(bemasc): Remove ice_state_.
188 IceState ice_state_;
189 IceConnectionState ice_connection_state_;
190 IceGatheringState ice_gathering_state_;
191
192 talk_base::scoped_ptr<cricket::PortAllocator> port_allocator_;
193 talk_base::scoped_ptr<WebRtcSession> session_;
194 talk_base::scoped_ptr<MediaStreamSignaling> mediastream_signaling_;
195 talk_base::scoped_ptr<MediaStreamHandlerContainer> stream_handler_container_;
196 StatsCollector stats_;
197};
198
199} // namespace webrtc
200
201#endif // TALK_APP_WEBRTC_PEERCONNECTION_H_