IWMPSettings：：rate 屬性

  • 發行項

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

rate屬性會取得或設定影片的目前播放速率。

Syntax

public System.Double rate {get; set;}


Public Property rate As System.Double

屬性值

System.Double，其為播放速率，預設值為 1.0。

備註

這個屬性所擷取的值可作為乘數值，可讓您以更快的或較慢速率播放媒體專案。 預設值 1.0 表示撰寫的速度。

請注意，音訊曲目很難以低於 0.5 或高於 1.5 的速率瞭解。 播放速率為 2 表示一般播放速度兩倍。

Windows 媒體播放機會嘗試使用下列四種不同的播放模式最有效

  • 使用音訊音調維持順暢的視訊播放
  • 未維護音訊音調的平滑視訊播放
  • 無音訊的平滑視訊播放
  • 沒有音訊的主要畫面格視訊播放

Windows 媒體播放機選擇的模式取決於許多因素，包括檔案類型和位置、作業系統、網路和伺服器。

其他考慮也適用，視用來建立內容的數位媒體格式而定：

  • Windows Media Video (WMV) 和 ASF。 rate屬性的最佳值為 1 到 10，或從 1 到 10 進行反向播放。 從 0.5 到 1.0 或從 -0.5 到 -1.0 的值，在可以維護音訊音調的情況下，例如播放位於本機電腦上的檔案時，也可能正常運作。 允許絕對大小大於 10 的值，但不是非常有意義的。
  • 其他視訊格式。 rate屬性的範圍可以從 0 到 9。 不允許負值。 小於 1 的值代表緩慢動作。 允許高於 9 的值，但不是非常有意義的。

IWMPControls.fastForward方法會將速率的值變更為 5.0，而IWMPControls.fastReverse方法會將速率的值變更為 5.0。

無法改變某些數位媒體格式的播放速率。 使用 IWMPSettings.isAvailable 屬性 (在 C# 中， IWMPSettings.get_isAvailable 方法) ，以探索是否可以針對特定媒體專案指定此屬性。

範例

下列範例會使用數值下移控制項，讓使用者變更目前媒體的播放速度。 當使用者按一下控制項的向上或向下箭號時， rate 屬性會設定為新的值。 控制項中可能的值範圍是 0.5 (半速) 到 2.0 (雙速度) 。 AxWMPLib.AxWindowsMediaPlayer物件是由名為 player 的變數表示。

private void playbackRate_Click(object sender, System.EventArgs e)
{
    // Get the new value of the control, and cast it from decimal to double.
    double newRate = (double)((System.Windows.Forms.NumericUpDown)sender).Value;

    // Test whether playback rate can be set. 
    if( player.settings.get_isAvailable("Rate") )
    {
        // Set the playback rate to the new value.
        player.settings.rate = newRate;
    }
}


Public Sub playbackRate_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playbackRate.Click

    '  Get the new value of the control as a double.
    Dim nUpDown As System.Windows.Forms.NumericUpDown = sender
    Dim newRate As Double = nUpDown.Value

    '  Test whether playback rate can be set. 
    If (player.settings.isAvailable("Rate")) Then

        '  Set the playback rate to the new value.
        player.settings.rate = newRate

    End If

End Sub

規格需求

需求 值
版本
 Windows 媒體播放機 9 系列或更新版本
命名空間
 WMPLib
組件
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另請參閱

IWMPControls.fastForward (VB 和 C#)

IWMPControls.fastReverse (VB 和 C#)

IWMPSettings 介面 (VB 和 C#)

IWMPSettings.isAvailable (VB 和 C#)

IWMPSettings.mute (VB 和 C#)