Player.PlayStateChange 事件

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

PlayStateChange事件發生于playState屬性有所變更時。

語法

Player.PlayStateChange(
  NewState
)

參數

NewState

number (long) ，指定新的 playState。 如需可能值的資料表，請參閱 playState 。

傳回值

此事件不會傳回值。

備註

事件參數的值是由Windows 媒體播放機指定，而且可以使用指定的參數名稱，存取或傳遞至匯入 JScript 檔案中的方法。 此參數名稱必須完全符合所示的類型，包括大寫。

Windows 媒體播放機狀態不保證會以任何特定順序發生。 此外，並非每個狀態都必須在事件序列期間發生。 您不應該撰寫依賴狀態順序的程式碼。

範例

下列範例示範 Player的事件處理常式。playStateChange 事件。 名為 「myText」 的 HTML 文字元素會顯示新的播放狀態。 播放機物件是以識別碼 = 「Player」 建立。

<SCRIPT LANGUAGE = "JScript"  FOR = Player EVENT = playStateChange(NewState)>

// Test for the player current state, display a message for each.
switch (NewState){
    case 1:
        myText.value = "Stopped";
        break;

    case 2:
        myText.value = "Paused";
        break;

    case 3:
        myText.value = "Playing";
        break;

    // Other cases go here.

    default:
        myText.value = "";
}
</SCRIPT>

規格需求

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

另請參閱

Player 物件

Player.playState