Network.bufferingProgress

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

bufferingProgress 属性检索缓冲完成的百分比。

语法

玩家。网络。bufferingProgress

可能的值

此属性是只读 Number (长) 。

备注

每次停止并重启播放时，此属性都设置为零。 如果播放暂停，则不会重置。

缓冲仅适用于流式处理内容。 此属性仅在 运行时（当 Player）期间返回有效信息。设置 URL 属性。

使用 Player。用于 确定缓冲何时开始或停止的缓冲事件。

示例

以下 JScript 示例使用 网络。bufferingProgress 显示缓冲完成的百分比。 此信息显示在 ID = “BP” 创建的 HTML DIV 中。 该示例使用间隔为 1 秒的计时器来更新显示。 创建的 Player 对象 ID 为“Player”。

<!-- Create an event handler for buffering. -->
<SCRIPT FOR = Player EVENT = buffering(Start)>
   var idI; // Variable for the interval id.

   // Test whether buffering has started or stopped.
   if (true == Start){ 
      // Start the timer. Call the function to update the display every second.
      idI = window.setInterval("UpdateBP()", 1000);
   }

   else{
      // Buffering is complete. Stop the timer.
      window.clearInterval(idI);
   }
</SCRIPT>

<!-- Put the function to update the display in a separate code block. -->
<SCRIPT>
function UpdateBP(){
   BP.innerHTML = "";
   BP.innerHTML = "Buffering progress: " + Player.network.bufferingProgress;
   BP.innerHTML += " percent complete";
}
</SCRIPT>

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本。
DLL	Wmp.dll

另请参阅

网络对象

Player.Buffering 事件

Player.URL