Player.playState
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
playState屬性會擷取值,指出Windows 媒體播放機作業的狀態。
Syntax
播放程式 。playState
可能的值
此屬性是唯讀 的數位 (長) 。 C 樣式列舉常數可以藉由將狀態值前面加上 「wmpps」 來衍生。 例如,Playing 狀態的常數是 wmppsPlaying。
值 | State | 描述 |
---|---|---|
0 | 未定義 | Windows 媒體播放機處於未定義的狀態。 |
1 | 已停止 | 目前媒體專案的播放已停止。 |
2 | 已暫停 | 目前媒體專案的播放已暫停。 當媒體專案暫停時,繼續播放會從相同的位置開始。 |
3 | 正在播放 | 目前媒體專案現正播放。 |
4 | ScanForward | 目前的媒體專案是快速轉送。 |
5 | ScanReverse | 目前的媒體專案正在快速回復。 |
6 | 緩衝 | 目前的媒體專案會從伺服器取得其他資料。 |
7 | 等候中 | 已建立連線,但伺服器未傳送資料。 等候會話開始。 |
8 | MediaEnded | 媒體專案已完成播放。 |
9 | 轉換中 | 準備新的媒體專案。 |
10 | 就緒 | 準備好開始播放。 |
11 | 重新連線 | 重新連線至資料流程。 |
備註
Windows 媒體播放機狀態不保證會以任何特定順序發生。 此外,並非每個狀態一定會在事件序列期間發生。 您不應該撰寫依賴狀態順序的程式碼。
範例
下列 JScript 程式碼顯示 玩家的使用。playState 屬性。 名為 「myText」 的 HTML 文字專案會顯示目前的狀態。 Player物件是以識別碼 = 「Player」 建立的。
// Test whether Windows Media Player is in the playing state.
if (3 == Player.playState)
myText.value = "Windows Media Player is playing!";
else
myText.value = "Windows Media Player is NOT playing!";
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應