twilio-video 2.24.3 → 2.25.0

package/CHANGELOG.md

@@ -2,6 +2,67 @@ The Twilio Programmable Video SDKs use [Semantic Versioning](http://www.semver.o
 
 **Version 1.x reached End of Life on September 8th, 2021.** See the changelog entry [here](https://www.twilio.com/changelog/end-of-life-complete-for-unsupported-versions-of-the-programmable-video-sdk). Support for the 1.x version ended on December 4th, 2020.
 
+2.25.0 (November 14, 2022)
+==========================
+
+New Features
+------------
+
+### Auto-switch default audio input devices
+
+This release adds a new feature that preserves audio continuity in situations where end-users change the default audio input device.
+A LocalAudioTrack is said to be capturing audio from the default audio input device if:
+
+- it was created using the MediaTrackConstraints `{ audio: true }`, or
+- it was created using the MediaTrackConstraints `{ audio: { deviceId: 'foo' } }`, and "foo" is not available, or
+- it was created using the MediaTrackConstraints `{ audio: { deviceId: { ideal: 'foo' } } }` and "foo" is not available
+
+In previous versions of the SDK, if the default device changed (ex: a bluetooth headset is connected to a mac or windows laptop),
+the LocalAudioTrack continued to capture audio from the old default device (ex: the laptop microphone). Now, a LocalAudioTrack
+will switch automatically from the old default audio input device to the new default audio input device (ex: from the laptop microphone to the headset microphone).
+This feature is controlled by a new [CreateLocalAudioTrackOptions](https://sdk.twilio.com/js/video/releases/2.25.0/docs/global.html#CreateLocalAudioTrackOptions)
+property `defaultDeviceCaptureMode`, which defaults to `auto` (new behavior) or can be set to `manual` (old behavior).
+
+The application can decide to capture audio from a specific audio input device by creating a LocalAudioTrack:
+
+- using the MediaTrackConstraints `{ audio: { deviceId: 'foo' } }`, and "foo" is available, or
+- using the MediaTrackConstraints `{ audio: { deviceId: { ideal: 'foo' } } }` and "foo" is available, or
+- using the MediaTrackConstraints `{ audio: { deviceId: { exact: 'foo' } } }` and "foo" is available 
+
+In this case, the LocalAudioTrack DOES NOT switch to another audio input device if the current audio input device is no
+longer available. See below for the behavior of this property based on how the LocalAudioTrack is created. (VIDEO-11701)
+
+```js
+const { connect, createLocalAudioTrack, createLocalTracks } = require('twilio-video');
+
+// Auto-switch default audio input devices: option 1
+const audioTrack = await createLocalAudioTrack();
+
+// Auto-switch default audio input devices: option 2
+const audioTrack1 = await createLocalAudioTrack({ defaultDeviceCaptureMode: 'auto' });
+
+// Auto-switch default audio input devices: option 3
+const [audioTrack3] = await createLocalTracks({ audio: true });
+
+// Auto-switch default audio input devices: option 4
+const [audioTrack4] = await createLocalTracks({ audio: { defaultDeviceCaptureMode: 'auto' } });
+
+// Auto-switch default audio input devices: option 5
+const room1 = await connect({ audio: true });
+
+// Auto-switch default audio input devices: option 6
+const room2 = await connect({ audio: { defaultDeviceCaptureMode: 'auto' } });
+
+// Disable auto-switch default audio input devices
+const room = await createLocalAudioTrack({ defaultDeviceCaptureMode: 'manual' });
+```
+
+**Limitations**
+
+- This feature is not enabled on iOS as it is natively supported.
+- Due to this [WebKit bug](https://bugs.webkit.org/show_bug.cgi?id=232835), MacOS Safari Participants may lose their local audio after switching between default audio input devices two-three times.
+- This feature is not supported on Android Chrome, as it does not support the [MediaDevices.ondevicechange](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/devicechange_event#browser_compatibility) event.
+
 2.24.3 (October 10, 2022)
 =========================
 

package/README.md

@@ -74,8 +74,7 @@ Releases of twilio-video.js are hosted on a CDN, and you can include these
 directly in your web app using a <script> tag.
 
 ```html
-<script src="//sdk.twilio.com/js/video/releases/2.24.3/twilio-video.min.js"></script>
-
+<script src="//sdk.twilio.com/js/video/releases/2.25.0/twilio-video.min.js"></script>
 ```
 
 Using this method, twilio-video.js will set a browser global:

package/dist/twilio-video.js

@@ -1,4 +1,4 @@
-/*! twilio-video.js 2.24.3
+/*! twilio-video.js 2.25.0
 
 The following license applies to all parts of this software except as
 documented below.
@@ -1116,8 +1116,16 @@ var NoiseCancellationVendor = {
  * @property {boolean} [workaroundWebKitBug180748=false] - setting this
  *   attempts to workaround WebKit Bug 180748, where, in Safari, getUserMedia may return a silent audio
  *   MediaStreamTrack.
- * @property {NoiseCancellationOptions} [noiseCancellationOptions] - This property enables using 3rd party plugins
- *   for noise cancellation. This is a beta feature.
+ * @property {DefaultDeviceCaptureMode} [defaultDeviceCaptureMode="auto"] - This optional property only applies if the
+ *   {@link LocalAudioTrack} is capturing from the default audio input device connected to a desktop or laptop. When the
+ *   property is set to "auto", the LocalAudioTrack restarts whenever the default audio input device changes, in order to
+ *   capture audio from the new default audio input device. For example, when a bluetooth audio headset is connected to a
+ *   Macbook, the LocalAudioTrack will start capturing audio from the headset microphone. When the headset is disconnected,
+ *   the LocalAudioTrack will start capturing audio from the Macbook microphone. When the property is set to "manual", the
+ *   LocalAudioTrack continues to capture from the same audio input device even after the default audio input device changes.
+ *   When the property is not specified, it defaults to "auto".
+ * @property {NoiseCancellationOptions} [noiseCancellationOptions] - This optional property enables using 3rd party plugins
+ *   for noise cancellation.
  */
 /**
  * Create {@link LocalTrack} options. Apart from the properties listed here, you can
@@ -1218,7 +1226,7 @@ var buildLogLevels = require('./util').buildLogLevels;
 var _a = require('./webrtc'), getUserMedia = _a.getUserMedia, MediaStreamTrack = _a.MediaStreamTrack;
 var _b = require('./media/track/es5'), LocalAudioTrack = _b.LocalAudioTrack, LocalDataTrack = _b.LocalDataTrack, LocalVideoTrack = _b.LocalVideoTrack;
 var Log = require('./util/log');
-var _c = require('./util/constants'), DEFAULT_LOG_LEVEL = _c.DEFAULT_LOG_LEVEL, DEFAULT_LOGGER_NAME = _c.DEFAULT_LOGGER_NAME;
+var _c = require('./util/constants'), DEFAULT_LOG_LEVEL = _c.DEFAULT_LOG_LEVEL, DEFAULT_LOGGER_NAME = _c.DEFAULT_LOGGER_NAME, INVALID_VALUE = _c.typeErrors.INVALID_VALUE;
 var workaround180748 = require('./webaudio/workaround180748');
 // This is used to make out which createLocalTracks() call a particular Log
 // statement belongs to. Each call to createLocalTracks() increments this
@@ -1317,19 +1325,31 @@ function createLocalTracks(options) {
                     extraLocalTrackOptions = {
                         audio: typeof fullOptions.audio === 'object' && fullOptions.audio.name
                             ? { name: fullOptions.audio.name }
-                            : {},
+                            : { defaultDeviceCaptureMode: 'auto' },
                         video: typeof fullOptions.video === 'object' && fullOptions.video.name
                             ? { name: fullOptions.video.name }
                             : {}
                     };
                     extraLocalTrackOptions.audio.isCreatedByCreateLocalTracks = true;
                     extraLocalTrackOptions.video.isCreatedByCreateLocalTracks = true;
-                    if (typeof fullOptions.audio === 'object' && typeof fullOptions.audio.workaroundWebKitBug1208516 === 'boolean') {
-                        extraLocalTrackOptions.audio.workaroundWebKitBug1208516 = fullOptions.audio.workaroundWebKitBug1208516;
-                    }
-                    if (typeof fullOptions.audio === 'object' && 'noiseCancellationOptions' in fullOptions.audio) {
-                        noiseCancellationOptions = fullOptions.audio.noiseCancellationOptions;
-                        delete fullOptions.audio.noiseCancellationOptions;
+                    if (typeof fullOptions.audio === 'object') {
+                        if (typeof fullOptions.audio.workaroundWebKitBug1208516 === 'boolean') {
+                            extraLocalTrackOptions.audio.workaroundWebKitBug1208516 = fullOptions.audio.workaroundWebKitBug1208516;
+                        }
+                        if ('noiseCancellationOptions' in fullOptions.audio) {
+                            noiseCancellationOptions = fullOptions.audio.noiseCancellationOptions;
+                            delete fullOptions.audio.noiseCancellationOptions;
+                        }
+                        if (!('defaultDeviceCaptureMode' in fullOptions.audio)) {
+                            extraLocalTrackOptions.audio.defaultDeviceCaptureMode = 'auto';
+                        }
+                        else if (['auto', 'manual'].every(function (mode) { return mode !== fullOptions.audio.defaultDeviceCaptureMode; })) {
+                            // eslint-disable-next-line new-cap
+                            throw INVALID_VALUE('CreateLocalAudioTrackOptions.defaultDeviceCaptureMode', ['auto', 'manual']);
+                        }
+                        else {
+                            extraLocalTrackOptions.audio.defaultDeviceCaptureMode = fullOptions.audio.defaultDeviceCaptureMode;
+                        }
                     }
                     if (typeof fullOptions.video === 'object' && typeof fullOptions.video.workaroundWebKitBug1208516 === 'boolean') {
                         extraLocalTrackOptions.video.workaroundWebKitBug1208516 = fullOptions.video.workaroundWebKitBug1208516;
@@ -2969,6 +2989,7 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var isIOS = require('../../util/browserdetection').isIOS;
 var AudioTrack = require('./audiotrack');
 var mixinLocalMediaTrack = require('./localmediatrack');
 var LocalMediaAudioTrack = mixinLocalMediaTrack(AudioTrack);
@@ -3001,13 +3022,61 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         var _this = this;
         var noiseCancellation = (options === null || options === void 0 ? void 0 : options.noiseCancellation) || null;
         _this = _super.call(this, mediaStreamTrack, options) || this;
+        var log = _this._log;
+        var _a = mediaStreamTrack.label, defaultDeviceLabel = _a === void 0 ? '' : _a;
+        var _b = mediaStreamTrack.getSettings(), _c = _b.deviceId, defaultDeviceId = _c === void 0 ? '' : _c, _d = _b.groupId, defaultGroupId = _d === void 0 ? '' : _d;
         Object.defineProperties(_this, {
+            _currentDefaultDeviceInfo: {
+                value: { deviceId: defaultDeviceId, groupId: defaultGroupId, label: defaultDeviceLabel },
+                writable: true
+            },
+            _defaultDeviceCaptureMode: {
+                value: !isIOS()
+                    && _this._isCreatedByCreateLocalTracks
+                    && typeof navigator === 'object'
+                    && typeof navigator.mediaDevices === 'object'
+                    && typeof navigator.mediaDevices.addEventListener === 'function'
+                    && typeof navigator.mediaDevices.enumerateDevices === 'function'
+                    ? (options === null || options === void 0 ? void 0 : options.defaultDeviceCaptureMode) || 'auto'
+                    : 'manual'
+            },
+            _onDeviceChange: {
+                value: function () {
+                    navigator.mediaDevices.enumerateDevices().then(function (deviceInfos) {
+                        // NOTE(mmalavalli): In Chrome, when the default device changes, and we restart the LocalAudioTrack with
+                        // device ID "default", it will not switch to the new default device unless all LocalAudioTracks capturing
+                        // from the old default device are stopped. So, we restart the LocalAudioTrack with the actual device ID of
+                        // the new default device instead.
+                        var defaultDeviceInfo = deviceInfos.find(function (_a) {
+                            var deviceId = _a.deviceId, kind = _a.kind;
+                            return kind === 'audioinput' && deviceId !== 'default';
+                        });
+                        if (defaultDeviceInfo && ['deviceId', 'groupId'].some(function (prop) {
+                            return defaultDeviceInfo[prop] !== _this._currentDefaultDeviceInfo[prop];
+                        })) {
+                            log.info('Default device changed, restarting the LocalAudioTrack');
+                            log.debug("Old default device: \"" + _this._currentDefaultDeviceInfo.deviceId + "\" => \"" + _this._currentDefaultDeviceInfo.label + "\"");
+                            log.debug("New default device: \"" + defaultDeviceInfo.deviceId + "\" => \"" + defaultDeviceInfo.label + "\"");
+                            _this._currentDefaultDeviceInfo = defaultDeviceInfo;
+                            _this._restartDefaultDevice().catch(function (error) { return log.warn("Failed to restart: " + error.message); });
+                        }
+                    }, function (error) {
+                        log.warn("Failed to run enumerateDevices(): " + error.message);
+                    });
+                }
+            },
+            _restartOnDefaultDeviceChangeCleanup: {
+                value: null,
+                writable: true
+            },
             noiseCancellation: {
                 enumerable: true,
                 value: noiseCancellation,
                 writable: false
             },
         });
+        log.debug('defaultDeviceCaptureMode:', _this._defaultDeviceCaptureMode);
+        _this._maybeRestartOnDefaultDeviceChange();
         return _this;
     }
     LocalAudioTrack.prototype.toString = function () {
@@ -3024,6 +3093,51 @@ var LocalAudioTrack = /** @class */ (function (_super) {
     LocalAudioTrack.prototype._end = function () {
         return _super.prototype._end.apply(this, arguments);
     };
+    /**
+     * @private
+     */
+    LocalAudioTrack.prototype._maybeRestartOnDefaultDeviceChange = function () {
+        var _this = this;
+        var _a = this, constraints = _a._constraints, defaultDeviceCaptureMode = _a._defaultDeviceCaptureMode, log = _a._log;
+        var mediaStreamTrack = this.noiseCancellation ? this.noiseCancellation.sourceTrack : this.mediaStreamTrack;
+        var deviceId = mediaStreamTrack.getSettings().deviceId;
+        var isNotEqualToCapturedDeviceIdOrEqualToDefault = function (requestedDeviceId) {
+            return requestedDeviceId !== deviceId || requestedDeviceId === 'default';
+        };
+        var isCapturingFromDefaultDevice = (function checkIfCapturingFromDefaultDevice(deviceIdConstraint) {
+            if (deviceIdConstraint === void 0) { deviceIdConstraint = {}; }
+            if (typeof deviceIdConstraint === 'string') {
+                return isNotEqualToCapturedDeviceIdOrEqualToDefault(deviceIdConstraint);
+            }
+            else if (Array.isArray(deviceIdConstraint)) {
+                return deviceIdConstraint.every(isNotEqualToCapturedDeviceIdOrEqualToDefault);
+            }
+            else if (deviceIdConstraint.exact) {
+                return checkIfCapturingFromDefaultDevice(deviceIdConstraint.exact);
+            }
+            else if (deviceIdConstraint.ideal) {
+                return checkIfCapturingFromDefaultDevice(deviceIdConstraint.ideal);
+            }
+            return true;
+        }(constraints.deviceId));
+        if (defaultDeviceCaptureMode === 'auto' && isCapturingFromDefaultDevice) {
+            if (!this._restartOnDefaultDeviceChangeCleanup) {
+                log.info('LocalAudioTrack will be restarted if the default device changes');
+                navigator.mediaDevices.addEventListener('devicechange', this._onDeviceChange);
+                this._restartOnDefaultDeviceChangeCleanup = function () {
+                    log.info('Cleaning up the listener to restart the LocalAudioTrack if the default device changes');
+                    navigator.mediaDevices.removeEventListener('devicechange', _this._onDeviceChange);
+                    _this._restartOnDefaultDeviceChangeCleanup = null;
+                };
+            }
+        }
+        else {
+            log.info('LocalAudioTrack will NOT be restarted if the default device changes');
+            if (this._restartOnDefaultDeviceChangeCleanup) {
+                this._restartOnDefaultDeviceChangeCleanup();
+            }
+        }
+    };
     /**
      * @private
      */
@@ -3037,6 +3151,21 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         }
         return _super.prototype._reacquireTrack.call(this, constraints);
     };
+    /**
+     * @private
+     */
+    LocalAudioTrack.prototype._restartDefaultDevice = function () {
+        var _this = this;
+        var constraints = Object.assign({}, this._constraints);
+        var restartConstraints = Object.assign({}, constraints, { deviceId: this._currentDefaultDeviceInfo.deviceId });
+        return this.restart(restartConstraints).then(function () {
+            // NOTE(mmalavalli): Since we used the new default device's ID while restarting the LocalAudioTrack,
+            // we reset the constraints to the original constraints so that the default device detection logic in
+            // _maybeRestartOnDefaultDeviceChange() still works.
+            _this._constraints = constraints;
+            _this._maybeRestartOnDefaultDeviceChange();
+        });
+    };
     /**
      * Disable the {@link LocalAudioTrack}. This is effectively "mute".
      * @returns {this}
@@ -3108,6 +3237,9 @@ var LocalAudioTrack = /** @class */ (function (_super) {
         if (this.noiseCancellation) {
             this.noiseCancellation.stop();
         }
+        if (this._restartOnDefaultDeviceChangeCleanup) {
+            this._restartOnDefaultDeviceChangeCleanup();
+        }
         return _super.prototype.stop.apply(this, arguments);
     };
     return LocalAudioTrack;
@@ -3138,7 +3270,7 @@ var LocalAudioTrack = /** @class */ (function (_super) {
  */
 module.exports = LocalAudioTrack;
 
-},{"./audiotrack":13,"./localmediatrack":23}],20:[function(require,module,exports){
+},{"../../util/browserdetection":122,"./audiotrack":13,"./localmediatrack":23}],20:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -3387,8 +3519,8 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 var getUserMedia = require('../../webrtc').getUserMedia;
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
-var _b = require('../../util'), capitalize = _b.capitalize, defer = _b.defer, isUserMediaTrack = _b.isUserMediaTrack, waitForSometime = _b.waitForSometime, waitForEvent = _b.waitForEvent;
+var isIOS = require('../../util/browserdetection').isIOS;
+var _a = require('../../util'), capitalize = _a.capitalize, defer = _a.defer, isUserMediaTrack = _a.isUserMediaTrack, waitForSometime = _a.waitForSometime, waitForEvent = _a.waitForEvent;
 var ILLEGAL_INVOKE = require('../../util/constants').typeErrors.ILLEGAL_INVOKE;
 var detectSilentAudio = require('../../util/detectsilentaudio');
 var detectSilentVideo = require('../../util/detectsilentvideo');
@@ -3414,10 +3546,7 @@ function mixinLocalMediaTrack(AudioOrVideoTrack) {
          */
         function LocalMediaTrack(mediaStreamTrack, options) {
             var _this = this;
-            // NOTE(mpatwardhan): by default workaround for WebKitBug1208516 will be enabled on Safari browsers
-            // although the bug is seen  mainly on iOS devices, we do not have a reliable way to tell iOS from MacOs
-            // userAgent on iOS pretends its macOs if Safari is set to request desktop pages.
-            var workaroundWebKitBug1208516 = (guessBrowser() === 'safari' || isIOSChrome())
+            var workaroundWebKitBug1208516 = isIOS()
                 && isUserMediaTrack(mediaStreamTrack)
                 && typeof document === 'object'
                 && typeof document.addEventListener === 'function'
@@ -3726,7 +3855,7 @@ function restartWhenInadvertentlyStopped(localMediaTrack) {
 }
 module.exports = mixinLocalMediaTrack;
 
-},{"../../util":131,"../../util/constants":124,"../../util/detectsilentaudio":125,"../../util/detectsilentvideo":126,"../../util/documentvisibilitymonitor.js":127,"../../util/localmediarestartdeferreds":134,"../../webaudio/workaround180748":154,"../../webrtc":157,"../../webrtc/util":170,"./sender":38}],24:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/constants":124,"../../util/detectsilentaudio":125,"../../util/detectsilentvideo":126,"../../util/documentvisibilitymonitor.js":127,"../../util/localmediarestartdeferreds":134,"../../webaudio/workaround180748":154,"../../webrtc":157,"./sender":38}],24:[function(require,module,exports){
 /* eslint new-cap:0 */
 'use strict';
 var __extends = (this && this.__extends) || (function () {
@@ -3909,7 +4038,7 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var detectSilentVideo = require('../../util/detectsilentvideo');
 var mixinLocalMediaTrack = require('./localmediatrack');
 var VideoTrack = require('./videotrack');
@@ -3940,7 +4069,7 @@ var LocalVideoTrack = /** @class */ (function (_super) {
     function LocalVideoTrack(mediaStreamTrack, options) {
         var _this = this;
         options = Object.assign({
-            workaroundSilentLocalVideo: (guessBrowser() === 'safari' || isIOSChrome())
+            workaroundSilentLocalVideo: isIOS()
                 && isUserMediaTrack(mediaStreamTrack)
                 && typeof document !== 'undefined'
                 && typeof document.createElement === 'function'
@@ -4239,7 +4368,7 @@ function workaroundSilentLocalVideo(localVideoTrack, doc) {
  */
 module.exports = LocalVideoTrack;
 
-},{"../../util":131,"../../util/detectsilentvideo":126,"../../webrtc/util":170,"./localmediatrack":23,"./videotrack":42}],26:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/detectsilentvideo":126,"./localmediatrack":23,"./videotrack":42}],26:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -4302,9 +4431,9 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-var _a = require('../../webrtc/util'), guessBrowser = _a.guessBrowser, isIOSChrome = _a.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var MediaStream = require('../../webrtc').MediaStream;
-var _b = require('../../util'), waitForEvent = _b.waitForEvent, waitForSometime = _b.waitForSometime;
+var _a = require('../../util'), waitForEvent = _a.waitForEvent, waitForSometime = _a.waitForSometime;
 var localMediaRestartDeferreds = require('../../util/localmediarestartdeferreds');
 var Track = require('./');
 /**
@@ -4334,7 +4463,7 @@ var MediaTrack = /** @class */ (function (_super) {
     function MediaTrack(mediaTrackTransceiver, options) {
         var _this = this;
         options = Object.assign({
-            playPausedElementsIfNotBackgrounded: (guessBrowser() === 'safari' || isIOSChrome())
+            playPausedElementsIfNotBackgrounded: isIOS()
                 && typeof document === 'object'
                 && typeof document.addEventListener === 'function'
                 && typeof document.visibilityState === 'string'
@@ -4649,7 +4778,7 @@ function shimMediaElement(el, onUnintentionallyPaused) {
 }
 module.exports = MediaTrack;
 
-},{"../../util":131,"../../util/localmediarestartdeferreds":134,"../../webrtc":157,"../../webrtc/util":170,"./":18}],28:[function(require,module,exports){
+},{"../../util":131,"../../util/browserdetection":122,"../../util/localmediarestartdeferreds":134,"../../webrtc":157,"./":18}],28:[function(require,module,exports){
 'use strict';
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -5383,7 +5512,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from) {
     return to;
 };
 var _a = require('../../util/constants'), E = _a.typeErrors, trackPriority = _a.trackPriority;
-var _b = require('../../webrtc/util'), guessBrowser = _b.guessBrowser, isIOSChrome = _b.isIOSChrome;
+var isIOS = require('../../util/browserdetection').isIOS;
 var documentVisibilityMonitor = require('../../util/documentvisibilitymonitor.js');
 function mixinRemoteMediaTrack(AudioOrVideoTrack) {
     /**
@@ -5417,7 +5546,7 @@ function mixinRemoteMediaTrack(AudioOrVideoTrack) {
                 // NOTE(mpatwardhan): WebKit bug: 212780 sometimes causes the audio/video elements to stay paused when safari
                 // regains foreground. To workaround it, when safari gains foreground - we will play any elements that were
                 // playing before safari lost foreground.
-                workaroundWebKitBug212780: (guessBrowser() === 'safari' || isIOSChrome())
+                workaroundWebKitBug212780: isIOS()
                     && typeof document === 'object'
                     && typeof document.addEventListener === 'function'
                     && typeof document.visibilityState === 'string'
@@ -5630,7 +5759,7 @@ function playIfPausedWhileInBackground(remoteMediaTrack) {
  */
 module.exports = mixinRemoteMediaTrack;
 
-},{"../../util/constants":124,"../../util/documentvisibilitymonitor.js":127,"../../webrtc/util":170}],35:[function(require,module,exports){
+},{"../../util/browserdetection":122,"../../util/constants":124,"../../util/documentvisibilitymonitor.js":127}],35:[function(require,module,exports){
 'use strict';
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
@@ -20661,36 +20790,37 @@ var __read = (this && this.__read) || function (o, n) {
 function isAndroid() {
     return /Android/.test(navigator.userAgent);
 }
-/**
- * Check whether the current browser is an iOS device.
- * @returns {boolean}
- */
-function isIOS() {
-    return /iPad|iPhone|iPod/.test(navigator.userAgent);
-}
 /**
  * Detects whether or not a device is an Apple touch screen device.
  * @returns {boolean}
  */
 function hasTouchScreen() {
-    return navigator && navigator.maxTouchPoints &&
-        navigator.maxTouchPoints > 2;
+    return !!(navigator && navigator.maxTouchPoints && navigator.maxTouchPoints > 2);
 }
 /**
- * Detects whether or not a device is an iPad
+ * Detects whether or not a device is an iPad.
  * @returns {boolean}
  */
 function isIpad() {
-    return hasTouchScreen() && window.screen.width >= 744 &&
-        (/Macintosh/i.test(navigator.userAgent) || /iPad/.test(navigator.userAgent) || /iPad/.test(navigator.platform));
+    return hasTouchScreen() && window.screen.width >= 744 && (/Macintosh/i.test(navigator.userAgent)
+        || /iPad/.test(navigator.userAgent)
+        || /iPad/.test(navigator.platform));
 }
 /**
- * Detects whether or not a device is an iPhone
+ * Detects whether or not a device is an iPhone.
  * @returns {boolean}
  */
 function isIphone() {
-    return hasTouchScreen() && window.screen.width <= 476 &&
-        (/Macintosh/i.test(navigator.userAgent) || /iPhone/.test(navigator.userAgent) || /iPhone/.test(navigator.platform));
+    return hasTouchScreen() && window.screen.width <= 476 && (/Macintosh/i.test(navigator.userAgent)
+        || /iPhone/.test(navigator.userAgent)
+        || /iPhone/.test(navigator.platform));
+}
+/**
+ * Check whether the current device is an iOS device.
+ * @returns {boolean}
+ */
+function isIOS() {
+    return isIpad() || isIphone();
 }
 /**
  * Check whether the current browser is a mobile browser
@@ -29532,7 +29662,7 @@ module.exports={
   "name": "twilio-video",
   "title": "Twilio Video",
   "description": "Twilio Video JavaScript Library",
-  "version": "2.24.3",
+  "version": "2.25.0",
   "homepage": "https://twilio.com",
   "author": "Mark Andrus Roberts <mroberts@twilio.com>",
   "contributors": [
@@ -29633,7 +29763,7 @@ module.exports={
     "test:serversiderender": "mocha ./test/serversiderender/index.js",
     "test:integration:adapter": "node ./scripts/karma.js karma/integration.adapter.conf.js",
     "test:integration": "npm run build:es5 && node ./scripts/karma.js karma/integration.conf.js",
-    "test:umd:install": "npm install puppeteer@5.5.0",
+    "test:umd:install": "npm install puppeteer@19.2.2",
     "test:umd": "mocha ./test/umd/index.js",
     "test:crossbrowser:build:clean": "rimraf ./test/crossbrowser/lib ./test/crossbrowser/src/browser/index.js",
     "test:crossbrowser:build:lint": "cd ./test/crossbrowser && tslint --project tsconfig.json",