tencent cloud

A version number is in the format of major.minor.patch.

• major: Major version number. If there is major version refactoring, this field will be incremented. Generally, the APIs of different major versions are not compatible with each other.
• minor: Minor version number. The APIs of different minor versions are compatible with each other. If there is a new or optimized API, this field will be incremented.
• patch: Patch number. If there is a feature improvement or bug fix, this field will be incremented.

Note：

• Please update to the latest version in a timely manner for service stability and better online support.
• For notes on version updates, see Update Guide.

Version 4.12.5 Released on May 20, 2022

Bug fixing

• Fixed the issue where an error occurs when the npm package trtc.umd.js is loaded in Internet Explorer.
• Fixed the occasional failure to play the low-quality stream after a subscription change.
• Fixed the issue where, on Chrome 70 and earlier versions, moving the div container causes playback to pause.

Version 4.12.4 Released on May 7, 2022

Improvements

• Sped up room entry.
• Optimized the logic for switching to the low-quality stream.

Bug fixing

• Fixed the occasional failure to invoke the stream-added event.
• Fixed the failure to use Logitech cameras to capture 480p videos on Firefox.
• Fixed the issue where, when the SDK is imported into WKWebview for iPad, an error occurs.

Version 4.12.3 Released on April 19, 2022

Improvements

• Optimized the logic of high-resolution capturing on iOS 13 and 14.
• Optimized the event listening logic to avoid cases where the SDK captures errors on the project side.
• Added support for volume detection on Safari to help with dashboard troubleshooting.

Bug fixing

• Fixed occasional failure to reconnect after a disconnection in the live streaming mode.
• Fixed error getting the audio volume on iOS 11.

Version 4.12.2 Released on April 2, 2022

Improvements
Optimized the volume detecting logic, lowering memory usage and overhead.

Bug fixing

• Fixed the issue where users are occasionally removed from the room (receive the client-banned callback) if they keep the SDK in the background for a long time.
• Fixed the issue where, on iOS 15.2-15.4, echo is heard after camera switch. For details, see WebRTC Known Issues and Solutions > Safari for iOS > Case 11.

Version 4.12.1 Released on March 18, 2022

Notes
See Update Guide.

Improvements

• You can now call the stream.play API multiple times and use it to turn on/off the mirror mode and set playback parameters in real time.
• Optimized the auto capturing resumption logic to fix occasional failure to watermark published streams.

Bug fixing

• Fixed the issue where, after the local user calls muteVideo or unmuteVideo, remote users see a black screen when trying to play the local user’s small stream.
• Fixed the issue where the stream-subscribed callback is received after users switch to the small stream.

Breaking change
Deprecated the mirror property of the TRTC.createStream API. Please use stream.play(elementId, { mirror: true }) instead.

Version 4.12.0 Released on March 4, 2022

Notes
See Update Guide.

New features
Made client.setRemoteVideoStreamType an async API, which returns a promise that indicates whether the switch is successful.

Improvements
Improved scheduling accuracy for services outside the Chinese mainland.

Bug fixing
Fixed the occasional issue where a user is removed from the room due to user_time_out.

Version 4.11.13 Released on February 17, 2022

Improvements

• Updated the TypeScript declaration file in the npm package.
• Optimized the parameter authentication logic of stream.play.

Bug fixing

• Fixed the occasional issue where, on iOS 13, before access is granted, an error occurs when LocalStream.initialize is called.
• Fixed the occasional issue where AUDIO_VOLUME returns 0.

Version 4.11.12 Released on January 11, 2022

Improvements

• Published a TypeScript declaration file to the npm package.
• Optimized the implementation logic of stream.close().
• Optimized the signaling logic for when publish/unpublish is called frequently.

Bug fixing

• Fixed the issue where, on iOS 15.1, desktop webpages crash when streams are published. For details, see WebRTC Known Issues and Solutions > Safari for iOS > Case 7.
• Fixed the issue where LocalStream.setAudioProfile('high') sets the bitrate to 192 Kbps.

Version 4.11.11 Released on December 17, 2021

Improvements

• Optimized the auto capturing resumption logic, circumventing the issue of failure to resume capturing on some low-end Android devices.
• Optimized the autoplay pop-up style.

Version 4.11.10 Released on December 03, 2021

Bug fixing

• Fixed failure to disable the autoplay pop-up via enableAutoPlayDialog: false.
• Fixed failure of the SDK to intercept repeated stream.play calls.

Version 4.11.9 Released on November 26, 2021

Notes
See Update Guide.

Improvements

• Supported displaying a pop-up when autoplay fails. For details, see Use the autoplay dialog provided by SDK.
• Optimized the logic of circumventing the SDK crash issue when streams are published on iOS 15.1. For details, see WebRTC Known Issues and Solutions > Safari for iOS > Case 7.
• To avoid the potential no audio issue, TRTC.getMicrophones no longer returns mics whose deviceId is communications. For details, see WebRTC Known Issues and Solutions > Chrome > Case 8 & 9.
• Optimized the switchDevice policy.
• Improved the accuracy of the encoding/decoding support test in the context of WebView.
• Improved parameter verification for client.startPublishCDNStream, client.stopPublishCDNStream, client.startMixTranscode, and client.stopMixTranscode.

Bug fixing
Fixed the occasional “TRTC not supported” error when client.publish is called.

Version 4.11.8 Released on November 5, 2021

Improvements

• Circumvented the black screen issue during video playback on iOS 15.0. For details, see WebRTC Known Issues and Solutions > Safari for iOS > Case 6.
• Circumvented the issue where the SDK crashes whenever streams are published on iOS 15.1. For details, see WebRTC Known Issues and Solutions > Safari for iOS > Case 7.

Version 4.11.7 Released on September 30, 2021

Improvements

• Required parameter verification for key APIs.
• Supported error messages in Chinese in the development mode (LogLevel set to Debug).
• Improved the recovery success rate in cases of device capturing error.
• Optimized the logic of call resumption after the system wakes up from hibernation.
• Added trtc.esm.js and trtc.umd.js to meet the needs in different scenarios. For details, please see TRTC Web SDK.

Version 4.11.6 Released on September 10, 2021

Improvements
Optimized the signaling scheduling logic, improving the success rate of room entry under poor network conditions. If you are using SDK v4.11.5, we recommend that you update to this version.

Version 4.11.5 Released on September 4, 2021

Improvements

• Supported dynamic signaling channel scheduling, improving connection success rate under poor network conditions.
• Supported cross-room stream mixing. For details, please see Client.startMixTranscode.

Bug fixing

• Fixed occasional failure to receive the stream-added event callback after reconnection.
• Fixed the occasional issue where the frame rate drops to 0 after screen sharing continues for a long time.

Version 4.11.4 Released on August 20, 2021

Improvements

• Improved the accuracy of the H.264 support check for OPPO and vivo built-in browsers.
• Supported auto capturing resumption (triggered in case of capturing error).
• Added timeout logic for the subscribe API. For details, see the error code API_CALL_TIMEOUT.

Bug fixing

• Fixed occasional failure to pull streams on Safari for iOS in some older versions.
• Fixed the issue where the mute status is inaccurate after the switching of devices.
• Fixed the occasional issue where exceptions occur when the room entry API is called again after timeout.
• Fixed the issue where, after a remote stream is unpublished, the audio/video player is not terminated in a timely manner.

Version 4.11.3 Released on July 30, 2021

Improvements

• Optimized the exception handling logic for the publish and subscribe APIs.
• Optimized the recovery policy for audio mixing plugins.

Bug fixing
Fixed occasional inaccuracy of the peer-leave notification.

Version 4.11.2 Released on July 23, 2021

Improvements

• Supported TURN server scheduling, improving connection success rate.
• Added the hasSmall property, which indicates whether a remote user has substream video, to Client.getRemoteMutedState.

Bug fixing

• Fixed the issue where the SDK is unavailable when LocalStorage is disabled.
• Fixed the occasional issue where API requests are not rejected when publishing exceptions occur.

Version 4.11.1 Released on June 25, 2021

Improvements

• Supported the beauty filter plugin. For details, please see Enabling Beauty Filters.
• Improved statistical accuracy.

Version 4.11.0 Released on June 18, 2021

New features
Supported dual streams (primary and substream). For detailed directions, please see Enabling Dual Streams.

Improvements
Optimized the event notification order.

Version 4.10.3 Released on June 11, 2021

Improvements

• Optimized the quality measuring logic and allowed getting call quality statistics via a server-side API.
• Added statistics on RTT and packet loss to ClientEvent.NETWORK_QUALITY.
• Optimized the API verification logic to prevent exceptions caused by repeated calls.
• Optimized the playback logic, reducing audio loading time.

Version 4.10.2 Released on May 24, 2021

Improvements

• Optimized the implementation logic of the switchDevice API, fixing occasional failure to switch to the front camera in Huawei Browser.
• Increased the accuracy of the StreamEvent.CONNECTION_STATE_CHANGED event notification.

Bug fixing

• Fixed occasional failure to play screen sharing streams on native applications.
• Fixed occasional failure to receive the stream-removed event after reconnection.

Version 4.10.1 Released on April 30, 2021

New features

• Added the StreamEvent.CONNECTION_STATE_CHANGED event for the change of stream connection status.
• Added the Client.getTransportStats API, which can be used to obtain downstream RTT.
• Supported using the Client.getRemoteVideoStats API to obtain statistics of the substream (screen sharing).

Improvements
Optimized the implementation logic of the Client.switchRole API.

Bug fixing

• Fixed the issue where the mute event is occasionally triggered before stream-added.
• Fixed the issue where no audio can be heard sometimes after room entry.

Version 4.10.0 Released on April 16, 2021

New features

• Added the client.startPublishCDNStream API for publishing streams to the CDN of Tencent Cloud or a third-party vendor.
• Added the client.stopPublishCDNStream API for stopping publishing streams to the CDN of Tencent Cloud or a third-party vendor.

Improvements
Optimized the parameter verification logic of the localStream.switchDevice, localStream.addTrack, and localStream.removeTrack APIs.

Version 4.9.0 Released on March 19, 2021

New features

• Supported the preset layout mode for On-Cloud MixTranscoding. For details, see the client.startMixTranscode API.
• Supported the callback of volume. For details, see the client.enableAudioVolumeEvaluation API.

Improvements

Changed the default port number of the WebSocket protocol to 443.

Bug fixing

• Fixed the issue where audience cannot receive the callbacks of room entry and exit by an anchor in live streaming scenarios.
• Fixed occasional failure to reconnect when string-type room IDs are used.

Breaking change

Supported returning detailed results of browser compatibility check via TRTC.checkSystemRequirements. For details, please see the API document and Update Guide.

Version 4.8.6 Released on March 1, 2021

Improvements

Supported stereo audio playback.

Note：

Not supported on iOS yet.

Bug fixing

Fixed the issue where the stream-removed event is received when audio and video are disabled on a mobile device.

Version 4.8.5 Released on January 29, 2021

Improvements

• Supported configuring multiple TURN servers via client.setTurnServer.
• Optimized the userId verification logic.

Bug fixing

Fixed the issue where the mute status is occasionally inaccurate after stream pushing starts.

Version 4.8.4 Released on January 15, 2021

Improvements

• Supported dynamically calling the localStream.setVideoProfile API.
• Optimized the data reporting logic of the dashboard.
• Optimized the logic of dealing with autoplay restrictions. For details, please see Suggested Solutions for Autoplay Restrictions.
• Optimized the logic of dealing with failure to recover audio/video capturing after device connection/disconnection. For more information, please see DEVICE_AUTO_RECOVER_FAILED.

Bug fixing

Fixed the issue where the mute status is occasionally inaccurate after stream pushing is resumed.

Version 4.8.3 Released on January 7, 2021

Improvements

Optimized the verification logic for the roomId parameter of the room entry API.

Bug fixing

• Fixed the lack of third-party dependencies in version 4.8.2.
• Fixed the issue where no audio is played when a user subscribes only to audio streams.
• Fixed the occasional issue where no audio is played or getAudioLevel returns 0 after playback is resumed from autoplay restrictions on iOS.

Version 4.8.2 Released on December 31, 2020

Improvements

• Optimized the verification logic for the roomId parameter of the room entry API. For more information, please see the API document and Update Guide.
• Optimized the timing of the peer-join and peer-leave notifications.

Bug fixing

Fixed the occasional Cannot read property 'isConnected' of null error during room exit.

Breaking change

Deleted the disused API setDefaultMuteRemoteStreams. Please use the autoSubscribe parameter of TRTC.createClient instead.

Version 4.8.1 Released on December 25, 2020

Bug fixing

• Fixed occasional failure to hear remote users’ audio on Windows.
• Fixed the issue where the client.getRemoteVideoStats() API returns empty data.

Version 4.8.0 Released on December 18, 2020

New features

• Supported On-Cloud MixTranscoding.
• Supported string-type room IDs on all platforms. For details, please see the useStringRoomId parameter of TRTC.createClient.
• Allowed users to disable auto subscription. For details, please see the autoSubscribe parameter of TRTC.createClient.

Improvements

• Optimized the H.264 support check logic.
• Optimized the device switching logic.
• Optimized the status identification logic of the hasAudio and hasVideo APIs.

Bug fixing

• Fixed occasional failure to reconnect after network disconnection.
• Fixed black screen caused by frequent track adding or removing on Safari for iOS.

Version 4.7.1 Released on November 27, 2020

Improvements

• Optimized the auto capturing resumption logic upon switch of media devices (which may be caused by a loose port or device plugging/unplugging).
• Added the error code DEVICE_AUTO_RECOVER_FAILED, which indicates failure to restart a device.

Bug fixing

• Fixed occasional black screen on Chrome 87.
• Fixed the issue where, when both camera and screen sharing streams are pushed from a native application, users on web fail to pull screen sharing streams after subscribing to and unsubscribing from the streams repeatedly.

Version 4.7.0 Released on November 20, 2020

New features

Supported desktop Firefox M56+ and Edge M80+.

Improvements

• Optimized the upstream bitrate control logic.
• Optimized the retry logic for getting media devices.
• Optimized the WebSocket reconnection logic.
• Supported auto push resumption when a mic is plugged in/unplugged during audio mixing, optimizing the auto push resumption logic.

Breaking change

Supported returning detailed results of browser compatibility check via TRTC.checkSystemRequirements. For more information, please see the API document and Update Guide.

Version 4.6.7 Released on November 5, 2020

Bug fixing

• Fixed the occasional issue of blurry screen during playback when hardware acceleration is enabled on Chrome.
• Fixed failure to enter rooms and pull streams on WeChat’s built-in browser for iOS.

Version 4.6.6 Released on October 23, 2020

Improvements

• Optimized the retry logic for upstream peer connection.
• Optimized the retry logic for downstream peer connection.
• Optimized the logic of TRTC.checkSystemRequirements.
• Supported screen sharing on Safari. For details, please see Screen Sharing Guide.

Bug fixing

Fixed the issue where getAudioLevel returns 0 after audio playback is manually resumed due to autoplay restrictions.

Version 4.6.5 Released on October 14, 2020

Improvements

• Optimized the logic for reestablishing WebSocket signaling channels, improving connection stability.
• Optimized the log output logic.

Bug fixing

• Fixed the issue where getAudioLevel returns 0 after resubscription on Chrome.
• Fixed the issue where no audio is played after resubscription on Safari.
• Fixed the issue where the getLocalVideoStats API returns undefined after the upstream audio track is replaced via replaceTrack.
• Fixed occasional WebSocket disconnection upon change of network type during calls on a mobile device.

Version 4.6.4 Released on September 24, 2020

Improvements

Allowed stopping the collection of network quality statistics after room exit.

Bug fixing

• Fixed the room entry error on Chrome 56.
• Fixed the issue where image is rotated when relayed push is enabled on mobile devices.
• Fixed on-cloud recording exceptions when audio-only streams are pushed.
• Fixed failure to automatically resume push after the camera is unplugged due to inconsistent resolution.

Version 4.6.3 Released on August 28, 2020

Improvements

• Optimized the compatibility check logic.
• Optimized the log reporting logic.
• Optimized the upstream bitrate control logic.

Version 4.6.2 Released on August 14, 2020

Improvements

• Optimized the upstream bitrate control logic.
• Optimized the switchRole parameter verification logic.
• Optimized the logic of measuring upstream network quality.
• Optimized error messages.
• Supported automatically resuming push when change of the stream capturing device is detected.

Bugs fixed

Fixed failure to publish again immediately after unpublish succeeds.

Version 4.6.1 Released on July 28, 2020

Improvements

• Supported checking via TRTC.isScreenShareSupported whether screen sharing is supported. Safari does not support screen sharing.
• Optimized the parameter verification logic for the subscribe and unsubscribe APIs.
• Added network quality logs.

Bugs fixed

• Fixed the “OverconstrainedError” error when access to media devices is not granted and an empty device ID is passed in the TRTC.createStream API.
• Fixed the issue where no log is printed when upstream peer connection is lost.

Version 4.6.0 Released on July 16, 2020

New features

Added the NETWORK_QUALITY event.

Version 4.5.0 Released on July 2, 2020

New features

Added the screenAudio parameter to the createStream API.

Bugs fixed

• Fixed the issue where echo cancellation does not work in browsers for Android.
• Fixed the issue where the RTT value returned by the getTransportStats API is NAN.

Version 4.4.0 Released on May 28, 2020

New features

Supported capturing system audio (on Windows) or audio of the current tab (on macOS) during screen sharing on Chrome 74 or above.

Version 4.3.14 Released on April 29, 2020

Bugs fixed

Fixed the muted and unmute events for Mini Program.

Version 4.3.13 Released on April 16, 2020

Improvements

Optimized the availability check logic.

Version 4.3.12 Released on April 13, 2020

Bugs fixed

Fixed a potential RTCPeerConnection status change exception.

Version 4.3.11 Released on March 28, 2020

Improvements

Supported detection of mobile QQ Browser, which does not support TRTC SDK for desktop browsers at the moment.

Bugs fixed

Fixed Boolean return types.

Version 4.3.10 Released on March 17, 2020

Improvements

• Optimized the environment detection logic.
• Added name code for RtcError.

Version 4.3.9 Released on March 13, 2020

Improvements

• Supported automatic detection of the deployment environment.
• Optimized logging.

Version 4.3.8 Released on February 24, 2020

Improvements

Added the streamId and userdefinerecordid parameters to createClient.

Version 4.3.7 Released on February 21, 2020

Improvements

Fixed the issue where an exception is throw upon device switch during screen sharing.

Bugs fixed

• Fixed the device occupation issue by releasing MediaStream after device switch.
• Fixed the potential error of the subscription API.

Version 4.3.6 Released on February 25, 2020

Bugs fixed

Adjusted the audio/video playback sequence of Stream.resume(), and fixed autoplay exceptions in WeChat’s built-in browser on iOS.

Version 4.3.5 Released on February 5, 2020

Improvements

Added timeout check for the publish API, improving the success rate of signaling.

Version 4.3.4 Released on January 6, 2020

Improvements

Updated core-js to version 3.6.1.

Bugs fixed

• Fixed the issue where an exception is thrown after unpublish times out.
• Fixed the issue where third-party libraries cause decline in the performance of V8.

Version 4.3.3 Released on December 25, 2019

Improvements

• Added the ability to check whether the environment supports WebRTC.
• Optimized the SDP response mechanism.
• Optimized the reporting logic.

Bugs fixed

Optimized the TURN URL protocol format.

Version 4.3.2 Released on December 9, 2019

Improvements

• Supported automatic reconnection after downstream ICE disconnection.
• Removed the STUN hole punching step to increase the success rate and speed of user connection via private networks.
• Used the server-calibrated UTC time as the timestamp for log reporting.
• Optimized ICE error reporting.
• Added more key events to avmonitor.

Bugs fixed

• Fixed the 1005 reconnection error of WebSocket signaling channels.
• Fixed the issue with the reporting of downstream packet loss rate.

Version 4.3.1 Released on November 23, 2019

Improvements

Supported automatic reconnection when upstream ICE disconnects during calls.

Bugs fixed

Fixed the issue where the host ICE candidate of public IP type does not take effect after STUN hole punching fails.

Version 4.3.0 Released on November 15, 2019

New features

Added the client.getTransportStats() API.

Improvements

• Made log reporting more detailed.
• Supported wildcard characters for event unbinding.
• Extended the connection timeout threshold to 5 seconds.
• Extended the publishing timeout threshold to 5 seconds.

Bugs fixed

Fixed the issue of abnormal SDK judgment due to modification of the prototype chain of zone.js.

Version 4.2.0 Released on November 4, 2019

New features

Added the client.off() API, which can be used to unbind client events.

Improvements

• Optimized the collection of call status statistics.
• Added permission check for client.publish().
• Added an auto playback error prompt for stream.play() and stream.resume().

Bugs fixed

Fixed black screen when the camera is switched via localStream.switchDevice().

Version 4.1.1 Released on October 24, 2019

Bugs fixed

• Fixed log loss.
• Fixed the loss of remote users who reconnect after disconnection.

Version 4.1.0 Released on October 17, 2019

New features

• Supported passing object HTMLDivElement in the stream.play() API.
• Supported setting audio attributes via localStream.setAudioProfile(). Currently, two profiles are supported: standard and high.

Bugs fixed

• Fixed the restriction on the number of WebAudio Context on Chrome.
• Fixed the issue where the local audio/video player is not restarted after replaceTrack().
• Fixed the issue where custom settings via localStream.setScreenProfile() do not take effect.
• Fixed the issues with the restart of the audio/video player and status reporting.

Version 4.0.0 Released on October 11, 2019

Provided APIs in the Client/Stream format, allowing for clearer role assignment and naming.
The new version is not compatible with the legacy version. In addition to APIs, the new version introduced the following changes:

• Changed the method of setting video attributes. All video attributes (resolution, frame rate, and bitrate) are now set using the localStream.setVideoProfile() API of the SDK via applications. The new version does not support setting video attributes via “Image Settings” (Spear Role) in the Tencent Cloud console.
• Integrated an audio/video player into the stream object. Playback is now solely controlled by the SDK.
• Supported subscribing to and unsubscribing from remote audio/video streams via the client.subscribe() and client.unsubscribe() APIs.