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/voice-video-calling/includes/pre-call-diagnostics/pre-call-diagnostics-android.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
-
title: Azure Communication Services precall diagnostics
2
+
title: Azure Communication Services pre-call diagnostics
3
3
titleSuffix: An Azure Communication Services concept document
4
-
description: Overview of the precall diagnostic API feature.
4
+
description: Overview of the pre-call diagnostic API feature.
The precall API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access precall features using the Calling SDK. The precall diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see precall diagnostics enabled.
18
+
The pre-call API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access pre-call features using the Calling SDK. The pre-call diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see pre-call diagnostics enabled.
19
19
20
-
##Precall diagnostics access
20
+
### Pre-call diagnostics access
21
21
22
-
To access precall diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
22
+
To access pre-call diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
23
23
24
24
```java
25
25
String acsToken ="";
@@ -38,7 +38,7 @@ catch (Exception ex) { }
38
38
39
39
Once it finishes running, developers can access the result object.
40
40
41
-
## Diagnostic results
41
+
###Diagnostic results
42
42
43
43
Pre-call diagnostics return a full diagnostic of the device including details like availability and compatibility, call quality statistics, and in-call diagnostics. The results are returned as a `PreCallDiagnosticsReadyEvent` object.
44
44
@@ -66,7 +66,7 @@ public void OnPreCallDiagnosticsReady(PreCallDiagnosticsReadyEvent args)
66
66
}
67
67
```
68
68
69
-
You can access individual result objects using the `PreCallDiagnosticsReadyEvent` type. Results for individual tests are returned as they are completed with many of the test results being available immediately. The results might take up to 1 minute as the test validates the quality of the video and audio.
69
+
You can access individual result objects using the `PreCallDiagnosticsReadyEvent` type. Results for individual tests are returned when completed with many of the test results being available immediately. The results might take up to 1 minute as the test validates the quality of the video and audio.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/voice-video-calling/includes/pre-call-diagnostics/pre-call-diagnostics-ios.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,25 +1,25 @@
1
1
---
2
-
title: Azure Communication Services precall diagnostics
2
+
title: Azure Communication Services pre-call diagnostics
3
3
titleSuffix: An Azure Communication Services concept document
4
-
description: Overview of the precall diagnostic API feature.
4
+
description: Implement the pre-call diagnostic API feature.
The precall API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access precall features using the Calling SDK. The precall diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see precall diagnostics enabled.
18
+
The pre-call API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access pre-call features using the Calling SDK. The pre-call diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../support.md) about which platforms you want to see pre-call diagnostics enabled.
19
19
20
-
##Precall diagnostics access
20
+
### Pre-call diagnostics access
21
21
22
-
To access precall diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
22
+
To access pre-call diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
23
23
24
24
```swift
25
25
let acsToken: String;
@@ -65,9 +65,9 @@ class PreCallDiagnosticsCallClientFeatureObserver: NSObject, PreCallDiagnosticsC
65
65
66
66
Once it finishes running, developers can access the result object.
67
67
68
-
## Diagnostic results
68
+
###Diagnostic results
69
69
70
-
Pre-call diagnostics return a full diagnostic of the device including details like availability and compatibility, call quality statistics, and in-call diagnostics. The results are returned as a `PreCallDiagnosticsReadyEvent` object.
70
+
Pre-call diagnostics returns a full diagnostic of the device including details like availability and compatibility, call quality statistics, and in-call diagnostics. The results are returned as a `PreCallDiagnosticsReadyEvent` object.
You can access individual result objects using the `PreCallDiagnosticsReadyEvent` type. Results for individual tests are returned as they are completed with many of the test results being available immediately. The results might take up to 1 minute as the test validates the quality of the video and audio.
94
+
You can access individual result objects using the `PreCallDiagnosticsReadyEvent` type. Results for individual tests are returned as they're completed with many of the test results being available immediately. The results might take up to 1 minute as the test validates the quality of the video and audio.
95
95
96
-
### Device permissions
96
+
####Device permissions
97
97
98
98
The permission check determines whether video and audio devices are available from a permissions perspective. Provides `boolean` value for `audio` and `video` devices.
99
99
100
100
```swift
101
101
let permissionList = preCallDiagnosticsFeature?.devicePermissions()
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/voice-video-calling/includes/pre-call-diagnostics/pre-call-diagnostics-javascript.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
-
title: Azure Communication Services precall diagnostics
2
+
title: Azure Communication Services pre-call diagnostics
3
3
titleSuffix: An Azure Communication Services concept document
4
-
description: Overview of the precall diagnostic API feature.
4
+
description: Overview of the pre-call diagnostic API feature.
The precall API feature enables developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access precall features using the Calling SDK. The precall diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see precall diagnostics enabled.
18
+
The pre-call API feature enables developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access pre-call features using the Calling SDK. The pre-call diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see pre-call diagnostics enabled.
19
19
20
20
## Prerequisites
21
21
@@ -30,12 +30,12 @@ The precall API feature enables developers to programmatically validate a client
30
30
31
31
For more information, see [Use Azure CLI to Create and Manage Access Tokens](../../../identity/access-tokens.md?pivots=platform-azcli).
32
32
33
-
## Accessing precall diagnostics
33
+
## Accessing pre-call diagnostics
34
34
35
35
>[!IMPORTANT]
36
36
>Pre-call diagnostics are available starting with version [1.9.1-beta.1](https://www.npmjs.com/package/@azure/communication-calling/v/1.9.1-beta.1) of the Calling SDK. Make sure to use that version or higher when following these instructions.
37
37
38
-
To Access precall diagnostics, you need to initialize a `callClient`, and provision an Azure Communication Services access token. There you can access the `PreCallDiagnostics` feature and the `startTest` method.
38
+
To access pre-call diagnostics, you need to initialize a `callClient`, and provision an Azure Communication Services access token. There you can access the `PreCallDiagnostics` feature and the `startTest` method.
@@ -124,7 +124,7 @@ If devices aren't available, the user shouldn't continue into joining a call. Ra
124
124
125
125
Performs a quick call to check in-call metrics for audio and video and provides results back. Includes connectivity (`connected`, boolean), bandwidth quality (`bandWidth`, `'Bad' | 'Average' | 'Good'`) and call diagnostics for audio and video (`diagnostics`). Provided diagnostic categories include `jitter`, `packetLoss`, and `rtt` and results are generated using a simple quality grade (`'Bad' | 'Average' | 'Good'`).
126
126
127
-
InCall diagnostics uses [Media quality statistics](../../../../concepts/voice-video-calling/media-quality-sdk.md) to calculate quality scores and diagnose issues. During the precall diagnostic, the full set of media quality statistics are available for consumption. These statistics include raw values across video and audio metrics that you can use programatically.
127
+
InCall diagnostics uses [Media quality statistics](../../../../concepts/voice-video-calling/media-quality-sdk.md) to calculate quality scores and diagnose issues. During the pre-call diagnostic, the full set of media quality statistics are available for consumption. These statistics include raw values across video and audio metrics that you can use programatically.
128
128
129
129
The InCall diagnostic provides a convenience layer on top of media quality statistics to consume the results without the need to process all the raw data. For more information including instructions to access, see [Media quality statistics for an ongoing call](../../../../concepts/voice-video-calling/media-quality-sdk.md#media-quality-statistics-for-an-ongoing-call).
130
130
@@ -142,4 +142,4 @@ The InCall diagnostic provides a convenience layer on top of media quality stati
142
142
At this step, there are multiple possible failure points. The values provided by the API are based on the threshold values required by the service. The raw thresholds can be found in [Media quality statistics](../../../../concepts/voice-video-calling/media-quality-sdk.md#best-practices).
143
143
144
144
- If a connection fails, prompt users to recheck their network connectivity. Connection failures can also be attributed to network conditions like DNS, proxies, or firewalls. For more information on recommended network setting, see [Network recommendations](../../../../concepts/voice-video-calling/network-requirements.md).
145
-
- If bandwidth is `Bad`, prompt users to try a different network or verify the bandwidth availability on their current network. Ensure no other high bandwidth activities are taking place.
145
+
- If bandwidth is `Bad`, prompt users to try a different network or verify the bandwidth availability on their current network. Ensure no other high bandwidth activities are taking place.
Copy file name to clipboardExpand all lines: articles/communication-services/quickstarts/voice-video-calling/includes/pre-call-diagnostics/pre-call-diagnostics-windows.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
-
title: Azure Communication Services precall diagnostics
2
+
title: Azure Communication Services pre-call diagnostics
3
3
titleSuffix: An Azure Communication Services concept document
4
-
description: Overview of the precall diagnostic API feature.
4
+
description: Overview of the pre-call diagnostic API feature.
The precall API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access precall features using the Calling SDK. The precall diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see precall diagnostics enabled.
18
+
The pre-call API feature allows developers to programmatically validate a client’s readiness to join an Azure Communication Services call. You can only access pre-call features using the Calling SDK. The pre-call diagnostic feature provides multiple diagnostics including device, connection, and call quality. Provide us with [feedback](../../../../support.md) about which platforms you want to see pre-call diagnostics enabled.
19
19
20
-
##Precall diagnostics access
20
+
### Pre-call diagnostics access
21
21
22
-
To access precall diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
22
+
To access pre-call diagnostics, you need to initialize a `CallClient`, and provision an Azure Communication Services access token. Then you can access the `PreCallDiagnostics` feature and the `startTest` method.
23
23
24
24
```c#
25
25
stringacsToken="";
@@ -39,9 +39,9 @@ catch (Exception ex) { }
39
39
40
40
Once it finishes running, developers can access the result object.
41
41
42
-
## Diagnostic results
42
+
###Diagnostic results
43
43
44
-
Precall diagnostics return a full diagnostic of the device including details like availability and compatibility, call quality statistics, and in-call diagnostics. The results are returned as a `PreCallDiagnosticsReadyEvent` object.
44
+
Pre-call diagnostics return a full diagnostic of the device including details like availability and compatibility, call quality statistics, and in-call diagnostics. The results are returned as a `PreCallDiagnosticsReadyEvent` object.
0 commit comments