Användarinriktad diagnostik

Lokal diagnostik jämfört med fjärranvändarinriktad diagnostik

Användarinriktad diagnostik (UFD) aktiveras för att exponera användarpåverkande händelser som händer på en användare som anropar enheten via ett programmatiskt API. I Azure Communication Services finns det två metoder för att använda och generera UFD:er: lokala UFD:er och fjärranslutna UFD:er. Lokala UFD:er genereras i den lokala användarens telefonwebbläsare eller skrivbordswebbläsare. Fjärr-UFD:er är händelser som inträffar i en fjärrdeltagares miljö, vilket gör det möjligt för en lokal användare att använda och visa de fjärranvändare som påverkar händelser lokalt.

Med användarinriktad diagnostik (UFD) kan du se när lokala eller fjärranslutna deltagare har problem som påverkar ljud-videosamtalskvaliteten. UFD tillhandahåller realtidsdiagnostik för nätverksförhållanden, enhetsfunktioner och medieprestanda. Den här diagnostikinformationen hjälper utvecklare att identifiera problem som dålig anslutning, avstängda mikrofoner eller låg bandbredd. Även om UFD:er inte löser dessa problem automatiskt, gör det möjligt för program att erbjuda proaktiv feedback till användare, vilket tyder på lösningar som att kontrollera sin Internetanslutning eller justera enhetsinställningarna. Baserat på dessa data kan användarna antingen korrigera problemet själva (till exempel stänga av video när nätverket är svagt) eller visa informationen via användargränssnittet.

Det finns några mindre skillnader i användning av fjärranslutna UFD:er och lokala UFD:er. Dessa skillnader är:

• Den anropande SDK:n skickar inte alla fjärranslutna UFD:er som är tillgängliga från en lokal UFD.
• Den anropande SDK:n exponerar och strömmar endast fjärranslutna UFD:er upp till högst 20 deltagare i samtalet. När antalet deltagare överstiger 20 begränsar vi och avslutar överföringen av fjärr-UFD:er för att förhindra att nätverket överbelastas med dessa händelser.
• Anropande SDK filtrerar så att du bara ser tre (3) fjärranslutna UFD-händelser per minut som kommer från en unik klient.
• Från klient-SDK-perspektivet måste du aktivera funktionerna för att de lokala UFD:erna ska kunna skickas via fjärranslutning.

Diagnostikvärden

Följande användarinriktade diagnostik är tillgänglig:

Nätverksvärden

Ljudvärden

Kameravärden

Diverse värden

Åtkomst till diagnostik

Användarinriktad diagnostik är en utökad funktion i kärn-API Call :et. Du kan förstå mer om UserFacingDiagnosticsFeature gränssnittet här.

Här är en omfattande trädstruktur som mappar ut UserFacingDiagnosticsFeature gränssnittet tillsammans med dess relaterade beroenden, egenskaper och metoder. Varje diagnostikmodul (Nätverk, Media, Fjärr) har händelselyssnare för ändringar och ger den senaste diagnostiska ögonblicksbilden.

UserFacingDiagnosticsFeature (Interface)
├── Inherits: CallFeature
├── Properties
│   ├── network: NetworkDiagnostics
│   ├── media: MediaDiagnostics
│   └── remote: RemoteDiagnostics
│
├── Dependencies
│   ├── NetworkDiagnostics
│   │   ├── Methods
│   │   │   ├── getLatest(): LatestNetworkDiagnostics
│   │   │   ├── on('diagnosticChanged', listener): void
│   │   │   └── off('diagnosticChanged', listener): void
│   │   └── Types
│   │       ├── NetworkDiagnosticChangedEventArgs
│   │       │   ├── value: DiagnosticQuality | DiagnosticFlag
│   │       │   ├── valueType: DiagnosticValueType
│   │       │   └── diagnostic: NetworkDiagnosticType
│   │       ├── NetworkDiagnosticType = keyof LatestNetworkDiagnostics
│   │       └── LatestNetworkDiagnostics
│   │           ├── networkReconnect?: LatestDiagnosticValue
│   │           ├── networkReceiveQuality?: LatestDiagnosticValue
│   │           ├── networkSendQuality?: LatestDiagnosticValue
│   │           ├── noNetwork?: LatestDiagnosticValue
│   │           └── networkRelaysNotReachable?: LatestDiagnosticValue
│   │
│   ├── MediaDiagnostics
│   │   ├── Methods
│   │   │   ├── getLatest(): LatestMediaDiagnostics
│   │   │   ├── on('diagnosticChanged', listener): void
│   │   │   └── off('diagnosticChanged', listener): void
│   │   └── Types
│   │       ├── MediaDiagnosticChangedEventArgs
│   │       │   ├── value: DiagnosticQuality | DiagnosticFlag
│   │       │   ├── valueType: DiagnosticValueType
│   │       │   └── diagnostic: MediaDiagnosticType
│   │       ├── MediaDiagnosticType = keyof LatestMediaDiagnostics
│   │       └── LatestMediaDiagnostics
│   │           ├── speakingWhileMicrophoneIsMuted?: LatestDiagnosticValue
│   │           ├── noSpeakerDevicesEnumerated?: LatestDiagnosticValue
│   │           ├── noMicrophoneDevicesEnumerated?: LatestDiagnosticValue
│   │           ├── cameraFreeze?: LatestDiagnosticValue
│   │           ├── cameraStartFailed?: LatestDiagnosticValue
│   │           ├── cameraStartTimedOut?: LatestDiagnosticValue
│   │           ├── capturerStartFailed?: LatestDiagnosticValue
│   │           ├── microphoneNotFunctioning?: LatestDiagnosticValue
│   │           ├── microphoneMuteUnexpectedly?: LatestDiagnosticValue
│   │           ├── cameraStoppedUnexpectedly?: LatestDiagnosticValue
│   │           ├── capturerStoppedUnexpectedly?: LatestDiagnosticValue
│   │           ├── screenshareRecordingDisabled?: LatestDiagnosticValue
│   │           ├── microphonePermissionDenied?: LatestDiagnosticValue
│   │           └── cameraPermissionDenied?: LatestDiagnosticValue
│   │
│   └── RemoteDiagnostics
│       ├── Properties
│       │   └── isSendingDiagnosticsEnabled: boolean
│       ├── Methods
│       │   ├── startSendingDiagnostics(): void
│       │   ├── stopSendingDiagnostics(): void
│       │   ├── getLatest(): RemoteParticipantDiagnosticsData
│       │   ├── on('diagnosticChanged', listener): void
│       │   └── off('diagnosticChanged', listener): void
│       └── Types
│           ├── RemoteParticipantDiagnosticsData
│           │   └── diagnostics: RemoteDiagnostic[]
│           └── RemoteDiagnostic
│               ├── participantId: string
│               ├── rawId: string
│               ├── remoteParticipant?: RemoteParticipant
│               ├── diagnostic: NetworkDiagnosticType | MediaDiagnosticType | ServerDiagnosticType
│               ├── value: DiagnosticQuality | DiagnosticFlag
│               └── valueType: DiagnosticValueType
│           └── ServerDiagnosticType = 'serverConnection'

För att använda användarinriktad diagnostik måste du först instansiera funktionen för användarinriktad diagnostik från anropet.

const userFacingDiagnostics = call.feature(Features.UserFacingDiagnostics);

När du har initierat den användarinriktade diagnostikfunktionen, lägg sedan till händelselyssnare för den lokala nätverks-UFD:ns "diagnosticChanged"-händelse och händelselyssnare för den lokala media-UFD:ns "diagnosticChanged"-händelse. Händelselyssnaren anropas när en lokal UFD aktiveras. I händelselyssnaren kan du komma åt den utlösta UFD:ns data, till exempel dess namn (diagnosticInfo.diagnostic), dess värde (diagnosticInfo.value) och dess värdetyp (diagnosticInfo.valueType).

Diagnostikhändelser för lokal användare

Varje diagnostik har följande data:

• Diagnostik är den typ av UFD-diagnostik som utlöses på den lokala datorn. Till exempel en UFD för NetworkSendQuality eller DeviceSpeakWhileMuted.
• värdet är DiagnosticQuality eller DiagnosticFlag
• DiagnosticQuality = enum { Good = 1, Poor = 2, Bad = 3 }.
• DiagnosticFlag = true | false

const diagnosticChangedListener = (diagnosticInfo: NetworkDiagnosticChangedEventArgs | MediaDiagnosticChangedEventArgs) => {
    console.log(`Diagnostic changed: ` +
        `Diagnostic: ${diagnosticInfo.diagnostic}` +
        `Value: ${diagnosticInfo.value}` +
        `Value type: ${diagnosticInfo.valueType}`);

    if (diagnosticInfo.valueType === 'DiagnosticQuality') {
        if (diagnosticInfo.value === DiagnosticQuality.Bad) {
            console.error(`${diagnosticInfo.diagnostic} is bad quality`);

        } else if (diagnosticInfo.value === DiagnosticQuality.Poor) {
            console.error(`${diagnosticInfo.diagnostic} is poor quality`);
        }

    } else if (diagnosticInfo.valueType === 'DiagnosticFlag') {
        if (diagnosticInfo.value === true) {
            console.error(`${diagnosticInfo.diagnostic}`);
        }
    }
};


// Subscribe to the `diagnosticChanged` event to monitor when any local user-facing diagnostic changes.
userFacingDiagnostics.network.on('diagnosticChanged', diagnosticChangedListener);
userFacingDiagnostics.media.on('diagnosticChanged', diagnosticChangedListener);

Åtkomst till diagnostikhändelser för fjärranvändare

Om du vill överföra fjärr-UFD:er till alla deltagare i ett anrop måste du aktivera funktionen från varje klient. Du kan aktivera eller inaktivera den här funktionen per klient. När klienten har aktiverats börjar den överföra sina lokala UFD:er via fjärranslutning till alla deltagare för användning och bearbetning. Om antalet deltagare överstiger 20 stoppas överföringen av fjärr-UFD:er från den lokala klienten. Det här måttet implementeras för att förhindra överdriven förbrukning av nätverksbandbredd på grund av UFD-trafik.

// Start the local client to send its local UFD to all remote participants (send local UFD to remote clients).
userFacingDiagnostics.remote.startSendingDiagnostics();
// Stop sending local UFDs to remote clients.
userFacingDiagnostics.remote.stopSendingDiagnostics();

För kodexemplet nedan RemoteParticipantDiagnosticsData har följande data associerade med sig:

• diagnostic innehåller en matris med diagnostik-UFD som utlöses från en fjärrdator. Till exempel en UFD för NetworkSendQuality.
• Värdet för elementet är: DiagnosticQuality eller DiagnosticFlag:
• DiagnosticQuality = enum { Good = 1, Poor = 2, Bad = 3 }.
• DiagnosticFlag = true | false
• valueType för matrisen = DiagnosticQuality | DiagnosticFlag

const remoteDiagnosticChangedListener = (diagnosticInfo: RemoteParticipantDiagnosticsData) => {
    for (const diagnostic of diagnosticInfo.diagnostics) {
        if (diagnostic.valueType === 'DiagnosticQuality') {
            if (diagnostic.value === SDK.DiagnosticQuality.Bad) {
                console.error(`${diagnostic.diagnostic} is bad quality`);

            } else if (diagnostic.value === SDK.DiagnosticQuality.Poor) {
                console.error(`${diagnostic.diagnostic} is poor quality`);
            }

        } else if (diagnostic.valueType === 'DiagnosticFlag') {
            console.error(`${diagnostic.diagnostic} diagnostic flag raised`);
        }
    }
};

// Subscribe to the `diagnosticChanged` event to monitor when any remote user-facing diagnostic changes.
userFacingDiagnostics.remote.on('diagnosticChanged', remoteDiagnosticChangedListener);

Observera att alla fjärranslutna UFD:er klassificeras under "userFacingDiagnostics.remote".

Hämta den senaste användarfokuserade diagnostikhändelsen som mottogs

Här är exempelkoden för att generera det senaste lokala UFD-värdet som genereras av den anropande SDK:n. Om en diagnostik är odefinierad innebär det att UFD inte har utlöstts.

const latestNetworkDiagnostics = userFacingDiagnostics.network.getLatest();

console.log(
  `noNetwork: ${latestNetworkDiagnostics.noNetwork.value}, ` +
    `value type = ${latestNetworkDiagnostics.noNetwork.valueType}`
);

console.log(
  `networkRelaysNotReachable: ${latestNetworkDiagnostics.networkRelaysNotReachable.value}, ` +
    `value type = ${latestNetworkDiagnostics.networkRelaysNotReachable.valueType}`
);

console.log(
  `networkReconnect: ${latestNetworkDiagnostics.networkReconnect.value}, ` +
    `value type = ${latestNetworkDiagnostics.networkReconnect.valueType}`
);

console.log(
  `networkReceiveQuality: ${latestNetworkDiagnostics.networkReceiveQuality.value}, ` +
    `value type = ${latestNetworkDiagnostics.networkReceiveQuality.valueType}`
);

console.log(
  `networkSendQuality: ${latestNetworkDiagnostics.networkSendQuality.value}, ` +
    `value type = ${latestNetworkDiagnostics.networkSendQuality.valueType}`
);

const latestMediaDiagnostics = userFacingDiagnostics.media.getLatest();

console.log(
  `noSpeakerDevicesEnumerated: ${latestMediaDiagnostics.noSpeakerDevicesEnumerated.value}, ` +
    `value type = ${latestMediaDiagnostics.noSpeakerDevicesEnumerated.valueType}`
);

console.log(
  `speakingWhileMicrophoneIsMuted: ${latestMediaDiagnostics.speakingWhileMicrophoneIsMuted.value}, ` +
    `value type = ${latestMediaDiagnostics.speakingWhileMicrophoneIsMuted.valueType}`
);

console.log(
  `noMicrophoneDevicesEnumerated: ${latestMediaDiagnostics.noMicrophoneDevicesEnumerated.value}, ` +
    `value type = ${latestMediaDiagnostics.noMicrophoneDevicesEnumerated.valueType}`
);

console.log(
  `microphoneNotFunctioning: ${latestMediaDiagnostics.microphoneNotFunctioning.value}, ` +
    `value type = ${latestMediaDiagnostics.microphoneNotFunctioning.valueType}`
);

console.log(
  `microphoneMuteUnexpectedly: ${latestMediaDiagnostics.microphoneMuteUnexpectedly.value}, ` +
    `value type = ${latestMediaDiagnostics.microphoneMuteUnexpectedly.valueType}`
);

console.log(
  `microphonePermissionDenied: ${latestMediaDiagnostics.microphonePermissionDenied.value}, ` +
    `value type = ${latestMediaDiagnostics.microphonePermissionDenied.valueType}`
);

console.log(
  `cameraFreeze: ${latestMediaDiagnostics.cameraFreeze.value}, ` +
    `value type = ${latestMediaDiagnostics.cameraFreeze.valueType}`
);

console.log(
  `cameraStartFailed: ${latestMediaDiagnostics.cameraStartFailed.value}, ` +
    `value type = ${latestMediaDiagnostics.cameraStartFailed.valueType}`
);

console.log(
  `cameraStartTimedOut: ${latestMediaDiagnostics.cameraStartTimedOut.value}, ` +
    `value type = ${latestMediaDiagnostics.cameraStartTimedOut.valueType}`
);

console.log(
  `cameraPermissionDenied: ${latestMediaDiagnostics.cameraPermissionDenied.value}, ` +
    `value type = ${latestMediaDiagnostics.cameraPermissionDenied.valueType}`
);

console.log(
  `cameraStoppedUnexpectedly: ${latestMediaDiagnostics.cameraStoppedUnexpectedly.value}, ` +
    `value type = ${latestMediaDiagnostics.cameraStoppedUnexpectedly.valueType}`
);

Här är exempelkoden för att generera det senaste fjärr-UFD-värdet som levereras till den anropande SDK:n. Om en diagnostik är odefinierad innebär det att UFD inte har hämtats från fjärrklientens SDK.

const latestRemoteDiagnostics = userFacingDiagnostics.remote.getLatest();
for (const diagnostic of latestRemoteDiagnostics.diagnostics) { 
    console.error(`Remote participant ${diagnostic.participantId} diagnostic: ${diagnostic.diagnostic} = ${diagnostic.value}`); 
}  

Diagnostikvärden

Följande användarinriktade diagnostik är tillgänglig:

Nätverksvärden

Ljudvärden

Kameravärden

Endast inhemsk

Åtkomst till diagnostik

Användarinriktad diagnostik är en utökad funktion i kärn-API Call :et och gör att du kan diagnostisera ett aktivt anrop.

DiagnosticsCallFeature diagnosticsCallFeature = call.feature(Features.LOCAL_USER_DIAGNOSTICS);

Användarriktade diagnostikhändelser

• Hämta funktionsobjekt och lägg till lyssnare i diagnostikhändelserna.

DiagnosticsCallFeature diagnosticsCallFeature = call.feature(Features.LOCAL_USER_DIAGNOSTICS);

/* NetworkDiagnostic */
FlagDiagnosticChangedListener listener = (FlagDiagnosticChangedEvent args) -> {
  Boolean mediaValue = args.getValue();
  // Handle new value for no network diagnostic.
};

NetworkDiagnostics networkDiagnostics = diagnosticsCallFeature.getNetworkDiagnostics();
networkDiagnostics.addOnNetworkUnreachableChangedListener(listener);

// To remove listener for network quality event
networkDiagnostics.removeOnNetworkUnreachableChangedListener(listener);

// Quality Diagnostics
DiagnosticsCallFeature diagnosticsCallFeature = call.feature(Features.LOCAL_USER_DIAGNOSTICS);
QualityDiagnosticChangedListener listener = (QualityDiagnosticChangedEvent args) -> {
  DiagnosticQuality diagnosticQuality = args.getValue();
  // Handle new value for network reconnect diagnostic.
};

NetworkDiagnostics networkDiagnostics = diagnosticsCallFeature.getNetworkDiagnostics();
networkDiagnostics.addOnNetworkReconnectionQualityChangedListener(listener);

// To remove listener for media flag event
networkDiagnostics.removeOnNetworkReconnectionQualityChangedListener(listener);

/* MediaDiagnostic */
DiagnosticsCallFeature diagnosticsCallFeature = call.feature(Features.LOCAL_USER_DIAGNOSTICS);
FlagDiagnosticChangedListener listener = (FlagDiagnosticChangedEvent args) -> {
  Boolean mediaValue = args.getValue();
  // Handle new value for speaker not functioning diagnostic.
};

MediaDiagnostics mediaDiagnostics = diagnosticsCallFeature.getMedia();
mediaDiagnostics.addOnIsSpeakerNotFunctioningChangedListener(listener);

// To remove listener for media flag event
mediaDiagnostics.removeOnIsSpeakerNotFunctioningChangedListener(listener);

Hämta den senaste användarinriktade diagnostiken

• Hämta de senaste diagnostikvärdena som har genererats i det aktuella anropet. Om vi fortfarande inte har fått något värde för diagnostiken genereras ett undantag.

DiagnosticsCallFeature diagnosticsCallFeature = call.feature(Features.LOCAL_USER_DIAGNOSTICS);
NetworkDiagnostics networkDiagnostics = diagnosticsCallFeature.getNetwork();
MediaDiagnostics mediaDiagnostics = diagnosticsCallFeature.getMedia();

NetworkDiagnosticValues latestNetwork = networkDiagnostics.getLatestDiagnostics();
Boolean lastNetworkValue = latestNetwork.isNetworkUnavailable(); // null if there isn't a value for this diagnostic.
DiagnosticQuality lastReceiveQualityValue = latestNetwork.getNetworkReceiveQuality(); //  UNKNOWN if there isn't a value for this diagnostic.

MediaDiagnosticValues latestMedia = networkDiagnostics.getLatestDiagnostics();
Boolean lastSpeakerNotFunctionValue = latestMedia.isSpeakerNotFunctioning(); // null if there isn't a value for this diagnostic.

// Use the last values ...

Diagnostikvärden

Följande användarinriktade diagnostik är tillgänglig:

Nätverksvärden

Ljudvärden

Kameravärden

Endast inhemsk

Åtkomst till diagnostik

Användarinriktad diagnostik är en utökad funktion i kärn-API Call :et och gör att du kan diagnostisera ett aktivt anrop.

let userFacingDiagnostics = self.call?.feature(Features.localUserDiagnostics)

Användarriktade diagnostikhändelser

• Implementera delegeringar för media och network diagnostikkällor. MediaDiagnosticsDelegate respektive NetworkDiagnosticsDelegate .

extension CallObserver: MediaDiagnosticsDelegate {
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsCameraFrozen args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsSpeakerMuted args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsCameraStartFailed args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsSpeakerVolumeZero args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsSpeakerNotFunctioning args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsCameraPermissionDenied args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsMicrophoneNotFunctioning args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsCameraStartTimedOut args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsMicrophoneMutedUnexpectedly args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsZeroSpeakerDevicesAvailable args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...                            
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsZeroMicrophoneDevicesAvailable args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsSpeakingWhileMicrophoneIsMuted args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsSpeakerBusy args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func mediaDiagnostics(_ mediaDiagnostics: MediaDiagnostics,
                        didChangeIsMicrophoneBusy args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
}

extension CallObserver: NetworkDiagnosticsDelegate {
  func networkDiagnostics(_ networkDiagnostics: NetworkDiagnostics,
                          didChangeIsNetworkRelaysUnreachable args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func networkDiagnostics(_ networkDiagnostics: NetworkDiagnostics,
                          didChangeNetworkReconnectionQuality args: DiagnosticQualityChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func networkDiagnostics(_ networkDiagnostics: NetworkDiagnostics,
                          didChangeNetworkSendQuality args: DiagnosticQualityChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func networkDiagnostics(_ networkDiagnostics: NetworkDiagnostics,
                          didChangeIsNetworkUnavailable args: DiagnosticFlagChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
    
  func networkDiagnostics(_ networkDiagnostics: NetworkDiagnostics,
                          didChangeNetworkReceiveQuality args: DiagnosticQualityChangedEventArgs) {
    let newValue = args.value
    // Handle the diagnostic event value changed...
  }
}

• Håll en referens till media och network diagnostik och sätt delegeringsobjekt för att lyssna på händelser.

self.mediaDiagnostics = userFacingDiagnostics?.media
self.networkDiagnostics = userFacingDiagnostics?.network
self.mediaDiagnostics?.delegate = self.callObserver
self.networkDiagnostics?.delegate = self.callObserver

Hämta den senaste användarinriktade diagnostiken

• Hämta de senaste diagnostikvärdena som har genererats. Om vi fortfarande inte fick något värde för diagnostiken nil eller .unknown returneras.

let lastSpeakerNotFunctionValue = self.mediaDiagnostics.latest.isSpeakerNotFunctioning // Boolean?
let lastNetworkRelayNotReachableValue = self.networkDiagnostics.latest.networkRelaysUnreachable // Boolean?
let lastReceiveQualityValue = self.networkDiagnostics.latest.networkReceiveQuality // DiagnosticQuality (.good, .poor, .bad)
// or .unknown if there isn't a diagnostic for this.

Diagnostikvärden

Följande användarinriktade diagnostik är tillgänglig:

Nätverksvärden

Ljudvärden

Kameravärden

Endast inhemsk

Åtkomst till diagnostik

Användarinriktad diagnostik är en utökad funktion i kärn-API Call :et och gör att du kan diagnostisera ett aktivt anrop.

this.diagnosticsCallFeature = call.Features.LocalUserDiagnostics;

Användarriktade diagnostikhändelser

• Implementera lyssnare för diagnostikhändelser.

private async void Call__OnNetworkUnavailableChanged(object sender, FlagDiagnosticChangedEventArgs args)
{
  var value = args.Value;
  // Handle the diagnostic event value changed...
}

// Listen to other network diagnostics

private async void Call__OnMediaSpeakerNotFunctioningChanged(object sender, FlagDiagnosticChangedEventArgs args)
{
  var value = args.Value;
  // Handle the diagnostic event value changed...
}

// Listen to other media diagnostics

• Ange händelsemetoder för att lyssna på händelser.

this.diagnosticsCallFeature = call.Features.LocalUserDiagnostics;
this.networkDiagnostics = diagnosticsCallFeature.Network;
this.mediaDiagnostics = diagnosticsCallFeature.Media;

this.networkDiagnostics.NetworkUnavailableChanged += Call__OnNetworkUnavailableChanged;
// Listen to other network events as well ... 

this.mediaDiagnostics.SpeakerNotFunctioningChanged += Call__OnMediaSpeakerNotFunctioningChanged;
// Listen to other media events as well ... 

// Removing listeners

this.networkDiagnostics.NetworkUnavailable -= Call__NetworkUnavailableChanged;
// Remove the other listeners as well ... 

this.mediaDiagnostics.SpeakerNotFunctioningChanged -= Call__OnMediaSpeakerNotFunctioningChanged;
// Remove the other listeners as well ... 

Hämta den senaste användarinriktade diagnostiken

• Hämta de senaste diagnostikvärdena som har genererats i det aktuella anropet. Om vi fortfarande inte fick något värde för diagnostikvärdet, returneras null eller .unknown.

this.diagnosticsCallFeature = call.Features.LocalUserDiagnostics;
this.networkDiagnostics = diagnosticsCallFeature.Network;
this.mediaDiagnostics = diagnosticsCallFeature.Media;

bool? lastSpeakerNotFunctionValue = this.mediaDiagnostics.GetLatestDiagnostics().IsSpeakerNotFunctioning; // Boolean?
bool? lastNetworkRelayNotReachableValue = this.networkDiagnostics.GetLatestDiagnostics().IsNetworkRelaysUnreachable; // Boolean?
DiagnosticQuality lastReceiveQualityValue = this.networkDiagnostics.GetLatestDiagnostics().NetworkReceiveQuality; // DiagnosticQuality (.good, .poor, .bad)
// or .unknown if there isn't a diagnostic for this.