@azure/communication-react package
Classes
| CallError |
Error thrown from failed stateful API methods. |
| ChatError |
Error thrown from failed StatefulChatClient methods. |
Interfaces
| AcceptedTransfer |
Transfer feature state |
| ActiveErrorMessage |
Active error messages to be shown via ErrorBar. |
| ActiveNotification |
Active notifications to be shown via NotificationStack. |
| AdapterError |
Error reported via error events and stored in adapter state. |
| AdapterNotification |
Notification from call client state stored in adapter state. |
| AdapterState |
Functionality for interfacing with Composite adapter state. |
| AttachmentMetadata |
Data model that represents a chat message attachment where it contains an ID to uniquely identify the attachment, a name that represents the name of file, and a URL to download the attachment. |
| BaseCompositeProps |
Properties common to all composites exported from this library. |
| BaseCustomStyles |
Basic fluent styles props for all components exported from this libray. |
| BreakoutRoomsState |
Breakout rooms state |
| CallAdapter |
An Adapter interface specific for Azure Communication identity which extends CommonCallAdapter. |
| CallAdapterCallManagement |
Functionality for managing the current call or start a new call |
| CallAdapterCallOperations |
Functionality for managing the current call. |
| CallAdapterDeviceManagement |
Functionality for managing devices within a call. |
| CallAdapterSubscribers |
Call composite events that can be subscribed to. |
| CallAgentProviderProps |
Arguments to initialize a CallAgentProvider. |
| CallAgentState |
State only version of <xref:%40azure%2Fcommunication-calling%23CallAgent> except calls is moved to be a child directly of CallClientState and not included here. The reason to have CallAgent's state proxied is to provide access to displayName. We don't flatten CallAgent.displayName and put it in CallClientState because it would be ambiguious that displayName is actually reliant on the creation/existence of CallAgent to be available. |
| CallAndChatLocator |
Arguments for use in createAzureCommunicationCallWithChatAdapter to join a Call with an associated Chat thread. |
| CallClientProviderProps |
Arguments to initialize a CallClientProvider. |
| CallClientState |
Container for all of the state data proxied by StatefulCallClient. The calls, callsEnded, incomingCalls, and incomingCallsEnded states will be automatically provided if a callAgent has been created. The deviceManager will be empty initially until populated see DeviceManagerState. The userId state is provided as a convenience for the developer and is completely controled and set by the developer. |
| CallCompositeLoaderProps |
Props for the OutboundCallComposite that you can use in your application. Contains two options bags:
|
| CallCompositeProps |
Props for CallComposite. |
| CallCompositeStrings |
Strings used by the CallComposite directly. This strings are in addition to those used by the components from the component library. |
| CallFeatureStreamState |
State only version of <xref:%40azure%2Fcommunication-calling%23CallFeatureStream>. Represents call feature stream state. |
| CallInfoState |
State to track the types <xref:CallInfo> and <xref:TeamsCallInfo> |
| CallNotification | |
| CallProviderProps |
Arguments to initialize a CallProvider. |
| CallState |
State only version of <xref:%40azure%2Fcommunication-calling%23Call>. StatefulCallClient will automatically retrieve Call's state and add it to the state exposed by StatefulCallClient. |
| CallSurveyImprovementSuggestions |
Represents the improvement suggestion part of call survey |
| CallWithChatAdapter |
CallWithChatComposite Adapter interface. |
| CallWithChatAdapterManagement |
Functionality for managing the current call with chat. |
| CallWithChatAdapterState |
CallWithChat State is a combination of Stateful Chat and Stateful Calling clients with some state specific to the CallWithChat Composite only. |
| CallWithChatAdapterSubscriptions |
Call and Chat events that can be subscribed to in the CallWithChatAdapter. |
| CallWithChatAdapterUiState |
UI state pertaining to the CallWithChatComposite. |
| CallWithChatClientState |
State from the backend services that drives CallWithChatComposite. |
| CallWithChatCompositeLoaderProps |
Props for the CallWithChatComposite that you can use in your application. Contains two options bags:
|
| CallWithChatCompositeProps |
Props required for the CallWithChatComposite |
| CallWithChatCompositeStrings |
Strings used by the CallWithChatComposite directly. This strings are in addition to those used by the components from the component library. |
| CallWithChatControlOptions |
Customization options for the control bar in calling with chat experience. |
| CallingHandlers |
Object containing all the handlers required for calling components. Calling related components from this package are able to pick out relevant handlers from this object. See <xref:useHandlers> and usePropsFor. |
| CallingTheme |
Custom Fluent theme palette used by calling related components in this library. |
| CameraButtonContextualMenuStyles |
Styles for the CameraButton menu. |
| CameraButtonProps |
Props for CameraButton component. |
| CameraButtonStrings |
Strings of CameraButton that can be overridden. |
| CameraButtonStyles |
Styles for CameraButton |
| CapabilitiesFeatureState |
State only version of <xref:%40azure%2Fcommunication-calling%23CapabilitiesFeature> |
| CapabilityChangedNotificationStrings |
Strings for capability changed notification |
| CaptionLanguageStrings |
caption language strings for captions setting modal |
| CaptionsBannerProps |
CaptionsBanner Component Props. |
| CaptionsBannerStrings |
strings for captions banner |
| CaptionsCallFeatureState | |
| CaptionsInfo | |
| CaptionsSettingsModalProps |
CaptionsSettingsModal Component Props. |
| CaptionsSettingsModalStrings |
strings for captions setting modal |
| ChatAdapterSubscribers |
Chat composite events that can be subscribed to. |
| ChatAdapterThreadManagement |
Functionality for managing the current chat thread. |
| ChatCompositeLoaderProps |
Props for the ChatComposite that you can use in your application. Contains the options for the ChatComposite ChatCompositeOptions. |
| ChatCompositeProps |
Props for ChatComposite. |
| ChatCompositeStrings |
Strings used by the ChatComposite directly. This strings are in addition to those used by the components from the component library. |
| ChatMessage |
A chat message. |
| CommonCallAdapter |
CallComposite Adapter interface. |
| CommonCallingHandlers |
Object containing all the handlers required for calling components. Calling related components from this package are able to pick out relevant handlers from this object. See <xref:useHandlers> and usePropsFor. |
| ComponentLocale |
Locale information for all components exported from this library. |
| ComponentStrings |
Strings used by all components exported from this library. |
| CompositeLocale |
Locale information for all composites exported from this library. |
| CompositeStrings |
Strings used in the composites directly. These strings are used by the composites directly, instead of by the contained components. |
| ConferencePhoneInfo |
Information for conference phone info |
| ContentSystemMessage |
A system message with arbitary content. |
| ControlBarButtonProps |
Props for ControlBarButton. |
| ControlBarButtonStrings |
Strings of ControlBarButton that can be overridden. |
| ControlBarProps |
Props for ControlBar. |
| CreateVideoStreamViewResult |
Object returned after creating a local or remote VideoStream. This contains helper functions to manipulate the render of the stream. |
| CustomCallControlButtonCallbackArgs |
Arguments for CustomCallControlButtonCallback. |
| CustomCallControlButtonProps |
Response from CustomCallControlButtonCallback. Includes the base props necessary to render a ControlBarButton or <xref:DrawerMenuItem>. |
| CustomCallControlButtonStrings |
Strings for CustomCallControlButtons |
| CustomMessage |
A custom message type. Custom messages are not rendered by default, but applications can provide custom renderers for them. |
| DevicesButtonContextualMenuStyles |
Styles for the DevicesButton menu. |
| DevicesButtonProps |
Props for DevicesButton. |
| DevicesButtonStrings |
Strings of DevicesButton that can be overridden. |
| DevicesButtonStyles |
Styles for the Devices button menu items. |
| DiagnosticsCallFeatureState |
State only proxy for <xref:%40azure%2Fcommunication-calling%23DiagnosticsCallFeature>. |
| DialpadProps |
Props for Dialpad component. |
| DialpadStrings |
Strings of Dialpad that can be overridden. |
| DialpadStyles |
Styles for Dialpad component. |
| Disposable |
Functionality for correctly disposing a Composite. |
| DtmfDialPadOptions |
Options to determine the rendering behavior of the dtmfDialer in the CallComposite |
| EndCallButtonProps |
Props for EndCallButton. |
| EndCallButtonStrings |
Strings of EndCallButton that can be overridden. |
| ErrorBarProps |
Props for ErrorBar. In addition to the following, ErrorBar forwards all <xref:%40fluentui%2Freact%23IMessageBarProps> to the underlying <xref:%40fluentui%2Freact%23MessageBar>. |
| ErrorBarStrings |
All strings that may be shown on the UI in the ErrorBar. |
| FluentThemeProviderProps |
Props for FluentThemeProvider. |
| GridLayoutProps |
Props for GridLayout. |
| GridLayoutStyles |
GridLayout Component Styles. |
| HoldButtonProps | |
| HoldButtonStrings |
Strings for the hold button labels |
| HorizontalGalleryStyles |
<xref:HorizontalGallery> Component Styles. |
| ImageOverlayProps |
Props for ImageOverlay. |
| ImageOverlayStrings |
Strings of ImageOverlay that can be overridden. |
| IncomingCallNotificationProps |
Properties for the incoming call notification component. |
| IncomingCallNotificationStrings |
Strings for the incoming call notification component. |
| IncomingCallNotificationStyles |
Styles for the incoming call notification component. |
| IncomingCallStackCall |
Represents an active incoming call. |
| IncomingCallStackProps |
Props for the IncomingCallManager component. |
| IncomingCallState |
State only version of <xref:%40azure%2Fcommunication-calling%23IncomingCall>. StatefulCallClient will automatically detect incoming calls and add their state to the state exposed by StatefulCallClient. |
| InlineImage |
InlineImage's state, as reflected in the UI. |
| InlineImageOptions |
Options to display inline image in the inline image scenario. |
| JoinCallOptions |
Options for setting microphone and camera state when joining a call true = turn on the device when joining call false = turn off the device when joining call 'keep'/undefined = retain devices' precall state |
| JumpToNewMessageButtonProps |
Arguments for MessageThreadProps.onRenderJumpToNewMessageButton. |
| LocalVideoCameraCycleButtonProps | |
| LocalVideoStreamState |
State only version of <xref:%40azure%2Fcommunication-calling%23LocalVideoStream>. |
| LocalVideoStreamVideoEffectsState |
State only version of a LocalVideoStream's <xref:%40azure%2Fcommunication-calling%23VideoEffectsFeature>. |
| LocalVideoTileOptions |
Options for the local video tile in the Call composite. |
| MediaAccessState |
Media access state |
| MediaDiagnosticsState |
State only proxy for <xref:%40azure%2Fcommunication-calling%23MediaDiagnostics>. |
| MeetingConferencePhoneInfoModalStrings |
strings for phone info modal |
| MessageCommon |
Common properties of all message types. |
| MessageStatusIndicatorProps |
Props for MessageStatusIndicator. |
| MessageStatusIndicatorStrings |
Strings of MessageStatusIndicator that can be overridden. |
| MessageThreadStrings |
Strings of MessageThread that can be overridden. |
| MessageThreadStyles |
Fluent styles for MessageThread. |
| MicrophoneButtonContextualMenuStyles |
Styles for the MicrophoneButton menu. |
| MicrophoneButtonProps |
Props for MicrophoneButton. |
| MicrophoneButtonStrings |
Strings of MicrophoneButton that can be overridden. |
| MicrophoneButtonStyles |
Styles for MicrophoneButton |
| NetworkDiagnosticsState |
State only proxy for <xref:%40azure%2Fcommunication-calling%23NetworkDiagnostics>. |
| NotificationOptions |
Options for controlling the notifications in the composite. |
| NotificationProps |
Props for Notification. |
| NotificationStackProps |
Props for NotificationStack. |
| NotificationStackStrings |
All strings that may be shown on the UI in the NotificationStack. |
| NotificationStrings |
All strings that may be shown on the UI in the Notification. |
| NotificationStyles |
Styles for the notification component. |
| OptimalVideoCountFeatureState |
State only version of Optimal Video Count Feature <xref:%40azure%2Fcommunication-calling%23OptimalVideoCountCallFeature>. |
| OptionsDevice |
A device, e.g. camera, microphone, or speaker, in the DevicesButton flyout. |
| OutboundCallCompositeLoaderProps |
Props for the OutboundCallComposite that you can use in your application. Contains two options bags:
|
| PPTLiveCallFeatureState |
State only version of <xref:%40azure%2Fcommunication-calling%23PPTLiveCallFeature>. StatefulCallClient will automatically listen for pptLive on the call and update the state exposed by StatefulCallClient accordingly. |
| ParticipantAddedSystemMessage |
A system message notifying that a participant was added to the chat thread. |
| ParticipantItemProps |
Props for ParticipantItem. |
| ParticipantItemStrings |
Strings of ParticipantItem that can be overridden. |
| ParticipantItemStyles |
Fluent styles for ParticipantItem. |
| ParticipantListItemStyles |
Styles for the ParticipantList ParticipantItem. |
| ParticipantListStyles |
Styles for the ParticipantList. |
| ParticipantRemovedSystemMessage |
A system message notifying that a participant was removed from the chat thread. |
| ParticipantsButtonContextualMenuStyles |
Styles for the ParticipantsButton menu. |
| ParticipantsButtonProps |
Props for ParticipantsButton. |
| ParticipantsButtonStrings |
Strings of ParticipantsButton that can be overridden. |
| ParticipantsButtonStyles |
Styles Props for ParticipantsButton. |
| RaiseHandButtonProps |
Props for RaiseHandButton. |
| RaiseHandButtonStrings |
Strings of RaiseHandButton that can be overridden. |
| RaiseHandCallFeature |
State only version of <xref:%40azure%2Fcommunication-calling%23RaiseHandCallFeature>. StatefulCallClient will automatically listen for raised hands on the call and update the state exposed by StatefulCallClient accordingly. |
| ReactionButtonProps |
Props for ReactionButton. |
| ReactionButtonStrings |
Strings of ReactionButton that can be overridden. |
| ReactionResources |
Interface for animation sprite image and related metadata |
| RealTimeTextCallFeatureState | |
| RealTimeTextInfo | |
| RealTimeTextModalProps |
RealTimeTextModal Component Props. |
| RealTimeTextModalStrings |
strings for realTimeText modal |
| RealTimeTextProps |
Props for a single line of RealTimeText. |
| RealTimeTextStrings |
strings for rtt |
| RecordingCallFeature |
State only version of <xref:%40azure%2Fcommunication-calling%23RecordingCallFeature>. StatefulCallClient will automatically listen for recording state of the call and update the state exposed by StatefulCallClient accordingly. |
| RemoteParticipantState |
State only version of <xref:%40azure%2Fcommunication-calling%23RemoteParticipant>. StatefulCallClient will automatically retrieve RemoteParticipants and add their state to the state exposed by StatefulCallClient. |
| RemoteVideoStreamState |
State only version of <xref:%40azure%2Fcommunication-calling%23RemoteVideoStream>. |
| RemoteVideoTileMenuOptions |
Menu options for remote video tiles in VideoGallery. |
| ScreenShareButtonProps |
Props for ScreenShareButton. |
| ScreenShareButtonStrings |
Strings of ScreenShareButton that can be overridden. |
| SendBoxProps |
Props for SendBox. |
| SendBoxStrings |
Strings of SendBox that can be overridden. |
| SendBoxStylesProps |
Fluent styles for <xref:Sendbox>. |
| SpokenLanguageStrings |
spoken language strings for captions setting modal |
| SpotlightCallFeatureState |
State only version of <xref:%40azure%2Fcommunication-calling%23SpotlightCallFeature> |
| SpotlightPromptStrings |
Strings used in prompt related to spotlight |
| SpotlightState |
Spotlight state with order |
| StartCaptionsAdapterOptions |
Options passed to adapter.startCaptions |
| StartCaptionsButtonProps | |
| StartCaptionsButtonStrings |
Strings for the hold button labels |
| StartRealTimeTextButtonProps |
Props for the StartRealTimeTextButton component |
| StartRealTimeTextButtonStrings |
Strings for the hold button labels |
| StatefulCallClient |
Defines the methods that allow CallClient <xref:%40azure%2Fcommunication-calling%23CallClient> to be used statefully. The interface provides access to proxied state and also allows registering a handler for state change events. For state definition see CallClientState. State change events are driven by:
|
| StatefulChatClient |
Defines the methods that allow {@Link @azure/communication-chat#ChatClient} to be used with a centralized generated state. The interface provides access to proxied state and also allows registering a handler for state change events. |
| StatefulDeviceManager |
Defines the additional methods added by the stateful on top of <xref:%40azure%2Fcommunication-calling%23DeviceManager>. |
| StopCaptionsAdapterOptions |
Options passed to adapter.stopCaptions |
| StreamMediaProps |
Props for StreamMedia. |
| SurveyIssues |
Corresponding texts to each call issue |
| SurveyIssuesHeadingStrings |
Corresponding texts to each call issue category |
| SystemMessageCommon |
Common properties of all system messages. |
| TeamsCallAdapter |
An Adapter interface specific for Teams identity which extends CommonCallAdapter. |
| TeamsCallingHandlers |
Object containing all the teams call handlers required for calling components. Calling related components from this package are able to pick out relevant handlers from this object. See <xref:useHandlers> and usePropsFor. |
| TeamsIncomingCallState |
State only version of <xref:%40azure%2Fcommunication-calling%23TeamsIncomingCall> |
| TogetherModeCallFeatureState |
State only version of <xref:%40azure%2Fcommunication-calling%23TogetherModeCallFeature>. StatefulCallClient. Represents the state of the Together Mode feature. |
| TogetherModeSeatingPositionState |
State only version of <xref:%40azure%2Fcommunication-calling%23TogetherModeSeatingMap>. Represents the seating position of a participant in Together Mode. |
| TogetherModeStreamOptions |
Interface representing the result of a Together Mode stream view. |
| TogetherModeStreamViewResult |
Interface representing the result of a Together Mode stream view. |
| TogetherModeStreamsState |
Represents the streams in Together Mode. |
| TopicUpdatedSystemMessage |
A system message notifying that the chat thread topic was updated. |
| TranscriptionCallFeature |
State only version of <xref:%40azure%2Fcommunication-calling%23TranscriptionCallFeature>. StatefulCallClient will automatically listen for transcription state of the call and update the state exposed by StatefulCallClient accordingly. |
| TransferFeature |
Transfer feature state |
| TypingIndicatorProps |
Props for TypingIndicator. |
| TypingIndicatorStrings |
Strings of TypingIndicator that can be overridden. |
| TypingIndicatorStylesProps |
Fluent styles for TypingIndicator. |
| VerticalGalleryControlBarStyles |
Styles for the control bar inside the VerticalGallery component |
| VerticalGalleryStrings |
Strings for localization of the vertical gallery. |
| VerticalGalleryStyles |
Styles for the VerticalGallery component |
| VideoBackgroundBlurEffect |
Contains the attibutes of the blur video background effect |
| VideoBackgroundImage |
Contains the attibutes of a background image like url, name etc. |
| VideoBackgroundNoEffect |
Contains the attibutes to remove video background effect |
| VideoBackgroundReplacementEffect |
Contains the attibutes of a selected replacement video background effect |
| VideoGalleryLocalParticipant |
The state of the local participant in the VideoGallery. |
| VideoGalleryProps |
Props for VideoGallery. |
| VideoGalleryRemoteParticipant |
The state of a remote participant in the VideoGallery. |
| VideoGalleryStream |
Video stream of a participant in VideoGallery. |
| VideoGalleryStrings |
All strings that may be shown on the UI in the VideoGallery. |
| VideoGalleryStyles |
VideoGallery Component Styles. |
| VideoGalleryTogetherModeSeatingInfo |
Interface representing the seating information in Together Mode. |
| VideoGalleryTogetherModeStreams |
Interface representing the streams in Together Mode. |
| VideoStreamOptions |
Options to control how video streams are rendered. |
| VideoStreamRendererViewState |
State only version of <xref:%40azure%2Fcommunication-calling%23VideoStreamRendererView>. This property is added to the state exposed by StatefulCallClient by StatefulCallClient.createView and removed by StatefulCallClient.disposeView. |
| VideoTileContextualMenuProps |
Properties for showing contextual menu for remote VideoTile components in VideoGallery. |
| VideoTileDrawerMenuProps |
Properties for showing drawer menu on remote VideoTile long touch in VideoGallery. |
| VideoTileProps |
Props for VideoTile. |
| VideoTileStrings |
Strings of VideoTile that can be overridden. |
| VideoTileStylesProps |
Fluent styles for VideoTile. |
| VideoTilesOptions |
Options that apply to all Video Tiles in the VideoGallery |
Type Aliases
| AdapterErrors |
Adapters stores the latest error for each operation in the state.
|
| AdapterNotifications |
Adapters stores the latest notification for each target. |
| AreEqual |
Compare if 2 react components are exact equal, result type will be true/false |
| AreParamEqual |
Compare if props of 2 react components are equal, result type will be true/false |
| AreTypeEqual |
Compare if two types are equal, result type will be true/false |
| AvatarPersonaData |
Custom data attributes for displaying avatar for a user. |
| AvatarPersonaDataCallback |
Callback function used to provide custom data to build an avatar for a user. |
| AzureCommunicationCallAdapterArgs |
Arguments for creating the Azure Communication Services implementation of CallAdapter. Note: |
| AzureCommunicationCallAdapterOptions |
Optional parameters to create useAzureCommunicationCallAdapter |
| AzureCommunicationCallWithChatAdapterArgs |
Arguments for createAzureCommunicationCallWithChatAdapter |
| AzureCommunicationCallWithChatAdapterFromClientArgs |
Arguments for <xref:createAzureCommunicationCallWithChatAdapterFromClient> |
| AzureCommunicationChatAdapterArgs |
Arguments for creating the Azure Communication Services implementation of ChatAdapter. |
| AzureCommunicationOutboundCallAdapterArgs |
Arguments for creating the Azure Communication Services implementation of CallAdapter. These arguments are used to create an outbound call scenarios. Note: |
| CallAdapterCallEndedEvent |
Payload for CallEndedListener containing details on the ended call. |
| CallAdapterClientState |
CommonCallAdapter state inferred from Azure Communication Services backend. |
| CallAdapterLocator |
Locator used by createAzureCommunicationCallAdapter to locate the call to join |
| CallAdapterState |
CommonCallAdapter state. |
| CallAdapterUiState |
CommonCallAdapter state for pure UI purposes. |
| CallCompositeIcons |
Icons that can be overridden for CallComposite. |
| CallCompositeOptions |
Optional features of the CallComposite. |
| CallCompositePage |
Major UI screens shown in the CallComposite. |
| CallControlDisplayType |
Control bar display type for CallComposite. |
| CallControlOptions |
Customization options for the control bar in calling experience. |
| CallEndedListener |
Callback for CallAdapterSubscribers 'callEnded' event. |
| CallErrorBarSelector |
Selector type for ErrorBar component. |
| CallErrorTarget |
String literal type for all permissible keys in {@Link CallErrors}. |
| CallErrors |
Errors teed from API calls to the Calling SDK. Each property in the object stores the latest error for a particular SDK API method. Errors from this object can be cleared using the <xref:newClearCallErrorsModifier>. Additionally, errors are automatically cleared when:
|
| CallFeatureStreamName |
Represents the name of the call feature stream |
| CallIdChangedListener |
Callback for CallAdapterSubscribers 'callIdChanged' event. |
| CallNotifications | |
| CallParticipantListParticipant |
Calling participant's state, as reflected in the UI components. |
| CallWithChatCompositeIcons |
Icons that can be overridden for CallWithChatComposite. |
| CallWithChatCompositeOptions |
Optional features of the CallWithChatComposite. |
| CallWithChatEvent |
Events fired off by the CallWithChatAdapter. |
| CallingBaseSelectorProps |
Common props used to reference calling declarative client state. |
| CallingHandlersOptions |
Configuration options to include video effect background dependency. |
| CallingReturnProps |
Helper type for usePropsFor. |
| CallingSounds |
Type for representing a set of sounds to use for different calling events |
| CameraButtonSelector |
Selector type for CameraButton component. |
| CancelEditCallback |
Callback function run when a message edit is cancelled. |
| CapabilitiesChangedListener |
Callback for CallAdapterSubscribers 'capabilitiesChanged' event. |
| CaptionSettingsSelector |
Selector type for components for Changing caption language and spoken language |
| CaptionsBannerSelector |
Selector type for the CaptionsBanner component. |
| CaptionsInformation |
information required for each line of caption |
| CaptionsOptions |
options bag to start captions |
| CaptionsReceivedListener |
Callback for CallAdapterSubscribers 'captionsReceived' event. |
| ChatAdapter |
ChatComposite Adapter interface. |
| ChatAdapterOptions |
Options for configuring the ChatAdapter. |
| ChatAdapterState |
ChatAdapter state. |
| ChatAdapterUiState |
ChatAdapter state for pure UI purposes. |
| ChatAttachmentType |
Represents the type of attachment |
| ChatBaseSelectorProps |
Common props for selectors for ChatClientState. |
| ChatClientProviderProps |
Arguments to initialize a ChatClientProvider. |
| ChatClientState |
Centralized state for <xref:%40azure%2Fcommunication-chat%23ChatClient>. |
| ChatCompositeClientState |
ChatAdapter state inferred from Azure Communication Services backend. |
| ChatCompositeIcons |
Icons that can be overridden for ChatComposite. |
| ChatCompositeOptions |
Optional features of the ChatComposite. |
| ChatErrorBarSelector |
Selector type for ErrorBar component. |
| ChatErrorTarget |
String literal type for all permissible keys in ChatErrors. |
| ChatErrors |
Errors teed from API calls to the Chat SDK. Each property in the object stores the latest error for a particular SDK API method. |
| ChatHandlers |
Object containing all the handlers required for chat components. Chat related components from this package are able to pick out relevant handlers from this object. See <xref:useHandlers> and usePropsFor. |
| ChatInitializedListener |
Callback for <xref:CallWithChatAdapterSubscribers> 'chatInitialized' event. |
| ChatMessageWithStatus |
An extension to <xref:%40azure%2Fcommunication-chat%23ChatMessage> that stores client-side only metadata for chat messages. TODO: The name has bitrotted. Rename me. |
| ChatParticipantListSelector |
Selector type for ParticipantList component. |
| ChatProfile |
The profile of a user or bot. |
| ChatReturnProps |
Helper type for usePropsFor. |
| ChatThreadClientProviderProps |
Arguments to initialize a ChatThreadClientProvider. |
| ChatThreadClientState |
Centralized state for <xref:%40azure%2Fcommunication-chat%23ChatThreadClient>. |
| ChatThreadProperties |
Properties of a chat thread. We define a minimal one that helps us hide the different types used by underlying API. |
| ClientState |
Centralized state for <xref:%40azure%2Fcommunication-calling%23CallClient> or <xref:%40azure%2Fcommunication-chat%23ChatClient>. See also: CallClientState, ChatClientState. |
| Common |
Return intersect type of 2 types |
| CommonCallAdapterOptions |
Common optional parameters to create useAzureCommunicationCallAdapter or TeamsCallAdapter |
| CommonCallControlOptions |
Customization options for the control bar in calling experience. |
| CommonProperties |
Return intersect properties of 2 types |
| CommunicationParticipant |
A Chat or Calling participant's state, as reflected in the UI. |
| ComponentIcons |
Icons used by the React components exported from this library. |
| ComponentProps |
Helper type for usePropsFor. |
| ComponentSlotStyle |
ComponentSlotStyle is a @fluentui/react-northstar type. As we have moved away from this package we have used the more generic IRawStyle type from fluent for interoperability. |
| CompositeIcons |
Icons that can be overridden in one of the composites exported by this library. See ChatCompositeIcons, CallCompositeIcons and CallWithChatCompositeIcons for more targeted types. |
| ControlBarButtonStyles |
Styles for all ControlBarButton implementations. |
| ControlBarLayout |
Present layouts for the ControlBar. |
| CreateDefaultCallingHandlers |
Type of createDefaultCallingHandlers. |
| CreateViewResult |
Return result from StatefulCallClient.createView. |
| CustomAvatarOptions |
Options that can be injected into the |
| CustomCallControlButtonCallback |
A callback that returns the props to render a custom ControlBarButton and <xref:DrawerMenuItem>. The response indicates where the custom button should be placed. Performance tip: This callback is only called when either the callback or its arguments change. |
| CustomCallControlButtonPlacement |
Placement for a custom button injected in the <xref:CommonCallControlBar>. 'primary': Place the button(s) on the right end of the center control bar but before the EndCallButton (left end in rtl mode). 'overflow': Place the buttons(s) on the end of the overflow Menu. 'secondary': Place the button(s) on the left end of the side control bar (right in rtl mode). Multiple buttons assigned the same placement are appended in order. E.g., if two buttons are placed in 'secondary', they'll both appear on the left end (right end in rtl mode) in the order provided. Only 'primary' placement works when legacy call control is enabled in call composite |
| DeclarativeCallAgent |
|
| DeclarativeTeamsCallAgent |
|
| DeepNoiseSuppressionEffectDependency |
Dependency type to be injected for deep noise suppression |
| DeviceManagerState |
This type is meant to encapsulate all the state inside <xref:%40azure%2Fcommunication-calling%23DeviceManager>. For optional parameters they may not be available until permission is granted by the user. The cameras, microphones, speakers, and deviceAccess states will be empty until the corresponding <xref:%40azure%2Fcommunication-calling%23DeviceManager>'s getCameras, getMicrophones, getSpeakers, and askDevicePermission APIs are called and completed. |
| DevicesButtonSelector |
Selector type for DevicesButton component. |
| DiagnosticChangedEventListner |
Callback for CallAdapterSubscribers 'diagnosticChanged' event. |
| DialpadMode |
Modes of the dialpad component. |
| DisplayNameChangedListener |
Callback for CallAdapterSubscribers 'displayNameChanged' event. |
| DtmfTone |
DTMF tone for PSTN calls. |
| EmptySelector |
A type for trivial selectors that return no data. Used as a default return value if usePropsFor is called for a component that requires no data. |
| ErrorType |
All errors that can be shown in the ErrorBar. |
| GetCallingSelector |
Specific type of the selector applicable to a given Component. |
| GetChatSelector |
Specific type of the selector applicable to a given Component. |
| HoldButtonSelector |
Selector type for the HoldButton component. |
| IncomingCallManagement |
This contains a readonly array that returns all the active |
| IncomingCallStackSelector |
Selector to get the active and removed incoming calls. |
| IsCaptionLanguageChangedListener |
Callback for CallAdapterSubscribers 'isCaptionLanguageChanged' event. |
| IsCaptionsActiveChangedListener |
Callback for CallAdapterSubscribers 'isCaptionsActiveChanged' event. |
| IsLocalScreenSharingActiveChangedListener |
Callback for CallAdapterSubscribers 'isLocalScreenSharingActiveChanged' event. |
| IsMutedChangedListener |
Callback for CallAdapterSubscribers 'isMuted' event. |
| IsSpeakingChangedListener |
Callback for CallAdapterSubscribers 'isSpeakingChanged' event. |
| IsSpokenLanguageChangedListener |
Callback for CallAdapterSubscribers 'isSpokenLanguageChanged' event. |
| LoadingState |
Whether the stream is loading or not. |
| LocalScreenShareView | |
| LocalVideoTileSize |
different modes of the local video tile |
| LocalizationProviderProps |
Props for LocalizationProvider. |
| LongPressTrigger |
Modes of how the longpress handlers can be tiggered. |
| MediaAccess |
Audio/Video Media access state |
| MediaDiagnosticChangedEvent |
Payload for DiagnosticChangedEventListner where there is a change in a media diagnostic. |
| Message |
Discriminated union of all messages. The |
| MessageAttachedStatus |
Indicate whether a chat message should be displayed merged with the message before / after it.
If |
| MessageContentType |
Supported types of chat message content. |
| MessageDeletedListener |
Callback for ChatAdapterSubscribers 'messageDeleted' event. |
| MessageEditedListener |
Callback for ChatAdapterSubscribers 'messageEdited' event. |
| MessageProps |
Props to render a single message. See MessageRenderer. |
| MessageReadListener |
Callback for ChatAdapterSubscribers 'messageRead' event. |
| MessageReceivedListener |
Callback for ChatAdapterSubscribers 'messageReceived' event. |
| MessageRenderer |
A component to render a single message. |
| MessageSentListener |
Callback for ChatAdapterSubscribers 'messageSent' event. |
| MessageStatus |
Client-side state of a sent message. Includes transitional states that occur before message delivery is confirmed from the backend. |
| MessageThreadProps |
Props for MessageThread. |
| MessageThreadSelector |
Selector type for MessageThread component. |
| MicrophoneButtonSelector |
Selector type for MicrophoneButton component. |
| NetworkDiagnosticChangedEvent |
Payload for DiagnosticChangedEventListner where there is a change in a network diagnostic. |
| NotificationStackSelector |
Selector type for Notification component. |
| NotificationTarget | |
| NotificationType |
All notifications that can be shown in the NotificationStack. |
| OnFetchChatProfileCallback |
Callback function used to provide custom data to build profile for a user or bot. |
| OnFetchProfileCallback |
Callback function used to provide custom data to build profile for a user or bot. |
| OnRenderAvatarCallback |
A custom rendered callback that allows users to customize the rendering of a Persona Component. |
| OverflowGalleryPosition |
Different modes and positions of the overflow gallery in the VideoGallery |
| ParticipantListParticipant |
Participants displayed in a ParticipantList. |
| ParticipantListProps |
Props for ParticipantList. |
| ParticipantListSelector |
Selector type for ParticipantList component. |
| ParticipantMenuItemsCallback |
A callback for providing custom menu items for each participant in ParticipantList. |
| ParticipantState |
The connection state of a call participant. |
| ParticipantsAddedListener |
Callback for ChatAdapterSubscribers 'participantsAdded' event. |
| ParticipantsButtonSelector |
Selector type for ParticipantsButton component. |
| ParticipantsJoinedListener |
Callback for CallAdapterSubscribers 'participantsJoined' event. |
| ParticipantsLeftListener |
Callback for CallAdapterSubscribers 'participantsLeft' event. |
| ParticipantsRemovedListener |
Callback for ChatAdapterSubscribers 'participantsRemoved' event. |
| Profile |
The profile of a user or bot. |
| RaiseHandButtonSelector |
Selector type for RaiseHandButton component. |
| RaisedHand |
Raised hand state with order |
| RaisedHandState |
Raised hand state with order |
| Reaction |
Reaction state with reaction type to render |
| ReactionButtonReaction |
Reactions types for the Reaction button |
| ReactionSprite |
Type for animation sprite image and related metadata |
| ReactionState |
State only version of <xref:%40azure%2Fcommunication-calling%23Call.ReactionMessage> with UI helper props receivedOn. Reaction state with a timestamp which helps UI to decide to render the reaction accordingly. |
| ReadReceiptsBySenderId |
An array of key value pairs that stores each sender's display name and last read message |
| RealTimeTextInformation |
information required for each line of real time text |
| RealTimeTextReceivedListener |
Callback for CallAdapterSubscribers 'realTimeTextReceived' event. |
| ResourceDetails |
Details required for download a resource to cache. |
| ResourceFetchResult |
Result of the Resource downloaded from stateful client |
| ScreenShareButtonSelector |
Selector type for ScreenShareButton component. |
| Selector |
An optimized selector that refines ClientState updates into props for React Components in this library. |
| SendBoxSelector |
Selector type for SendBox component. |
| SoundEffect |
Type for representing a custom sound to use for a calling event |
| Spotlight |
Spotlight state with order |
| SpotlightChangedListener |
Callback for CallAdapterSubscribers 'spotlightChanged' event. |
| StartCallIdentifier |
Identifier types for initiating a call using the CallAdapter |
| StartCaptionsButtonSelector |
Selector type for the StartCaptionsButton component. |
| StatefulCallClientArgs |
Arguments to construct the StatefulCallClient. |
| StatefulCallClientOptions |
Options to construct the StatefulCallClient with. |
| StatefulChatClientArgs |
Arguments to construct the StatefulChatClient. |
| StatefulChatClientOptions |
Options to construct the StatefulChatClient. |
| SupportedCaptionLanguage | |
| SupportedSpokenLanguage | |
| SystemMessage |
Discriminated union of all system messages. The |
| TeamsAdapterOptions |
Optional parameters to create TeamsCallAdapter |
| TeamsCallAdapterArgs |
Arguments for creating the Azure Communication Services implementation of TeamsCallAdapter. |
| TeamsCallAdapterArgsCommon |
Common part of args to create the Azure Communication Services implementation of TeamsCallAdapter. |
| TeamsIncomingCallManagement |
Proxies the <xref:%40azure%2Fcommunication-calling%23TeamsIncomingCall> interface. |
| TogetherModeParticipantSeatingState |
Represents the seating positions of participants in Together Mode. |
| TopicChangedListener |
Callback for ChatAdapterSubscribers 'topicChanged' event. |
| TransferAcceptedListener |
Callback for CallAdapterSubscribers 'transferRequested' event. |
| TypingIndicatorSelector |
Selector type for TypingIndicator component. |
| UpdateMessageCallback |
Callback function run when a message is updated. |
| VideoBackgroundEffect |
Contains the attibutes of a selected video background effect |
| VideoBackgroundEffectsDependency |
Dependency type to be injected for video background effects |
| VideoGalleryLayout | |
| VideoGalleryParticipant |
The state of a participant in the VideoGallery. |
| VideoGallerySelector |
Selector type for VideoGallery component. |
| VideoGalleryTogetherModeParticipantPosition |
Interface representing the position of a participant in Together Mode. |
| ViewScalingMode |
Scaling mode of a VideoGalleryStream. |
Functions
Variables
| Call |
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-calling%23CallAgent>. Calling components from this package must be wrapped with a CallAgentProvider. |
| Call |
A <xref:React.Context> that stores a StatefulCallClient. Calling components from this package must be wrapped with a CallClientProvider. |
| Call |
A customizable UI composite for calling experience. |
| Call |
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-calling%23Call>. Calling components from this package must be wrapped with a CallProvider. |
| Call |
CallWithChatComposite brings together key components to provide a full call with chat experience out of the box. |
| Camera |
A button to turn camera on / off. Can be used with ControlBar. |
| Captions |
A component for displaying a CaptionsBanner with user icon, displayName and captions text. |
| Captions |
a component for setting spoken languages |
| Chat |
A <xref:React.Context> that stores a StatefulChatClient. Chat components from this package must be wrapped with a ChatClientProvider. |
| Chat |
A customizable UI composite for the chat experience. |
| Chat |
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-chat%23ChatThreadClient>. Chat components from this package must be wrapped with a ChatThreadClientProvider. |
| COMPONENT_LOCALE_AR_SA | Locale for Arabic (Saudi Arabia). |
| COMPONENT_LOCALE_CS_CZ | Locale for Czech (Czech Republic). |
| COMPONENT_LOCALE_CY_GB | Locale for Welsh (GB). |
| COMPONENT_LOCALE_DE_DE | Locale for German (Germany). |
| COMPONENT_LOCALE_EN_GB | Locale for English (GB). |
| COMPONENT_LOCALE_EN_US | Locale for English (US). |
| COMPONENT_LOCALE_ES_ES | Locale for Spanish (Spain). |
| COMPONENT_LOCALE_ES_MX | Locale for Spanish (Mexico). |
| COMPONENT_LOCALE_FI_FI | Locale for Finnish (Finland). |
| COMPONENT_LOCALE_FR_CA | Locale for French (Canada). |
| COMPONENT_LOCALE_FR_FR | Locale for French (France). |
| COMPONENT_LOCALE_HE_IL | Locale for Hebrew (Israel). |
| COMPONENT_LOCALE_IT_IT | Locale for Italian (Italy). |
| COMPONENT_LOCALE_JA_JP | Locale for Japanese (Japan). |
| COMPONENT_LOCALE_KO_KR | Locale for Korean (South Korea). |
| COMPONENT_LOCALE_NB_NO | Locale for Norwegian Bokmål (Norway) . |
| COMPONENT_LOCALE_NL_NL | Locale for Dutch (Netherlands). |
| COMPONENT_LOCALE_PL_PL | Locale for Polish (Poland). |
| COMPONENT_LOCALE_PT_BR | Locale for Portuguese (Brazil). |
| COMPONENT_LOCALE_RU_RU | Locale for Russian (Russia). |
| COMPONENT_LOCALE_SV_SE | Locale for Swedish (Sweden) . |
| COMPONENT_LOCALE_TR_TR | Locale for Turkish (Turkey). |
| COMPONENT_LOCALE_ZH_CN | Locale for Chinese (Mainland China). |
| COMPONENT_LOCALE_ZH_TW | Locale for Chinese (Taiwan). |
| COMPOSITE_LOCALE_AR_SA | Locale for Arabic (Saudi Arabia) |
| COMPOSITE_LOCALE_CS_CZ | Locale for Czech (Czech Republic) |
| COMPOSITE_LOCALE_CY_GB | Locale for Welsh (GB) |
| COMPOSITE_LOCALE_DE_DE | Locale for German (Germany) |
| COMPOSITE_LOCALE_EN_GB | Locale for English (British) |
| COMPOSITE_LOCALE_EN_US | Locale for English (US) |
| COMPOSITE_LOCALE_ES_ES | Locale for Spanish (Spain) |
| COMPOSITE_LOCALE_ES_MX | Locale for Spanish (Mexico) |
| COMPOSITE_LOCALE_FI_FI | Locale for Finnish (Finland) |
| COMPOSITE_LOCALE_FR_CA | Locale for French (Canada) |
| COMPOSITE_LOCALE_FR_FR | Locale for French (France) |
| COMPOSITE_LOCALE_HE_IL | Locale for Hebrew (Israel) |
| COMPOSITE_LOCALE_IT_IT | Locale for Italian (Italy) |
| COMPOSITE_LOCALE_JA_JP | Locale for Japanese (Japan) |
| COMPOSITE_LOCALE_KO_KR | Locale for Korean (South Korea) |
| COMPOSITE_LOCALE_NB_NO | Locale for Norwegian Bokmål (Norway) |
| COMPOSITE_LOCALE_NL_NL | Locale for Dutch (Netherlands) |
| COMPOSITE_LOCALE_PL_PL | Locale for Polish (Poland) |
| COMPOSITE_LOCALE_PT_BR | Locale for Portuguese (Brazil) |
| COMPOSITE_LOCALE_RU_RU | Locale for Russian (Russia) |
| COMPOSITE_LOCALE_SV_SE | Locale for Swedish (Sweden) |
| COMPOSITE_LOCALE_TR_TR | Locale for Turkish (Turkey) |
| COMPOSITE_LOCALE_ZH_CN | Locale for Chinese (Mainland China) |
| COMPOSITE_LOCALE_ZH_TW | Locale for Chinese (Taiwan) |
| COMPOSITE_ONLY_ICONS | The default set of icons used by the composites directly (i.e. not via the components defined in this library). |
| Control |
A container for various buttons for call controls. Use with various call control buttons in this library, e.g., CameraButton, or your own instances of ControlBarButton directly. |
| Control |
Default button styled for the ControlBar. Use this component create custom buttons that are styled the same as other buttons provided by the UI Library. |
| DEFAULT_COMPONENT_ICONS | The default set of icons that are available to use in the UI components. |
| DEFAULT_COMPOSITE_ICONS | The default set of icons that are available to used in the Composites. |
| Devices |
A button to open a menu that controls device options. Can be used with ControlBar. |
| Dialpad | A component to allow users to enter phone number through clicking on dialpad/using keyboard It will return empty component for stable builds |
| End |
A button to end an ongoing call. Can be used with ControlBar. |
| Error |
A component to show error messages on the UI. All strings that can be shown are accepted as the ErrorBarProps.strings so that they can be localized. Active errors are selected by ErrorBarProps.activeErrorMessages. This component internally tracks dismissed by the user.
Uses <xref:%40fluentui%2Freact%23MessageBar> UI element. |
| Fluent |
Provider to apply a Fluent theme across this library's react components. |
| Grid |
A component to lay out audio / video participants tiles in a call. |
| Hold |
a button to hold or resume a ongoing call. Can be used with ControlBar |
| Image |
Component to render a fullscreen modal for a selected image. |
| Incoming |
A Notification component that is to be used to represent incoming calls to the end user. Allows the user to accept or reject the incoming call. |
| Incoming |
Wrapper to manage multiple incoming calls |
| Localization |
Provider to provide localized strings for this library's react components. |
| Message |
Component to display the status of a sent message. Adds an icon and tooltip corresponding to the message status. |
| Message |
|
| Microphone |
A button to turn microphone on / off. Can be used with ControlBar. |
| Notification | A component to show notification messages on the UI. |
| Notification |
A component to show notifications on the UI. All strings that can be shown are accepted as the NotificationStackProps.strings so that they can be localized. Active notifications are selected by NotificationStackProps.activeNotifications. This component internally tracks dismissed by the user.
|
| Participant |
Component to render a calling or chat participant. Displays the participant's avatar, displayName and status as well as optional icons and context menu. |
| Participant |
Component to render all calling or chat participants. By default, each participant is rendered with ParticipantItem. See ParticipantListProps.onRenderParticipant to override. |
| Participants |
A button to show a menu with calling or chat participants. Can be used with ControlBar. This button contains dropdown menu items defined through its property |
| Raise |
A button to start / stop screen sharing. Can be used with ControlBar. |
| Reaction |
A button to send reactions. Can be used with ControlBar. |
| Real |
A component for displaying a single line of RealTimeText |
| Real |
a component for realTimeText modal |
| Screen |
A button to start / stop screen sharing. Can be used with ControlBar. |
| Send |
Component for typing and sending messages. Supports sending typing notification when user starts entering text. Supports an optional message below the text input field. |
| Start |
a button to start or stop captions Can be used with ControlBar |
| Start |
a button to start RealTimeText based on accessibility requirement, real time text cannot be turned off once it is on Can be used with ControlBar |
| Stream |
Utility component to convert an HTMLElement with a video stream into a JSX element. Use to convert an HTMLElement returned by headless calling API into a component that can be rendered as a VideoTile. |
| Typing |
Component to notify local user when one or more participants in the chat thread are typing. |
| Video |
VideoGallery represents a layout of video tiles for a specific call. It displays a VideoTile for the local user as well as for each remote participant who has joined the call. |
| Video |
A component to render the video stream for a single call participant. Use with GridLayout in a VideoGallery. |
| create |
Create a CallWithChatAdapter backed by Azure Communication services to plug into the CallWithChatComposite. |
| create |
Create a CallWithChatAdapter using the provided StatefulChatClient and StatefulCallClient. Useful if you want to keep a reference to StatefulChatClient and StatefulCallClient. Please note that chatThreadClient has to be created by StatefulChatClient via chatClient.getChatThreadClient(chatThreadId) API. Consider using createAzureCommunicationCallWithChatAdapter for a simpler API. |
| create |
Create a ChatAdapter backed by Azure Communication Services. This is the default implementation of ChatAdapter provided by this library. |
| create |
Create the default implementation of CallingHandlers for teams call. Useful when implementing a custom component that utilizes the providers exported from this library. |
| create |
Create the default implementation of ChatHandlers. Useful when implementing a custom component that utilizes the providers exported from this library. Returned object is memoized to avoid rerenders when used as props for React Components. |
| create |
Create the default implementation of TeamsCallingHandlers for teams call. Useful when implementing a custom component that utilizes the providers exported from this library. |
| create |
Creates a StatefulCallClient StatefulCallClient by proxying CallClient <xref:%40azure%2Fcommunication-calling%23CallClient> with ProxyCallClient <xref:ProxyCallClient> which then allows access to state in a declarative way. It is important to use the <xref:%40azure%2Fcommunication-calling%23DeviceManager> and <xref:%40azure%2Fcommunication-calling%23CallAgent> and <xref:%40azure%2Fcommunication-calling%23Call> (and etc.) that are obtained from the StatefulCallClient in order for their state changes to be proxied properly. |
| create |
Creates a stateful ChatClient StatefulChatClient by proxying ChatClient <xref:%40azure%2Fcommunication-chat%23ChatClient> with ProxyChatClient <xref:ProxyChatClient> which then allows access to state in a declarative way. |
| create |
|
| create |
Create a TeamsCallAdapter using the provided StatefulCallClient. Useful if you want to keep a reference to StatefulCallClient. Consider using createAzureCommunicationCallAdapter for a simpler API. |
| dark |
Preset dark theme for components exported from this library. |
| from |
Reverse operation of toFlatCommunicationIdentifier. |
| get |
Get the selector for a specified component. Useful when implementing a custom component that utilizes the providers exported from this library. |
| get |
Get the selector for a specified component. Useful when implementing a custom component that utilizes the providers exported from this library. |
| light |
Preset light theme for components exported from this library. |
| load |
Loader function for the CallComposite that you can use in your application. This function will load the CallComposite into the provided HTML element. The best use case for this is in a Node ui framework that is not React based. |
| load |
Props for the CallWithChatComposite that you can use in your application. This function will load the CallWithChatComposite into the provided HTML element. The best use case for this is in a Node UI framework that is not React based. |
| load |
Loader function for the ChatComposite that you can use in your application. This function will load the ChatComposite into the provided HTML element. The best use case for this is in a Node UI framework that is not React based. |
| load |
Loader function for the OutboundCallComposite that you can use in your application. This function will load the CallComposite into the provided HTML element to make outbound calls. The best use case for this is in a Node UI framework that is not React based. |
| on |
Dependency resolution for video background effects using lazy loading. |
| on |
Dependency resolution for video background effects using lazy loading. |
| on |
Dependency resolution for video background effects. |
| on |
Dependency resolution for video background effects using lazy loading. |
| to |
A string representation of a <xref:%40azure%2Fcommunication-common%23CommunicationIdentifier>. This string representation of CommunicationIdentifier is guaranteed to be stable for a unique Communication user. Thus,
|
| use |
A custom React hook to simplify the creation of CallAdapter. Similar to createAzureCommunicationCallAdapter, but takes care of asynchronous creation of the adapter internally. Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined. Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples. |
| use |
A custom React hook to simplify the creation of CallWithChatAdapter. Similar to createAzureCommunicationCallWithChatAdapter, but takes care of asynchronous creation of the adapter internally. Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined. Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples. |
| use |
A custom React hook to simplify the creation of ChatAdapter. Similar to createAzureCommunicationChatAdapter, but takes care of asynchronous creation of the adapter internally. Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined. Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples. |
| use |
Hook to obtain <xref:%40azure%2Fcommunication-calling%23Call> from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. you must have previously used the CallProvider with a Call object to use this hook |
| use |
Hook to obtain <xref:%40azure%2Fcommunication-calling%23CallAgent> from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Hook to obtain StatefulCallClient from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Hook to obtain StatefulChatClient from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Hook to obtain <xref:%40azure%2Fcommunication-chat%23ChatThreadClient> from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Hook to obtain StatefulDeviceManager from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Primary hook to get all hooks necessary for a React Component from this library. To call this hook, the component requires to be wrapped under these providers:
Most straightforward usage of a components looks like: Example
|
| use |
Hook to obtain a selector for a specified component. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
Hook to obtain <xref:%40azure%2Fcommunication-calling%23TeamsCall> from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. you must have previously used the CallProvider with a TeamsCall object to use this hook |
| use |
A custom React hook to simplify the creation of TeamsCallAdapter. Similar to <xref:createTeamsAzureCommunicationCallAdapter>, but takes care of asynchronous creation of the adapter internally. Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined. Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples. |
| use |
Hook to obtain <xref:%40azure%2Fcommunication-calling%23TeamsCallAgent> from the provider. Useful when implementing a custom component that utilizes the providers exported from this library. |
| use |
React hook to access theme |
Function Details
createAzureCommunicationCallAdapter(AzureCommunicationCallAdapterArgs)
Create a CallAdapter backed by Azure Communication Services.
This is the default implementation of CallAdapter provided by this library.
Note: displayName can be a maximum of 256 characters.
function createAzureCommunicationCallAdapter(args: AzureCommunicationCallAdapterArgs): Promise<CallAdapter>
Parameters
Returns
Promise<CallAdapter>
createAzureCommunicationCallAdapter(AzureCommunicationOutboundCallAdapterArgs)
Create a CallAdapter backed by Azure Communication Services.
This is the default implementation of CallAdapter provided by this library.
Note: displayName can be a maximum of 256 characters.
function createAzureCommunicationCallAdapter(args: AzureCommunicationOutboundCallAdapterArgs): Promise<CallAdapter>
Parameters
Returns
Promise<CallAdapter>
createAzureCommunicationCallAdapterFromClient(StatefulCallClient, CallAgent, CommunicationIdentifier[], CommonCallAdapterOptions)
Create a CallAdapter using the provided StatefulCallClient.
Useful if you want to keep a reference to StatefulCallClient. Consider using createAzureCommunicationCallAdapter for a simpler API.
function createAzureCommunicationCallAdapterFromClient(callClient: StatefulCallClient, callAgent: CallAgent, targetCallees: CommunicationIdentifier[], options?: CommonCallAdapterOptions): Promise<CallAdapter>
Parameters
- callClient
- StatefulCallClient
- callAgent
- CallAgent
- targetCallees
- options
- CommonCallAdapterOptions
Returns
Promise<CallAdapter>
createAzureCommunicationCallAdapterFromClient(StatefulCallClient, CallAgent, CallAdapterLocator, CommonCallAdapterOptions)
Create a CallAdapter using the provided StatefulCallClient.
Useful if you want to keep a reference to StatefulCallClient. Consider using createAzureCommunicationCallAdapter for a simpler API.
function createAzureCommunicationCallAdapterFromClient(callClient: StatefulCallClient, callAgent: CallAgent, locator: CallAdapterLocator, options?: CommonCallAdapterOptions): Promise<CallAdapter>
Parameters
- callClient
- StatefulCallClient
- callAgent
- CallAgent
- locator
- CallAdapterLocator
- options
- CommonCallAdapterOptions
Returns
Promise<CallAdapter>
createAzureCommunicationChatAdapterFromClient(StatefulChatClient, ChatThreadClient, ChatAdapterOptions)
Create a ChatAdapter using the provided StatefulChatClient.
Useful if you want to keep a reference to StatefulChatClient. Consider using createAzureCommunicationChatAdapter for a simpler API.
function createAzureCommunicationChatAdapterFromClient(chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient, chatAdapterOptions?: ChatAdapterOptions): Promise<ChatAdapter>
Parameters
- chatClient
- StatefulChatClient
- chatThreadClient
- ChatThreadClient
- chatAdapterOptions
- ChatAdapterOptions
Returns
Promise<ChatAdapter>
Variable Details
CallAgentProvider
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-calling%23CallAgent>.
Calling components from this package must be wrapped with a CallAgentProvider.
CallAgentProvider: (props: CallAgentProviderProps) => JSX.Element
Type
(props: CallAgentProviderProps) => JSX.Element
CallClientProvider
A <xref:React.Context> that stores a StatefulCallClient.
Calling components from this package must be wrapped with a CallClientProvider.
CallClientProvider: (props: CallClientProviderProps) => JSX.Element
Type
(props: CallClientProviderProps) => JSX.Element
CallComposite
A customizable UI composite for calling experience.
CallComposite: (props: CallCompositeProps) => JSX.Element
Type
(props: CallCompositeProps) => JSX.Element
Remarks
Call composite min width/height are as follow:
- mobile: 17.5rem x 21rem (280px x 336px, with default rem at 16px)
- desktop: 30rem x 22rem (480px x 352px, with default rem at 16px)
CallProvider
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-calling%23Call>.
Calling components from this package must be wrapped with a CallProvider.
CallProvider: (props: CallProviderProps) => JSX.Element
Type
(props: CallProviderProps) => JSX.Element
CallWithChatComposite
CallWithChatComposite brings together key components to provide a full call with chat experience out of the box.
CallWithChatComposite: (props: CallWithChatCompositeProps) => JSX.Element
Type
(props: CallWithChatCompositeProps) => JSX.Element
CameraButton
A button to turn camera on / off.
Can be used with ControlBar.
CameraButton: (props: CameraButtonProps) => JSX.Element
Type
(props: CameraButtonProps) => JSX.Element
CaptionsBanner
A component for displaying a CaptionsBanner with user icon, displayName and captions text.
CaptionsBanner: (props: CaptionsBannerProps) => JSX.Element
Type
(props: CaptionsBannerProps) => JSX.Element
CaptionsSettingsModal
a component for setting spoken languages
CaptionsSettingsModal: (props: CaptionsSettingsModalProps) => JSX.Element
Type
(props: CaptionsSettingsModalProps) => JSX.Element
ChatClientProvider
A <xref:React.Context> that stores a StatefulChatClient.
Chat components from this package must be wrapped with a ChatClientProvider.
ChatClientProvider: (props: ChatClientProviderProps) => JSX.Element
Type
(props: ChatClientProviderProps) => JSX.Element
ChatComposite
A customizable UI composite for the chat experience.
ChatComposite: (props: ChatCompositeProps) => JSX.Element
Type
(props: ChatCompositeProps) => JSX.Element
Remarks
Chat composite min width and height are respectively 17.5rem and 20rem (280px and 320px, with default rem at 16px)
ChatThreadClientProvider
A <xref:React.Context> that stores a <xref:%40azure%2Fcommunication-chat%23ChatThreadClient>.
Chat components from this package must be wrapped with a ChatThreadClientProvider.
ChatThreadClientProvider: (props: ChatThreadClientProviderProps) => JSX.Element
Type
(props: ChatThreadClientProviderProps) => JSX.Element
COMPONENT_LOCALE_AR_SA
COMPONENT_LOCALE_CS_CZ
COMPONENT_LOCALE_CY_GB
COMPONENT_LOCALE_DE_DE
COMPONENT_LOCALE_EN_GB
COMPONENT_LOCALE_EN_US
COMPONENT_LOCALE_ES_ES
COMPONENT_LOCALE_ES_MX
COMPONENT_LOCALE_FI_FI
COMPONENT_LOCALE_FR_CA
COMPONENT_LOCALE_FR_FR
COMPONENT_LOCALE_HE_IL
COMPONENT_LOCALE_IT_IT
COMPONENT_LOCALE_JA_JP
COMPONENT_LOCALE_KO_KR
COMPONENT_LOCALE_NB_NO
Locale for Norwegian Bokmål (Norway) .
COMPONENT_LOCALE_NB_NO: ComponentLocale
Type
COMPONENT_LOCALE_NL_NL
COMPONENT_LOCALE_PL_PL
COMPONENT_LOCALE_PT_BR
COMPONENT_LOCALE_RU_RU
COMPONENT_LOCALE_SV_SE
COMPONENT_LOCALE_TR_TR
COMPONENT_LOCALE_ZH_CN
COMPONENT_LOCALE_ZH_TW
COMPOSITE_LOCALE_AR_SA
COMPOSITE_LOCALE_CS_CZ
COMPOSITE_LOCALE_CY_GB
COMPOSITE_LOCALE_DE_DE
COMPOSITE_LOCALE_EN_GB
COMPOSITE_LOCALE_EN_US
COMPOSITE_LOCALE_ES_ES
COMPOSITE_LOCALE_ES_MX
COMPOSITE_LOCALE_FI_FI
COMPOSITE_LOCALE_FR_CA
COMPOSITE_LOCALE_FR_FR
COMPOSITE_LOCALE_HE_IL
COMPOSITE_LOCALE_IT_IT
COMPOSITE_LOCALE_JA_JP
COMPOSITE_LOCALE_KO_KR
COMPOSITE_LOCALE_NB_NO
COMPOSITE_LOCALE_NL_NL
COMPOSITE_LOCALE_PL_PL
COMPOSITE_LOCALE_PT_BR
COMPOSITE_LOCALE_RU_RU
COMPOSITE_LOCALE_SV_SE
COMPOSITE_LOCALE_TR_TR
COMPOSITE_LOCALE_ZH_CN
COMPOSITE_LOCALE_ZH_TW
COMPOSITE_ONLY_ICONS
The default set of icons used by the composites directly (i.e. not via the components defined in this library).
COMPOSITE_ONLY_ICONS: CompositeIcons
Type
ControlBar
A container for various buttons for call controls.
Use with various call control buttons in this library, e.g., CameraButton, or your own instances of ControlBarButton directly.
ControlBar: (props: ControlBarProps) => JSX.Element
Type
(props: ControlBarProps) => JSX.Element
ControlBarButton
Default button styled for the ControlBar.
Use this component create custom buttons that are styled the same as other buttons provided by the UI Library.
ControlBarButton: (props: ControlBarButtonProps) => JSX.Element
Type
(props: ControlBarButtonProps) => JSX.Element
DEFAULT_COMPONENT_ICONS
The default set of icons that are available to use in the UI components.
DEFAULT_COMPONENT_ICONS: { CaptionsIcon: React_2.JSX.Element, CaptionsOffIcon: React_2.JSX.Element, CaptionsSettingsIcon: React_2.JSX.Element, ChangeCaptionLanguageIcon: React_2.JSX.Element, ChangeSpokenLanguageIcon: React_2.JSX.Element, ChatMessageOptions: React_2.JSX.Element, ConfigurationScreenVideoEffectsButton: React_2.JSX.Element, ContextMenuCameraIcon: React_2.JSX.Element, ContextMenuMicIcon: React_2.JSX.Element, ContextMenuRemoveParticipant: React_2.JSX.Element, ContextMenuSpeakerIcon: React_2.JSX.Element, ContextualMenuMicMutedIcon: React_2.JSX.Element, ControlButtonCameraOff: React_2.JSX.Element, ControlButtonCameraOn: React_2.JSX.Element, ControlButtonCameraProhibited: React_2.JSX.Element, ControlButtonCameraProhibitedSmall: React_2.JSX.Element, ControlButtonEndCall: React_2.JSX.Element, ControlButtonLowerHand: React_2.JSX.Element, ControlButtonMicOff: React_2.JSX.Element, ControlButtonMicOn: React_2.JSX.Element, ControlButtonMicProhibited: React_2.JSX.Element, ControlButtonMicProhibitedSmall: React_2.JSX.Element, ControlButtonOptions: React_2.JSX.Element, ControlButtonParticipants: React_2.JSX.Element, ControlButtonParticipantsContextualMenuItem: React_2.JSX.Element, ControlButtonRaiseHand: React_2.JSX.Element, ControlButtonScreenShareStart: React_2.JSX.Element, ControlButtonScreenShareStop: React_2.JSX.Element, ControlButtonVideoEffectsOption: React_2.JSX.Element, DialpadBackspace: React_2.JSX.Element, EditBoxCancel: React_2.JSX.Element, EditBoxSubmit: React_2.JSX.Element, ErrorBarCallCameraAccessDenied: React_2.JSX.Element, ErrorBarCallCameraAlreadyInUse: React_2.JSX.Element, ErrorBarCallLocalVideoFreeze: React_2.JSX.Element, ErrorBarCallMacOsCameraAccessDenied: React_2.JSX.Element, ErrorBarCallMacOsMicrophoneAccessDenied: React_2.JSX.Element, ErrorBarCallMicrophoneAccessDenied: React_2.JSX.Element, ErrorBarCallMicrophoneMutedBySystem: React_2.JSX.Element, ErrorBarCallMicrophoneUnmutedBySystem: React_2.JSX.Element, ErrorBarCallNetworkQualityLow: React_2.JSX.Element, ErrorBarCallNoMicrophoneFound: React_2.JSX.Element, ErrorBarCallNoSpeakerFound: React_2.JSX.Element, ErrorBarCallVideoRecoveredBySystem: React_2.JSX.Element, ErrorBarCallVideoStoppedBySystem: React_2.JSX.Element, ErrorBarClear: React_2.JSX.Element, ErrorBarMutedByRemoteParticipant: React_2.JSX.Element, ExpandIcon: React_2.JSX.Element, HoldCallButton: React_2.JSX.Element, HoldCallContextualMenuItem: React_2.JSX.Element, HorizontalGalleryLeftButton: React_2.JSX.Element, HorizontalGalleryRightButton: React_2.JSX.Element, IncomingCallNotificationAcceptIcon: React_2.JSX.Element, IncomingCallNotificationAcceptWithVideoIcon: React_2.JSX.Element, IncomingCallNotificationRejectIcon: React_2.JSX.Element, LowerHandContextualMenuItem: React_2.JSX.Element, MessageDelivered: React_2.JSX.Element, MessageEdit: React_2.JSX.Element, MessageFailed: React_2.JSX.Element, MessageRemove: React_2.JSX.Element, MessageResend: React_2.JSX.Element, MessageSeen: React_2.JSX.Element, MessageSending: React_2.JSX.Element, MinimizeIcon: React_2.JSX.Element, NotificationBarBreakoutRoomChanged: React_2.JSX.Element, NotificationBarBreakoutRoomClosed: React_2.JSX.Element, NotificationBarBreakoutRoomClosingSoon: React_2.JSX.Element, NotificationBarBreakoutRoomJoined: React_2.JSX.Element, NotificationBarBreakoutRoomOpened: React_2.JSX.Element, NotificationBarBreakoutRoomPromptJoin: React_2.JSX.Element, NotificationBarRecording: React_2.JSX.Element, NotificationBarTogetherModeIcon: React_2.JSX.Element, NotificationBarTranscriptionError: React_2.JSX.Element, NotificationBarTranscriptionStartedByYou: React_2.JSX.Element, OpenAttachment: React_2.JSX.Element, OptionsCamera: React_2.JSX.Element, OptionsMic: React_2.JSX.Element, OptionsSpeaker: React_2.JSX.Element, ParticipantItemMicOff: React_2.JSX.Element, ParticipantItemOptions: React_2.JSX.Element, ParticipantItemOptionsHovered: React_2.JSX.Element, ParticipantItemPinned: React_2.JSX.Element, ParticipantItemScreenShareStart: React_2.JSX.Element, ParticipantItemSpotlighted: React_2.JSX.Element, PinParticipant: React_2.JSX.Element, RaiseHandContextualMenuItem: React_2.JSX.Element, ReactionButtonIcon: React_2.JSX.Element, RealTimeTextIcon: React_2.JSX.Element, ResumeCall: React_2.JSX.Element, SendBoxSend: React_2.JSX.Element, SendBoxSendHovered: React_2.JSX.Element, SplitButtonPrimaryActionCameraOff: React_2.JSX.Element, SplitButtonPrimaryActionCameraOn: React_2.JSX.Element, SplitButtonPrimaryActionMicMuted: React_2.JSX.Element, SplitButtonPrimaryActionMicUnmuted: React_2.JSX.Element, StartSpotlightContextualMenuItem: React_2.JSX.Element, StopSpotlightContextualMenuItem: React_2.JSX.Element, SurveyStarIcon: React_2.JSX.Element, SurveyStarIconFilled: React_2.JSX.Element, UnpinParticipant: React_2.JSX.Element, VerticalGalleryLeftButton: React_2.JSX.Element, VerticalGalleryRightButton: React_2.JSX.Element, VideoTileCameraOff: React_2.JSX.Element, VideoTileMicOff: React_2.JSX.Element, VideoTileMoreOptions: React_2.JSX.Element, VideoTilePinned: React_2.JSX.Element, VideoTileScaleFill: React_2.JSX.Element, VideoTileScaleFit: React_2.JSX.Element, VideoTileSpotlighted: React_2.JSX.Element }
Type
{ CaptionsIcon: React_2.JSX.Element, CaptionsOffIcon: React_2.JSX.Element, CaptionsSettingsIcon: React_2.JSX.Element, ChangeCaptionLanguageIcon: React_2.JSX.Element, ChangeSpokenLanguageIcon: React_2.JSX.Element, ChatMessageOptions: React_2.JSX.Element, ConfigurationScreenVideoEffectsButton: React_2.JSX.Element, ContextMenuCameraIcon: React_2.JSX.Element, ContextMenuMicIcon: React_2.JSX.Element, ContextMenuRemoveParticipant: React_2.JSX.Element, ContextMenuSpeakerIcon: React_2.JSX.Element, ContextualMenuMicMutedIcon: React_2.JSX.Element, ControlButtonCameraOff: React_2.JSX.Element, ControlButtonCameraOn: React_2.JSX.Element, ControlButtonCameraProhibited: React_2.JSX.Element, ControlButtonCameraProhibitedSmall: React_2.JSX.Element, ControlButtonEndCall: React_2.JSX.Element, ControlButtonLowerHand: React_2.JSX.Element, ControlButtonMicOff: React_2.JSX.Element, ControlButtonMicOn: React_2.JSX.Element, ControlButtonMicProhibited: React_2.JSX.Element, ControlButtonMicProhibitedSmall: React_2.JSX.Element, ControlButtonOptions: React_2.JSX.Element, ControlButtonParticipants: React_2.JSX.Element, ControlButtonParticipantsContextualMenuItem: React_2.JSX.Element, ControlButtonRaiseHand: React_2.JSX.Element, ControlButtonScreenShareStart: React_2.JSX.Element, ControlButtonScreenShareStop: React_2.JSX.Element, ControlButtonVideoEffectsOption: React_2.JSX.Element, DialpadBackspace: React_2.JSX.Element, EditBoxCancel: React_2.JSX.Element, EditBoxSubmit: React_2.JSX.Element, ErrorBarCallCameraAccessDenied: React_2.JSX.Element, ErrorBarCallCameraAlreadyInUse: React_2.JSX.Element, ErrorBarCallLocalVideoFreeze: React_2.JSX.Element, ErrorBarCallMacOsCameraAccessDenied: React_2.JSX.Element, ErrorBarCallMacOsMicrophoneAccessDenied: React_2.JSX.Element, ErrorBarCallMicrophoneAccessDenied: React_2.JSX.Element, ErrorBarCallMicrophoneMutedBySystem: React_2.JSX.Element, ErrorBarCallMicrophoneUnmutedBySystem: React_2.JSX.Element, ErrorBarCallNetworkQualityLow: React_2.JSX.Element, ErrorBarCallNoMicrophoneFound: React_2.JSX.Element, ErrorBarCallNoSpeakerFound: React_2.JSX.Element, ErrorBarCallVideoRecoveredBySystem: React_2.JSX.Element, ErrorBarCallVideoStoppedBySystem: React_2.JSX.Element, ErrorBarClear: React_2.JSX.Element, ErrorBarMutedByRemoteParticipant: React_2.JSX.Element, ExpandIcon: React_2.JSX.Element, HoldCallButton: React_2.JSX.Element, HoldCallContextualMenuItem: React_2.JSX.Element, HorizontalGalleryLeftButton: React_2.JSX.Element, HorizontalGalleryRightButton: React_2.JSX.Element, IncomingCallNotificationAcceptIcon: React_2.JSX.Element, IncomingCallNotificationAcceptWithVideoIcon: React_2.JSX.Element, IncomingCallNotificationRejectIcon: React_2.JSX.Element, LowerHandContextualMenuItem: React_2.JSX.Element, MessageDelivered: React_2.JSX.Element, MessageEdit: React_2.JSX.Element, MessageFailed: React_2.JSX.Element, MessageRemove: React_2.JSX.Element, MessageResend: React_2.JSX.Element, MessageSeen: React_2.JSX.Element, MessageSending: React_2.JSX.Element, MinimizeIcon: React_2.JSX.Element, NotificationBarBreakoutRoomChanged: React_2.JSX.Element, NotificationBarBreakoutRoomClosed: React_2.JSX.Element, NotificationBarBreakoutRoomClosingSoon: React_2.JSX.Element, NotificationBarBreakoutRoomJoined: React_2.JSX.Element, NotificationBarBreakoutRoomOpened: React_2.JSX.Element, NotificationBarBreakoutRoomPromptJoin: React_2.JSX.Element, NotificationBarRecording: React_2.JSX.Element, NotificationBarTogetherModeIcon: React_2.JSX.Element, NotificationBarTranscriptionError: React_2.JSX.Element, NotificationBarTranscriptionStartedByYou: React_2.JSX.Element, OpenAttachment: React_2.JSX.Element, OptionsCamera: React_2.JSX.Element, OptionsMic: React_2.JSX.Element, OptionsSpeaker: React_2.JSX.Element, ParticipantItemMicOff: React_2.JSX.Element, ParticipantItemOptions: React_2.JSX.Element, ParticipantItemOptionsHovered: React_2.JSX.Element, ParticipantItemPinned: React_2.JSX.Element, ParticipantItemScreenShareStart: React_2.JSX.Element, ParticipantItemSpotlighted: React_2.JSX.Element, PinParticipant: React_2.JSX.Element, RaiseHandContextualMenuItem: React_2.JSX.Element, ReactionButtonIcon: React_2.JSX.Element, RealTimeTextIcon: React_2.JSX.Element, ResumeCall: React_2.JSX.Element, SendBoxSend: React_2.JSX.Element, SendBoxSendHovered: React_2.JSX.Element, SplitButtonPrimaryActionCameraOff: React_2.JSX.Element, SplitButtonPrimaryActionCameraOn: React_2.JSX.Element, SplitButtonPrimaryActionMicMuted: React_2.JSX.Element, SplitButtonPrimaryActionMicUnmuted: React_2.JSX.Element, StartSpotlightContextualMenuItem: React_2.JSX.Element, StopSpotlightContextualMenuItem: React_2.JSX.Element, SurveyStarIcon: React_2.JSX.Element, SurveyStarIconFilled: React_2.JSX.Element, UnpinParticipant: React_2.JSX.Element, VerticalGalleryLeftButton: React_2.JSX.Element, VerticalGalleryRightButton: React_2.JSX.Element, VideoTileCameraOff: React_2.JSX.Element, VideoTileMicOff: React_2.JSX.Element, VideoTileMoreOptions: React_2.JSX.Element, VideoTilePinned: React_2.JSX.Element, VideoTileScaleFill: React_2.JSX.Element, VideoTileScaleFit: React_2.JSX.Element, VideoTileSpotlighted: React_2.JSX.Element }
DEFAULT_COMPOSITE_ICONS
The default set of icons that are available to used in the Composites.
DEFAULT_COMPOSITE_ICONS: { BlurVideoBackground?: JSX.Element, CaptionsIcon: React_2.JSX.Element, CaptionsOffIcon: React_2.JSX.Element, CaptionsSettingsIcon: React_2.JSX.Element, ChangeCaptionLanguageIcon: React_2.JSX.Element, ChangeSpokenLanguageIcon: React_2.JSX.Element, ChatMessageOptions: React_2.JSX.Element, ChevronLeft?: JSX.Element, ConfigurationScreenVideoEffectsButton: React_2.JSX.Element, ContextMenuCameraIcon: React_2.JSX.Element, ContextMenuMicIcon: React_2.JSX.Element, ContextMenuRemoveParticipant: React_2.JSX.Element, ContextMenuSpeakerIcon: React_2.JSX.Element, ContextualMenuMicMutedIcon: React_2.JSX.Element, ControlBarChatButtonActive?: JSX.Element, ControlBarChatButtonInactive?: JSX.Element, ControlBarPeopleButton?: JSX.Element, ControlButtonCameraOff: JSX.Element, ControlButtonCameraOn: JSX.Element, ControlButtonCameraProhibited: JSX.Element, ControlButtonCameraProhibitedSmall: JSX.Element, ControlButtonEndCall: JSX.Element, ControlButtonExitSpotlight?: JSX.Element, ControlButtonLowerHand: JSX.Element, ControlButtonMicOff: JSX.Element, ControlButtonMicOn: JSX.Element, ControlButtonMicProhibited: JSX.Element, ControlButtonMicProhibitedSmall: JSX.Element, ControlButtonOptions: JSX.Element, ControlButtonParticipants: JSX.Element, ControlButtonParticipantsContextualMenuItem: React_2.JSX.Element, ControlButtonRaiseHand: JSX.Element, ControlButtonScreenShareStart: JSX.Element, ControlButtonScreenShareStop: JSX.Element, ControlButtonVideoEffectsOption: React_2.JSX.Element, DefaultCustomButton?: JSX.Element, DefaultGalleryLayout?: JSX.Element, DialpadBackspace: React_2.JSX.Element, DialpadStartCall?: JSX.Element, DtmfDialpadButton?: JSX.Element, EditBoxCancel: JSX.Element, EditBoxSubmit: JSX.Element, ErrorBarCallCameraAccessDenied: JSX.Element, ErrorBarCallCameraAlreadyInUse: JSX.Element, ErrorBarCallLocalVideoFreeze: JSX.Element, ErrorBarCallMacOsCameraAccessDenied: JSX.Element, ErrorBarCallMacOsMicrophoneAccessDenied: JSX.Element, ErrorBarCallMicrophoneAccessDenied: JSX.Element, ErrorBarCallMicrophoneMutedBySystem: JSX.Element, ErrorBarCallMicrophoneUnmutedBySystem: JSX.Element, ErrorBarCallNetworkQualityLow: JSX.Element, ErrorBarCallNoMicrophoneFound: JSX.Element, ErrorBarCallNoSpeakerFound: JSX.Element, ErrorBarCallVideoRecoveredBySystem: React_2.JSX.Element, ErrorBarCallVideoStoppedBySystem: React_2.JSX.Element, ErrorBarClear: JSX.Element, ErrorBarMutedByRemoteParticipant: React_2.JSX.Element, ExpandIcon: React_2.JSX.Element, FloatingLocalVideoGalleryLayout?: JSX.Element, FocusedContentGalleryLayout?: JSX.Element, GalleryOptions?: JSX.Element, HoldCallButton: React_2.JSX.Element, HoldCallContextualMenuItem: React_2.JSX.Element, HorizontalGalleryLeftButton: JSX.Element, HorizontalGalleryRightButton: JSX.Element, IncomingCallNotificationAcceptIcon: React_2.JSX.Element, IncomingCallNotificationAcceptWithVideoIcon: React_2.JSX.Element, IncomingCallNotificationRejectIcon: React_2.JSX.Element, JoinByPhoneConferenceIdIcon?: JSX.Element, JoinByPhoneDialStepIcon?: JSX.Element, JoinByPhoneWaitToBeAdmittedIcon?: JSX.Element, LargeGalleryLayout?: JSX.Element, Link?: JSX.Element, LobbyScreenConnectingToCall?: JSX.Element, LobbyScreenWaitingToBeAdmitted?: JSX.Element, LocalCameraSwitch?: JSX.Element, LocalDeviceSettingsCamera?: JSX.Element, LocalDeviceSettingsMic?: JSX.Element, LocalDeviceSettingsSpeaker?: JSX.Element, LocalPreviewPlaceholder?: JSX.Element, LowerHandContextualMenuItem: JSX.Element, MessageDelivered: JSX.Element, MessageEdit: JSX.Element, MessageFailed: JSX.Element, MessageRemove: JSX.Element, MessageResend: React_2.JSX.Element, MessageSeen: JSX.Element, MessageSending: JSX.Element, MinimizeIcon: React_2.JSX.Element, MoreDrawerMicrophones?: JSX.Element, MoreDrawerPeople?: JSX.Element, MoreDrawerSelectedMicrophone?: JSX.Element, MoreDrawerSelectedSpeaker?: JSX.Element, MoreDrawerSpeakers?: JSX.Element, Muted?: JSX.Element, NetworkReconnectIcon?: JSX.Element, NoticePageAccessDeniedTeamsMeeting?: JSX.Element, NoticePageCallRejected?: JSX.Element, NoticePageCallTimeout?: JSX.Element, NoticePageInviteToRoomRemoved?: JSX.Element, NoticePageJoinCallFailedDueToNoNetwork?: JSX.Element, NoticePageLeftCall?: JSX.Element, NoticePageNotInvitedToRoom?: JSX.Element, NoticePageRemovedFromCall?: JSX.Element, NoticePageRoomNotFound?: JSX.Element, NoticePageRoomNotValid?: JSX.Element, NotificationBarBreakoutRoomChanged: React_2.JSX.Element, NotificationBarBreakoutRoomClosed: React_2.JSX.Element, NotificationBarBreakoutRoomClosingSoon: React_2.JSX.Element, NotificationBarBreakoutRoomJoined: React_2.JSX.Element, NotificationBarBreakoutRoomOpened: React_2.JSX.Element, NotificationBarBreakoutRoomPromptJoin: React_2.JSX.Element, NotificationBarRecording: React_2.JSX.Element, NotificationBarTogetherModeIcon: React_2.JSX.Element, NotificationBarTranscriptionError: React_2.JSX.Element, NotificationBarTranscriptionStartedByYou: React_2.JSX.Element, OpenAttachment: React_2.JSX.Element, OptionsCamera: JSX.Element, OptionsMic: JSX.Element, OptionsSpeaker: JSX.Element, OverflowGalleryTop?: JSX.Element, ParticipantItemMicOff: JSX.Element, ParticipantItemOptions: JSX.Element, ParticipantItemOptionsHovered: JSX.Element, ParticipantItemPinned: React_2.JSX.Element, ParticipantItemScreenShareStart: JSX.Element, ParticipantItemSpotlighted: React_2.JSX.Element, PeoplePaneAddPerson?: JSX.Element, PeoplePaneMoreButton?: JSX.Element, PeoplePaneOpenDialpad?: JSX.Element, PhoneNumberButton?: JSX.Element, PinParticipant: React_2.JSX.Element, RaiseHandContextualMenuItem: JSX.Element, ReactionButtonIcon: JSX.Element, ReactionContextualMenuItem?: JSX.Element, RealTimeTextIcon: React_2.JSX.Element, RemoveVideoBackgroundEffect?: JSX.Element, ResumeCall: React_2.JSX.Element, SendBoxAttachFile?: JSX.Element, SendBoxSend: JSX.Element, SendBoxSendHovered: JSX.Element, SpeakerGalleryLayout?: JSX.Element, SplitButtonPrimaryActionCameraOff: React_2.JSX.Element, SplitButtonPrimaryActionCameraOn: React_2.JSX.Element, SplitButtonPrimaryActionMicMuted: React_2.JSX.Element, SplitButtonPrimaryActionMicUnmuted: React_2.JSX.Element, StartSpotlightContextualMenuItem: React_2.JSX.Element, StopAllSpotlightMenuButton?: JSX.Element, StopSpotlightContextualMenuItem: React_2.JSX.Element, SurveyStarIcon: React_2.JSX.Element, SurveyStarIconFilled: React_2.JSX.Element, TogetherModeLayout?: JSX.Element, UnpinParticipant: React_2.JSX.Element, VerticalGalleryLeftButton: React_2.JSX.Element, VerticalGalleryRightButton: React_2.JSX.Element, VideoTileCameraOff: React_2.JSX.Element, VideoTileMicOff: JSX.Element, VideoTileMoreOptions: React_2.JSX.Element, VideoTilePinned: React_2.JSX.Element, VideoTileScaleFill: React_2.JSX.Element, VideoTileScaleFit: React_2.JSX.Element, VideoTileSpotlighted: React_2.JSX.Element }
Type
{ BlurVideoBackground?: JSX.Element, CaptionsIcon: React_2.JSX.Element, CaptionsOffIcon: React_2.JSX.Element, CaptionsSettingsIcon: React_2.JSX.Element, ChangeCaptionLanguageIcon: React_2.JSX.Element, ChangeSpokenLanguageIcon: React_2.JSX.Element, ChatMessageOptions: React_2.JSX.Element, ChevronLeft?: JSX.Element, ConfigurationScreenVideoEffectsButton: React_2.JSX.Element, ContextMenuCameraIcon: React_2.JSX.Element, ContextMenuMicIcon: React_2.JSX.Element, ContextMenuRemoveParticipant: React_2.JSX.Element, ContextMenuSpeakerIcon: React_2.JSX.Element, ContextualMenuMicMutedIcon: React_2.JSX.Element, ControlBarChatButtonActive?: JSX.Element, ControlBarChatButtonInactive?: JSX.Element, ControlBarPeopleButton?: JSX.Element, ControlButtonCameraOff: JSX.Element, ControlButtonCameraOn: JSX.Element, ControlButtonCameraProhibited: JSX.Element, ControlButtonCameraProhibitedSmall: JSX.Element, ControlButtonEndCall: JSX.Element, ControlButtonExitSpotlight?: JSX.Element, ControlButtonLowerHand: JSX.Element, ControlButtonMicOff: JSX.Element, ControlButtonMicOn: JSX.Element, ControlButtonMicProhibited: JSX.Element, ControlButtonMicProhibitedSmall: JSX.Element, ControlButtonOptions: JSX.Element, ControlButtonParticipants: JSX.Element, ControlButtonParticipantsContextualMenuItem: React_2.JSX.Element, ControlButtonRaiseHand: JSX.Element, ControlButtonScreenShareStart: JSX.Element, ControlButtonScreenShareStop: JSX.Element, ControlButtonVideoEffectsOption: React_2.JSX.Element, DefaultCustomButton?: JSX.Element, DefaultGalleryLayout?: JSX.Element, DialpadBackspace: React_2.JSX.Element, DialpadStartCall?: JSX.Element, DtmfDialpadButton?: JSX.Element, EditBoxCancel: JSX.Element, EditBoxSubmit: JSX.Element, ErrorBarCallCameraAccessDenied: JSX.Element, ErrorBarCallCameraAlreadyInUse: JSX.Element, ErrorBarCallLocalVideoFreeze: JSX.Element, ErrorBarCallMacOsCameraAccessDenied: JSX.Element, ErrorBarCallMacOsMicrophoneAccessDenied: JSX.Element, ErrorBarCallMicrophoneAccessDenied: JSX.Element, ErrorBarCallMicrophoneMutedBySystem: JSX.Element, ErrorBarCallMicrophoneUnmutedBySystem: JSX.Element, ErrorBarCallNetworkQualityLow: JSX.Element, ErrorBarCallNoMicrophoneFound: JSX.Element, ErrorBarCallNoSpeakerFound: JSX.Element, ErrorBarCallVideoRecoveredBySystem: React_2.JSX.Element, ErrorBarCallVideoStoppedBySystem: React_2.JSX.Element, ErrorBarClear: JSX.Element, ErrorBarMutedByRemoteParticipant: React_2.JSX.Element, ExpandIcon: React_2.JSX.Element, FloatingLocalVideoGalleryLayout?: JSX.Element, FocusedContentGalleryLayout?: JSX.Element, GalleryOptions?: JSX.Element, HoldCallButton: React_2.JSX.Element, HoldCallContextualMenuItem: React_2.JSX.Element, HorizontalGalleryLeftButton: JSX.Element, HorizontalGalleryRightButton: JSX.Element, IncomingCallNotificationAcceptIcon: React_2.JSX.Element, IncomingCallNotificationAcceptWithVideoIcon: React_2.JSX.Element, IncomingCallNotificationRejectIcon: React_2.JSX.Element, JoinByPhoneConferenceIdIcon?: JSX.Element, JoinByPhoneDialStepIcon?: JSX.Element, JoinByPhoneWaitToBeAdmittedIcon?: JSX.Element, LargeGalleryLayout?: JSX.Element, Link?: JSX.Element, LobbyScreenConnectingToCall?: JSX.Element, LobbyScreenWaitingToBeAdmitted?: JSX.Element, LocalCameraSwitch?: JSX.Element, LocalDeviceSettingsCamera?: JSX.Element, LocalDeviceSettingsMic?: JSX.Element, LocalDeviceSettingsSpeaker?: JSX.Element, LocalPreviewPlaceholder?: JSX.Element, LowerHandContextualMenuItem: JSX.Element, MessageDelivered: JSX.Element, MessageEdit: JSX.Element, MessageFailed: JSX.Element, MessageRemove: JSX.Element, MessageResend: React_2.JSX.Element, MessageSeen: JSX.Element, MessageSending: JSX.Element, MinimizeIcon: React_2.JSX.Element, MoreDrawerMicrophones?: JSX.Element, MoreDrawerPeople?: JSX.Element, MoreDrawerSelectedMicrophone?: JSX.Element, MoreDrawerSelectedSpeaker?: JSX.Element, MoreDrawerSpeakers?: JSX.Element, Muted?: JSX.Element, NetworkReconnectIcon?: JSX.Element, NoticePageAccessDeniedTeamsMeeting?: JSX.Element, NoticePageCallRejected?: JSX.Element, NoticePageCallTimeout?: JSX.Element, NoticePageInviteToRoomRemoved?: JSX.Element, NoticePageJoinCallFailedDueToNoNetwork?: JSX.Element, NoticePageLeftCall?: JSX.Element, NoticePageNotInvitedToRoom?: JSX.Element, NoticePageRemovedFromCall?: JSX.Element, NoticePageRoomNotFound?: JSX.Element, NoticePageRoomNotValid?: JSX.Element, NotificationBarBreakoutRoomChanged: React_2.JSX.Element, NotificationBarBreakoutRoomClosed: React_2.JSX.Element, NotificationBarBreakoutRoomClosingSoon: React_2.JSX.Element, NotificationBarBreakoutRoomJoined: React_2.JSX.Element, NotificationBarBreakoutRoomOpened: React_2.JSX.Element, NotificationBarBreakoutRoomPromptJoin: React_2.JSX.Element, NotificationBarRecording: React_2.JSX.Element, NotificationBarTogetherModeIcon: React_2.JSX.Element, NotificationBarTranscriptionError: React_2.JSX.Element, NotificationBarTranscriptionStartedByYou: React_2.JSX.Element, OpenAttachment: React_2.JSX.Element, OptionsCamera: JSX.Element, OptionsMic: JSX.Element, OptionsSpeaker: JSX.Element, OverflowGalleryTop?: JSX.Element, ParticipantItemMicOff: JSX.Element, ParticipantItemOptions: JSX.Element, ParticipantItemOptionsHovered: JSX.Element, ParticipantItemPinned: React_2.JSX.Element, ParticipantItemScreenShareStart: JSX.Element, ParticipantItemSpotlighted: React_2.JSX.Element, PeoplePaneAddPerson?: JSX.Element, PeoplePaneMoreButton?: JSX.Element, PeoplePaneOpenDialpad?: JSX.Element, PhoneNumberButton?: JSX.Element, PinParticipant: React_2.JSX.Element, RaiseHandContextualMenuItem: JSX.Element, ReactionButtonIcon: JSX.Element, ReactionContextualMenuItem?: JSX.Element, RealTimeTextIcon: React_2.JSX.Element, RemoveVideoBackgroundEffect?: JSX.Element, ResumeCall: React_2.JSX.Element, SendBoxAttachFile?: JSX.Element, SendBoxSend: JSX.Element, SendBoxSendHovered: JSX.Element, SpeakerGalleryLayout?: JSX.Element, SplitButtonPrimaryActionCameraOff: React_2.JSX.Element, SplitButtonPrimaryActionCameraOn: React_2.JSX.Element, SplitButtonPrimaryActionMicMuted: React_2.JSX.Element, SplitButtonPrimaryActionMicUnmuted: React_2.JSX.Element, StartSpotlightContextualMenuItem: React_2.JSX.Element, StopAllSpotlightMenuButton?: JSX.Element, StopSpotlightContextualMenuItem: React_2.JSX.Element, SurveyStarIcon: React_2.JSX.Element, SurveyStarIconFilled: React_2.JSX.Element, TogetherModeLayout?: JSX.Element, UnpinParticipant: React_2.JSX.Element, VerticalGalleryLeftButton: React_2.JSX.Element, VerticalGalleryRightButton: React_2.JSX.Element, VideoTileCameraOff: React_2.JSX.Element, VideoTileMicOff: JSX.Element, VideoTileMoreOptions: React_2.JSX.Element, VideoTilePinned: React_2.JSX.Element, VideoTileScaleFill: React_2.JSX.Element, VideoTileScaleFit: React_2.JSX.Element, VideoTileSpotlighted: React_2.JSX.Element }
DevicesButton
A button to open a menu that controls device options.
Can be used with ControlBar.
DevicesButton: (props: DevicesButtonProps) => JSX.Element
Type
(props: DevicesButtonProps) => JSX.Element
Dialpad
A component to allow users to enter phone number through clicking on dialpad/using keyboard It will return empty component for stable builds
Dialpad: (props: DialpadProps) => JSX.Element
Type
(props: DialpadProps) => JSX.Element
EndCallButton
A button to end an ongoing call.
Can be used with ControlBar.
EndCallButton: (props: EndCallButtonProps) => JSX.Element
Type
(props: EndCallButtonProps) => JSX.Element
ErrorBar
A component to show error messages on the UI. All strings that can be shown are accepted as the ErrorBarProps.strings so that they can be localized. Active errors are selected by ErrorBarProps.activeErrorMessages.
This component internally tracks dismissed by the user.
- Errors that have an associated timestamp: The error is shown on the UI again if it occurs after being dismissed.
- Errors that do not have a timestamp: The error is dismissed until it disappears from the props. If the error recurs, it is shown in the UI.
Uses <xref:%40fluentui%2Freact%23MessageBar> UI element.
ErrorBar: (props: ErrorBarProps) => JSX.Element
Type
(props: ErrorBarProps) => JSX.Element
FluentThemeProvider
Provider to apply a Fluent theme across this library's react components.
FluentThemeProvider: (props: FluentThemeProviderProps) => JSX.Element
Type
(props: FluentThemeProviderProps) => JSX.Element
Remarks
Components in this library are composed primarily from Fluent UI, controls, mixing v8 and v9 controls. This provider handles applying any theme provided to the underlying Fluent UI controls. *
GridLayout
A component to lay out audio / video participants tiles in a call.
GridLayout: (props: GridLayoutProps) => JSX.Element
Type
(props: GridLayoutProps) => JSX.Element
HoldButton
a button to hold or resume a ongoing call.
Can be used with ControlBar
HoldButton: (props: HoldButtonProps) => JSX.Element
Type
(props: HoldButtonProps) => JSX.Element
ImageOverlay
Component to render a fullscreen modal for a selected image.
ImageOverlay: (props: ImageOverlayProps) => JSX.Element
Type
(props: ImageOverlayProps) => JSX.Element
IncomingCallNotification
A Notification component that is to be used to represent incoming calls to the end user. Allows the user to accept or reject the incoming call.
IncomingCallNotification: (props: IncomingCallNotificationProps) => JSX.Element
Type
(props: IncomingCallNotificationProps) => JSX.Element
IncomingCallStack
Wrapper to manage multiple incoming calls
IncomingCallStack: (props: IncomingCallStackProps) => JSX.Element
Type
(props: IncomingCallStackProps) => JSX.Element
LocalizationProvider
Provider to provide localized strings for this library's react components.
LocalizationProvider: (props: LocalizationProviderProps) => JSX.Element
Type
(props: LocalizationProviderProps) => JSX.Element
Remarks
Components will be provided localized strings in English (US) by default if this provider is not used.
MessageStatusIndicator
Component to display the status of a sent message.
Adds an icon and tooltip corresponding to the message status.
MessageStatusIndicator: (props: MessageStatusIndicatorProps) => JSX.Element
Type
(props: MessageStatusIndicatorProps) => JSX.Element
MessageThread
MessageThread allows you to easily create a component for rendering chat messages, handling scrolling behavior of new/old messages and customizing icons & controls inside the chat thread.
MessageThread: (props: MessageThreadProps) => JSX.Element
Type
(props: MessageThreadProps) => JSX.Element
MicrophoneButton
A button to turn microphone on / off.
Can be used with ControlBar.
MicrophoneButton: (props: MicrophoneButtonProps) => JSX.Element
Type
(props: MicrophoneButtonProps) => JSX.Element
Notification
A component to show notification messages on the UI.
Notification: (props: NotificationProps) => JSX.Element
Type
(props: NotificationProps) => JSX.Element
NotificationStack
A component to show notifications on the UI. All strings that can be shown are accepted as the NotificationStackProps.strings so that they can be localized. Active notifications are selected by NotificationStackProps.activeNotifications.
This component internally tracks dismissed by the user.
- Notifications that have an associated timestamp: The notification is shown on the UI again if it occurs after being dismissed.
- Notifications that do not have a timestamp: The notification is dismissed until it disappears from the props. If the notification recurs, it is shown in the UI.
NotificationStack: (props: NotificationStackProps) => JSX.Element
Type
(props: NotificationStackProps) => JSX.Element
ParticipantItem
Component to render a calling or chat participant.
Displays the participant's avatar, displayName and status as well as optional icons and context menu.
ParticipantItem: (props: ParticipantItemProps) => JSX.Element
Type
(props: ParticipantItemProps) => JSX.Element
ParticipantList
Component to render all calling or chat participants.
By default, each participant is rendered with ParticipantItem. See ParticipantListProps.onRenderParticipant to override.
ParticipantList: (props: ParticipantListProps) => JSX.Element
Type
(props: ParticipantListProps) => JSX.Element
ParticipantsButton
A button to show a menu with calling or chat participants.
Can be used with ControlBar.
This button contains dropdown menu items defined through its property menuProps. By default, it can display the number of remote participants with the full list
as sub-menu and an option to mute all participants, as well as a copy-to-clipboard button to copy the call invitation URL.
This menuProps can be fully redefined and its property is of type IContextualMenuProps.
ParticipantsButton: (props: ParticipantsButtonProps) => JSX.Element
Type
(props: ParticipantsButtonProps) => JSX.Element
RaiseHandButton
A button to start / stop screen sharing.
Can be used with ControlBar.
RaiseHandButton: (props: RaiseHandButtonProps) => JSX.Element
Type
(props: RaiseHandButtonProps) => JSX.Element
ReactionButton
A button to send reactions.
Can be used with ControlBar.
ReactionButton: (props: ReactionButtonProps) => JSX.Element
Type
(props: ReactionButtonProps) => JSX.Element
RealTimeText
A component for displaying a single line of RealTimeText
RealTimeText: (props: RealTimeTextProps) => JSX.Element
Type
(props: RealTimeTextProps) => JSX.Element
RealTimeTextModal
a component for realTimeText modal
RealTimeTextModal: (props: RealTimeTextModalProps) => JSX.Element
Type
(props: RealTimeTextModalProps) => JSX.Element
ScreenShareButton
A button to start / stop screen sharing.
Can be used with ControlBar.
ScreenShareButton: (props: ScreenShareButtonProps) => JSX.Element
Type
(props: ScreenShareButtonProps) => JSX.Element
SendBox
Component for typing and sending messages.
Supports sending typing notification when user starts entering text. Supports an optional message below the text input field.
SendBox: (props: SendBoxProps) => JSX.Element
Type
(props: SendBoxProps) => JSX.Element
StartCaptionsButton
a button to start or stop captions
Can be used with ControlBar
StartCaptionsButton: (props: StartCaptionsButtonProps) => JSX.Element
Type
(props: StartCaptionsButtonProps) => JSX.Element
StartRealTimeTextButton
a button to start RealTimeText based on accessibility requirement, real time text cannot be turned off once it is on
Can be used with ControlBar
StartRealTimeTextButton: (props: StartRealTimeTextButtonProps) => JSX.Element
Type
(props: StartRealTimeTextButtonProps) => JSX.Element
StreamMedia
Utility component to convert an HTMLElement with a video stream into a JSX element.
Use to convert an HTMLElement returned by headless calling API into a component that can be rendered as a VideoTile.
StreamMedia: (props: StreamMediaProps) => JSX.Element
Type
(props: StreamMediaProps) => JSX.Element
TypingIndicator
Component to notify local user when one or more participants in the chat thread are typing.
TypingIndicator: (props: TypingIndicatorProps) => JSX.Element
Type
(props: TypingIndicatorProps) => JSX.Element
VideoGallery
VideoGallery represents a layout of video tiles for a specific call. It displays a VideoTile for the local user as well as for each remote participant who has joined the call.
VideoGallery: (props: VideoGalleryProps) => JSX.Element
Type
(props: VideoGalleryProps) => JSX.Element
VideoTile
A component to render the video stream for a single call participant.
Use with GridLayout in a VideoGallery.
VideoTile: (props: VideoTileProps) => JSX.Element
Type
(props: VideoTileProps) => JSX.Element
createAzureCommunicationCallWithChatAdapter
Create a CallWithChatAdapter backed by Azure Communication services to plug into the CallWithChatComposite.
createAzureCommunicationCallWithChatAdapter: ({ userId, displayName, credential, endpoint, locator, alternateCallerId, callAdapterOptions }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>
Type
({ userId, displayName, credential, endpoint, locator, alternateCallerId, callAdapterOptions }: AzureCommunicationCallWithChatAdapterArgs) => Promise<CallWithChatAdapter>
createAzureCommunicationCallWithChatAdapterFromClients
Create a CallWithChatAdapter using the provided StatefulChatClient and StatefulCallClient.
Useful if you want to keep a reference to StatefulChatClient and StatefulCallClient. Please note that chatThreadClient has to be created by StatefulChatClient via chatClient.getChatThreadClient(chatThreadId) API. Consider using createAzureCommunicationCallWithChatAdapter for a simpler API.
createAzureCommunicationCallWithChatAdapterFromClients: ({ callClient, callAgent, callLocator, chatClient, chatThreadClient, callAdapterOptions }: AzureCommunicationCallWithChatAdapterFromClientArgs) => Promise<CallWithChatAdapter>
Type
({ callClient, callAgent, callLocator, chatClient, chatThreadClient, callAdapterOptions }: AzureCommunicationCallWithChatAdapterFromClientArgs) => Promise<CallWithChatAdapter>
createAzureCommunicationChatAdapter
Create a ChatAdapter backed by Azure Communication Services.
This is the default implementation of ChatAdapter provided by this library.
createAzureCommunicationChatAdapter: ({ endpoint: endpointUrl, userId, displayName, credential, threadId, chatAdapterOptions }: AzureCommunicationChatAdapterArgs) => Promise<ChatAdapter>
Type
({ endpoint: endpointUrl, userId, displayName, credential, threadId, chatAdapterOptions }: AzureCommunicationChatAdapterArgs) => Promise<ChatAdapter>
createDefaultCallingHandlers
Create the default implementation of CallingHandlers for teams call.
Useful when implementing a custom component that utilizes the providers exported from this library.
createDefaultCallingHandlers: CreateDefaultCallingHandlers
Type
createDefaultChatHandlers
Create the default implementation of ChatHandlers.
Useful when implementing a custom component that utilizes the providers exported from this library.
Returned object is memoized to avoid rerenders when used as props for React Components.
createDefaultChatHandlers: (chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => ChatHandlers
Type
(chatClient: StatefulChatClient, chatThreadClient: ChatThreadClient) => ChatHandlers
createDefaultTeamsCallingHandlers
Create the default implementation of TeamsCallingHandlers for teams call.
Useful when implementing a custom component that utilizes the providers exported from this library.
createDefaultTeamsCallingHandlers: (callClient: StatefulCallClient, callAgent?: TeamsCallAgent, deviceManager?: StatefulDeviceManager, call?: TeamsCall, options?: { onResolveDeepNoiseSuppressionDependency?: () => Promise<DeepNoiseSuppressionEffectDependency>, onResolveVideoBackgroundEffectsDependency?: () => Promise<VideoBackgroundEffectsDependency> }) => TeamsCallingHandlers
Type
(callClient: StatefulCallClient, callAgent?: TeamsCallAgent, deviceManager?: StatefulDeviceManager, call?: TeamsCall, options?: { onResolveDeepNoiseSuppressionDependency?: () => Promise<DeepNoiseSuppressionEffectDependency>, onResolveVideoBackgroundEffectsDependency?: () => Promise<VideoBackgroundEffectsDependency> }) => TeamsCallingHandlers
createStatefulCallClient
Creates a StatefulCallClient StatefulCallClient by proxying CallClient <xref:%40azure%2Fcommunication-calling%23CallClient> with ProxyCallClient <xref:ProxyCallClient> which then allows access to state in a declarative way.
It is important to use the <xref:%40azure%2Fcommunication-calling%23DeviceManager> and <xref:%40azure%2Fcommunication-calling%23CallAgent> and <xref:%40azure%2Fcommunication-calling%23Call> (and etc.) that are obtained from the StatefulCallClient in order for their state changes to be proxied properly.
createStatefulCallClient: (args: StatefulCallClientArgs, options?: StatefulCallClientOptions) => StatefulCallClient
Type
(args: StatefulCallClientArgs, options?: StatefulCallClientOptions) => StatefulCallClient
createStatefulChatClient
Creates a stateful ChatClient StatefulChatClient by proxying ChatClient <xref:%40azure%2Fcommunication-chat%23ChatClient> with ProxyChatClient <xref:ProxyChatClient> which then allows access to state in a declarative way.
createStatefulChatClient: (args: StatefulChatClientArgs, options?: StatefulChatClientOptions) => StatefulChatClient
Type
(args: StatefulChatClientArgs, options?: StatefulChatClientOptions) => StatefulChatClient
createTeamsCallAdapter
createTeamsCallAdapter: (args: TeamsCallAdapterArgs) => Promise<TeamsCallAdapter>
Type
(args: TeamsCallAdapterArgs) => Promise<TeamsCallAdapter>
createTeamsCallAdapterFromClient
Create a TeamsCallAdapter using the provided StatefulCallClient.
Useful if you want to keep a reference to StatefulCallClient. Consider using createAzureCommunicationCallAdapter for a simpler API.
createTeamsCallAdapterFromClient: (callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator, options?: TeamsAdapterOptions) => Promise<TeamsCallAdapter>
Type
(callClient: StatefulCallClient, callAgent: TeamsCallAgent, locator: CallAdapterLocator, options?: TeamsAdapterOptions) => Promise<TeamsCallAdapter>
darkTheme
Preset dark theme for components exported from this library.
darkTheme: PartialTheme & CallingTheme
Type
PartialTheme & CallingTheme
fromFlatCommunicationIdentifier
Reverse operation of toFlatCommunicationIdentifier.
fromFlatCommunicationIdentifier: (id: string) => CommunicationIdentifier
Type
(id: string) => CommunicationIdentifier
getCallingSelector
Get the selector for a specified component.
Useful when implementing a custom component that utilizes the providers exported from this library.
getCallingSelector: (component: Component) => GetCallingSelector<Component>
Type
(component: Component) => GetCallingSelector<Component>
getChatSelector
Get the selector for a specified component.
Useful when implementing a custom component that utilizes the providers exported from this library.
getChatSelector: (component: Component) => GetChatSelector<Component>
Type
(component: Component) => GetChatSelector<Component>
lightTheme
Preset light theme for components exported from this library.
lightTheme: PartialTheme & CallingTheme
Type
PartialTheme & CallingTheme
loadCallComposite
Loader function for the CallComposite that you can use in your application. This function will load the CallComposite into the provided HTML element. The best use case for this is in a Node ui framework that is not React based.
loadCallComposite: (loaderArgs: CallCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallAdapter | undefined>
Type
(loaderArgs: CallCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallAdapter | undefined>
loadCallWithChatComposite
Props for the CallWithChatComposite that you can use in your application. This function will load the CallWithChatComposite into the provided HTML element. The best use case for this is in a Node UI framework that is not React based.
loadCallWithChatComposite: (loaderArgs: CallWithChatCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallWithChatAdapter | undefined>
Type
(loaderArgs: CallWithChatCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallWithChatAdapter | undefined>
loadChatComposite
Loader function for the ChatComposite that you can use in your application. This function will load the ChatComposite into the provided HTML element. The best use case for this is in a Node UI framework that is not React based.
loadChatComposite: (loaderArgs: ChatCompositeLoaderProps, htmlElement: HTMLElement) => Promise<ChatAdapter | undefined>
Type
(loaderArgs: ChatCompositeLoaderProps, htmlElement: HTMLElement) => Promise<ChatAdapter | undefined>
loadOutboundCallComposite
Loader function for the OutboundCallComposite that you can use in your application. This function will load the CallComposite into the provided HTML element to make outbound calls. The best use case for this is in a Node UI framework that is not React based.
loadOutboundCallComposite: (loaderArgs: OutboundCallCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallAdapter | undefined>
Type
(loaderArgs: OutboundCallCompositeLoaderProps, htmlElement: HTMLElement) => Promise<CallAdapter | undefined>
onResolveDeepNoiseSuppressionDependency
Dependency resolution for video background effects using lazy loading.
onResolveDeepNoiseSuppressionDependency: () => Promise<DeepNoiseSuppressionEffectDependency>
Type
() => Promise<DeepNoiseSuppressionEffectDependency>
onResolveDeepNoiseSuppressionDependencyLazy
Dependency resolution for video background effects using lazy loading.
onResolveDeepNoiseSuppressionDependencyLazy: () => Promise<DeepNoiseSuppressionEffectDependency>
Type
() => Promise<DeepNoiseSuppressionEffectDependency>
onResolveVideoEffectDependency
Dependency resolution for video background effects.
onResolveVideoEffectDependency: () => Promise<VideoBackgroundEffectsDependency>
Type
() => Promise<VideoBackgroundEffectsDependency>
onResolveVideoEffectDependencyLazy
Dependency resolution for video background effects using lazy loading.
onResolveVideoEffectDependencyLazy: () => Promise<VideoBackgroundEffectsDependency>
Type
() => Promise<VideoBackgroundEffectsDependency>
toFlatCommunicationIdentifier
A string representation of a <xref:%40azure%2Fcommunication-common%23CommunicationIdentifier>.
This string representation of CommunicationIdentifier is guaranteed to be stable for a unique Communication user. Thus,
- it can be used to persist a user's identity in external databases.
- it can be used as keys into a Map to store data for the user.
toFlatCommunicationIdentifier: (identifier: CommunicationIdentifier) => string
Type
(identifier: CommunicationIdentifier) => string
useAzureCommunicationCallAdapter
A custom React hook to simplify the creation of CallAdapter.
Similar to createAzureCommunicationCallAdapter, but takes care of asynchronous creation of the adapter internally.
Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined.
Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples.
useAzureCommunicationCallAdapter: (args: Partial<AzureCommunicationCallAdapterArgs | AzureCommunicationOutboundCallAdapterArgs>, afterCreate?: (adapter: CallAdapter) => Promise<CallAdapter>, beforeDispose?: (adapter: CallAdapter) => Promise<void>) => CallAdapter | undefined
Type
(args: Partial<AzureCommunicationCallAdapterArgs | AzureCommunicationOutboundCallAdapterArgs>, afterCreate?: (adapter: CallAdapter) => Promise<CallAdapter>, beforeDispose?: (adapter: CallAdapter) => Promise<void>) => CallAdapter | undefined
useAzureCommunicationCallWithChatAdapter
A custom React hook to simplify the creation of CallWithChatAdapter.
Similar to createAzureCommunicationCallWithChatAdapter, but takes care of asynchronous creation of the adapter internally.
Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined.
Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples.
useAzureCommunicationCallWithChatAdapter: (args: Partial<AzureCommunicationCallWithChatAdapterArgs>, afterCreate?: (adapter: CallWithChatAdapter) => Promise<CallWithChatAdapter>, beforeDispose?: (adapter: CallWithChatAdapter) => Promise<void>) => CallWithChatAdapter | undefined
Type
(args: Partial<AzureCommunicationCallWithChatAdapterArgs>, afterCreate?: (adapter: CallWithChatAdapter) => Promise<CallWithChatAdapter>, beforeDispose?: (adapter: CallWithChatAdapter) => Promise<void>) => CallWithChatAdapter | undefined
useAzureCommunicationChatAdapter
A custom React hook to simplify the creation of ChatAdapter.
Similar to createAzureCommunicationChatAdapter, but takes care of asynchronous creation of the adapter internally.
Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined.
Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples.
useAzureCommunicationChatAdapter: (args: Partial<AzureCommunicationChatAdapterArgs>, afterCreate?: (adapter: ChatAdapter) => Promise<ChatAdapter>, beforeDispose?: (adapter: ChatAdapter) => Promise<void>) => ChatAdapter | undefined
Type
(args: Partial<AzureCommunicationChatAdapterArgs>, afterCreate?: (adapter: ChatAdapter) => Promise<ChatAdapter>, beforeDispose?: (adapter: ChatAdapter) => Promise<void>) => ChatAdapter | undefined
useCall
Hook to obtain <xref:%40azure%2Fcommunication-calling%23Call> from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
you must have previously used the CallProvider with a Call object to use this hook
useCall: () => Call | undefined
Type
() => Call | undefined
useCallAgent
Hook to obtain <xref:%40azure%2Fcommunication-calling%23CallAgent> from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useCallAgent: () => CallAgent | undefined
Type
() => CallAgent | undefined
useCallClient
Hook to obtain StatefulCallClient from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useCallClient: () => StatefulCallClient
Type
() => StatefulCallClient
useChatClient
Hook to obtain StatefulChatClient from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useChatClient: () => StatefulChatClient
Type
() => StatefulChatClient
useChatThreadClient
Hook to obtain <xref:%40azure%2Fcommunication-chat%23ChatThreadClient> from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useChatThreadClient: () => ChatThreadClient
Type
() => ChatThreadClient
useDeviceManager
Hook to obtain StatefulDeviceManager from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useDeviceManager: () => StatefulDeviceManager | undefined
Type
() => StatefulDeviceManager | undefined
usePropsFor
Primary hook to get all hooks necessary for a React Component from this library.
To call this hook, the component requires to be wrapped under these providers:
For chat components: ChatClientProvider and ChatThreadClientProvider.
For calling components: CallClientProvider, CallAgentProvider and CallAgentProvider.
Most straightforward usage of a components looks like:
Example
import { ParticipantList, usePropsFor } from '@azure/communication-react';
const App = (): JSX.Element => {
// ... code to setup Providers ...
return <ParticipantList {...usePropsFor(ParticipantList)}/>
}
usePropsFor: (component: Component, type?: "calling" | "chat") => ComponentProps<Component>
Type
(component: Component, type?: "calling" | "chat") => ComponentProps<Component>
useSelector
Hook to obtain a selector for a specified component.
Useful when implementing a custom component that utilizes the providers exported from this library.
useSelector: (selector: ParamT, selectorProps?: (ParamT extends Selector ? Parameters<ParamT>[1] : undefined), type?: "calling" | "chat") => (ParamT extends Selector ? ReturnType<ParamT> : undefined)
Type
(selector: ParamT, selectorProps?: (ParamT extends Selector ? Parameters<ParamT>[1] : undefined), type?: "calling" | "chat") => (ParamT extends Selector ? ReturnType<ParamT> : undefined)
useTeamsCall
Hook to obtain <xref:%40azure%2Fcommunication-calling%23TeamsCall> from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
you must have previously used the CallProvider with a TeamsCall object to use this hook
useTeamsCall: () => undefined | TeamsCall
Type
() => undefined | TeamsCall
useTeamsCallAdapter
A custom React hook to simplify the creation of TeamsCallAdapter.
Similar to <xref:createTeamsAzureCommunicationCallAdapter>, but takes care of asynchronous creation of the adapter internally.
Allows arguments to be undefined so that you can respect the rule-of-hooks and pass in arguments as they are created. The adapter is only created when all arguments are defined.
Note that you must memoize the arguments to avoid recreating adapter on each render. See storybook for typical usage examples.
useTeamsCallAdapter: (args: Partial<TeamsCallAdapterArgs>, afterCreate?: (adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>, beforeDispose?: (adapter: TeamsCallAdapter) => Promise<void>) => TeamsCallAdapter | undefined
Type
(args: Partial<TeamsCallAdapterArgs>, afterCreate?: (adapter: TeamsCallAdapter) => Promise<TeamsCallAdapter>, beforeDispose?: (adapter: TeamsCallAdapter) => Promise<void>) => TeamsCallAdapter | undefined
useTeamsCallAgent
Hook to obtain <xref:%40azure%2Fcommunication-calling%23TeamsCallAgent> from the provider.
Useful when implementing a custom component that utilizes the providers exported from this library.
useTeamsCallAgent: () => undefined | TeamsCallAgent
Type
() => undefined | TeamsCallAgent
useTheme
React hook to access theme
useTheme: () => Theme
Type
() => Theme