import { CONNECTION_DISCONNECTED_, CONNECTION_FAILED_ } from './service/statistics/AnalyticsEvents'; import JitsiConference from './JitsiConference'; import * as JitsiConnectionEvents from './JitsiConnectionEvents'; import Statistics from './modules/statistics/statistics'; import XMPP from './modules/xmpp/xmpp'; /** * Creates a new connection object for the Jitsi Meet server side video * conferencing service. Provides access to the JitsiConference interface. * @param appID identification for the provider of Jitsi Meet video conferencing * services. * @param token the JWT token used to authenticate with the server(optional) * @param options Object with properties / settings related to connection with * the server. * @constructor */ export default function JitsiConnection(appID, token, options) { this.appID = appID; this.token = token; this.options = options; this.xmpp = new XMPP(options, token); this.addEventListener(JitsiConnectionEvents.CONNECTION_FAILED, (errType, msg) => { Statistics.sendEventToAll( `${CONNECTION_FAILED_}.${errType}`, { label: msg }); }); this.addEventListener(JitsiConnectionEvents.CONNECTION_DISCONNECTED, msg => { // we can see disconnects from normal tab closing of the browser // and then there are no msgs, but we want to log only disconnects // when there is real error if (msg) { Statistics.analytics.sendEvent( `${CONNECTION_DISCONNECTED_}.${msg}`); } Statistics.sendLog( JSON.stringify({ id: 'connection.disconnected', msg })); }); } /** * Connect the client with the server. * @param options {object} connecting options * (for example authentications parameters). */ JitsiConnection.prototype.connect = function(options = {}) { this.xmpp.connect(options.id, options.password); }; /** * Attach to existing connection. Can be used for optimizations. For example: * if the connection is created on the server we can attach to it and start * using it. * * @param options {object} connecting options - rid, sid and jid. */ JitsiConnection.prototype.attach = function(options) { this.xmpp.attach(options); }; /** * Disconnect the client from the server. */ JitsiConnection.prototype.disconnect = function(...args) { // XXX Forward any arguments passed to JitsiConnection.disconnect to // XMPP.disconnect. For example, the caller of JitsiConnection.disconnect // may optionally pass the event which triggered the disconnect in order to // provide the implementation with finer-grained context. this.xmpp.disconnect(...args); }; /** * This method allows renewal of the tokens if they are expiring. * @param token the new token. */ JitsiConnection.prototype.setToken = function(token) { this.token = token; }; /** * Creates and joins new conference. * @param name the name of the conference; if null - a generated name will be * provided from the api * @param options Object with properties / settings related to the conference * that will be created. * @returns {JitsiConference} returns the new conference object. */ JitsiConnection.prototype.initJitsiConference = function(name, options) { return new JitsiConference({ name, config: options, connection: this }); }; /** * Subscribes the passed listener to the event. * @param event {JitsiConnectionEvents} the connection event. * @param listener {Function} the function that will receive the event */ JitsiConnection.prototype.addEventListener = function(event, listener) { this.xmpp.addListener(event, listener); }; /** * Unsubscribes the passed handler. * @param event {JitsiConnectionEvents} the connection event. * @param listener {Function} the function that will receive the event */ JitsiConnection.prototype.removeEventListener = function(event, listener) { this.xmpp.removeListener(event, listener); }; /** * Returns measured connectionTimes. */ JitsiConnection.prototype.getConnectionTimes = function() { return this.xmpp.connectionTimes; }; /** * Adds new feature to the list of supported features for the local * participant. * @param {String} feature the name of the feature. * @param {boolean} submit if true - the new list of features will be * immediately submitted to the others. */ JitsiConnection.prototype.addFeature = function(feature, submit = false) { return this.xmpp.caps.addFeature(feature, submit); }; /** * Removes a feature from the list of supported features for the local * participant * @param {String} feature the name of the feature. * @param {boolean} submit if true - the new list of features will be * immediately submitted to the others. */ JitsiConnection.prototype.removeFeature = function(feature, submit = false) { return this.xmpp.caps.removeFeature(feature, submit); };