1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/* -*- 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 boolean duplicateFingerprintQuirk;
readonly attribute RTCSctpTransport? sctp;
/* Data channels */
[Throws]
RTCDataChannel createDataChannel(UTF8String label, UTF8String 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);
};
|
