You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

RTC.js 11KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342
  1. /* global APP */
  2. var EventEmitter = require("events");
  3. var RTCBrowserType = require("./RTCBrowserType");
  4. var RTCUtils = require("./RTCUtils.js");
  5. var JitsiTrack = require("./JitsiTrack");
  6. var JitsiLocalTrack = require("./JitsiLocalTrack.js");
  7. var DataChannels = require("./DataChannels");
  8. var JitsiRemoteTrack = require("./JitsiRemoteTrack.js");
  9. var MediaStreamType = require("../../service/RTC/MediaStreamTypes");
  10. var RTCEvents = require("../../service/RTC/RTCEvents.js");
  11. function createLocalTracks(streams, options) {
  12. var newStreams = []
  13. var deviceId = null;
  14. for (var i = 0; i < streams.length; i++) {
  15. if (streams[i].type === 'audio') {
  16. deviceId = options.micDeviceId;
  17. } else if (streams[i].videoType === 'camera'){
  18. deviceId = options.cameraDeviceId;
  19. }
  20. var localStream = new JitsiLocalTrack(streams[i].stream,
  21. streams[i].videoType, streams[i].resolution, deviceId);
  22. newStreams.push(localStream);
  23. }
  24. return newStreams;
  25. }
  26. function RTC(room, options) {
  27. this.room = room;
  28. this.localStreams = [];
  29. //FIXME: We should support multiple streams per jid.
  30. this.remoteStreams = {};
  31. this.localAudio = null;
  32. this.localVideo = null;
  33. this.eventEmitter = new EventEmitter();
  34. var self = this;
  35. this.options = options || {};
  36. room.addPresenceListener("videomuted", function (values, from) {
  37. if(self.remoteStreams[from]) {
  38. // If there is no video track, but we receive it is muted,
  39. // we need to create a dummy track which we will mute, so we can
  40. // notify interested about the muting
  41. if(!self.remoteStreams[from][JitsiTrack.VIDEO]) {
  42. var track = self.createRemoteStream(
  43. {peerjid:room.roomjid + "/" + from,
  44. videoType:"camera",
  45. jitsiTrackType:JitsiTrack.VIDEO},
  46. null, null);
  47. self.eventEmitter
  48. .emit(RTCEvents.FAKE_VIDEO_TRACK_CREATED, track);
  49. }
  50. self.remoteStreams[from][JitsiTrack.VIDEO]
  51. .setMute(values.value == "true");
  52. }
  53. });
  54. room.addPresenceListener("audiomuted", function (values, from) {
  55. if(self.remoteStreams[from]) {
  56. self.remoteStreams[from][JitsiTrack.AUDIO]
  57. .setMute(values.value == "true");
  58. }
  59. });
  60. room.addPresenceListener("videoType", function(data, from) {
  61. if(!self.remoteStreams[from] ||
  62. (!self.remoteStreams[from][JitsiTrack.VIDEO]))
  63. return;
  64. self.remoteStreams[from][JitsiTrack.VIDEO]._setVideoType(data.value);
  65. });
  66. }
  67. /**
  68. * Creates the local MediaStreams.
  69. * @param {Object} [options] optional parameters
  70. * @param {Array} options.devices the devices that will be requested
  71. * @param {string} options.resolution resolution constraints
  72. * @param {bool} options.dontCreateJitsiTrack if <tt>true</tt> objects with the following structure {stream: the Media Stream,
  73. * type: "audio" or "video", videoType: "camera" or "desktop"}
  74. * will be returned trough the Promise, otherwise JitsiTrack objects will be returned.
  75. * @param {string} options.cameraDeviceId
  76. * @param {string} options.micDeviceId
  77. * @returns {*} Promise object that will receive the new JitsiTracks
  78. */
  79. RTC.obtainAudioAndVideoPermissions = function (options) {
  80. return RTCUtils.obtainAudioAndVideoPermissions(options).then(function (streams) {
  81. return createLocalTracks(streams, options);
  82. });
  83. }
  84. RTC.prototype.onIncommingCall = function(event) {
  85. if(this.options.config.openSctp)
  86. this.dataChannels = new DataChannels(event.peerconnection,
  87. this.eventEmitter);
  88. for(var i = 0; i < this.localStreams.length; i++)
  89. if(this.localStreams[i])
  90. {
  91. var ssrcInfo = null;
  92. if(this.localStreams[i].isMuted() &&
  93. this.localStreams[i].getType() === "video") {
  94. /**
  95. * Handles issues when the stream is added before the peerconnection is created.
  96. * The peerconnection is created when second participant enters the call. In
  97. * that use case the track doesn't have information about it's ssrcs and no
  98. * jingle packets are sent. That can cause inconsistant behavior later.
  99. *
  100. * For example:
  101. * If we mute the stream and than second participant enter it's remote SDP won't
  102. * include that track. On unmute we are not sending any jingle packets which
  103. * will brake the unmute.
  104. *
  105. * In order to solve issues like the above one here we have to generate the ssrc
  106. * information for the track .
  107. */
  108. this.localStreams[i]._setSSRC(
  109. this.room.generateNewStreamSSRCInfo());
  110. ssrcInfo = {
  111. mtype: this.localStreams[i].getType(),
  112. type: "addMuted",
  113. ssrc: this.localStreams[i].ssrc,
  114. msid: this.localStreams[i].initialMSID
  115. }
  116. }
  117. this.room.addStream(this.localStreams[i].getOriginalStream(),
  118. function () {}, ssrcInfo, true);
  119. }
  120. }
  121. RTC.prototype.selectedEndpoint = function (id) {
  122. if(this.dataChannels)
  123. this.dataChannels.handleSelectedEndpointEvent(id);
  124. }
  125. RTC.prototype.pinEndpoint = function (id) {
  126. if(this.dataChannels)
  127. this.dataChannels.handlePinnedEndpointEvent(id);
  128. }
  129. RTC.prototype.addListener = function (type, listener) {
  130. this.eventEmitter.on(type, listener);
  131. };
  132. RTC.prototype.removeListener = function (eventType, listener) {
  133. this.eventEmitter.removeListener(eventType, listener);
  134. };
  135. RTC.addListener = function (eventType, listener) {
  136. RTCUtils.addListener(eventType, listener);
  137. }
  138. RTC.removeListener = function (eventType, listener) {
  139. RTCUtils.removeListener(eventType, listener)
  140. }
  141. RTC.isRTCReady = function () {
  142. return RTCUtils.isRTCReady();
  143. }
  144. RTC.init = function (options) {
  145. this.options = options || {};
  146. return RTCUtils.init(this.options);
  147. }
  148. RTC.getDeviceAvailability = function () {
  149. return RTCUtils.getDeviceAvailability();
  150. }
  151. RTC.prototype.addLocalStream = function (stream) {
  152. this.localStreams.push(stream);
  153. stream._setRTC(this);
  154. if (stream.isAudioTrack()) {
  155. this.localAudio = stream;
  156. } else {
  157. this.localVideo = stream;
  158. }
  159. };
  160. /**
  161. * Get local video track.
  162. * @returns {JitsiLocalTrack}
  163. */
  164. RTC.prototype.getLocalVideoStream = function () {
  165. return this.localVideo;
  166. };
  167. /**
  168. * Set mute for all local audio streams attached to the conference.
  169. * @param value the mute value
  170. * @returns {Promise}
  171. */
  172. RTC.prototype.setAudioMute = function (value) {
  173. var mutePromises = [];
  174. for(var i = 0; i < this.localStreams.length; i++) {
  175. var stream = this.localStreams[i];
  176. if(stream.getType() !== "audio") {
  177. continue;
  178. }
  179. // this is a Promise
  180. mutePromises.push(value ? stream.mute() : stream.unmute());
  181. }
  182. // we return a Promise from all Promises so we can wait for their execution
  183. return Promise.all(mutePromises);
  184. }
  185. RTC.prototype.removeLocalStream = function (stream) {
  186. var pos = this.localStreams.indexOf(stream);
  187. if (pos === -1) {
  188. return;
  189. }
  190. this.localStreams.splice(pos, 1);
  191. if (stream.isAudioTrack()) {
  192. this.localAudio = null;
  193. } else {
  194. this.localVideo = null;
  195. }
  196. };
  197. RTC.prototype.createRemoteStream = function (data, sid, thessrc) {
  198. var remoteStream = new JitsiRemoteTrack(this, data, sid, thessrc);
  199. if(!data.peerjid)
  200. return;
  201. var resource = Strophe.getResourceFromJid(data.peerjid);
  202. if(!this.remoteStreams[resource]) {
  203. this.remoteStreams[resource] = {};
  204. }
  205. this.remoteStreams[resource][remoteStream.type]= remoteStream;
  206. return remoteStream;
  207. };
  208. RTC.prototype.removeRemoteStream = function (resource) {
  209. if(this.remoteStreams[resource]) {
  210. delete this.remoteStreams[resource];
  211. }
  212. };
  213. RTC.getPCConstraints = function () {
  214. return RTCUtils.pc_constraints;
  215. };
  216. RTC.attachMediaStream = function (elSelector, stream) {
  217. return RTCUtils.attachMediaStream(elSelector, stream);
  218. };
  219. RTC.getStreamID = function (stream) {
  220. return RTCUtils.getStreamID(stream);
  221. };
  222. RTC.getVideoSrc = function (element) {
  223. return RTCUtils.getVideoSrc(element);
  224. };
  225. /**
  226. * Returns true if retrieving the the list of input devices is supported and
  227. * false if not.
  228. */
  229. RTC.isDeviceListAvailable = function () {
  230. return RTCUtils.isDeviceListAvailable();
  231. };
  232. /**
  233. * Returns true if changing the camera / microphone device is supported and
  234. * false if not.
  235. */
  236. RTC.isDeviceChangeAvailable = function () {
  237. return RTCUtils.isDeviceChangeAvailable();
  238. }
  239. /**
  240. * Allows to receive list of available cameras/microphones.
  241. * @param {function} callback would receive array of devices as an argument
  242. */
  243. RTC.enumerateDevices = function (callback) {
  244. RTCUtils.enumerateDevices(callback);
  245. };
  246. RTC.setVideoSrc = function (element, src) {
  247. RTCUtils.setVideoSrc(element, src);
  248. };
  249. /**
  250. * A method to handle stopping of the stream.
  251. * One point to handle the differences in various implementations.
  252. * @param mediaStream MediaStream object to stop.
  253. */
  254. RTC.stopMediaStream = function (mediaStream) {
  255. RTCUtils.stopMediaStream(mediaStream);
  256. };
  257. /**
  258. * Returns whether the desktop sharing is enabled or not.
  259. * @returns {boolean}
  260. */
  261. RTC.isDesktopSharingEnabled = function () {
  262. return RTCUtils.isDesktopSharingEnabled();
  263. };
  264. RTC.prototype.dispose = function() {
  265. };
  266. RTC.prototype.switchVideoStreams = function (newStream) {
  267. this.localVideo.stream = newStream;
  268. this.localStreams = [];
  269. //in firefox we have only one stream object
  270. if (this.localAudio.getOriginalStream() != newStream)
  271. this.localStreams.push(this.localAudio);
  272. this.localStreams.push(this.localVideo);
  273. };
  274. RTC.prototype.setAudioLevel = function (resource, audioLevel) {
  275. if(!resource)
  276. return;
  277. if(this.remoteStreams[resource] && this.remoteStreams[resource][JitsiTrack.AUDIO])
  278. this.remoteStreams[resource][JitsiTrack.AUDIO].setAudioLevel(audioLevel);
  279. };
  280. /**
  281. * Searches in localStreams(session stores ssrc for audio and video) and
  282. * remoteStreams for the ssrc and returns the corresponding resource.
  283. * @param ssrc the ssrc to check.
  284. */
  285. RTC.prototype.getResourceBySSRC = function (ssrc) {
  286. if((this.localVideo && ssrc == this.localVideo.getSSRC())
  287. || (this.localAudio && ssrc == this.localAudio.getSSRC())) {
  288. return Strophe.getResourceFromJid(this.room.myroomjid);
  289. }
  290. var resultResource = null;
  291. $.each(this.remoteStreams, function (resource, remoteTracks) {
  292. if((remoteTracks[JitsiTrack.AUDIO]
  293. && remoteTracks[JitsiTrack.AUDIO].getSSRC() == ssrc)
  294. || (remoteTracks[JitsiTrack.VIDEO]
  295. && remoteTracks[JitsiTrack.VIDEO].getSSRC() == ssrc))
  296. resultResource = resource;
  297. });
  298. return resultResource;
  299. };
  300. module.exports = RTC;