Skip to content

Commit 72a76f2

Browse files
committed
incorporating feedback
1 parent 5d01dfc commit 72a76f2

File tree

3 files changed

+8
-8
lines changed

3 files changed

+8
-8
lines changed

articles/communication-services/concepts/includes/best-practices-native.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ We highly recommend that you identify and validate your scenario by using the in
4242

4343
### Verify device permissions for app requests
4444

45-
To use the Calling Native SDK for making or receiving calls, it's necessary to authorize each platform to access device resources. As a developer, you should prompt the user for access and ensure that permissions are enabled. The consumer authorizes these access rights, so verify that they were granted permission previously.
45+
To use the Calling Native SDK for making or receiving calls, consumers need to authorize each platform to access device resources. As a developer, you must prompt the user for access and ensure that permissions are enabled. The consumer authorizes these access rights, so verify that they currently have the required permissions.
4646

4747
#### [iOS](#tab/ios)
4848

@@ -86,9 +86,9 @@ You should track the `CallID` value in the telemetry that you configure in your
8686

8787
### Subscribe to User Facing Diagnostics and media quality statistics
8888

89-
You can use these features of Azure Communication Services to help improve the user experience:
89+
You can use these Azure Communication Services features to help improve the user experience:
9090

91-
- [User Facing Diagnostics](../voice-video-calling/user-facing-diagnostics.md): Examine various properties of a call to determine the cause of problems that affect your customers.
91+
- [User Facing Diagnostics](../voice-video-calling/user-facing-diagnostics.md): Examine properties of a call to determine the cause of problems that affect your customers.
9292
- [Media quality statistics](../voice-video-calling/media-quality-sdk.md): Examine the low-level audio, video, and screen-sharing quality metrics for incoming and outgoing call metrics. We recommend that you collect the data and send it to your pipeline ingestion after a call ends.
9393

9494
### Manage error handling

articles/communication-services/concepts/includes/best-practices-web.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This section provides information about best practices associated with the Azure
1717

1818
### Plug in a microphone or enable a microphone from the device manager when a call is in progress
1919

20-
When no microphone is available at the beginning of an Azure Communication Services call, and then a microphone becomes available, the change raises a `noMicrophoneDevicesEnumerated` diagnostic event. When that event happens, your application should invoke `askDevicePermission` to obtain user consent to enumerate devices. The user can then mute or unmute the microphone.
20+
When no microphone is available at the beginning of an Azure Communication Services call, and then a microphone becomes available, the change raises a `noMicrophoneDevicesEnumerated` diagnostic event. When that event happens, your application needs to invoke `askDevicePermission` to obtain user consent to enumerate devices. The user can then mute or unmute the microphone.
2121

2222
### Dispose of VideoStreamRendererView
2323

@@ -84,12 +84,12 @@ To stop the application from being screen shared, you have to take one of these
8484

8585
- Right-click the application's icon on the desktop taskbar, and then select **Quit**.
8686
- Select the **Stop sharing** button on the browser.
87-
- Call the SDK's `Call.stopScreenSharing()` API.
87+
- Call the SDK's `Call.stopScreenSharing()` API operation.
8888

8989
#### Safari can do only full-screen sharing
9090

9191
Safari allows screen sharing only for the entire screen. That behavior is unlike Chromium, which lets you screen share the full screen, a specific desktop app, or a specific browser tab.
9292

9393
#### You can grant screen-sharing permissions on macOS
9494

95-
To do screen sharing in macOS Safari or macOS Chrome, grant the necessary permissions to the browsers on the OS menu: **System Preferences** > **Security & Privacy** > **Screen Recording**.
95+
To screen share in macOS Safari or macOS Chrome, grant the necessary permissions to the browsers on the OS menu: **System Preferences** > **Security & Privacy** > **Screen Recording**.

articles/communication-services/concepts/voice-video-calling/end-of-call-survey-concept.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The End of Call Survey is a tool that helps you understand how your users percei
1919

2020
## Purpose of the End of Call Survey
2121

22-
It's difficult to determine a customer's perceived calling experience and determine how well your calling solution is performing unless you gather feedback. You can use the End of Call Survey to collect and analyze customers' *subjective* opinions on their calling experience. Relying only on *objective* measurements, such as audio and video bitrate, jitter, and latency, might not indicate if a customer had a poor calling experience.
22+
It's difficult to determine a customer's perceived calling experience and understand how well your calling solution is performing unless you gather feedback. You can use the End of Call Survey to collect and analyze customers' *subjective* opinions on their calling experience. Relying only on *objective* measurements, such as audio and video bitrate, jitter, and latency, might not indicate if a customer had a poor calling experience.
2323

2424
After you publish survey data, you can view the survey results through Azure for analysis and improvements. Azure Communication Services uses these survey results to monitor and improve quality and reliability.
2525

@@ -30,7 +30,7 @@ The survey is designed to answer two questions:
3030
- How did the user perceive the overall experience of call quality?
3131
- Did the user perceive any problems with audio, video, or screen sharing in the call?
3232

33-
The API allows applications to gather data points that describe user-perceived ratings of their overall call, audio, video, and screen-sharing experiences. Microsoft analyzes survey API results according to the following goals.
33+
The API enables applications to gather data points that describe user-perceived ratings of their overall call, audio, video, and screen-sharing experiences. Microsoft analyzes survey API results according to the following goals.
3434

3535
| API rating category | Question goal |
3636
| ----------- | ----------- |

0 commit comments

Comments
 (0)