mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-30 21:55:31 +00:00
116 lines
4.5 KiB
Plaintext
116 lines
4.5 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*
|
|
* The origin of this IDL file is
|
|
* http://dev.w3.org/2011/webrtc/editor/webrtc.html#idl-def-RTCPeerConnection
|
|
*/
|
|
|
|
callback RTCSessionDescriptionCallback = void (mozRTCSessionDescription sdp);
|
|
callback RTCPeerConnectionErrorCallback = void (DOMString errorInformation);
|
|
callback VoidFunction = void ();
|
|
|
|
enum RTCSignalingState {
|
|
"stable",
|
|
"have-local-offer",
|
|
"have-remote-offer",
|
|
"have-local-pranswer",
|
|
"have-remote-pranswer",
|
|
"closed"
|
|
};
|
|
|
|
enum RTCIceGatheringState {
|
|
"new",
|
|
"gathering",
|
|
"complete"
|
|
};
|
|
|
|
enum RTCIceConnectionState {
|
|
"new",
|
|
"checking",
|
|
"connected",
|
|
"completed",
|
|
"failed",
|
|
"disconnected",
|
|
"closed"
|
|
};
|
|
|
|
dictionary RTCDataChannelInit {
|
|
boolean ordered = true;
|
|
unsigned short? maxRetransmitTime = null;
|
|
unsigned short? maxRetransmits = null;
|
|
DOMString protocol = "";
|
|
boolean negotiated = false; // spec currently says 'true'; we disagree
|
|
unsigned short? id = null;
|
|
|
|
// these are deprecated due to renaming in the spec, but still supported for Fx22
|
|
boolean outOfOrderAllowed; // now ordered, and the default changes to keep behavior the same
|
|
unsigned short maxRetransmitNum; // now maxRetransmits
|
|
boolean preset; // now negotiated
|
|
unsigned short stream; // now id
|
|
};
|
|
|
|
interface RTCDataChannel;
|
|
|
|
[Pref="media.peerconnection.enabled",
|
|
JSImplementation="@mozilla.org/dom/peerconnection;1",
|
|
Constructor (optional RTCConfiguration configuration,
|
|
optional object? constraints)]
|
|
// moz-prefixed until sufficiently standardized.
|
|
interface mozRTCPeerConnection : EventTarget {
|
|
void createOffer (RTCSessionDescriptionCallback successCallback,
|
|
RTCPeerConnectionErrorCallback? failureCallback, // for apprtc
|
|
optional object? constraints);
|
|
void createAnswer (RTCSessionDescriptionCallback successCallback,
|
|
RTCPeerConnectionErrorCallback? failureCallback, // for apprtc
|
|
optional object? constraints);
|
|
void setLocalDescription (mozRTCSessionDescription description,
|
|
optional VoidFunction successCallback,
|
|
optional RTCPeerConnectionErrorCallback failureCallback);
|
|
void setRemoteDescription (mozRTCSessionDescription description,
|
|
optional VoidFunction successCallback,
|
|
optional RTCPeerConnectionErrorCallback failureCallback);
|
|
readonly attribute mozRTCSessionDescription? localDescription;
|
|
readonly attribute mozRTCSessionDescription? remoteDescription;
|
|
readonly attribute RTCSignalingState signalingState;
|
|
void updateIce (optional RTCConfiguration configuration,
|
|
optional object? constraints);
|
|
void addIceCandidate (mozRTCIceCandidate candidate,
|
|
optional VoidFunction successCallback,
|
|
optional RTCPeerConnectionErrorCallback failureCallback);
|
|
readonly attribute RTCIceGatheringState iceGatheringState;
|
|
readonly attribute RTCIceConnectionState iceConnectionState;
|
|
sequence<MediaStream> getLocalStreams ();
|
|
sequence<MediaStream> getRemoteStreams ();
|
|
MediaStream? getStreamById (DOMString streamId);
|
|
void addStream (MediaStream stream, optional object? constraints);
|
|
void removeStream (MediaStream stream);
|
|
void close ();
|
|
attribute EventHandler onnegotiationneeded;
|
|
attribute EventHandler onicecandidate;
|
|
attribute EventHandler onsignalingstatechange;
|
|
attribute EventHandler onaddstream;
|
|
attribute EventHandler onremovestream;
|
|
attribute EventHandler oniceconnectionstatechange;
|
|
};
|
|
|
|
// Mozilla extensions.
|
|
partial interface mozRTCPeerConnection {
|
|
// Deprecated callbacks (use causes warning)
|
|
attribute RTCPeerConnectionErrorCallback onicechange;
|
|
attribute RTCPeerConnectionErrorCallback ongatheringchange;
|
|
|
|
// Deprecated attributes (use causes warning)
|
|
readonly attribute object localStreams;
|
|
readonly attribute object remoteStreams;
|
|
readonly attribute DOMString readyState;
|
|
|
|
// Data channel.
|
|
RTCDataChannel createDataChannel (DOMString label,
|
|
optional RTCDataChannelInit dataChannelDict);
|
|
attribute EventHandler ondatachannel;
|
|
attribute EventHandler onconnection;
|
|
attribute EventHandler onclosedconnection;
|
|
};
|