PARAM 元素

  • 發行項

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

PARAM元素會定義與播放清單或播放清單元素相關聯的自訂參數。

<PARAM
   NAME = "parameter name"
   VALUE = "parameter value"
/>

參數

參數也可以與 show 建立關聯，而不是個別剪輯，方法是將這個專案直接放在 ASX 標記之後。 這些專案的名稱和以零開頭的索引值會參考這些專案。

注意

這個ASX元素僅適用于 Windows 媒體播放機 6.01 版和更新版本。 Microsoft Internet Explorer 5 的標準安裝包含相容版本的 Windows 媒體播放機。

屬性

名稱

用來存取參數值的名稱。 名稱可以是任何有效的字串。 已定義下列字串。

字串 描述
AllowShuffle VALUE屬性會指定中繼檔播放清單是否允許Windows 媒體播放機隨機播放專案。 VALUE屬性可以設定為 「Yes」 或 「No」。 預設值為 「No」。
CanPause VALUE屬性會指定使用者是否可以暫停播放。 VALUE屬性可以設定為 「Yes」 或 「No」。 預設值為 「Yes」。
CanSeek VALUE屬性會指定使用者是否可以使用搜尋列、快速向前或快速反轉來變更目前的播放位置。 VALUE屬性可以設定為 「Yes」 或 「No」。 預設值為 「Yes」。
CanSkipBack VALUE屬性指定使用者是否可以按一下 [上一步] 來跳回上一個播放清單專案。 VALUE屬性可以設定為 「Yes」 或 「No」。 預設值為 「Yes」。
CanSkipForward VALUE屬性指定使用者是否可以按一下 [下一步] 來跳到下一個播放清單專案。 VALUE屬性可以設定為 「Yes」 或 「No」。 預設值為 「Yes」。
CPRadioID VALUE屬性會指定類型 1 線上商店所提供的無線電摘要識別碼。 也就是說， VALUE 屬性必須等於線上商店目錄中其中一個無線電摘要的 RadioID 欄位。 父元素是 ASX 元素。
編碼 VALUE屬性設定為 「utf-8」，表示中繼檔是 Unicode (UTF-8) 編碼檔案。
HtmlFlink VALUE屬性是由類型 1 線上商店所提供的字串。 Windows 媒體播放機會將字串傳遞至線上商店外掛程式所實作的IWMPContentPartner：：GetItemInfo方法。 GetItemInfo方法會傳回網頁的 URL，以顯示在播放機的 [立即播放] 窗格中。 網頁可存取 外部 物件公開給類型 1 存放區的所有方法。 如需這些方法的清單，請參閱 類型 1 Online Store 的外部物件。
HTMLView VALUE屬性會指定 URL，根據父元素是ASX元素或ENTRY元素而定，在播放清單期間或目前專案的完整模式播放窗格中顯示。 Windows 媒體播放機 控制項不支援 HTMLView。
Log：FieldName[：NameSpace] VALUE屬性會指定指定的記錄欄位將設定為 的值。 NAME屬性的 ：NameSpace部分是選擇性的。
Prebuffer VALUE屬性會指定下一個播放清單專案是否開始緩衝處理目前專案結尾，這可讓轉換順暢。 VALUE屬性可以設定為 「true」 或 「false」。
ShowWhileBuffering VALUE屬性會指定目前ENTRY元素所參考的影像檔是否會在緩衝處理下一個播放清單專案時，繼續顯示超過其指定的持續時間。 VALUE屬性可以設定為 「true」 或 「false」。

VALUE

與此參數相關聯的值。 它可以是數值或字串值。

父/子項目

階層 元素
父元素 ASX， ENTRY
子元素 無

備註

這個專案可讓使用者將每個剪輯的其他資訊放在包含它的 ENTRY 元素內。 若要擷取播放清單 ENTRY中指定的中繼資料資訊，請使用 媒體。getItemInfo 方法。 媒體。getItemInfo方法會擷取VALUE屬性的值，指定參數的名稱。 舊版的 Windows 媒體播放機擷取播放清單ENTRY中指定的中繼資料資訊，方法是使用GetMediaParameter方法來指定參數的名稱和專案的索引編號。

參數也可以與 show 建立關聯，而不是個別剪輯，方法是將這個專案直接放在 ASX 標記之後。 這些專案的名稱和以零開頭的索引值會參考這些專案。

注意

這個ASX元素僅適用于 Windows 媒體播放機 6.01 版和更新版本。 Microsoft Internet Explorer 5 的標準安裝包含相容版本的 Windows 媒體播放機。

範例

<ASX VERSION="3.0">
   <TITLE>Example Media Player Show</TITLE>
   <PARAM NAME="Director" VALUE="Jane D." />
   
   <ENTRY>
      <TITLE>Example Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/media.asf" />
      <PARAM NAME="Location" VALUE="North America" />
      <PARAM NAME="Release Date" VALUE="March 1998" />
   </ENTRY>
   
   <ENTRY>
      <TITLE>Another Clip</TITLE>
      <REF HREF="https://sample.microsoft.com/more_media.asf" />
      <PARAM NAME="Location" VALUE="Japan">
      <PARAM NAME="Release Date" VALUE="December 1996" />
   </ENTRY>
</ASX>

規格需求

需求 值
版本
 Windows 媒體播放機 7.0 版或更新版本，預先定義的 NAME 屬性需要Windows 媒體播放機 9 系列或更新版本，Windows 媒體播放機 10 或更新版本是預先定義名稱 CanPause、CanSeek、CanSkipBack 和 CanSkipForward 的必要專案

另請參閱

在 Windows 媒體播放機 中顯示網頁

記錄資料流程資料

Windows 媒體中繼檔專案參考

Windows 媒體中繼檔參考