Player 物件

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

Player 物件是Windows 媒體播放機控制項的根物件。 它支援下表所列的屬性、方法和事件。

Player 物件支援下列屬性。 以星號標示的屬性 (*) 無法供面板存取。

屬性	描述
cdromCollection	擷取 CdromCollection 物件。
closedCaption	擷 取 ClosedCaption 物件。
控制	擷取 Controls 物件。
currentMedia	指定或擷取目前的 Media 物件。
currentPlaylist	指定或擷取目前的 Playlist 物件。
Dvd	擷取 DVD 物件。
enableCoNtextMenu *	指定或擷取值，指出是否要啟用操作功能表，當按一下滑鼠右鍵時會出現。
啟用 *	指定或擷取值，指出是否啟用Windows 媒體播放機控制項。
error	擷取 Error 物件。
全屏 *	指定或擷取值，指出是否以全螢幕模式播放視訊內容。
isOnline	擷取值，指出使用者是否已連線到網路。
isRemote *	擷取值，指出Windows 媒體播放機控制項是否以遠端模式執行。
mediaCollection	擷 取 MediaCollection 物件。
network	擷取 Network 物件。
openState	擷取值，指出內容來源的狀態。
playerApplication *	當遠端Windows 媒體播放機控制項正在執行時，擷取PlayerApplication物件。
playlistCollection	擷取 PlaylistCollection 物件。
playState	擷取值，指出Windows 媒體播放機作業的狀態。
設定	擷取 Settings 物件。
status	擷取值，指出Windows 媒體播放機的目前狀態。
stretchToFit *	指定或擷取值，指出視訊是否會延展以符合控制項視訊顯示Windows 媒體播放機的大小。
uiMode *	指定或擷取值，指出當網頁內嵌Windows 媒體播放機時，使用者介面中顯示的控制項。
URL	指定或擷取要播放之剪輯的名稱。
versionInfo	擷取指定Windows 媒體播放機版本的 String 值。
windowlessVideo *	指定或擷取值，指出Windows 媒體播放機控制項是否以無視窗模式轉譯視訊。

 

* 無法存取面板。

Player 物件支援下列方法。

方法	描述
close	發行Windows 媒體播放機資源。
launchURL	將 URL 傳送給要轉譯之使用者的預設瀏覽器。
newMedia	建立新的 Media 物件。
newPlaylist	建立新的 Playlist 物件。
openPlayer	使用指定的 URL 開啟Windows 媒體播放機。

 

Player 物件支援下列事件。 以星號標示的事件 (*) 無法存取面板。 如需在面板中處理滑鼠和鍵盤事件的相關資訊，請參閱 外來事件。

事件	描述
AudioLanguageChange	發生于目前的音訊語言變更時。
緩衝處理	發生于Windows 媒體播放機控制項開始或結束緩衝時。
CdromMediaChange	當 CD 或 DVD 插入或退出 CD 或 DVD 磁片磁碟機時發生。
點擊 *	發生于使用者按一下滑鼠按鍵時。
CurrentItemChange	發生于 控制項時。currentItem 變更。
CurrentMediaItemAvailable	發生于目前媒體專案中的圖形中繼資料專案變成可用時。
CurrentPlaylistChange	發生于目前播放清單內變更的專案時。
CurrentPlaylistItemAvailable	發生于目前的播放清單專案變成可用時。
中斷連線	保留供未來使用。
DomainChange	發生于 DVD 網域變更時。
按兩下 *	發生于使用者按兩下滑鼠按鍵時。
DurationUnitChange	保留供未來使用。
EndOfStream	保留供未來使用。
錯誤	發生于Windows 媒體播放機控制項有錯誤狀況時。
KeyDown *	發生於按下按鍵時。
KeyPress *	發生于按下按鍵後放開時。
KeyUp *	發生於放開按鍵時。
MarkerHit	發生于到達標記時。
MediaChange	發生于媒體專案變更時。
MediaCollectionAttributeStringAdded	發生于將屬性值加入至程式庫時。
MediaCollectionAttributeStringChanged	發生于程式庫中的屬性值變更時。
MediaCollectionAttributeStringRemoved	發生于從程式庫移除屬性值時。
MediaCollectionChange	發生于媒體集合變更時。
MediaCollectionMediaAdded	當媒體專案新增至本機程式庫時發生。
MediaCollectionMediaRemoved	發生于從本機程式庫移除媒體專案時。
MediaError	發生于 Media 物件有錯誤狀況時。
ModeChange	發生于變更Windows 媒體播放機模式時。
MouseDown *	發生于按下滑鼠按鍵時。
MouseMove *	發生于移動滑鼠指標時。
MouseUp *	發生于放開滑鼠按鍵時。
NewStream	保留供未來使用。
OpenPlaylistSwitch	發生于 DVD 上的標題開始播放時。
OpenStateChange	發生于Windows 媒體播放機控制項變更狀態時。
PlaylistChange	發生于播放清單變更時。
PlaylistCollectionChange	發生于播放清單集合中的某個專案變更時。
PlaylistCollectionPlaylistAdded	發生于將播放清單新增至播放清單集合時。
PlaylistCollectionPlaylistRemoved	發生于從播放清單集合中移除播放清單時。
PlaylistCollectionPlaylistSetAsDeleted	保留供未來使用。
PlayStateChange	發生于Windows 媒體播放機控制項的播放狀態變更時。
PositionChange	發生于媒體專案的目前位置已變更時。
ScriptCommand	發生于收到同步處理的命令或 URL 時。
StatusChange	發生于 狀態 屬性變更值時。
StringCollectionChange	發生于字串集合變更時。
警告	保留供未來使用。

 

* 無法存取面板。 如需在面板中處理滑鼠和鍵盤事件的相關資訊，請參閱 環境事件處理常式。

內嵌在網頁中時，可以使用 OBJECT 標記中指定的識別碼值來存取 Player 物件。 在面板定義檔案內，會使用 玩家 全域屬性來存取它。 為了方便說明， 播放機 將會作為參考語法區段中的物件識別碼。

另請參閱

腳本的物件模型參考