Settings.rate

發行項
06/21/2023

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

rate屬性會指定或擷取視訊媒體的目前播放速率。

Syntax

player.settings.rate

可能的值

此屬性是具有預設值 1.0 的讀取/寫入 Number (double) 。

備註

這個屬性可作為乘數值，可讓您以更快或較慢的速率播放剪輯。預設值 1.0 表示撰寫的速度。請注意，音訊曲目很難以低於 0.5 或高於 1.5 的速率瞭解。 2 的播放速率相當於一般播放速度兩倍。

Windows 媒體播放機會嘗試使用四種不同的播放模式最有效。這些模式是使用音訊音調維護的平滑視訊播放、未維護音訊音調的平滑視訊播放、沒有音訊的平滑視訊播放，以及沒有音訊的主要畫面格視訊播放。播放機選擇的模式取決於許多因素，包括檔案類型和位置、作業系統、網路和伺服器。

其他考慮也適用，視媒體類型而定：

Windows Media Format (WMV) 和 ASF 檔案：此屬性的最佳值是從 1 到 10，或從 1 到 10 進行反向播放。從 0.5 到 1.0 或從 -0.5 到 -1.0 的值，在播放位於本機電腦上的檔案時，也可以正常運作。允許絕對大小大於 10 的值，但不是非常有意義的。
其他視訊媒體類型：此屬性的範圍可以從 0 到 9。不允許負值。小於 1 的值代表緩慢動作。允許高於 9 的值，但不是非常有意義的。

控制項。fastForward方法會將速率的值變更為 5.0，而Controls。fastReverse方法會將速率變更為 5.0。

某些媒體類型的播放速率無法改變。使用 [ 設定]。isAvailable 方法，可判斷是否可以針對特定媒體專案指定這個屬性。

Windows 媒體播放機 10 Mobile：此屬性只接受或傳回 -5.0、1.0 或 5.0 的值。

範例

下列範例會建立 HTML SELECT 元素，讓使用者變更目前媒體的播放速度。 SELECT 選項提供一般速度、半速和雙速度播放速率。 Player物件是以識別碼 = 「Player」建立的。

<!-- Create the HTML SELECT element. -->
<SELECT  ID = pbRATE  NAME = "pbRATE"  LANGUAGE="JScript"
         onChange="
                   /* Test whether playback rate can be set. */
                   if(Player.settings.IsAvailable('Rate'))

                   /* Set the playback rate based on the current
                      value of the SELECT element. */
                   Player.settings.rate = this.value
">

/* Create the OPTION list. */
<OPTION VALUE = 1>NORMAL</OPTION>
<OPTION VALUE = .5>half speed</OPTION>
<OPTION VALUE = 2>2 speed</OPTION>
</SELECT>

規格需求

需求	值
版本	Windows 媒體播放機 7.0 版或更新版本。
DLL	Wmp.dll

另請參閱

Controls.fastForward
Controls.fastReverse
Settings 物件
Settings.isAvailable