Skip to content

Latest commit

 

History

History
1783 lines (1393 loc) · 188 KB

File metadata and controls

1783 lines (1393 loc) · 188 KB

Change Log - @azure/communication-react

Tue, 14 Oct 2025 22:25:40 GMT Compare changes

Fri, 15 Aug 2025 21:19:38 GMT Compare changes

Features

Improvements

Bug Fixes

Storybook Changes

Mon, 26 May 2025 21:03:25 GMT Compare changes

Improvements

Bug Fixes

Tue, 29 Apr 2025 17:27:30 GMT Compare changes

Features

Improvements

Bug Fixes

Storybook Changes

Mon, 24 Mar 2025 20:31:15 GMT Compare changes

Features

Improvements

Bug Fixes

Mon, 24 Feb 2025 23:41:46 GMT Compare changes

Improvements

Bug Fixes

Mon, 03 Feb 2025 22:02:22 GMT Compare changes

Features

Real Time Text

We are excited to announce that the Azure Communication Services Web UI Library now supports RTT (Real Time Text). In an RTT enabled audio or video call, end-users augment the call with text. RTT text communications are transmitted immediately as they are typed, character-by-character, without the user hitting “send.” Users can enable RTT in a call, type to send real time text, or receive real time text from other users. Developers can use this functionality today through our composites (e.g CallComposite, CallWithChatComposite) as well as through components (e.g VideoGallery). This feature is a required by the EU as a core accessibility feature, with implementation needed by June 2025.

  • Receive and send Real Time Text messages
  • Seamless integration of real-time text with captions, allowing you to view both simultaneously
  • In our composites, Real Time Text turns on automatically for everyone when a message is first received/sent

TogetherMode

We are excited to announce that the Azure Communication Services Web UI Library now supports Together Mode in Teams interop scenarios. Together Mode is a feature that creates a virtual shared space for meeting participants. By using AI segmentation technology, it places participants in a common background, such as a conference room or auditorium, making it look like everyone is sitting together. This mode is designed to make meetings feel more engaging and reduce virtual meeting fatigue. It can help improve participants' sense of connection and collaboration by mimicking the experience of being in the same physical location. Developers can use this functionality today through our composites (e.g CallComposite, CallWithChatComposite) as well as through components (e.g VideoGallery).

  • Receive together Mode in Teams Interop Meetings
  • View reactions and raised hands in the Together mode view

Improvements

Bug Fixes

Mon, 02 Dec 2024 20:48:59 GMT Compare changes

Improvements

Bug Fixes

Mon, 28 Oct 2024 22:53:26 GMT Compare changes

Improvements

Bug Fixes

Tue, 01 Oct 2024 17:03:44 GMT Compare changes

Features

JavaScript loaders

Azure Communication services is excited to introduce a new way to consume our Composite experiences. If you are wanting to use the Azure Communication Services UI library Composites and don't develop in react, we are introducing a series of loader functions to allow you to use the Composites in your application. These functions load a react node and attach it to your application allowing you to use the Composites as if you were building in react.

Improvements

Bug Fixes

Fri, 06 Sep 2024 23:30:32 GMT Compare changes

Bug Fixes

Mon, 26 Aug 2024 18:25:58 GMT Compare changes

Features

Breakout Rooms

We are excited to announce that the Azure Communication Services Web UI Library enables ACS users to be moved to assigned breakout rooms when in Teams meetings. ACS users will readily be able move to breakout rooms in the Call and CallWithChat composite. In the CallWithChat composite, the chat thread will be updated when in the breakout room. Breakout rooms can also be incorporated into apps that use only our stateful layer. It is important to note that ACS users will not yet be able to choose their own breakout room or manage breakout rooms as a Teams user with an organizer role.

Improvements

Bug Fixes

Tue, 06 Aug 2024 19:45:27 GMT Compare changes

Features

Soft Mute

We are excited to announce that the Azure Communication Services Web UI Library now supports the Soft Mute feature. This feature enables users to mute other users in a call. If a user has been soft muted, they retain the ability to unmute themselves. Developers can use this functionality today through our composites (e.g CallComposite, CallWithChatComposite).

Rich Text Editor

This release brings Rich Text Editor to the ChatComposite and the CallWithChatComposite with the following new features:

  • We have added support for sending/editing messages that include images when in a Teams meeting using the CallWithChatComposite.
  • An additional onPaste callback that can be used to customize content pasted to Rich Text Editor.

Text Only Messaging Policy

We now support the ability to set a text-only messaging policy for a chat thread. In Teams Meeting Chat scenarios, the CallWithChatComposite will enable/disable image upload based on the text only message policy of the meeting.

Improvements

Bug Fixes

Known Issues

  • For certain Android devices, pasting of a single image is only supported by long pressing on the Rich Text Editor and choosing paste. Selecting from the clipboard view from keyboard may not be supported.

Mon, 17 Jun 2024 16:27:12 GMT Compare changes

Features

Data Loss Prevention (DLP) Message Support - Public Preview

  • Data Loss Prevention (DLP) support has been enabled in the Composite for Teams interoperability scenarios. When enabled in Teams, DLP policies can be applied to prevent sensitive information from being shared in chat messages.

Video Pinning - Public Preview

  • UI library has been updated to include functionality for pinning a video tile from the participant list, in addition to the existing video gallery pinning feature.

Improvements

Bug Fixes

Tue, 21 May 2024 20:14:27 GMT Compare changes

Features

Join Call with Meeting ID/Passcode

We are excited to announce that the Azure Communication Services Web UI Library now supports joining a call with a Meeting Passcode and ID. Currently, Microsoft Teams allows you to require a meeting password for added security and generates a unique meeting ID for each meeting that participants can use to join. This feature now allows users on ACS to join interop Teams calls that have a meeting passcode or an ID generated. This is useful for private calls or events where limited access needs to be granted. Developers can use this functionality today through our composites (e.g CallComposite, CallWithChatComposite) as well as through components.

File Sharing

UI library supports file sharing for Teams Interop Scenario in CallWithChatComposite. File sharing capabilities are also supported in ChatComposite in conjunction with your choice of a storage solution. We have made improvements to the file sharing feature in this beta release. The attachment card is now more optimized and you can find the usage instructions in the storybook.

Rich Text Editor

This release brings major enhancements to the rich text editor feature. The changes include:

  • Upgrading Rooster JS from v8 to v9
  • Replacing RoosterJS React components with our own components

Improvements

Bug Fixes

Tue, 23 Apr 2024 17:54:31 GMT Compare changes

Features

Rich Text Editor - Public Preview

The Web UI RichTextSendBox and MessageThread components now support rich text formatting to generate HTML content for chat messages. This feature includes support for:

  • Different text styles (bold, italic and underline)
  • Bulleted and numbered lists
  • Changing indentation for text
  • Adding and updating tables

Closed Captions - Public Preview

We are excited to announce that Azure Communications Services has recently added the Closed Captions feature. With closed captions, developers can provide a textual representation of the audio content in their videos, making it easier for users who are deaf or hard of hearing to follow along. Developers can enable this functionality today through our composites (e.g CallComposite, CallWithChatComposite). This feature includes support for:

  • Enable and disable closed captions in the call
  • Change spoken language
  • Being able to use captions outside of teams scenario

Improvements

Bug Fixes

Tue, 26 Mar 2024 17:38:26 GMT Compare changes

End of Call Survey - Public Preview

The UI Library now supports End of Call Survey, with the feature added to the CallComposite and CallwithChatComposite on web. The survey supports feedback for the categories of overall quality, audio, video, and screenshare. This survey appears at the end of composite experience. By default, users are taken to a “thank you for your feedback” page after survey is submitted, and taken to the end call screen if survey is skipped. We provide abilities to overwrite those default screens. The survey can be disabled or enabled. The data received is sent to Contoso’s local Azure monitoring where it can be validated for overall call quality. When free form text survey is enabled, the free form text data collected are not sent to local Azure monitoring and will need to be handled by Contoso.

Features

Improvements

Bug Fixes

Tue, 05 Mar 2024 16:19:15 GMT Compare changes

Reinclude CallComposite Branding option.

Mon, 26 Feb 2024 16:19:15 GMT Compare changes

Improvements

Bug Fixes

Mon, 29 Jan 2024 17:18:22 GMT Compare changes

Custom Branding - Public Preview

The CallComposite and CallWithChatComposite now support applying a background image and logo to the Configuration Page. This allows developers to unify their customers' joining experiences if they have a Teams Premium feature enabled called Teams Meeting Themes.

Features

Improvements

Bug Fixes

Mon, 20 Nov 2023 21:42:07 GMT Compare changes

Features

Improvements

Bug Fixes

Mon, 23 Oct 2023 18:27:26 GMT Compare changes

Features

Improvements

Bug Fixes

Wed, 04 Oct 2023 17:17:11 GMT Compare changes

Image Gallery - Public Preview

The Web UI Chat and CallWithChat composite now supports the Image Gallery feature. This enables users to click on an individual inline image in a message bubble and display the selected image in full screen or download the image.

We are also introducing a new standalone ImageGallery component to display an image in large scale with the ability to download it

Gallery Layouts - Public Preview

UI Library now supports new Gallery Layouts in the CallComposite and CallWithChatComposite on web and mobile. Users can select the new layouts from the control bar.

Features

Improvements

Bug Fixes

Other Changes

Mon, 28 Aug 2023 22:17:59 GMT Compare changes

Raise Hand - Public Preview

The Web UI Call and CallWitihChat composite now supports Raise Hand feature. This enables users to raise and lower hand in Teams interop meetings.

Features

Bug Fixes

Improvements

Mon, 24 Jul 2023 17:34:36 GMT Compare changes

Improvements

Bug Fixes

Tue, 27 Jun 2023 22:07:18 GMT Compare changes

Mention - Public Preview

The Web UI SendBox and MessageThread components now support mentions capabilities in chat message thread. Enables user to @ mention another user by providing a Search capability to look for the desired user and then tagging them on the message.

File Sharing - Public Preview

The Web UI Chat composite now supports to view and download a file shared by a Teams user.

Optimal Video Count - Public Preview

The Web UI Calling and CallWithChat composite now supports optimal Video Count. This provides a way to get a value which dictates the maximum number of remote renderers that should be rendered to get a good quality video.

Ad-hoc Calling - Public Preview

The Web UI Calling composite now supports the ability to call Teams users and call queues through their organization id.

Call Transfer - Public Preview

The Web UI Calling composite now supports the ability to accept or reject transfer requests through CallAdapter event subscription. The Calling composite will show a transfer page when a transfer request is accepted which is then followed by a seamless transition to the new call.

New CallComposite configurations to support click to call scenarios - Public Preview

The Web UI Calling composite now supports new options to configure LocalVideoTile positioning. This enables new use case scenarios with the composite like click to call

Bug Fixes

Improvements

Tue, 23 May 2023 21:43:12 GMT Compare changes

Blurred and Custom Video Backgrounds - Public Preview

The Web UI Calling and CallWithChat composite now supports Blurred and Custom Video Backgrounds in web desktop.

This feature includes:

  • Ability to enable the blur/custom background effect before the call
  • Choose or change the video background effect during the call
  • Ability to use your own hosted images as custom backgrounds

Features

Bug Fixes

Improvements

Fri, 28 Apr 2023 23:16:11 GMT Compare changes

Bug fixes

  • Revert a breaking change for createAzureCommunicationCallWithChatAdapterFromClients

Mon, 24 Apr 2023 15:39:35 GMT Compare changes

Closed Captions - Public Preview

The Web UI Calling and CallWithChat composite now supports Closed Captions in Teams Interop and Teams CTE scenarios.

This feature includes:

  • Ability to enable, and show/hide closed captions in a call
  • Choose or change the captions spoken language
  • Ability to scroll through past 50 dialogues after captions has been enabled

Inline Images - Public Preview

The Web UI Chat Composite now supports teams interop images. An image from teams will be retrieved automatically by our composite.

This feature includes:

  • Message bubble can now provide the ability to download an image protected by header-based authentication
  • Developers can write there own HTTP call to get the image so you can provide the applicable headers

Features

Bug fixes

Improvements

Tue, 28 Mar 2023 16:00:31 GMT Compare changes

Vertical Gallery - Public Preview

We are now introducing a new overflow gallery for remote particants VideoGallery component as well as other improvements!

This feature includes:

  • The ability to position the overflow gallery on the right, this allows better utilisation of the vertical space in your calling experience.
  • VideoGallery is now responsive in the composites, switching between the vertical gallery and horizontal gallery.
  • Improvements to space utilized by the video tiles of the horizontal overflow gallery.
  • Remote participants are now ordered in the overflow gallery based on participation.

Features

Bug fixes

Improvements

Wed, 01 Feb 2023 17:56:59 GMT Compare changes

Communications as Teams User - Public Preview

ACS UI Library now enables developers to create a customized Teams experience leveraging communcation as a Teams user (beta).

This feature includes:

  • Joining calls using Teams identity instead of an external user
  • Browser support on mobile devices
  • Fetch and override display externally for participant 

Read more about Communication as Teams user through Azure Communication Services.

Pinning Participants - Public Preview

The VideoGallery now provides the ability to pin participants on the GridLayout.

This feature includes:

  1. Contextual menu for each remote video tile
  2. Pinning and unpinning participants
  3. Change rendering options for remote video streams between fit-to-frame and fill frame

Features

Bug Fixes

Improvements

Tue, 15 Nov 2022 21:12:22 GMT Compare changes

Features

Bug Fixes

Improvements

Wed, 05 Oct 2022 18:13:37 GMT Compare changes

Rooms - Public Preview

Azure Communication Services now supports Rooms in public preview. You can use our CallComposite experience for your users to interact with your Rooms-based calls. Rooms allows our customers to create calls with specific users and the ability to modify their users' calling experience with a variety of role based access control.

You can read more about rooms concept here.

You can apply a Rooms locator in the adapter similar to how you can join a group call using a locator in the adapter + composite.

roomId = 99466313975086563 // example roomId

locator: { 'roomId': roomId }

Checkout our storybook to read more about what the UI Library offers into your Rooms experience.

If you would like to clone a repo and get started immediately. Check out our quickstarts repo in Github JS Quickstarts

PSTN and 1:N Calling - Public Preview

ACS UI Library Call and CallWithChat composites are introducing two new capabilities (beta):

  1. PSTN Outbound Calling
  2. ACS 1:N Outbound Calling

Users will now be able to:

  • Call a phone number through the existing Call and CallWithChat composites
  • Call a phone number and add it to an ongoing call
  • Put the call on hold during a phone or ACS call
  • Send DTMF tones during a 1:1 phone call

Read more about getting a phone number through Azure Communication Services.

If you would like to clone a repo and get started immediately. Check out our quickstarts repo in Github JS Quickstarts

Features

Bug Fixes

Improvements

Wed, 29 Jun 2022 17:31:05 GMT Compare changes

Features

Bug Fixes

Improvements

Tue, 19 Apr 2022 20:46:13 GMT Compare changes

Features

Bug Fixes

Improvements

Tue, 01 Mar 2022 16:42:52 GMT Compare changes

Major Breaking Changes

Features

Bug Fixes

Improvements

Mon, 24 Jan 2022 23:18:53 GMT Compare changes

Changes

Tue, 04 Jan 2022 22:57:09 GMT Compare changes

Changes

Wed, 17 Nov 2021 22:21:27 GMT Compare changes

Changes

  • Bump headless calling SDK to 1.3.1-beta.1
  • [Breaking API change] API polish based on Azure Review Board feedback
  • ChatComposite: Improved responsive experience when editing messages in the message thread
  • ChatComposite: Disabled participant pane
  • CallComposite: Add a screen for bad network conditions
  • CallComposite: Add a notification UI when local participant is speaking while muted
  • CallComposite: Make end call pages uniform, add button to return to call
  • CallComposite: Use HorizontalGallery for local and remote screen share streams
  • CallComposite: Add tooltips to control bar buttons
  • Expose User Facing Diagnostics API in StatefulCallClient and CallAdapter
  • Expose more ariaLabel and text strings via the localization API, more styling props

Bug Fixes

  • Fully implement identifier to/from MRI conversion
  • Many UI improvements to make the composites responsive to different form factors
  • Disallow removing Teams participants from call and chat
  • ChatComposite: Update MessageThread selector to filter out unsupported messages
  • ChatComposite: Ensure message thread links open in a new tab
  • ChatComposite: Ensuring edit/delete context menu is adjacent to its corresponding message
  • ChatComposite: Fix chat initials not showing in the message thread
  • CallComposite: VideoTile fixes related to isSpeaking indicator
  • CallComposite: Do not show page navigation buttons in HorizontalGallery if all participants can fit
  • CallComposite: VideoTile label text truncation on overflow, opacity fix
  • CallComposite: Respect system defaults for audio / video devices
  • CallComposite: Make all button width consistent in desktop mode

Mon, 1 Nov 2021 12:57:14 GMT Compare changes

Changes

  • Updated the package to use calling sdk beta 1.2.3-beta.1
  • Improved how participants are ordered in the VideoGallery using underlying Calling SDK dominant speaking
  • Improved how video tiles are laid out in the VideoGallery
  • Messages in the MessageThread make better use of empty space
  • Accessibility improvements across calling and chat composites
  • Removed onToggleCamera API. Use startCamer and stopCamera instead
  • Removed setPage API. Developers can access the current page through adapter.getState() and modify the page by interacting with the UI.
  • Exposed additional diagnostic events through the CallAdapter
  • Removed screenshare button by default on Call Composite and Meeting Composite when in mobile view
  • Update options button icon to a settings gear
  • Updated the Lobby Page call controls to match the Call Page controls
  • Updated the "connecting to call" page UI in the Call Composite
  • Optimized Configuration Page, Lobby Page and Call Page for mobile in the Call Composite
  • Disable Participants button and Screenshare button on the Call Composite lobby screen

Bug fixes

  • Fix issue where messages from a Teams client would fail to render in MessageThread and ChatComposite
  • CallControl items are consistent between Lobby and Call screen
  • Maintain position in MessageThread when fetching additional messages
  • Fix browser camera indicator still showing in use after turning it off
  • Fix issue where some message thread strings could not be set through the ChatComposite interface
  • Fix box-shadow showing below the Call Composite controls bar
  • Fix issue where some message thread strings could not be set through the ChatComposite interface

Tue, 28 Sep 2021 19:19:18 GMT Compare changes

Changes

  • Support editing and deleting sent messages in the MessageThread UI
  • Support customization to the ParticipantList to inject menu items for each participant
  • (breaking change) API consistency and documentation updates
    • Add a uniform way to set cutomization options on the composites.
  • Add MeetingAdapter to back the MeetingComposite. By default, the MeetingAdapter is backed by the Azure Communication Services backends.
  • Azure Communication Services SDK updates: @azure/communication-chat bumped to 1.1.0
  • (breaking change) Error handling: Stop clearing errors from state on successful operations; drop support for modifying state in StatefulChatClient and StatefulCallClient.

Bug fixes

  • Stop styling the body tag from FluentThemeProvider (styling leak to the host application)
  • Better themeing support in ControlBar component - support container border and shadow customization; support label font costumization

Mon, 13 Sep 2021 21:02:16 GMT Compare changes

Changes

  • Update Call Composite to use @azure/communication-calling@1.2.1-beta.1

  • Add Dominant Speaker support to Video Gallery

  • Add active and dominant speaker support to screenshare gallery

  • Add custom Icons injection in components and composites

  • Add custom avatar data injection for composites

  • Show ACS errors via ErrorBar in CallComposite

  • Add a delete API to clear calling ACS errors

  • Add call diagnostics to stateful client

  • Expose strongly type errors in CallAdapter

  • Localize call and chat composite strings

  • Localize errors in Call Composite

  • Update available locales and translations

  • Add chat message edit feature

  • Truncating long display names in ParticipantItem

Bug Fixes

  • Fix menu disappearing during a call when new participants joined
  • Fix English (US) and English (GB) exports
  • Fix theming for local preview placeholder for calling composite
  • Fix theming for MessageThread icons
  • Fix Icon misalignment in ParticipantItem

Mon, 16 Aug 2021 21:18:19 GMT Compare changes

Changes

  • Add Localization to Composites. Learn more: https://azure.github.io/communication-ui-library/?path=/story/localization--page

  • Add remove participant button to the Meeting Composite and Call Composite

  • Add applicationID to chat user agent

  • Added rtl property to FluentThemeProvider

  • Remove redundant prop VideoTile.isVideoReady

  • Bump Typescript version to 4.3.5

  • Update Call composite adapter joinCall return type to be the same as startCall

  • Add explicit string literals for error targets in Chat Stateful client

  • Update createAzureCommunicationChatAdapter and createAzureCommunicationCallAdapter constructors to take in a named object instead of seperate args

  • Add meeting composite

  • Add system message for selector props

  • Replace StatefulChatClient.clearErrors() with modifier pattern

Bug Fixes

  • Fix item alignment and 'Leave' button color in Dark Mode for Chat sample header
  • Show avatar when video is off (remote and local)
  • Fix alignment of Chat bubble with/without receipt
  • Fix button menu flyouts exceeding screen width
  • Fix fluent theme provider not being applied to the meeting composite
  • Fix permission banner styling - allow multiline
  • Fix partially composed chat messages being lost when closing and reopening the chat pane in the meeting composite
  • Fix tsdoc comments - rename @Link -> @link
  • Fix Chat infinite scroll jumpy behavior
  • Fix screenshare not displaying for call attendees
  • Fix screenshare dialog eating user input across the whole web page
  • Fix video gallery styling issues during (participant pane too large) and after (messed up format) screenshare
  • Fix sample app dark theme on IPhoneSE
  • Fix RTL responsiveness of TypingIndicator
  • Fix video device icons in ControlBar Options button
  • Fix meeting pane overlapping the call control bar
  • Remove type blocking usage of the package on older typescript versions
  • Fix SendBox padding so we don't overlap text with the send message button
  • Fix video gallery local preview position to be relative to the parent
  • Ensure call composite media gallery has a minimum height

Thu, 22 Jul 2021 17:42:41 GMT Compare changes

Changes

  • [Breaking change] Call Composite and Chat Composite adapters now take in a CommunicationTokenCredential in the constructor instead of the token

  • [Breaking change] Call Composite and Chat Composite adapters take in an object containing all of the parameters instead of passing in the parameters individually (for the token point above, it is one of the properties of the object)

  • Publishing js files to use composites outside of a react app as part of the Github Release

  • Fixing the send box component where the padding would overlap with the icon

  • Fixing the local preview overlapping the call control bar

  • Setting minHeight on the call composite media gallery

  • Adding a small fix for supporting typescript < 4.1

  • React hook useTheme added to ACS Library

  • Fix truncation from MessageThread system message

  • Add default call control bar button for creating custom call control buttons

  • Fix cursor on control button labels

  • Fix MessageThread hook related console errors

  • Make participant pane in the chat composite optional. Disabled by default

  • Make topic heading in the chat composite optional. Disabled by default

  • Bugfix to prevent options menu from getting hidden every time a participant joins or leaves

  • Drop duplicate thread status banner

  • Fixing link on "Using Composites in a non-react environment" in Storybook

Fri, 09 Jul 2021 20:41:33 GMT Compare changes

Changes

  • Updated calling sdk dependency to 1.2.0-beta.1

  • Added Calling composite improvements including floating local video tile, permission banner when call is being recorded, changing local video device and microphone, and screen-sharing view improvements

  • Added Chat composite improvements including notifying a participant when they leave a thread and styling improvements

  • Improved Bundle size optimizations when only using chat or only using calling components

  • Updated react peer dependency to >=16.8.0 <18.0.0

Storybook pages added

  • Feedback (Help us create even better components for you)
  • Identity (How to get a token)
  • Adapters (What are adapters for and how you use them)
  • Using composites in a non-react environment

Fri, 21 May 2021 16:16:28 GMT

Composites added

  • ChatComposite
  • CallingComposite

UI Components added

  • ControlBar
  • Control Bar Buttons
    • CameraButton
    • EndCallButton
    • MicrophoneButton
    • DevicesButton
    • ScreenShareButton
  • GridLayout
  • MessageStatusIndicator
  • MessageThread
  • ParticipantItem
  • ParticipantList
  • SendBox
  • TypingIndicator
  • VideoTile
  • VideoGallery

Stateful Clients support added

  • StatefulChatClient
  • StatefulCallClient

UsePropsFor component support added

  • ControlBarButtons
  • MessageThread
  • ParticipantList
  • SendBox
  • TypingIndicator
  • VideoGallery