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
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
Bug fixing
Fixed the occasional “TRTC not supported” error when client.publish
is called.
Version 4.11.8 Released on November 5, 2021
Improvements
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
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
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
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
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.
Was this page helpful?