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.

Additional documentation for this sample can be found on Microsoft Docs. See this sample's wiki to see updated information on known issues

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.

Features

  • 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

Homepage

Prerequisites

Before running the sample for the first time

  1. Run pod install on the root of the project directory. This generates AzureCalling.xcworkspace
  2. Open AzureCalling.xcworkspace in XCode.
  3. Update AppSettings.plist. Set the value for the communicationTokenFetchUrl key to be the URL for your Authentication Endpoint.

Run Sample

  1. 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:

  1. Enable Azure Active Directory authentication in your app.
  2. 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 Azure Active Directory Configuration
  3. Open AppSettings.plist in 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: msauth.<app_bundle_id>://auth
    • aadScopes: an array of permission scopes requested from users for authorization. Add <Application ID URI>/user_impersonation to the array to grant access to authentication endpoint

Additional Reading

Known Issues

Please refer to the wiki for known issues related to this sample.