diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-07 19:33:14 +0000 |
commit | 36d22d82aa202bb199967e9512281e9a53db42c9 (patch) | |
tree | 105e8c98ddea1c1e4784a60a5a6410fa416be2de /dom/webidl/PeerConnectionImpl.webidl | |
parent | Initial commit. (diff) | |
download | firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip |
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | dom/webidl/PeerConnectionImpl.webidl | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/dom/webidl/PeerConnectionImpl.webidl b/dom/webidl/PeerConnectionImpl.webidl new file mode 100644 index 0000000000..5b59b629e5 --- /dev/null +++ b/dom/webidl/PeerConnectionImpl.webidl @@ -0,0 +1,134 @@ +/* -*- 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/. + * + * PeerConnection.js' interface to the C++ PeerConnectionImpl. + * + * Do not confuse with RTCPeerConnection. This interface is purely for + * communication between the PeerConnection JS DOM binding and the C++ + * implementation. + * + * See media/webrtc/signaling/include/PeerConnectionImpl.h + * + */ + +interface nsISupports; + +callback ChainedOperation = Promise<any> (); + +/* Must be created first. Observer events will be dispatched on the thread provided */ +[ChromeOnly, + Exposed=Window] +interface PeerConnectionImpl { + constructor(); + + /* Must be called first. Observer events dispatched on the thread provided */ + [Throws] + undefined initialize(PeerConnectionObserver observer, Window window); + + /* JSEP calls */ + [Throws] + undefined createOffer(optional RTCOfferOptions options = {}); + [Throws] + undefined createAnswer(); + [Throws] + undefined setLocalDescription(long action, DOMString sdp); + [Throws] + undefined setRemoteDescription(long action, DOMString sdp); + + Promise<RTCStatsReport> getStats(MediaStreamTrack? selector); + + sequence<MediaStream> getRemoteStreams(); + + /* Adds the tracks created by GetUserMedia */ + [Throws] + RTCRtpTransceiver addTransceiver(RTCRtpTransceiverInit init, + DOMString kind, + MediaStreamTrack? sendTrack, + boolean addTrackMagic); + sequence<RTCRtpTransceiver> getTransceivers(); + + [Throws] + undefined closeStreams(); + + [Throws] + undefined enablePacketDump(unsigned long level, + mozPacketDumpType type, + boolean sending); + + [Throws] + undefined disablePacketDump(unsigned long level, + mozPacketDumpType type, + boolean sending); + + /* As the ICE candidates roll in this one should be called each time + * in order to keep the candidate list up-to-date for the next SDP-related + * call PeerConnectionImpl does not parse ICE candidates, just sticks them + * into the SDP. + */ + [Throws] + undefined addIceCandidate(DOMString candidate, + DOMString mid, + DOMString ufrag, + unsigned short? level); + + /* Shuts down threads, deletes state */ + [Throws] + undefined close(); + + [Throws] + undefined setConfiguration(optional RTCConfiguration config = {}); + + undefined restartIce(); + undefined restartIceNoRenegotiationNeeded(); + + /* Notify DOM window if this plugin crash is ours. */ + boolean pluginCrash(unsigned long long pluginId, DOMString name); + + // Only throws if promise creation fails + [Throws] + Promise<undefined> onSetDescriptionSuccess(RTCSdpType type, boolean remote); + + undefined onSetDescriptionError(); + + /* Attributes */ + /* This provides the implementation with the certificate it uses to + * authenticate itself. The JS side must set this before calling + * createOffer/createAnswer or retrieving the value of fingerprint. This has + * to be delayed because generating the certificate takes some time. */ + attribute RTCCertificate certificate; + [Constant] + readonly attribute DOMString fingerprint; + readonly attribute DOMString currentLocalDescription; + readonly attribute DOMString pendingLocalDescription; + readonly attribute DOMString currentRemoteDescription; + readonly attribute DOMString pendingRemoteDescription; + readonly attribute boolean? currentOfferer; + readonly attribute boolean? pendingOfferer; + + readonly attribute RTCIceConnectionState iceConnectionState; + readonly attribute RTCIceGatheringState iceGatheringState; + readonly attribute RTCPeerConnectionState connectionState; + readonly attribute RTCSignalingState signalingState; + attribute DOMString id; + + [SetterThrows] + attribute DOMString peerIdentity; + readonly attribute boolean privacyRequested; + + readonly attribute RTCSctpTransport? sctp; + + /* Data channels */ + [Throws] + RTCDataChannel createDataChannel(DOMString label, DOMString protocol, + unsigned short type, boolean ordered, + unsigned short maxTime, unsigned short maxNum, + boolean externalNegotiated, unsigned short stream); + + [Throws] + Promise<any> chain(ChainedOperation op); + undefined updateNegotiationNeeded(); + + boolean createdSender(RTCRtpSender sender); +}; |