1.15.1 (October 16, 2023)
Bug Fixes
- Fixed a Chrome issue where audio is choppy when another application is also using the audio devices.
1.15.0 (Feb 28, 2023)
New Features
WebRTC API Overrides (Beta)
The SDK now allows you to override WebRTC APIs using the following options and events. If your environment supports WebRTC redirection, such as Citrix HDX's WebRTC redirection technologies, your application can use this new beta feature for improved audio quality in those environments.
Device.Options.enumerateDevices - Overrides the native MediaDevices.enumerateDevices API.Device.Options.getUserMedia - Overrides the native MediaDevices.getUserMedia API.Device.Options.RTCPeerConnection - Overrides the native RTCPeerConnection class.connection.on('audio', handler(remoteAudio)) - Emitted after the HTMLAudioElement for the remote audio is created.
Known Issues
- Volume levels currently report as zero and do not reflect the actual volume levels of the call. This issue does not affect the quality of the call but, might affect application behavior if you rely on these values.
- Only inbound calls are currently supported. Outbound calls will be available in a future release.
- Using
Device.audio.speakerDevices and Device.audio.setInputDevice will not properly switch speaker and microphone devices. You need to recreate the Device object or refresh the page when the default microphone or speaker device is changed.
1.14.0 (Jan 27, 2021)
New Features
Allow Connection specific ICE Servers
Developers can now opt to override rtcConfiguration set within Device.options per specific outgoing and incoming Connections.
To use this feature, a new parameter rtcConfiguration can be passed to Device.connect and Connection.accept. The function signatures are now described as below.
Device.connect(params?: Record<string, string>,
audioConstraints?: MediaTrackConstraints | boolean,
rtcConfiguration?: RTCConfiguration);
Connection.accept(audioConstraints?: MediaTrackConstraints | boolean,
rtcConfiguration?: RTCConfiguration);
Passing the rtcConfiguration parameter to these functions will override any previously set rtcConfiguration within Device.options but not affect any other members set within Device.options.
1.13.1 (Jan 11, 2021)
Additions
- Added support for Tokyo and Sydney interconnect locations. These edges can be used by interconnect customers by specifying
{ edge: 'sydney-ix' } or { edge: tokyo-ix' } in Device.setup() or new Device() options.
1.13.0 (Nov 11, 2020)
1.13.0-beta2 has been promoted to 1.13.0 GA. Here's a summary of what is new in 1.13.0.
New Features
Voice diagnostics using runPreflight API
The SDK now supports a preflight test API which can help determine Voice calling readiness. The API creates a test call and will provide information to help troubleshoot call related issues. Please see the following for more details.
Changes
Connection.on('warning') now provides data associated with the warning. This data can provide more details about the warning such as thresholds and WebRTC samples collected that caused the warning. The example below is a warning for high jitter. Please see Voice Insights SDK Events Reference for a list of possible warnings.
connection.on('warning', (warningName, warningData) => {
console.log({ warningName, warningData });
});
Example output:
{
"warningName": "high-jitter",
"warningData": {
"name": "jitter",
"values": [35, 44, 31, 32, 32],
"samples": [...],
"threshold": {
"name": "max",
"value": 30
}
}
}
Added high-packets-lost-fraction network warning. This new warning is raised when the average of the most recent seven seconds of packet-loss samples is greater than 3%. When the average packet-loss over the most recent seven seconds is less than or equal to 1%, then the warning is cleared.
The behavior for raising the constant-audio-level warning has been updated. Now, the most recent ten seconds of volume values are recorded and then analyzed. If the standard deviation of these samples is less than 1% of the maximum audio value, then the warning is raised. When the standard deviation is greater than 1% and the warning has already been raised, then the warning is cleared.
We now log an outgoing event to Insights when making an outbound call. This event also contains information whether the call is a preflight or not.
Added a boolean field to the signaling payload for calls initiated by Device.runPreflight for debugging purposes.
1.13.0-beta2 (Sept 10, 2020)
Breaking Changes
Additions
- We now emit a PreflightTest.Warning (
insights-connection-error) the first time Insights emits an
error, and add that Warning in Report.warnings.
Added signaling timing information in the PreflightTest.Report.networkTiming object.
Example:
const preflightTest = Device.testPreflight(token, options);
preflightTest.on(PreflightTest.Events.Completed, (report) => {
console.log(report.networkTiming);
});
Bug Fixes
- Fixed an issue where the browser console is flooded with errors after a network handover.
1.13.0-beta1 (July 7, 2020)
Bug Fixes
- Fixed an issue where preflight is not muting the audio output after output audio devices are updated.
1.13.0-preview1 (June 17, 2020)
New Features - Preview
The SDK now supports a preflight test API which can help determine Voice calling readiness. The API creates a test call and will provide information to help troubleshoot call related issues. This new API is a static member of the Device class and can be used like the example below. Please see API Docs for more details about this new API.
const preflight = Device.testPreflight(token, options);
preflight.on('completed', (report) => console.log(report));
preflight.on('failed', (error) => console.log(error));
Connection.on('warning') now provides data associated with the warning. This data can provide more details about the warning such as thresholds and WebRTC samples collected that caused the warning. The example below is a warning for high jitter. Please see Voice Insights SDK Events Reference for a list of possible warnings.
connection.on('warning', (warningName, warningData) => {
console.log({ warningName, warningData });
});
Example output:
{
"warningName": "high-jitter",
"warningData": {
"name": "jitter",
"values": [35, 44, 31, 32, 32],
"samples": [...],
"threshold": {
"name": "max",
"value": 30
}
}
}
1.12.5 (Sept 22, 2020)
Bug Fixes
- Fixed an issue introduced in Safari 13.1 that caused calls to continue playing after navigating away from the page.
- Fixed an issue where the disconnect sound plays after the caller cancelled the incoming call.
1.12.4 (Sept 4, 2020)
Bug Fixes
- Fixed an issue where an error is thrown if
Device is imported and run in a NodeJS environment.
Changes
- The twilio.js SDK no longer supports the deprecated Edge Legacy browsers that rely on ORTC. See our deprecation notice for more details.
1.12.3 (August 14, 2020)
Changes
- We now log selected ICE candidate pair to Insights. This will help with isolating issues should they arise.
- Fixed an issue where the transportClose event listener was not being cleaned up appropriately when a Connection is closed, causing MaxListenersExceededWarning on the console.
1.12.2 (August 6, 2020)
Bug Fixes
- Fixed an issue where calls on Safari 13.1.2 will intermittently fail and raise a 31003 error when establishing media connection. This usually happens when receiving or initiating the call.
1.12.1 (June 29, 2020)
Bug Fixes
- Fixed an issue where a
device.on('disconnect') is emitted before raising a device.on('cancel') event. This usually happens when the caller cancels the incoming call before the SDK accepts it.
- Fixed an issue where
sao-paolo is expected as an edge name instead of sao-paulo.
1.12.0 (June 11, 2020)
New Features
SHAKEN/STIR Verification Status for incoming calls
Twilio Client's Connection class now has Connection.callerInfo.isVerified, that can be used to display a trust indicator to the recipient when an incoming call, say from the public telephone network, has been verified under the SHAKEN/STIR framework.
A verified call that has been given highest attestation under SHAKEN/STIR means that the carrier that originated the call both (1) knows the identity of the caller, and (2) knows the caller has the right to use the phone number as the caller ID.
When your application receives a request webhook, that has the new StirStatus parameter all you have to do is <Dial><Client> and Twilio will implicitly pass the StirStatus to the Javascript Client.
CallerInfo
The Connection.callerInfo field returns caller verification information about the caller. If no caller verification information is available this will return null.
class Connection {
callerInfo: CallerInfo | null;
}
A CallerInfo provides caller verification information.
interface CallerInfo {
isVerified: boolean;
}
Attributes
isVerified - Whether or not the caller's phone number has been attested by the originating carrier and verified by Twilio using SHAKEN/STIR. True if the caller has been verified at highest attestation 'A', false if the caller has been attested at any lower level or verification has failed.
Example
device.on('incoming', connection => {
if (connection.callerInfo && connection.callerInfo.isVerified) {
console.log('This caller is verified by a carrier under the SHAKEN and STIR call authentication framework');
}
});
Read here to learn more about making and receiving SHAKEN/STIR calls to/from the public telephone network.
1.11.0 (May 21, 2020)
New Features
Twilio Edge Locations
This release includes support for the expansion of Twilio’s Global Infrastructure via Edge Locations which allows connectivity control into and out of Twilio’s platform. The Voice Client JS SDK uses these Edges to connect to Twilio’s infrastructure via the new parameter Twilio.Device.Options.edge. This new parameter supersedes the now deprecated Twilio.Device.Options.region. See Twilio.Device.Options.edge API documentation for migration instructions.
Example
const device = new Device(token, { edge: 'ashburn' });
Twilio Edge Fallback Support (Beta)
Deployments designed to connect to multiple Twilio Edge locations can take advantage of the new fallback mechanism. To enable the edge fallback, specify an array of edge names via Twilio.Device.Options.edge. When enabled and a connection failure is encountered, the SDK will reattempt the connection to the next region in the list. For more details about how the fallback works, see Twilio.Device.Options.edge documentation.
Example
const device = new Device(token, { edge: ['ashburn-ix', 'san-jose-ix', 'roaming' ] });
Application Name and Version Logging Support
This release also introduces two new Device options: appName and appVersion. The values will be logged to Insights. These can be used to correlate other insights events with the application generating them. This is useful for debugging purposes in cases where multiple versions are deployed e.g. When performing A/B testing.
Deprecations
Microsoft Edge Legacy is now deprecated. Running device.setup() on this browser will result with the console warning below.
Microsoft Edge Legacy (https:
is deprecated and will not be able to connect to Twilio to make or receive calls after September 1st, 2020.
Please see this documentation for a list of supported browsers
https:
1.10.3 (Apr 29, 2020)
Bug Fixes
- Fixed an issue where
rtcSample.rtt raised by Connection.on('sample', rtcSample => ...) was reported in seconds instead of milliseconds in Firefox. If your application is converting rtcSample.rtt to milliseconds in Firefox, please update your application to account for this change. (CLIENT-7014)
- Fixed an issue where a call doesn't get disconnected after the signaling server emits a
cancel event. (CLIENT-7576)
Additions
- Added tests for Signaling payloads. (CLIENT-4533)
1.10.2 (Apr 22, 2020)
Bug Fixes
- Fixed an issue where an Angular project will not build when the SDK is used as a module. (CLIENT-7544)
Fixed an issue where certain device event handlers, when an exception is thrown, causes some connection event handlers to stop working. This causes potential side effects such as incoming ringtone not being able to stop after receiving a call.
Example
In the following example, connection.on('accept') will not trigger if device.on('connect') throws an error. With this fix, connection.on('accept') handler should now receive the event.
connection.on('accept', () => {
console.log('This is my "accept" handler.');
});
device.on('connect', () => {
throw 'Something went wrong.';
});
Events affected
The following are the events affected and should be fixed with this release.
| Device Events | Affected Connection Events |
|:------------------------|:----------------------------|
| device.on('connect') | connection.on('accept') |
| device.on('error') | connection.on('error') |
| device.on('cancel') | connection.on('cancel') |
| device.on('disconnect') | connection.on('disconnect') |
As mentioned in our public documentation, the Device and Connection objects are EventEmitters. This release doesn't change the default behavior of EventEmitters, where if one of the handlers on the same EventEmitter object throws an exception, the rest of the event handlers will not receive the event. Consider the following example.
const myEmitter = new EventEmitter();
myEmitter.on('testevent', () => console.log('This is my handler 1'));
myEmitter.on('testevent', () => {
console.log('This is my handler 2');
throw 'Something went wrong';
});
myEmitter.on('testevent', () => console.log('This is my handler 3'));
myEmitter.emit('testevent');
In the above example, testevent has three handlers and are on the same EventEmitter object myEmitter. If one of the handlers, in this case handler number 2, throws an error, the rest of the event handlers will not receive the event. In this case, handler 3 will not receive testevent. This is a normal behavior on EventEmitters and this SDK release doesn't change this behavior. This release only fixes the issue where if the events are comming from two different EventEmitter objects - Connection and Device;
1.10.1 (Apr 6, 2020)
Improvements
Typescript declarations are now included with our NPM package. (CLIENT-7427, GH-36)
In the following example, Device, Connection, and their functions should have the correct typings.
import { Device, Connection } from 'twilio-client';
const token = ...;
const deviceOptions = ...;
const device: Device = new Device(token, deviceOptions);
const connection: Connection = device.connect(...);
...
connection.disconnect();
Bug Fixes
- Fixed an issue where
Device.on('incoming') event is not raised when the incoming sound is stopped right after playing it. This is a timing issue which can happen if multiple incoming connections comes in almost at the same time. (CLIENT-7482, GH-129)
- Fixed an issue causing Android chrome to throw the error
This browser does not support audio output selection. We now check if this is supported on the browser before attempting to update the output device. (CLIENT-7373, GH-124)
1.10.0 (Feb 19, 2020)
Improvements
For example, to set the log level:
import { getLogger } from 'loglevel';
const logger = getLogger(Device.packageName);
logger.setLevel('DEBUG');
- https://sdk.twilio.com is now being used for serving the sound files. (CLIENT-7221)
- Updated npm dependencies to support node version 12. (CLIENT-7024)
- We now log RTCDtlsTransport state changes to Insights. This will help with isolating issues should they arise. (CLIENT-6913)
1.9.7 (Dec 6, 2019)
Added an experimental feature to enable
Aggressive ICE Candidate Nomination. This feature can be enabled by setting forceAggressiveIceNomination to true. If your deployment is on devices with one network interface and your RTT to Twilio's Servers is typically greater than 96 milliseconds, this feature may help reduce call connect time. As this is an experimental feature, we dont recommend enabling this until after testing it thoroughly in your deployment.
Example:
Device.setup(TOKEN, {
forceAggressiveIceNomination: true
});
1.9.6 (Nov 22, 2019)
Improvements
- New improvements to media reconnection. ICE restart is now also requested when ICE gathering fails (transitions to complete and no ICE candidates were gathered), or ICE gathering exceeds 15 seconds and no ICE candidates were gathered.
- Locally gathered ICE candidates are now logged for debugging purposes. (CLIENT-6957)
1.9.5 (Nov 5, 2019)
Improvements
You can now connect to our interconnect region in Singapore by setting the region option to sg1-ix. See Twilio Client Regions for the list of supported regions. Note that with this release, to support new regions without requiring an SDK update, we have removed the check for the region name passed to Device.setup. If an unsupported region is supplied, Device.on('error') will be called. (CLIENT-6831)
We now log PeerConnection state changes to Insights. This will help with isolating issues should they arise. (CLIENT-6869)
1.9.4 (Oct 28, 2019)
Improvements
- We now report
audioInputLevel and audioOutputLevel within the last second in the connection sample object Connection.on('sample', handler(sample)). (CLIENT-6779)
Bug Fixes
- Update querystring to clear cached audio files without CORS headers. (CLIENT-6832)
- Fixed an issue where
constant-audio-input-level warning is not being emitted. (CLIENT-6779)
1.9.3 (Oct 15, 2019)
Bug Fixes
- Fixed an issue where audio files sometimes shows CORS errors on the console. (CLIENT-6786, CLIENT-6805)
1.9.2 (Oct 3, 2019)
Bug Fixes
- Fixed an issue on Safari where
sample.mos, emitted from Connection.on('sample', handler(sample)), is always null. (CLIENT-6664)
1.9.1 (Sept 13, 2019)
Improvements
- The Device sounds are now cached. They are only downloaded when
Device.setup() is invoked. (CLIENT-6632)
1.9.0 (Sept 10, 2019)
New Features
Max Average Bandwidth API
By default, the Opus codec is set up with a transmission rate of around 32 kbps (40-50kbps on the wire). With this release, you are able to set a custom max average bitrate to better control how much bandwidth your VoIP application should use. See RFC-7587 section 7.1 for information about Max Average Bitrate.
The main purpose of this API is to set a lower max average bitrate to minimise bandwidth usage. This is particularly useful in deployments where bandwidth is at a premium. Where bandwidth is not of concern, you do not need to use this API. Max Average Bitrate can be set to as low as 6,000bps and as high as 51,000 bps. Values outside this range are ignored and the default Opus operation mode is used. See API Docs for more information.
As would be expected, lowering the max average bitrate impacts audio quality. We don’t recommend setting max average bitrate to a value below 8,000 bps. On the other hand, setting values over 32,000 bps will have negligible audio quality improvements.
For example, to set a new max average bitrate to 16,000 bps:`
Device.setup(TOKEN, {
codecPreferences: ['opus', 'pcmu'],
maxAverageBitrate: 16000,
});
Bug Fixes
- Fixed an issue causing multiple devices that are created in the same tab to get disconnected when one of the devices disconnects a connection. (CLIENT-6581)
1.8.1 (Aug 28, 2019)
Bug Fixes
Fixed an issue causing audio levels to be reported as zero when running as an extension, or when the browser tab is inactive or minimized. (CLIENT-6539)
Fixed an issue causing Connection.status() to return pending instead of closed after calling Connection.reject(). (CLIENT-6534)
1.8.0 (Aug 20, 2019)
New Features
This feature, when enableIceRestart is enabled, allows for detecting when media connection fails which will trigger automatic media reconnection, and for detecting when media connection is restored. (CLIENT-6444)
New Events
Connection.on('reconnecting', handler(error)) - raised when media connection fails and automatic reconnection has been started. During this period, Connection.status() will be set to reconnecting.
error - Error object { code: 53405, message: 'Media connection failed.' }- Media reconnection triggers
- ICE Connection state transitions to
disconnect and bytes sent and received in the last 3 seconds is zero.
- ICE Connection state or PeerConnection state transitions to
failed. Only Chrome browser will attempt an ICE restart with this trigger. Other browsers will immediately disconnect the call and raise an error 31003. This is due to browsers not fully supporting connection states during an ICE restart.
Connection.on('reconnected', handler()) - raised when media connection has been restored which is detected when media starts flowing. Once reconnected, Connection.status() will be set to open.
Retries
ICE restarts will be retried in the event that previous ICE restarts are unsuccessful. Retry attempts will happen when ICE Connection state or PeerConnection state transitions to failed. If more than 30 seconds has elapsed during this transition, the call will disconnect and raise an error 31003.
Improvements
- Added de1-ix to valid list of regions. (CLIENT-6455)
- Added
Device.version to return sdk version
- When applicable, errors emitted through Device.on('error') and Connection.on('error') now contain a twilioError field, providing more information about the error. This twilioError represents the new TwilioError format that will become the default Error format in 2.0. (CLIENT-5908, CLIENT-5909)
{
code: number,
message: string,
...
twilioError: {
causes: Array<string>,
code: number,
description: string,
explanation: string,
solutions: Array<string>,
message: string,
stack: string
}
}
Bug Fixes
- Fixed an issue causing local environment information to get bundled into the build artifact in local npm builds. (CLIENT-6392)
- Fixed an issue where ringing will not stop when network is disconnected. (CLIENT-6336)
1.7.6 (Jul 23, 2019)
New Features
This feature was first introduced in 1.7.4 and was enabled by default.
With this release, we have introduced the enableIceRestart reconnect flag to enable or disable Automatic Media Reconnection. The default is disabled. This will allow you to transition your code to utilise this feature. (CLIENT-6400, CLIENT-6407)
Improvements
- We now show an error in the console if the page is not loaded over https for unsupported browsers. (CLIENT-6361)
Bug Fixes
- Fixed a bug where active connection gets disconnected when the token expires. (CLIENT-6383)
- Fixed a bug where an answer during ICE reconnection is applied without a valid offer, resulting into a console error
Failed to set remote answer sdp: Called in wrong state: kStable. (CLIENT-6372)
1.7.5 (Jul 5, 2019)
Improvements
- Checking whether plan-b or unified-plan is default on the browser now happens on
Device.setup() or on device initialization with a token, instead of on page load. (CLIENT-6279)
Bug Fixes
- Fixed a bug where ICE restarts will continue to retry when a call gets disconnected while ringing. (CLIENT-6319)
Device.destroy now disconnects all connections. (CLIENT-6319)- Fixed a bug where answer is applied multiple times after creating an offer. (CLIENT-6335)
- Fixed a bug where low-bytes warning is raised if total bytes sent and received is zero or not supported. (CLIENT-6341)
- Fixed a bug where ICE restart will not stop when connection drops on Firefox. (CLIENT-6342)
Known Issues
Updated July 16, 2019
The introduction of Automatic Media Reconnection in 1.7.4 is enabled by default. This functionality may affect program flow if you rely on Device.on('error', …) with error code 31003 to update your UI or reconnect logic. This error is not thrown at the time of media interruption any longer. It is now sent after ICE restart is attempted and fails which may take 10s of seconds.
1.7.4 (June 21, 2019)
New Features
A call may be inadvertently disconnected when media is temporarily lost. With this release, we will attempt to reconnect the media before dropping the call with a process known as ICE restart.
If you are relying on Device.on('error', …) with error code 31003, to update your UI or to initiate a reconnect, you will need to update your code to use Device.on('offline', …) instead. The 31003 error code may not be reported for some time as ICE restarts are continually attempted.
Updated July 16, 2019
We have identified this as a potential breaking change and we will include an opt-in feature switch in the 1.7.6 release. We apologize for any inconvenience this may have caused you.
Improvements
- We now report bytesSent and bytesReceived within the last second in the webrtc sample object (
RTCSample).
- We now begin monitoring for warnings 5 seconds after the start of a call (originally at 20 seconds).
Bug Fixes
- Fixed a bug where changing the input device then later calling
Connection.mute() will not work.
- Fixed a bug causing some signaling errors to not trigger an error event from Connection.
1.7.3 (May 16, 2019)
Improvements
- We now report audio codec and whether DSCP is enabled to Insights Metrics.
- Added new getter on Connection,
Connection.codec, which will be populated with the audio codec used
in the call as soon as the SDK receives that information from WebRTC. We currently do not get the audio
code from FireFox.
- We now emit a webrtc sample object (
RTCSample) every second through a new event, Connection.on('sample').
Bug Fixes
- Fixed a bug causing the input stream to not be released after a Connection is created without calling
Device.audio.setInputDevice and then later calling Device.audio.setInputDevice during the call
when using a browser that supports the unified-plan SDP semantic.
- Fixed an issue where audio ring tone plays on a different output device after reconnecting an external output device.
1.7.2 (May 3, 2019)
Bug Fixes
- Fixed an issue where some audio resources weren't being released after a call. Thank you to
Tsuchihashi-lvgs for helping us isolate this issue.
1.7.1 (Apr 29, 2019)
Unified Plan support
- If you are using twilio-client.js versions 1.7.0 or older, changing audio input devices during a call will break on Safari 12.2 onwards.
- twilio-client.js will now use the browser default SDP format. For Google Chrome 72+, Safari 12.2+ and Firefox since forever, the default format is Unified Plan. See this advisory for SDP format migration impact
Improvements
- Updated the algorithm used to report the "Audio input level" and "Audio output level" Insight metrics. The levels are obtained directly from an AudioContext and are no longer read out from webrtc's legacy stats
1.7.0 (Apr 4, 2019)
Additions
- Added the
codecPreferences option to Device.setup options. Passing an array of ordered codec
names will change the preferred audio codecs for voice media. Default is ['pcmu', 'opus'].
1.6.10 (Mar 20, 2019)
Bug Fixes
- In Chrome 72, the implementation of DSCP support and related APIs changed. As a result, prior versions
of twilio.js stopped tagging audio packets with EF. This release restores EF tagging when
Device.Options.dscp == true (this is the default), by setting RtpEncoder.networkPriority to "high"
in addition to applying the "googDscp" PeerConnection constraint.
1.6.9 (Feb 21, 2019)
- Added
device.audio.setAudioConstraints() and device.audio.unsetAudioConstraints(). These
methods allow the setting of a MediaTrackConstraints object to be applied to every time
device.audio.setInputDevice() is called, and any time an active input device is lost and
the SDK gets new user media to fall back to another input device. If an input device is already set
via device.audio.setInputDevice(), these methods will immediately call setInputDevice() internally
and return the resulting Promise, otherwise they will return a resolved Promise. The currently
set audio constraints can be seen on the new read-only field, device.audio.audioConstraints, which
defaults to null. Example:device.audio.setAudioConstraints({ echoCancellation: true });
await device.audio.setInputDevice('default');
device.audio.setAudioConstraints({
autoGainControl: false,
echoCancellation: false,
noiseSuppression: false,
}).then(() => {
}, err => {
await device.audio.unsetAudioConstraints();
});
1.6.8 (Feb 13, 2019)
Bug Fixes
Browser Support
- We are now using RTCP values for RTT where available. Initially, this will not affect Chrome
because Chrome has not yet implemented support.
Additionally, having access to RTT will allow FireFox to calculate and report MOS, however FireFox is
currently affected by a regression causing
jitter to be reported as 0, which will make MOS scores appear slightly better than they actually
are until it's fixed.
1.6.7 (Feb 12, 2019)
Insights
- Now sending ice gathering state change events to Insights as
ice-gathering-state.
Bug Fixes
- Fixed a regression introduced in 1.6.0 causing falsey TwiML params to be stripped.
Twilio.Device.audio.disconnect() will now toggle whether the disconnect sound should play while
already on an active call.
Additions
- Increased default websocket backoff maximum from 3000ms to 20000ms, and added the
backoffMaxMs
option to Device.setup() options that takes a time in milliseconds to override this default. The
minimum allowable value is 3000ms.
1.6.6 (Feb 5, 2019)
Dependencies
- Updated
ws dependency to latest. Only affects npm package because the CDN artifact of twilio.js uses
the browser's WebSocket implementation.
1.6.5 (Dec 3, 2018)
Bug Fixes
- Fixed a bug introduced in 1.6.3 preventing metrics from being published.
1.6.4 (Nov 30, 2018)
Additions
- Now sending NetworkInformation stats to Insights.
1.6.3 (Nov 19, 2018)
Bug Fixes
- Stopped sending Insights events that aren't associated with a CallSid or TempCallSid as they can't
be tracked.
Additions
- Added Device.setup option
{ fakeLocalDTMF: true } that uses imitation DTMF sounds instead of the default
real DTMF sounds, preventing an issue where DTMF tones would sometimes register twice.
1.6.2 (Nov 8, 2018)
Additions
- Added
{ sdpSemantics: 'plan-b' } to the default RTCConfiguration
object to ensure forward compatibility until unified plan is fully supported in the SDK.
- Added an
rtcConfiguration field to IDeviceOptions, which takes an RTCConfiguration
object that gets passed to any created RTCPeerConnections. Example:
Device.setup(token, {
rtcConfiguration: { iceTransportPolicy: 'relay' },
});
1.6.1 (Oct 3, 2018)
Bug Fixes
- Re-assigning the master output device mid-call, particularly when calling
device.disconnectAll(),
will no longer throw an exception or pause script execution.
- Fixed
closeProtection feature
- Added EventEmitter interface (
on, addListener, removeListener, etc...) to Device singleton.
1.6.0 (Aug 29, 2018)
Additions
Added the ability to receive and handle incoming calls while on an active call behind a
new flag, allowIncomingWhileBusy. When set to true, Device's default behavior of
silently ignoring the incoming call is removed, and the incoming call will instead cause
Device to emit an "incoming" event. If accepted, the prior active call will be immediately
disconnected, and the incoming call will be accepted, replacing the prior active call.
Twilio.Device.setup(token, { allowIncomingWhileBusy: true });
Added support for custom incoming parameters from TwiML as Map<string, string> Connection.customParameters.
When a TwiML application sends custom parameters using the <Parameter> noun, these parameters will be
added to .customParameters. For example:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Dial>
<Client>
<Identity>alice</Identity>
<Param name="foo" value="bar"/>
<Param name="baz" value="123"/>
</Client>
</Dial>
</Response>
device.on('incoming', connection => {
assert.equal(connection.customParameters.get('foo'), 'bar');
assert.equal(connection.customParameters.get('baz'), '123');
});
1.5.1 (Aug 15, 2018)
Bug Fixes
- Updated Insights logic to point to new endpoint, fully supporting Insights when using Access Tokens
1.5.0 (Aug 8, 2018)
Additions
Twilio.Device may now be instantiated multiple times via
const device = new Twilio.Device(token, options);
Twilio.Device.setup() may now be called with Access Tokens, in addition to Capability Tokens (CLIENT-4646)
Twilio.Device.destroy() will now completely clear out the Device, allowing Device.setup()
to be called with a new set of options (CLIENT-4951)
Bug Fixes
- We now ensure all Audio resources are cleaned up after closing a Connection (CLIENT-4901)
Deprecations
- The handler functions (cancel, connect, disconnect, error, incoming, offline, ready) have been deprecated
in favor of using the EventEmitter interface, which
Device
extends. Using the handlers will log a deprecation warning, and as of the next breaking release
the handlers will be removed. For example, Device.offline(handler) should be re-written as
Device.on('offline', handler). Additionally, listeners can be removed via
Device.removeListener('offline', handler).
1.4.33 (Jul 5, 2019)
Bug Fixes
- Fixed an issue causing incoming ringtone to continue playing after receiving a Connection error.
1.4.32 (Apr 19, 2018)
Bug Fixes
- Fixed an issue causing region passed to Device.setup to be ignored.
1.4.31 (Apr 16, 2018)
Bug Fixes
- Fixed an issue causing WebSocket requests to sometimes be sent out of order after
recovering from a lapse in network connectivity.
1.4.30 (Mar 28, 2018)
Additions
- Fixed an issue where an internal listener wasn't being cleaned up when disconnecting a call,
resulting in EventEmitter warnings when opening more than 10 calls in a row.
Added a Device.isSupported boolean property, which is true if the current browser supports
all of the features necessary to run twilio-client.js. Example usage:
if (Device.isSupported) {
Device.setup(token);
} else {
}
1.4.29 (Mar 6, 2018)
Bug Fixes
- Fixed an issue that broke Webpack- and likely Browserify-based builds.
twilio
