You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/ui-library/includes/get-started-call/android.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -230,7 +230,9 @@ The following classes and interfaces handle some of the major features of the Az
230
230
|[TeamsMeetingOptions](#teams-meeting)| Passed to CallComposite launch to join Teams meeting meeting. |
231
231
|[ThemeConfiguration](#apply-theme-configuration)| Injected as optional in CallCompositeBuilder to change primary color of composite. |
232
232
233
-
## Create Call Composite
233
+
## UI Library functionality
234
+
235
+
### Create Call Composite
234
236
235
237
Initialize a `CallCompositeBuilder` instance and a `CallComposite` instance inside the `startCallComposite` function.
236
238
@@ -246,7 +248,7 @@ CallComposite callComposite = new CallCompositeBuilder().build();
246
248
```
247
249
248
250
-----
249
-
### Create `CommunicationTokenCredential`
251
+
### Setup authentication
250
252
251
253
Initialize a `CommunicationTokenCredential` instance inside the `startCallComposite` function. Replace `"<USER_ACCESS_TOKEN>"` with your token.
252
254
@@ -275,7 +277,7 @@ CommunicationTokenCredential communicationTokenCredential = new CommunicationTok
275
277
Refer to the [user access token](../../../identity/quick-create-identity.md) documentation if you don't already have a token available.
276
278
277
279
-----
278
-
## Setup Group Call or Teams Meeting Options
280
+
###Setup Group Call or Teams Meeting Options
279
281
280
282
Depending on what type of Call/Meeting you would like to setup, use the appropriate options object.
281
283
@@ -341,12 +343,12 @@ TeamsMeetingOptions options = new TeamsMeetingOptions(
341
343
-----
342
344
### Get a Microsoft Teams meeting link
343
345
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).
345
347
346
348
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)
347
349
You can also get the required meeting information from the **Join Meeting** URL in the Teams meeting invite itself.
348
350
349
-
## Launch
351
+
###Launch
350
352
351
353
Call `launch` on the `CallComposite` instance inside the `startCallComposite` function
To receive events, inject a handler to the `CallCompositeBuilder`.
370
372
@@ -404,7 +406,7 @@ class ApplicationCallCompositeEventsHandler implements CallCompositeEventsHandle
404
406
405
407
-----
406
408
407
-
## Apply theme configuration
409
+
###Apply theme configuration
408
410
409
411
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`.
3. Run `pod install --repo-update`. (This process may take 10-15 min.)
49
+
4. Open the generated `.xcworkspace` with Xcode.
49
50
50
51
### Request access to the microphone, camera, etc.
51
52
@@ -67,7 +68,7 @@ Set `Enable Bitcode` option to `No` in the project `Build Settings`. To find the
67
68
68
69
## Initialize composite
69
70
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.
71
72
72
73
```swift
73
74
importUIKit
@@ -102,8 +103,8 @@ class ViewController: UIViewController {
102
103
let communicationTokenCredential =try!CommunicationTokenCredential(token: "<USER_ACCESS_TOKEN>")
103
104
104
105
let options =GroupCallOptions(communicationTokenCredential: communicationTokenCredential,
105
-
displayName: displayName,
106
-
groupId: uuid)
106
+
displayName: "<DISPLAY_NAME>",
107
+
groupId: "<GROUP_CALL_ID>")
107
108
callComposite?.launch(with: options)
108
109
}
109
110
}
@@ -119,22 +120,24 @@ You can build and run your app on iOS simulator by selecting **Product** > **Run
119
120
120
121

121
122
123
+
## Sample application code can be found [here](https://github.com/Azure-Samples/communication-services-ios-quickstarts/tree/ui-library-quickstart)
124
+
122
125
## Object Model
123
126
124
127
The following classes and interfaces handle some of the major features of the Azure Communication Services UI client library:
| 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. |
134
137
135
138
## UI Library functionality
136
139
137
-
### Create call composite options and call composite
140
+
### Create call composite
138
141
139
142
Initialize a `CallCompositeOptions` instance and a `CallComposite` instance inside the `startCallComposite` function.
140
143
@@ -194,7 +197,7 @@ Call `launch` on the `CallComposite` instance inside the `startCallComposite` fu
194
197
callComposite?.launch(with: options)
195
198
```
196
199
197
-
### Implement the closure for events handler
200
+
### Subscribe to events from `CallComposite`
198
201
199
202
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.
200
203
@@ -208,7 +211,7 @@ let handler = CallCompositeEventsHandler(didFail: { error in
208
211
let callCompositeOptions =CallCompositeOptions(callCompositeEventsHandler: handler)
209
212
```
210
213
211
-
### Customizing the theme
214
+
### Apply theme configuration
212
215
213
216
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.
0 commit comments