Settings.setMode 方法

  • 發行項

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

setMode方法會將各種模式設定為作用中或非作用中。

語法

Settings.setMode(
  modeName,
  state
)

參數

modeName [in]

字串 ，指定要變更之模式的名稱，其中包含下列其中一個值。

字串 描述
autoRewind 模式，指出播放到結尾之後，曲目是否會重新交錯到開頭。 預設狀態為 true。
loop 指出追蹤序列是否重複本身的模式。 預設狀態為 false。
showFrame 模式，指出未播放時，最接近的視訊主要畫面格是否顯示在目前的位置。 預設狀態為 false。 對音訊播放軌沒有任何作用。
隨機播放 指出曲目是否以隨機順序播放的模式。 預設狀態為 false。

狀態 [in]

布林值 ，指定新的指定模式是否為使用中。

傳回值

這個方法不會傳回值。

備註

當 showFrame 模式處於作用中狀態時，播放機必須存取播放軌內容以擷取視訊畫面。 由於頻寬考慮，請在播放非本機內容時謹慎使用此模式。

規格需求

需求 值
版本
 針對迴圈和隨機顯示模式，Windows 媒體播放機 7.0 版或更新版本。 針對 autoRewind 和 showFrame 模式，Windows 媒體播放機 9 系列或更新版本。
DLL
Wmp.dll

另請參閱

Settings 物件

Settings.getMode