Group Calling Sample
The sample is a native iOS application that uses the Azure Communication Services iOS client libraries to build a calling experience that features both voice and video calling. The application uses a server-side component to provision access tokens that are then used to initialize the Azure Communication Services client library. To configure this server-side component, feel free to follow the Trusted Service with Azure Functions tutorial.
A separate version of the Calling Sample is available with Teams Interop support (Teams Interop Sample). Teams Interop is currently in Public Preview. Please use the main branch sample for any production scenarios.
- Start a new group call
- Join an existing group call
- Render remote participant video streams
- Turning local video stream from camera on/off
- Mute/unmute local microphone audio
- An Azure account with an active subscription. Create an account for free.
- A Mac running Xcode, along with a valid developer certificate installed into your Keychain. CocoaPods must also be installed to fetch dependencies.
- A deployed Communication Services resource. Create a Communication Services resource.
- An Authentication Endpoint that will return the Azure Communication Services Token. See example or clone the code.
Before running the sample for the first time
pod installon the root of the project directory. This generates
AppSettings.plist. Set the value for the
communicationTokenFetchUrlkey to be the URL for your Authentication Endpoint.
- Build/Run in XCode
Securing Authentication Endpoint
For simple demonstration purposes, this sample uses a publicly accessible endpoint by default to fetch an Azure Communication Services access token. For production scenarios, it is recommended that the Azure Communication Services access token is returned from a secured endpoint.
With additional configuration, this sample also supports connecting to an Azure Active Directory (AAD) protected endpoint so that user login is required for the app to fetch an Azure Communication Services access token. See steps below:
- Enable Azure Active Directory authentication in your app.
- Go to your registered app overview page under Azure Active Directory App Registrations. Take note of the
Application (client) ID,
Directory (tenant) ID,
Application ID URI
AppSettings.plistin Xcode, add the following key values:
communicationTokenFetchUrl: the URL to request Azure Communication Services token
isAADAuthEnabled: a boolean value to indicate if the Azure Communication Services token authentication is required or not
aadClientId: your Application (client) ID
aadTenantId: your Directory (tenant) ID
aadRedirectURI: the redirect URI should be in this format:
aadScopes: an array of permission scopes requested from users for authorization. Add
<Application ID URI>/user_impersonationto the array to grant access to authentication endpoint
- Azure Communication Calling Features - To learn more about the calling iOS sdk -Azure Communication iOS Calling SDK
Please refer to the wiki for known issues related to this sample.