Skip to content

Commit 1360165

Browse files
committed
edits
1 parent aa262b3 commit 1360165

File tree

1 file changed

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

1 file changed

+16
-12
lines changed

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

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ Complete the following sections to set up the quickstart project.
2525

2626
In Xcode, create a new project:
2727

28+
1. In the **File** menu, select **New** > **Project**.
29+
2830
1. In **Choose a template for your new project**, select the **iOS** platform and select the **App** application template. The quickstart uses the UIKit storyboards. The quickstart doesn't create tests, so you can clear the **Include Tests** checkbox.
2931

3032
:::image type="content" source="../../media/xcode-new-project-template-select.png" alt-text="Screenshot that shows the Xcode new project dialog, with iOS and the App template selected.":::
@@ -67,9 +69,11 @@ To access the device's hardware, including the microphone and camera, update you
6769
<string></string>
6870
```
6971
72+
Here's an example of the `Info.plist` source code in an Xcode file:
73+
7074
:::image type="content" source="../../media/xcode-info-plist-source-code.png" alt-text="Screenshot that shows an example of the info plist source code in an Xcode file.":::
7175

72-
1. To verify that device permission requests are added correctly, select **Open As** > **Property List**. The information property list looks similar to the following example:
76+
1. To verify that device permission requests are added correctly, select **Open As** > **Property List**. Check that the information property list looks similar to the following example:
7377

7478
:::image type="content" source="../../media/xcode-info-plist.png" alt-text="Screenshot that shows the camera and microphone device privacy in Xcode.":::
7579

@@ -129,13 +133,13 @@ To initialize the composite:
129133

130134
## Run the code
131135

132-
To build and run your app on the iOS simulator, select **Product** > **Run**, or use the (&#8984;-R) keyboard shortcut. Then, try out the call experience on the simulator:
136+
To build and run your app on the iOS simulator, select **Product** > **Run** or use the (&#8984;-R) keyboard shortcut. Then, try out the call experience on the simulator:
133137

134138
1. Select **Start Experience**.
135139

136140
1. Accept audio permissions, and then select device, mic, and video settings.
137141

138-
1. Select **Start Call**.
142+
1. Select **Start call**.
139143

140144
:::image type="content" source="../../media/quick-start-calling-composite-running-ios.gif" alt-text="GIF animation that demonstrates the final look and feel of the quickstart iOS app.":::
141145

@@ -145,19 +149,19 @@ The following classes and interfaces handle some key features of the Azure Commu
145149

146150
| Name | Description |
147151
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
148-
| [CallComposite](#create-callcomposite) | Component that renders a call experience with participant gallery and controls |
152+
| [CallComposite](#create-callcomposite) | Component that renders a call experience that has a participant gallery and controls |
149153
| [CallCompositeOptions](#create-callcomposite) | Settings for options like themes and event handling |
150154
| RemoteOptions | Remote options to send to Azure Communication Services to join a [group call](#set-up-a-group-call) or a [Teams meeting](#set-up-a-teams-meeting). |
151155
| [ThemeOptions](#apply-theme-options) | Customization options for the composite theme |
152156
| [LocalizationOptions](#apply-localization-options) | Language options for the composite |
153157

154158
## UI Library functionality
155159

156-
Get the code to create key features for your iOS application.
160+
Get the code to create key communication features for your iOS application.
157161

158162
### Create CallComposite
159163

160-
To create `CallComposite`, inside the `startCallComposite` function, initialize a `CallCompositeOptions` instance and a `CallComposite` instance.
164+
To create `CallComposite`, inside the `startCallComposite` function, initialize a `CallCompositeOptions` instance and a `CallComposite` instance:
161165

162166
```swift
163167
@objc private func startCallComposite() {
@@ -169,17 +173,17 @@ To create `CallComposite`, inside the `startCallComposite` function, initialize
169173

170174
### Set up authentication
171175

172-
To set up authentication, inside the `startCallComposite` function, initialize a `CommunicationTokenCredential` instance. Replace `<USER_ACCESS_TOKEN>` with your token.
176+
To set up authentication, inside the `startCallComposite` function, initialize a `CommunicationTokenCredential` instance. Replace `<USER_ACCESS_TOKEN>` with your access token.
173177

174178
```swift
175179
let communicationTokenCredential = try! CommunicationTokenCredential(token: "<USER_ACCESS_TOKEN>")
176180
```
177181

178-
If you don't already have an access token, see [Create Azure Communication Services access tokens](../../../identity/quick-create-identity.md).
182+
If you don't already have an access token, [create an Azure Communication Services access token](../../../identity/quick-create-identity.md).
179183
180184
### Set up a group call
181185
182-
To set up a group call, inside the `startCallComposite` function, initialize a `RemoteOptions` instance for the `.groupCall` locator. Replace `<GROUP_CALL_ID>` with the group ID for your call. Replace <DISPLAY_NAME>` with your name.
186+
To set up a group call, inside the `startCallComposite` function, initialize a `RemoteOptions` instance for the `.groupCall` locator. Replace `<GROUP_CALL_ID>` with the group ID for your call. Replace `<DISPLAY_NAME>` with your name.
183187
184188
```swift
185189
// let uuid = UUID() to create a new call
@@ -193,7 +197,7 @@ For more information about using a group ID for calls, see [Manage calls](../../
193197
194198
### Set up a Teams meeting
195199
196-
To set up a Teams meeting, inside the `startCallComposite` function, initialize a `RemoteOptions` instance for the `.teamsMeeting` locator. Replace `<TEAMS_MEETING_LINK>` with the Teams meeting link for your call. Replace `<DISPLAY_NAME>` with your name.
200+
To set up a Microsoft Teams meeting, inside the `startCallComposite` function, initialize a `RemoteOptions` instance for the `.teamsMeeting` locator. Replace `<TEAMS_MEETING_LINK>` with the Teams meeting link for your call. Replace `<DISPLAY_NAME>` with your name.
197201
198202
```swift
199203
let remoteOptions = RemoteOptions(for: .teamsMeeting(teamsLink: "<TEAMS_MEETING_LINK>"),
@@ -227,7 +231,7 @@ callComposite?.events.onError = { error in
227231
228232
### Apply theme options
229233
230-
To customize the theme for your application, create custom theme options that implement the `ThemeOptions` protocol. Include an instance of that new class in `CallCompositeOptions`:
234+
To customize the communication experience in your application, create custom theme options that implement the `ThemeOptions` protocol. Include an instance of the new class in `CallCompositeOptions`:
231235
232236
```swift
233237
class CustomThemeOptions: ThemeOptions {
@@ -247,7 +251,7 @@ For more information about how theming works, see the [theming guide](../../../.
247251
248252
To change the language in the composite, create custom localization options and include them in `CallCompositeOptions`. By default, all text labels use English (`SupportedLocale.en`) strings. You can use `LocalizationOptions` to set a different value for `locale`. By default, UI Library includes a set of `locale` values that you can use with the UI components. `SupportedLocale.values` provides a list of all supported languages.
249253
250-
In the following example, the composite is localized to French (`fr`).
254+
In the following example, the composite is localized to French (`fr`):
251255
252256
```swift
253257
// Option1: Use IntelliSense to get locales UI Library supports.

0 commit comments

Comments
 (0)