Skip to content

Commit e02ada9

Browse files
authored
Merge pull request #176467 from jorgegarchirota/palatter/bug-bash-changes
Palatter/bug bash changes
2 parents 0db6f0f + f4e4bca commit e02ada9

File tree

2 files changed

+33
-28
lines changed
  • articles/communication-services/quickstarts/ui-library/includes/get-started-call

2 files changed

+33
-28
lines changed

articles/communication-services/quickstarts/ui-library/includes/get-started-call/android.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,9 @@ The following classes and interfaces handle some of the major features of the Az
230230
| [TeamsMeetingOptions](#teams-meeting) | Passed to CallComposite launch to join Teams meeting meeting. |
231231
| [ThemeConfiguration](#apply-theme-configuration) | Injected as optional in CallCompositeBuilder to change primary color of composite. |
232232

233-
## Create Call Composite
233+
## UI Library functionality
234+
235+
### Create Call Composite
234236

235237
Initialize a `CallCompositeBuilder` instance and a `CallComposite` instance inside the `startCallComposite` function.
236238

@@ -246,7 +248,7 @@ CallComposite callComposite = new CallCompositeBuilder().build();
246248
```
247249

248250
-----
249-
### Create `CommunicationTokenCredential`
251+
### Setup authentication
250252

251253
Initialize a `CommunicationTokenCredential` instance inside the `startCallComposite` function. Replace `"<USER_ACCESS_TOKEN>"` with your token.
252254

@@ -275,7 +277,7 @@ CommunicationTokenCredential communicationTokenCredential = new CommunicationTok
275277
Refer to the [user access token](../../../identity/quick-create-identity.md) documentation if you don't already have a token available.
276278

277279
-----
278-
## Setup Group Call or Teams Meeting Options
280+
### Setup Group Call or Teams Meeting Options
279281

280282
Depending on what type of Call/Meeting you would like to setup, use the appropriate options object.
281283

@@ -341,12 +343,12 @@ TeamsMeetingOptions options = new TeamsMeetingOptions(
341343
-----
342344
### Get a Microsoft Teams meeting link
343345

344-
A Microsoft Teams meeting link can be retrieved using Graph APIs. This process is detailed in [Graph documentation](/graph/api/onlinemeeting-createorget?tabs=http&view=graph-rest-beta&preserve-view=true).
346+
A Microsoft Teams meeting link can be retrieved using Graph APIs. This process is detailed in [Graph documentation](https://docs.microsoft.com/graph/api/onlinemeeting-createorget?tabs=http&view=graph-rest-beta&preserve-view=true).
345347

346348
The Communication Services Call SDK accepts a full Microsoft Teams meeting link. This link is returned as part of the `onlineMeeting` resource, accessible under the [`joinWebUrl` property](https://docs.microsoft.com/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true)
347349
You can also get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
348350

349-
## Launch
351+
### Launch
350352

351353
Call `launch` on the `CallComposite` instance inside the `startCallComposite` function
352354

@@ -364,7 +366,7 @@ callComposite.launch(options);
364366

365367
-----
366368

367-
## Subscribe on events from `CallComposite`
369+
### Subscribe to events from `CallComposite`
368370

369371
To receive events, inject a handler to the `CallCompositeBuilder`.
370372

@@ -404,7 +406,7 @@ class ApplicationCallCompositeEventsHandler implements CallCompositeEventsHandle
404406

405407
-----
406408

407-
## Apply theme configuration
409+
### Apply theme configuration
408410

409411
To change the primary color of composite, create a new theme style in `src/main/res/values/themes.xml` and `src/main/res/values-night/themes.xml` by considering `AzureCommunicationUI.Theme.Calling` as parent theme. To apply theme, inject the theme ID in `CallCompositeBuilder`.
410412

@@ -430,4 +432,4 @@ CallComposite callComposite =
430432
new CallCompositeBuilder()
431433
.theme(new ThemeConfiguration(R.style.MyCompany_CallComposite))
432434
.build();
433-
```
435+
```

articles/communication-services/quickstarts/ui-library/includes/get-started-call/ios.md

Lines changed: 23 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -23,29 +23,30 @@ In Xcode, create a new iOS project and select the **App** template. We will be u
2323

2424
![Screenshot showing the New Project template selection within Xcode.](../../media/xcode-new-project-template-select.png)
2525

26-
Name the project `UILibraryQuickStart`.
26+
Name the project `UILibraryQuickStart` and select `Storyboard` under the `Interface` dropdown.
2727

2828
![Screenshot showing the New Project details within Xcode.](../../media/xcode-new-project-details.png)
2929

3030
### Install the package and dependencies with CocoaPods
3131

32-
1. Create a Podfile for your application:
32+
1. Create a Podfile in your project root directory by running `pod init`.
33+
1.
34+
1. Add the following to your Podfile:
3335

3436
```
35-
source 'https://github.com/Azure/AzurePrivatePodspecs'
37+
source 'https://github.com/CocoaPods/Specs.git'
38+
source 'https://github.com/Azure/AzurePrivatePodspecs.git'
3639
3740
platform :ios, '13.0'
3841
3942
target 'UILibraryQuickStart' do
4043
use_frameworks!
41-
pod 'azure-communication-ui', '1.0.0-alpha.1'
42-
pod 'AzureCommunicationCalling', '2.0.1-beta.1'
43-
pod 'MicrosoftFluentUI', '0.3.3'
44+
pod 'AzureCommunicationUI', '1.0.0-alpha.1'
4445
end
4546
```
4647

47-
2. Run `pod install`.
48-
3. Open the generated `.xcworkspace` with Xcode.
48+
3. Run `pod install --repo-update`. (This process may take 10-15 min.)
49+
4. Open the generated `.xcworkspace` with Xcode.
4950

5051
### Request access to the microphone, camera, etc.
5152

@@ -67,7 +68,7 @@ Set `Enable Bitcode` option to `No` in the project `Build Settings`. To find the
6768

6869
## Initialize composite
6970

70-
Go to 'ViewController'. Here we'll drop the following code to initialize our Composite Components for Call. Replace `<GROUP_CALL_ID>` with your group ID for your call, `<DISPLAY_NAME>` with your name, and `<USER_ACCESS_TOKEN>` with your token.
71+
Go to 'ViewController'. Here we'll drop the following code to initialize our Composite Components for Call. Replace `<GROUP_CALL_ID>` with either your call group ID or `UUID()` to generate one. Also replace `<DISPLAY_NAME>` with your name, and `<USER_ACCESS_TOKEN>` with your token.
7172

7273
```swift
7374
import UIKit
@@ -102,8 +103,8 @@ class ViewController: UIViewController {
102103
let communicationTokenCredential = try! CommunicationTokenCredential(token: "<USER_ACCESS_TOKEN>")
103104

104105
let options = GroupCallOptions(communicationTokenCredential: communicationTokenCredential,
105-
displayName: displayName,
106-
groupId: uuid)
106+
displayName: "<DISPLAY_NAME>",
107+
groupId: "<GROUP_CALL_ID>")
107108
callComposite?.launch(with: options)
108109
}
109110
}
@@ -119,22 +120,24 @@ You can build and run your app on iOS simulator by selecting **Product** > **Run
119120

120121
![Final look and feel of the quick start app](../../media/quick-start-calling-composite-running-ios.gif)
121122

123+
## Sample application code can be found [here](https://github.com/Azure-Samples/communication-services-ios-quickstarts/tree/ui-library-quickstart)
124+
122125
## Object Model
123126

124127
The following classes and interfaces handle some of the major features of the Azure Communication Services UI client library:
125128

126129
| Name | Description |
127130
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
128-
| CallComposite | The composite renders a call experience with participant gallery and controls. |
129-
| CallCompositeOptions | Includes options such as the theme configuration and the events handler. |
130-
| CallCompositeEventsHandler | Allows you to receive events from composite. |
131-
| GroupCallOptions | The options for joining a group call, such as groupId. |
132-
| TeamsMeetingOptions | The options for joining a Team's meeting, such as the meeting link. |
133-
| ThemeConfiguration | Allows you to customize the theme. |
131+
| [CallComposite](#create-call-composite) | The composite renders a call experience with participant gallery and controls. |
132+
| [CallCompositeOptions](#create-call-composite) | Includes options such as the theme configuration and the events handler. |
133+
| [CallCompositeEventsHandler](#subscribe-to-events-from-callcomposite) | Allows you to receive events from composite. |
134+
| [GroupCallOptions](#group-call) | The options for joining a group call, such as groupId. |
135+
| [TeamsMeetingOptions](#teams-meeting) | The options for joining a Team's meeting, such as the meeting link. |
136+
| [ThemeConfiguration](#apply-theme-configuration) | Allows you to customize the theme. |
134137

135138
## UI Library functionality
136139

137-
### Create call composite options and call composite
140+
### Create call composite
138141

139142
Initialize a `CallCompositeOptions` instance and a `CallComposite` instance inside the `startCallComposite` function.
140143

@@ -194,7 +197,7 @@ Call `launch` on the `CallComposite` instance inside the `startCallComposite` fu
194197
callComposite?.launch(with: options)
195198
```
196199

197-
### Implement the closure for events handler
200+
### Subscribe to events from `CallComposite`
198201

199202
You can implement the closures from `CallCompositeEventsHandler` to act on the events and pass the implementation to `CallCompositeOptions`. An event for when the composite ended with an error is an example.
200203

@@ -208,7 +211,7 @@ let handler = CallCompositeEventsHandler(didFail: { error in
208211
let callCompositeOptions = CallCompositeOptions(callCompositeEventsHandler: handler)
209212
```
210213

211-
### Customizing the theme
214+
### Apply theme configuration
212215

213216
You can customize the theme by creating a custom theme configuration that implements the ThemeConfiguration protocol. You then include an instance of that new class in your CallCompositeOptions.
214217

0 commit comments

Comments
 (0)