Proprietà IWMPNetwork::receptionQuality

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La proprietà receptionQuality ottiene la percentuale di pacchetti non persi negli ultimi 30 secondi.

Sintassi

public System.Int32 receptionQuality {get; set;}

Public ReadOnly Property receptionQuality As System.Int32

Valore proprietà

System.Int32 che è la qualità della ricezione.

Commenti

Il numero di pacchetti ricevuti, persi e recuperati durante lo streaming viene monitorato una volta al secondo. La proprietà receptionQuality ottiene la percentuale di pacchetti non persi negli ultimi 30 secondi.

Ogni volta che la riproduzione viene arrestata e riavviata, questa proprietà viene reimpostata su zero. Il valore non viene reimpostato se la riproduzione viene sospesa.

Questa proprietà ottiene informazioni valide solo durante l'esecuzione quando l'URL per la riproduzione viene impostato usando la proprietà AxWindowsMediaPlayer.URL .

Esempio

Nell'esempio seguente viene usata la ricezioneQuality per visualizzare la percentuale di pacchetti ricevuti in un'etichetta, in risposta all'evento PlayStateChange . Nell'esempio viene usato un timer con un intervallo di 1 secondo per aggiornare la visualizzazione. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

// Add a delegate for the PlayStateChange event.
player.PlayStateChange += new AxWMPLib._WMPOCXEvents_PlayStateChangeEventHandler(player_PlayStateChange);

// Create an event handler for the PlayStateChange event.
private void player_PlayStateChange(object sender, AxWMPLib._WMPOCXEvents_PlayStateChangeEvent e)
{
    // Test whether content is playing. 
    if (e.newState == 3)
    {
        // Start the timer. Update the display every 10 seconds.
        timer.Interval = 10000;
        timer.Start();
    }
    else
    {
        // Not playing; stop the timer.
        timer.Stop();
    }
}

private void UpdateReceptionQuality(object sender, EventArgs e)
{
    receptionQualityLabel.Text = ("Packets recovered: " + player.network.receptionQuality.ToString() + "%");
}

' Create an event handler for the PlayStateChange event.
Public Sub player_PlayStateChange(ByVal sender As Object, ByVal e As AxWMPLib._WMPOCXEvents_PlayStateChangeEvent) Handles player.PlayStateChange

    ' Test whether packets may be arriving.
    Select Case e.newState

    ' If WMPPlayState is Stopped, Paused, ScanForward, ScanReverse, Waiting, MediaEnded
    ' or Transitioning then stop the timer. 
        Case 1
        Case 2
        Case 4
        Case 5
        Case 7
        Case 8
        Case 9
            timer.Stop()

        ' If WMPPlayState is Playing or Buffering then set the timer interval and start the timer.
        Case Else
            timer.Interval = 1000
            timer.Start()

    End Select

End Sub

Public Sub UpdateReceptionQuality(ByVal sender As Object, ByVal e As System.EventArgs) Handles timer.Tick

    receptionQualityLabel.Text = ("Packets recovered: " + player.network.receptionQuality.ToString() + "%")

End Sub

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o versioni successive
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

AxWindowsMediaPlayer.URL (VB e C#)

Interfaccia IWMPNetwork (VB e C#)