/* 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/. */ "use strict"; const {classes: Cc, interfaces: Ci, utils: Cu} = Components; Cu.import("resource://gre/modules/Services.jsm"); Cu.import("resource://gre/modules/XPCOMUtils.jsm"); const PC_CONTRACT = "@mozilla.org/dom/peerconnection;1"; const PC_ICE_CONTRACT = "@mozilla.org/dom/rtcicecandidate;1"; const PC_SESSION_CONTRACT = "@mozilla.org/dom/rtcsessiondescription;1"; const PC_MANAGER_CONTRACT = "@mozilla.org/dom/peerconnectionmanager;1"; const PC_CID = Components.ID("{7cb2b368-b1ce-4560-acac-8e0dbda7d3d0}"); const PC_ICE_CID = Components.ID("{8c5dbd70-2c8e-4ecb-a5ad-2fc919099f01}"); const PC_SESSION_CID = Components.ID("{5f21ffd9-b73f-4ba0-a685-56b4667aaf1c}"); const PC_MANAGER_CID = Components.ID("{7293e901-2be3-4c02-b4bd-cbef6fc24f78}"); // Global list of PeerConnection objects, so they can be cleaned up when // a page is torn down. (Maps inner window ID to an array of PC objects). function GlobalPCList() { this._list = []; Services.obs.addObserver(this, "inner-window-destroyed", true); Services.obs.addObserver(this, "profile-change-net-teardown", true); Services.obs.addObserver(this, "network:offline-about-to-go-offline", true); } GlobalPCList.prototype = { QueryInterface: XPCOMUtils.generateQI([Ci.nsIObserver, Ci.nsISupportsWeakReference, Ci.IPeerConnectionManager]), classID: PC_MANAGER_CID, classInfo: XPCOMUtils.generateCI({classID: PC_MANAGER_CID, contractID: PC_MANAGER_CONTRACT, classDescription: "PeerConnectionManager", interfaces: [ Ci.nsIObserver, Ci.nsISupportsWeakReference, Ci.IPeerConnectionManager ]}), _xpcom_factory: { createInstance: function(outer, iid) { if (outer) { throw Components.results.NS_ERROR_NO_AGGREGATION; } return _globalPCList.QueryInterface(iid); } }, addPC: function(pc) { let winID = pc._winID; if (this._list[winID]) { this._list[winID].push(pc); } else { this._list[winID] = [pc]; } }, hasActivePeerConnection: function(winID) { return this._list[winID] ? true : false; }, observe: function(subject, topic, data) { if (topic == "inner-window-destroyed") { let winID = subject.QueryInterface(Ci.nsISupportsPRUint64).data; if (this._list[winID]) { this._list[winID].forEach(function(pc) { pc._pc.close(false); delete pc._observer; pc._pc = null; }); delete this._list[winID]; } } else if (topic == "profile-change-net-teardown" || topic == "network:offline-about-to-go-offline") { // Delete all peerconnections on shutdown - synchronously (we need // them to be done deleting transports before we return)! // Also kill them if "Work Offline" is selected - more can be created // while offline, but attempts to connect them should fail. let array; while ((array = this._list.pop()) != undefined) { array.forEach(function(pc) { pc._pc.close(true); delete pc._observer; pc._pc = null; }); }; } }, }; let _globalPCList = new GlobalPCList(); function IceCandidate(candidate) { this.candidate = candidate; this.sdpMid = null; this.sdpMLineIndex = null; } IceCandidate.prototype = { classID: PC_ICE_CID, classInfo: XPCOMUtils.generateCI({classID: PC_ICE_CID, contractID: PC_ICE_CONTRACT, classDescription: "IceCandidate", interfaces: [ Ci.nsIDOMRTCIceCandidate ], flags: Ci.nsIClassInfo.DOM_OBJECT}), QueryInterface: XPCOMUtils.generateQI([ Ci.nsIDOMRTCIceCandidate, Ci.nsIDOMGlobalObjectConstructor ]), constructor: function(win, candidateInitDict) { if (this._win) { throw new Error("Constructor already called"); } this._win = win; if (candidateInitDict !== undefined) { this.candidate = candidateInitDict.candidate || null; this.sdpMid = candidateInitDict.sdbMid || null; this.sdpMLineIndex = candidateInitDict.sdpMLineIndex || null; } else { this.candidate = this.sdpMid = this.sdpMLineIndex = null; } } }; function SessionDescription(type, sdp) { this.type = type; this.sdp = sdp; } SessionDescription.prototype = { classID: PC_SESSION_CID, classInfo: XPCOMUtils.generateCI({classID: PC_SESSION_CID, contractID: PC_SESSION_CONTRACT, classDescription: "SessionDescription", interfaces: [ Ci.nsIDOMRTCSessionDescription ], flags: Ci.nsIClassInfo.DOM_OBJECT}), QueryInterface: XPCOMUtils.generateQI([ Ci.nsIDOMRTCSessionDescription, Ci.nsIDOMGlobalObjectConstructor ]), constructor: function(win, descriptionInitDict) { if (this._win) { throw new Error("Constructor already called"); } this._win = win; if (descriptionInitDict !== undefined) { this.type = descriptionInitDict.type || null; this.sdp = descriptionInitDict.sdp || null; } else { this.type = this.sdp = null; } }, toString: function() { return JSON.stringify({ type: this.type, sdp: this.sdp }); } }; function PeerConnection() { this._queue = []; this._pc = null; this._observer = null; this._closed = false; this._onCreateOfferSuccess = null; this._onCreateOfferFailure = null; this._onCreateAnswerSuccess = null; this._onCreateAnswerFailure = null; /** * Everytime we get a request from content, we put it in the queue. If * there are no pending operations though, we will execute it immediately. * In PeerConnectionObserver, whenever we are notified that an operation * has finished, we will check the queue for the next operation and execute * if neccesary. The _pending flag indicates whether an operation is currently * in progress. */ this._pending = false; // Public attributes. this.onaddstream = null; this.onopen = null; this.onremovestream = null; this.onicecandidate = null; this.onstatechange = null; this.ongatheringchange = null; this.onicechange = null; this.remoteDescription = null; // Data channel. this.ondatachannel = null; this.onconnection = null; this.onclosedconnection = null; } PeerConnection.prototype = { classID: PC_CID, classInfo: XPCOMUtils.generateCI({classID: PC_CID, contractID: PC_CONTRACT, classDescription: "PeerConnection", interfaces: [ Ci.nsIDOMRTCPeerConnection ], flags: Ci.nsIClassInfo.DOM_OBJECT}), QueryInterface: XPCOMUtils.generateQI([ Ci.nsIDOMRTCPeerConnection, Ci.nsIDOMGlobalObjectConstructor ]), // Constructor is an explicit function, because of nsIDOMGlobalObjectConstructor. constructor: function(win) { if (!Services.prefs.getBoolPref("media.peerconnection.enabled")) { throw new Error("PeerConnection not enabled (did you set the pref?)"); } if (this._win) { throw new Error("Constructor already called"); } this._pc = Cc["@mozilla.org/peerconnection;1"]. createInstance(Ci.IPeerConnection); this._observer = new PeerConnectionObserver(this); // Nothing starts until ICE gathering completes. this._queueOrRun({ func: this._pc.initialize, args: [this._observer, win, Services.tm.currentThread], wait: true }); this._win = win; this._winID = this._win.QueryInterface(Ci.nsIInterfaceRequestor) .getInterface(Ci.nsIDOMWindowUtils).currentInnerWindowID; // Add a reference to the PeerConnection to global list. _globalPCList.addPC(this); }, /** * Add a function to the queue or run it immediately if the queue is empty. * Argument is an object with the func, args and wait properties; wait should * be set to true if the function has a success/error callback that will * call _executeNext, false if it doesn't have a callback. */ _queueOrRun: function(obj) { if (this._closed) { return; } if (!this._pending) { obj.func.apply(this, obj.args); if (obj.wait) { this._pending = true; } } else { this._queue.push(obj); } }, // Pick the next item from the queue and run it. _executeNext: function() { if (this._queue.length) { let obj = this._queue.shift(); obj.func.apply(this, obj.args); if (!obj.wait) { this._executeNext(); } } else { this._pending = false; } }, /** * Constraints look like this: * * { * mandatory: {"foo": true, "bar": 10, "baz": "boo"}, * optional: [{"foo": true}, {"bar": 10}] * } * * We check for basic structure but not the validity of the constraints * themselves before passing them along to C++. */ _validateConstraints: function(constraints) { function isObject(obj) { return obj && (typeof obj === "object"); } function isArray(obj) { return isObject(obj) && (Object.prototype.toString.call(obj) === "[object Array]"); } if (!isObject(constraints)) { return false; } if (constraints.mandatory && !isObject(constraints.mandatory)) { return false; } if (constraints.optional && !isArray(constraints.optional)) { return false; } return true; }, createOffer: function(onSuccess, onError, constraints) { if (this._onCreateOfferSuccess) { throw new Error("createOffer already called"); } if (!constraints) { constraints = {}; } if (!this._validateConstraints(constraints)) { throw new Error("createOffer passed invalid constraints"); } this._onCreateOfferSuccess = onSuccess; this._onCreateOfferFailure = onError; this._queueOrRun({ func: this._pc.createOffer, args: [constraints], wait: true }); }, createAnswer: function(onSuccess, onError, constraints, provisional) { if (this._onCreateAnswerSuccess) { throw new Error("createAnswer already called"); } if (!this.remoteDescription) { throw new Error("setRemoteDescription not called"); } if (this.remoteDescription.type != "offer") { throw new Error("No outstanding offer"); } if (!constraints) { constraints = {}; } if (!this._validateConstraints(constraints)) { throw new Error("createAnswer passed invalid constraints"); } this._onCreateAnswerSuccess = onSuccess; this._onCreateAnswerFailure = onError; if (!provisional) { provisional = false; } // TODO: Implement provisional answer. this._queueOrRun({ func: this._pc.createAnswer, args: [constraints], wait: true }); }, setLocalDescription: function(desc, onSuccess, onError) { if (this._onSetLocalDescriptionSuccess) { throw new Error("setLocalDescription already called"); } this._onSetLocalDescriptionSuccess = onSuccess; this._onSetLocalDescriptionFailure = onError; let type; switch (desc.type) { case "offer": type = Ci.IPeerConnection.kActionOffer; break; case "answer": type = Ci.IPeerConnection.kActionAnswer; break; default: throw new Error( "Invalid type " + desc.type + " provided to setLocalDescription" ); break; } this._queueOrRun({ func: this._pc.setLocalDescription, args: [type, desc.sdp], wait: true }); }, setRemoteDescription: function(desc, onSuccess, onError) { if (this._onSetRemoteDescriptionSuccess) { throw new Error("setRemoteDescription already called"); } this._onSetRemoteDescriptionSuccess = onSuccess; this._onSetRemoteDescriptionFailure = onError; let type; switch (desc.type) { case "offer": type = Ci.IPeerConnection.kActionOffer; break; case "answer": type = Ci.IPeerConnection.kActionAnswer; break; default: throw new Error( "Invalid type " + desc.type + " provided to setRemoteDescription" ); break; } this.remoteDescription = { type: desc.type, sdp: desc.sdp, __exposedProps__: { type: "rw", sdp: "rw" } }; this._queueOrRun({ func: this._pc.setRemoteDescription, args: [type, desc.sdp], wait: true }); }, updateIce: function(config, constraints, restart) { return Cr.NS_ERROR_NOT_IMPLEMENTED; }, addIceCandidate: function(cand) { if (!cand) { throw "Invalid candidate passed to addIceCandidate!"; } if (!cand.candidate || !cand.sdpMid || !cand.sdpMLineIndex) { throw "Invalid candidate passed to addIceCandidate!"; } this._queueOrRun({ func: this._pc.addIceCandidate, args: [cand.candidate, cand.sdpMid, cand.sdpMLineIndex], wait: false }); }, addStream: function(stream, constraints) { // TODO: Implement constraints. this._queueOrRun({ func: this._pc.addStream, args: [stream], wait: false }); }, removeStream: function(stream) { this._queueOrRun({ func: this._pc.removeStream, args: [stream], wait: false }); }, close: function() { this._queueOrRun({ func: this._pc.close, args: [false], wait: false }); this._closed = true; }, get localStreams() { return this._pc.localStreams; }, get remoteStreams() { return this._pc.remoteStreams; }, createDataChannel: function(label, dict) { if (dict && dict.maxRetransmitTime != undefined && dict.maxRetransmitNum != undefined) { throw new Error("Both maxRetransmitTime and maxRetransmitNum cannot be provided"); } // Must determine the type where we still know if entries are undefined. let type; if (dict.maxRetransmitTime != undefined) { type = Ci.IPeerConnection.kDataChannelPartialReliableTimed; } else if (dict.maxRetransmitNum != undefined) { type = Ci.IPeerConnection.kDataChannelPartialReliableRexmit; } else { type = Ci.IPeerConnection.kDataChannelReliable; } // Synchronous since it doesn't block. let channel = this._pc.createDataChannel( label, type, dict.outOfOrderAllowed, dict.maxRetransmitTime, dict.maxRetransmitNum ); return channel; }, connectDataConnection: function(localport, remoteport, numstreams) { if (numstreams == undefined || numstreams <= 0) { numstreams = 16; } this._queueOrRun({ func: this._pc.connectDataConnection, args: [localport, remoteport, numstreams], wait: false }); } }; // This is a seperate object because we don't want to expose it to DOM. function PeerConnectionObserver(dompc) { this._dompc = dompc; } PeerConnectionObserver.prototype = { QueryInterface: XPCOMUtils.generateQI([Ci.IPeerConnectionObserver]), onCreateOfferSuccess: function(offer) { if (this._dompc._onCreateOfferSuccess) { try { this._dompc._onCreateOfferSuccess.onCallback({ type: "offer", sdp: offer, __exposedProps__: { type: "rw", sdp: "rw" } }); } catch(e) {} } this._dompc._executeNext(); }, onCreateOfferError: function(code) { if (this._dompc._onCreateOfferFailure) { try { this._dompc._onCreateOfferFailure.onCallback(code); } catch(e) {} } this._dompc._executeNext(); }, onCreateAnswerSuccess: function(answer) { if (this._dompc._onCreateAnswerSuccess) { try { this._dompc._onCreateAnswerSuccess.onCallback({ type: "answer", sdp: answer, __exposedProps__: { type: "rw", sdp: "rw" } }); } catch(e) {} } this._dompc._executeNext(); }, onCreateAnswerError: function(code) { if (this._dompc._onCreateAnswerFailure) { try { this._dompc._onCreateAnswerFailure.onCallback(code); } catch(e) {} } this._dompc._executeNext(); }, onSetLocalDescriptionSuccess: function(code) { if (this._dompc._onSetLocalDescriptionSuccess) { try { this._dompc._onSetLocalDescriptionSuccess.onCallback(code); } catch(e) {} } this._dompc._executeNext(); }, onSetRemoteDescriptionSuccess: function(code) { if (this._dompc._onSetRemoteDescriptionSuccess) { try { this._dompc._onSetRemoteDescriptionSuccess.onCallback(code); } catch(e) {} } this._dompc._executeNext(); }, onSetLocalDescriptionError: function(code) { if (this._dompc._onSetLocalDescriptionFailure) { try { this._dompc._onSetLocalDescriptionFailure.onCallback(code); } catch(e) {} } this._dompc._executeNext(); }, onSetRemoteDescriptionError: function(code) { if (this._dompc._onSetRemoteDescriptionFailure) { this._dompc._onSetRemoteDescriptionFailure.onCallback(code); } this._dompc._executeNext(); }, onStateChange: function(state) { if (state != Ci.IPeerConnectionObserver.kIceState) { return; } let self = this; let iceCb = function() {}; let iceGatherCb = function() {}; if (this._dompc.onicechange) { iceCb = function(args) { try { self._dompc.onicechange(args); } catch(e) {} }; } if (this._dompc.ongatheringchange) { iceGatherCb = function(args) { try { self._dompc.ongatheringchange(args); } catch(e) {} }; } switch (this._dompc._pc.iceState) { case Ci.IPeerConnection.kIceGathering: iceGatherCb("gathering"); break; case Ci.IPeerConnection.kIceWaiting: iceCb("starting"); this._dompc._executeNext(); break; case Ci.IPeerConnection.kIceChecking: iceCb("checking"); this._dompc._executeNext(); break; case Ci.IPeerConnection.kIceConnected: // ICE gathering complete. iceCb("connected"); iceGatherCb("complete"); this._dompc._executeNext(); break; case Ci.IPeerConnection.kIceFailed: iceCb("failed"); break; default: // Unknown state! break; } }, onAddStream: function(stream, type) { if (this._dompc.onaddstream) { try { this._dompc.onaddstream.onCallback({ stream: stream, type: type, __exposedProps__: { stream: "r", type: "r" } }); } catch(e) {} } this._dompc._executeNext(); }, onRemoveStream: function(stream, type) { if (this._dompc.onremovestream) { try { this._dompc.onremovestream.onCallback({ stream: stream, type: type, __exposedProps__: { stream: "r", type: "r" } }); } catch(e) {} } this._dompc._executeNext(); }, foundIceCandidate: function(cand) { if (this._dompc.onicecandidate) { try { this._dompc.onicecandidate.onCallback({ candidate: cand, __exposedProps__: { candidate: "rw" } }); } catch(e) {} } this._dompc._executeNext(); }, notifyDataChannel: function(channel) { if (this._dompc.ondatachannel) { try { this._dompc.ondatachannel.onCallback(channel); } catch(e) {} } this._dompc._executeNext(); }, notifyConnection: function() { if (this._dompc.onconnection) { try { this._dompc.onconnection.onCallback(); } catch(e) {} } this._dompc._executeNext(); }, notifyClosedConnection: function() { if (this._dompc.onclosedconnection) { try { this._dompc.onclosedconnection.onCallback(); } catch(e) {} } this._dompc._executeNext(); } }; this.NSGetFactory = XPCOMUtils.generateNSGetFactory( [GlobalPCList, IceCandidate, SessionDescription, PeerConnection] );