Azure Communication UI Mobile Library is an Azure Communication Services capability focused on providing UI components for common business-to-consumer and business-to-business calling interactions.
Get started with Azure Communication Services by using the UI Library to integrate communication experiences into your applications. For detailed instructions to quickly integrate the UI Library functionalities visit the Quick-start Documentation.
- An Azure account with an active subscription. Create an account for free.
- An OS running Android Studio.
- A deployed Communication Services resource. Create a Communication Services resource.
- Azure Communication Services Token. See example
In your app level (app folder) build.gradle
, add the following lines to the dependencies and android sections.
android {
...
packagingOptions {
pickFirst 'META-INF/*'
}
...
}
dependencies {
...
implementation 'com.azure.android:azure-communication-ui:+'
...
}
In your project gradle scripts add following lines to repositories
. For Android Studio (2020.*)
the repositories
are in settings.gradle
dependencyResolutionManagement(Gradle version 6.8 or greater)
. If you are using old versions of Android Studio (4.*)
then the repositories
will be in project level build.gradle
allprojects{}
.
repositories {
...
mavenCentral()
maven {
url "https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1"
}
...
}
Sync project with gradle files. (Android Studio -> File -> Sync Project With Gradle Files)
Create CallComposite
and launch it. Replace <GROUP_CALL_ID>
with your group ID for your call, <DISPLAY_NAME>
with your name, and <USER_ACCESS_TOKEN>
with your token.
val communicationTokenRefreshOptions = CommunicationTokenRefreshOptions({ "<USER_ACCESS_TOKEN>" }, true)
val communicationTokenCredential = CommunicationTokenCredential(communicationTokenRefreshOptions)
val options = GroupCallOptions(
communicationTokenCredential,
UUID.fromString("<GROUP_CALL_ID>"),
"<DISPLAY_NAME>",
)
val callComposite: CallComposite = CallCompositeBuilder().build()
callComposite.launch(context, options)
CommunicationTokenRefreshOptions communicationTokenRefreshOptions =
new CommunicationTokenRefreshOptions(() -> "<USER_ACCESS_TOKEN>", true);
CommunicationTokenCredential communicationTokenCredential =
new CommunicationTokenCredential(communicationTokenRefreshOptions);
GroupCallOptions options = new GroupCallOptions(
communicationTokenCredential,
UUID.fromString("<GROUP_CALL_ID>"),
"<DISPLAY_NAME>"
);
CallComposite callComposite = new CallCompositeBuilder().build();
callComposite.launch(context, options);
For more details on Mobile UI Library functionalities visit the API Reference Documentation.
Before developing and contributing to Communication Mobile UI Library, check out our making a contribution guide.
Included in this repository is a demo of using Mobile UI Library to start a call. You can find the detail of using and developing the UI Library in the Demo Guide.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments. Also, please check our Contribution Policy.
If you find a bug or have a feature request, please raise the issue on GitHub Issues.
Please refer to the wiki for known issues related to the library.