tencent cloud

Feedback

Release Notes (Web)

Last updated: 2022-09-23 18:06:13
    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.
    notice
    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.13.0 Released on July 8, 2022

    New features Added the Client.destroy API, complementing the lifecycle of Client.
    Improvements
    Improved the encoding of the low-quality stream, delivering smoother playback.
    Added an event for successful auto capturing resumption: DEVICE_AUTO_RECOVERED.
    Bug fixing
    Fixed the issue where, after Client.startMixTranscode is called and the SDK is disconnected for longer than 30 seconds, stream mixing does not continue upon reconnection.
    Fixed the issue where, after Client.startPublishCDNStream is called and the SDK is disconnected for longer than 30 seconds, publishing to CDN is discontinued even after reconnection.

    Version 4.12.7 Released on June 17, 2022

    Improvements
    Added the mixUser.renderMode parameter to Client.startMixTranscode. You can use it to set the rendering mode of the videos of users whose streams are mixed.
    Changed the default value of video profile to 480p_2, which uses less upstream bandwidth while delivering the same video quality. For details, see LocalStream.setVideoProfile.
    Improved the success rate of automatic playback resumption.
    Improved the accuracy of the muting status after a disconnection and reconnection.
    Fixed the issue where, on Safari 15.1, the page crashes when muteVideo is called. For details, see webkit bug.
    Bug fixing Fixed the issue where the stream-added event is sometimes not thrown in the dual-stream mode (manual subscription).

    Version 4.12.6 Released on June 10, 2022

    Improvements Added logic to prevent repeated room entry for client.join. For details, see SDK Upgrade 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
    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 window when autoplay fails. For details, see Use the autoplay dialog provided by SDK.
    Fixed 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.
    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.
    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, 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 the 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, see Enabling Beauty Filters.
    Improved statistical accuracy.

    Version 4.11.0 Released on June 18, 2021

    New features
    Supported the dual-stream mode. For detailed directions, see Enabling Dual-Stream Mode.
    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.
    notice
    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.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support