Network.receptionQuality

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die receptionQuality-Eigenschaft ruft den Prozentsatz der Pakete ab, die in den letzten 30 Sekunden empfangen wurden.

Syntax

player. Netzwerk. RezeptionQualität

Mögliche Werte

Diese Eigenschaft ist eine schreibgeschützte Zahl (long).

Bemerkungen

Die Anzahl der empfangenen, verlorenen und wiederhergestellten Pakete während des Streamings wird einmal pro Sekunde überwacht. receptionQuality ist der Prozentsatz der Pakete, die während der letzten 30 Sekunden nicht verloren gegangen sind.

Jedes Mal, wenn die Wiedergabe beendet und neu gestartet wird, wird diese Eigenschaft auf 0 festgelegt. Es wird nicht zurückgesetzt, wenn die Wiedergabe angehalten wird.

Diese Eigenschaft gibt nur während der Laufzeit gültige Informationen zurück, und nur, wenn der Player. Die URL-Eigenschaft ist ebenfalls festgelegt.

Beispiele

Im folgenden JScript-Beispiel wird Network verwendet. receptionQuality , um den Prozentsatz der empfangenen Pakete anzuzeigen. Die Informationen werden in einem HTML-DIV angezeigt, das mit der ID = "RQ" erstellt wurde. Im Beispiel wird ein Timer mit einem Intervall von 30 Sekunden verwendet, um die Anzeige zu aktualisieren. Das Player-Objekt wurde mit der ID = "Player" erstellt.

<!-- Create an event handler for play state change. -->
<SCRIPT FOR = Player EVENT = PlayStateChange(NewState)>
   var idI; // Variable for the interval id.

   // Test whether content is playing.
   if (3 == NewState){
         // Start the timer. Update the display every 30 seconds.
         idI = window.setInterval("UpdateRQ()", 30000);
   }

      else{
         // Not playing; stop the timer.
         window.clearInterval(idI);
      }
</SCRIPT>

<!-- Put the function to update the display in a separate code block. -->
<SCRIPT>
function UpdateRQ(){
         RQ.innerHTML = "";
         RQ.innerHTML = "Reception quality: " + Player.network.receptionQuality;
         RQ.innerHTML += "%";         
}
</SCRIPT>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher.
DLL	Wmp.dll

Siehe auch

Netzwerkobjekt

Player.URL