ref: Remove pinEndpoint. (#1440)

"Pinned" endpoints are deprecated, use "selected" instead.

JitsiConference.js

@@ -1338,17 +1338,6 @@ JitsiConference.prototype.selectParticipants = function(participantIds) {
     this.rtc.selectEndpoints(participantIds);
 };
 
-/**
- * Elects the participant with the given id to be the pinned participant in
- * order to always receive video for this participant (even when last n is
- * enabled).
- * @param participantId the identifier of the participant
- * @throws NetworkError or InvalidStateError or Error if the operation fails.
- */
-JitsiConference.prototype.pinParticipant = function(participantId) {
-    this.rtc.pinEndpoint(participantId);
-};
-
 /**
  * Obtains the current value for "lastN". See {@link setLastN} for more info.
  * @returns {number}

modules/RTC/BridgeChannel.js

@@ -207,22 +207,6 @@ export default class BridgeChannel {
         });
     }
 
-    /**
-     * Sends a "pinned endpoint changed" message via the channel.
-     * @param {string} endpointId The id of the pinned endpoint.
-     * @throws NetworkError or InvalidStateError from RTCDataChannel#send (@see
-     * {@link https://developer.mozilla.org/docs/Web/API/RTCDataChannel/send})
-     * or from WebSocket#send or Error with "No opened channel" message.
-     */
-    sendPinnedEndpointMessage(endpointId) {
-        logger.log(`Sending pinned endpoint: ${endpointId}.`);
-
-        this._send({
-            colibriClass: 'PinnedEndpointChangedEvent',
-            pinnedEndpoint: endpointId || null
-        });
-    }
-
     /**
      * Sends a "selected endpoints changed" message via the channel.
      *

modules/RTC/RTC.js

@@ -171,14 +171,6 @@ export default class RTC extends Listenable {
          */
         this._maxFrameHeight = undefined;
 
-        /**
-         * The endpoint ID of currently pinned participant or <tt>null</tt> if
-         * no user is pinned.
-         * @type {string|null}
-         * @private
-         */
-        this._pinnedEndpoint = null;
-
         /**
          * The endpoint IDs of currently selected participants.
          *
@@ -291,8 +283,6 @@ export default class RTC extends Listenable {
             // we want the notification to trigger even if userJid
             // is undefined, or null.
             try {
-                this._channel.sendPinnedEndpointMessage(
-                    this._pinnedEndpoint);
                 this._channel.sendSelectedEndpointsMessage(
                     this._selectedEndpoints);
 
@@ -304,7 +294,6 @@ export default class RTC extends Listenable {
                 GlobalOnErrorHandler.callErrorHandler(error);
                 logger.error(
                     `Cannot send selected(${this._selectedEndpoint})`
-                    + `pinned(${this._pinnedEndpoint})`
                     + `frameHeight(${this._maxFrameHeight}) endpoint message`,
                     error);
             }
@@ -434,22 +423,6 @@ export default class RTC extends Listenable {
         }
     }
 
-    /**
-     * Elects the participant with the given id to be the pinned participant in
-     * order to always receive video for this participant (even when last n is
-     * enabled).
-     * @param {stirng} id The user id.
-     * @throws NetworkError or InvalidStateError or Error if the operation
-     * fails.
-     */
-    pinEndpoint(id) {
-        // Cache the value if channel is missing, till we open it.
-        this._pinnedEndpoint = id;
-        if (this._channel && this._channel.isOpen()) {
-            this._channel.sendPinnedEndpointMessage(id);
-        }
-    }
-
     /**
      *
      * @param eventType