1/* 2 * Copyright (C) 2012 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * 3. Neither the name of Google Inc. nor the names of its contributors 15 * may be used to endorse or promote products derived from this 16 * software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31[ 32 GarbageCollected, 33 ActiveDOMObject, 34 Constructor(Dictionary rtcConfiguration, optional Dictionary mediaConstraints), 35 ConstructorCallWith=ExecutionContext, 36 NoInterfaceObject, 37 RaisesException=Constructor, 38] interface RTCPeerConnection : EventTarget { 39 [RaisesException] void createOffer(RTCSessionDescriptionCallback successCallback, [Default=Undefined] optional RTCErrorCallback failureCallback, optional Dictionary rtcOfferOptions); 40 41 [RaisesException] void createAnswer(RTCSessionDescriptionCallback successCallback, [Default=Undefined] optional RTCErrorCallback failureCallback, optional Dictionary mediaConstraints); 42 43 [RaisesException] void setLocalDescription(RTCSessionDescription description, [Default=Undefined] optional VoidCallback successCallback, [Default=Undefined] optional RTCErrorCallback failureCallback); 44 [RaisesException=Getter] readonly attribute RTCSessionDescription localDescription; 45 46 [RaisesException] void setRemoteDescription(RTCSessionDescription description, [Default=Undefined] optional VoidCallback successCallback, [Default=Undefined] optional RTCErrorCallback failureCallback); 47 [RaisesException=Getter] readonly attribute RTCSessionDescription remoteDescription; 48 49 readonly attribute DOMString signalingState; 50 51 [RaisesException] void updateIce(optional Dictionary configuration, optional Dictionary mediaConstraints); 52 53 // DEPRECATED 54 [RaisesException] void addIceCandidate(RTCIceCandidate candidate); 55 56 [RaisesException] void addIceCandidate(RTCIceCandidate candidate, VoidCallback successCallback, RTCErrorCallback failureCallback); 57 58 readonly attribute DOMString iceGatheringState; 59 readonly attribute DOMString iceConnectionState; 60 61 sequence<MediaStream> getLocalStreams(); 62 sequence<MediaStream> getRemoteStreams(); 63 MediaStream getStreamById(DOMString streamId); 64 65 [TypeChecking=Interface, RaisesException] void addStream(MediaStream? stream, optional Dictionary mediaConstraints); 66 [TypeChecking=Interface, RaisesException] void removeStream(MediaStream? stream); 67 68 void getStats(RTCStatsCallback successCallback, [Default=Undefined] optional MediaStreamTrack selector); 69 70 [RaisesException] RTCDataChannel createDataChannel([TreatUndefinedAs=NullString] DOMString? label, optional Dictionary options); 71 72 [RaisesException] RTCDTMFSender createDTMFSender(MediaStreamTrack track); 73 74 [RaisesException] void close(); 75 76 attribute EventHandler onnegotiationneeded; 77 attribute EventHandler onicecandidate; 78 attribute EventHandler onsignalingstatechange; 79 attribute EventHandler onaddstream; 80 attribute EventHandler onremovestream; 81 attribute EventHandler oniceconnectionstatechange; 82 attribute EventHandler ondatachannel; 83}; 84