Code Monkey home page Code Monkey logo

communication-services-ios-calling-hero's Introduction

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

Features

  • Start a new group call
  • Join an existing group call
  • Join an existing Teams Meeting (For instructions: Teams Tenant Interoperability)
  • 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.

communication-services-ios-calling-hero's People

Contributors

amyl219 avatar microsoft-github-operations[bot] avatar microsoftopensource avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.