Edit

Calling capabilities supported for Teams users in Calling SDK

  • Article
  • 5 minutes to read

The Azure Communication Services Calling SDK for JavaScript enables Teams user devices to drive voice and video communication experiences. This page provides detailed descriptions of Calling features, including platform and browser support information. To get started right away, check out Calling quickstarts.

Key features of the Calling SDK:

  • Addressing - Azure Communication Services is using Azure Active Directory user identifier to address communication endpoints. Clients use Azure Active Directory identities to authenticate to the service and communicate with each other. These identities are used in Calling APIs that provide clients visibility into who is connected to a call (the roster). And are also used in Microsoft Graph API.
  • Encryption - The Calling SDK encrypts traffic and prevents tampering on the wire.
  • Device Management and Media - The Calling SDK provides facilities for binding to audio and video devices, encodes content for efficient transmission over the communications data plane, and renders content to output devices and views that you specify. APIs are also provided for screen and application sharing.
  • Notifications - The Calling SDK provides APIs that allow clients to be notified of an incoming call. In situations where your app is not running in the foreground, patterns are available to fire pop-up notifications ("toasts") to inform users of an incoming call.

Calling capabilities

The following list presents the set of features that are currently available in the Azure Communication Services Calling SDK for JavaScript when participating in 1:1 voice-over-IP (VoIP) or group VoIP calls.

Group of features Capability JavaScript
Core Capabilities Place a one-to-one call to Teams user ✔️
Place a one-to-one call to Azure Communication Services user ❌
Place a group call with more than two Teams users (up to 350 users) ✔️
Promote a one-to-one call with two Teams users into a group call with more than two Teams users ✔️
Join a group call after it has started ❌
Invite another VoIP participant to join an ongoing group call ✔️
Test your mic, speaker, and camera with an audio testing service (available by calling 8:echo123) ✔️
Placing a call honors Teams external access configuration ✔️
Placing a call honors Teams guest access configuration ✔️
Mid call control Turn your video on/off ✔️
Mute/Unmute mic ✔️
Switch between cameras ✔️
Local hold/un-hold ✔️
Indicator of dominant speakers in the call ✔️
Choose speaker device for calls ✔️
Choose microphone for calls ✔️
Indicator of participant's state
Idle, Early media, Connecting, Connected, On hold, In Lobby, Disconnected		 ✔️
Indicator of call's state
Early Media, Incoming, Connecting, Ringing, Connected, Hold, Disconnecting, Disconnected		 ✔️
Indicate participants being muted ✔️
Indicate participants' reasons for terminating the call ✔️
Screen sharing Share the entire screen from within the application ✔️
Share a specific application (from the list of running applications) ✔️
Share a web browser tab from the list of open tabs ✔️
Share content in "content-only" mode ✔️
Receive video stream with content for "content-only" screen sharing experience ✔️
Share content in "standout" mode ❌
Receive video stream with content for a "standout" screen sharing experience ❌
Share content in "side-by-side" mode ❌
Receive video stream with content for "side-by-side" screen sharing experience ❌
Share content in "reporter" mode ❌
Receive video stream with content for "reporter" screen sharing experience ❌
Roster List participants ✔️
Add an Azure Communication Services user ❌
Add a Teams user ✔️
Adding Teams users honors Teams external access configuration ✔️
Adding Teams user honors Teams guest access configuration ✔️
Add a phone number ✔️
Remove a participant ✔️
Adding Teams users honors information barriers ✔️
Device Management Ask for permission to use audio and/or video ✔️
Get camera list ✔️
Set camera ✔️
Get selected camera ✔️
Get microphone list ✔️
Set microphone ✔️
Get selected microphone ✔️
Get speakers list ✔️
Set speaker ✔️
Get selected speaker ✔️
Video Rendering Render single video in many places (local camera or remote stream) ✔️
Set / update scaling mode ✔️
Render remote video stream ✔️
See together mode video stream ❌
See Large gallery view ❌
Receive video stream from Teams media bot ❌
Receive adjusted stream for "content from Camera" ❌
Add and remove video stream from spotlight ❌
Allow video stream to be selected for spotlight ❌
Apply Teams background effects ❌
Recording & transcription Manage Teams convenient recording ❌
Receive information of call being recorded ✔️
Manage Teams transcription ❌
Receive information of call being transcribed ✔️
Manage Teams closed captions ❌
Support for compliance recording ✔️
Engagement Raise and lower hand ❌
Indicate other participants' raised and lowered hands ❌
Trigger reactions ❌
Indicate other participants' reactions ❌
Integrations Control Teams third-party applications ❌
Receive PowerPoint Live stream ❌
Receive Whiteboard stream ❌
Interact with a poll ❌
Interact with a Q&A ❌
Accessibility Receive closed captions ❌
Advanced call routing Start a call and add user operations honor forwarding rules ✔️
Read and configure call forwarding rules ❌
Start a call and add user operations honor simultaneous ringing ✔️
Read and configure simultaneous ringing ❌
Start a call and add user operations honor "Do not disturb" status ✔️
Placing participant on hold plays music on hold ❌
Being placed by Teams user on Teams client on hold plays music on hold ✔️
Park a call ❌
Be parked ✔️
Transfer a call to a user ✔️
Be transferred to a user or call ✔️
Transfer a call to a call ✔️
Transfer a call to Voicemail ❌
Be transferred to voicemail ✔️
Merge ongoing calls ❌
Does start a call and add user operations honor shared line configuration ✔️
Start a call on behalf of the Teams user ❌
Read and configure shared line configuration ❌
Receive a call from Teams auto attendant ✔️
Transfer a call to Teams auto attendant ✔️
Receive a call from Teams call queue ✔️
Transfer a call from Teams call queue ✔️
Teams calling policy Honor "Make private calls" ✔️
Honor setting "Cloud recording for calling" No API available
Honor setting "Transcription" No API available
Honor setting "Call forwarding and simultaneous ringing to people in your organization" ✔️
Honor setting "Call forwarding and simultaneous ringing to external phone numbers" ✔️
Honor setting "Voicemail is available for routing inbound calls" ✔️
Honor setting "Inbound calls can be routed to call groups" ✔️
Honor setting "Delegation for inbound and outbound calls" ✔️
Honor setting "Prevent toll bypass and send calls through the PSTN" ❌
Honor setting "Music on hold" ❌
Honor setting "Busy on busy when in a call" ❌
Honor setting "Web PSTN calling" ❌
Honor setting "Real-time captions in Teams calls" No API available
Honor setting "Automatically answer incoming meeting invites" ❌
Honor setting "Spam filtering" ✔️
Honor setting "SIP devices can be used for calls" ✔️
DevOps Azure Metrics ✔️
Azure Monitor ✔️
Azure Communication Services Insights ✔️
Azure Communication Services Voice and video calling events ❌
Teams Call Analytics ✔️
Teams real-time Analytics ❌

Support for streaming, timeouts, platforms, and browsers is shared with Communication Services calling SDK overview.

Next steps

Get started with calling

For more information, see the following articles: