EVENT 元素

  • 發行項

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

EVENT元素會在收到標示為事件的指令碼命令時，定義Windows 媒體播放機所採取的行為或動作。

<EVENT   
   NAME = "text string"
   WHENDONE = "RESUME" | "NEXT" | "BREAK"
>
</EVENT>

屬性

需要名稱 ()

事件的名稱。

需要 WHENDONE ()

值，定義Windows 媒體播放機播放參考內容之後所執行的作業。

可能具有下列值。

值 描述
RESUME 目前專案 (事件中斷，) 繼續播放。 如果內容是儲存的內容，它會在停止的相同時間點繼續;如果內容是廣播的，則會繼續在目前的位置。
NEXT 下一個ENTRY元素會播放，就像事件未發生一樣，而且Windows 媒體播放機已到達目前剪輯的結尾。
BREAK 如果目前的專案位於 REPEAT 迴圈內，迴圈就會終止，就像重複計數已完成一樣。 否則，Windows 媒體播放機跳到播放清單結尾，就像最後一個專案如往常一樣完成。

父元素/子項目

階層 元素
父元素 ASX
子元素 ENTRY、 ENTRYREF

備註

此元素定義Windows 媒體播放機收到標示為事件的指令碼命令時所採取的行為或動作。 事件是內嵌在傳送至Windows 媒體播放機的資料流程中內嵌的特定指令碼命令類型，其中包含雙字串。 第一個字串是 「event」 這個字，而第二個字串則是事件名稱。 第二個字串中的事件名稱必須符合中繼檔中定義的事件名稱。 (比對不區分大小寫。) 事件可以傳送至接收即時串流Windows 媒體播放機，也可以儲存在傳遞為隨選單播資料流程的 .asf、.wma 或 .wmv 檔案中。 當Windows 媒體播放機收到指令碼命令時，它會處理EVENT元素所定義的事件。

此元素會定義每當Windows 媒體播放機使用具名事件接收指令碼命令時，所處理的ENTRY或ENTRYREF專案範圍。 ENTRYREF可以是指向 ASP 頁面的 URL。 使用這個專案，您可以指定近乎即時的串流切換行為，而不是使用其他內容片段或 Windows 媒體中繼檔參考預先撰寫的串流變更。

當您使用 ASP 頁面來產生播放清單時，您必須指定回應的值。ContentType屬性和Response。因為Windows 媒體播放機延遲問題，所以 ASP 頁面中的屬性會過期。 回應。ContentType必須是 Windows Media 中繼檔的有效副檔名。 有效型別包括 .asf、.asx、.wma、.檢視、.wmv 和 .wvx。

如需在 ASP 中使用 Response 物件的詳細資訊，請參閱 Platform SDK。

這個元素可以出現在 ASX 元素內的任何位置。 如果ASX元素內的多個EVENT元素對其NAME屬性具有相同的值，Windows 媒體播放機會使用ASX元素內的第一個出現專案，並忽略所有其他專案。 當 EVENT 元素具有相異 的 NAME 屬性時， ASX 元素內的順序並不重要。

Windows 媒體播放機捨棄處理另一個事件時收到的事件。 不支援事件巢狀。 當Windows 媒體播放機處於預覽模式時，事件內容不會受到PREVIEWDURATION元素的限制;即使作用中ENTRY元素的預覽持續時間在事件結束之前到期，事件內容的完整長度仍可播放。

範例

在此範例中，當Windows 媒體播放機在串流媒體中收到指令碼命令 EVENT 和命令字串 「Adlink」時，它會搜尋播放清單中的EVENTNAME 「Adlink」。 Windows 媒體播放機從正在轉譯的資料流程切換，並播放EVENT 「 https://example.microsoft.com/adlink.htm" ;」 中所參考的內容。

ENTRY 屬性 CLIENTSKIP 設定為 NO，以防止略過 EVENT 剪輯。 必須播放它。

腳本 WHENDONE="RESUME" 會指示Windows 媒體播放機在 Adlink.asf 完成時，繼續播放先前的媒體。

<ASX VERSION="3.0">
<ENTRY CLIENTSKIP="NO">
   <REF HREF="https://example.microsoft.com/clip1.asf" />
</ENTRY>
<EVENT NAME="Adlink" WHENDONE="RESUME">
   <ENTRYREF HREF="https://example.microsoft.com/adlink.htm" 
       CLIENTSKIP="NO" />
</EVENT>
</ASX>

規格需求

需求 值
版本
 Windows 媒體播放機 7.0 版或更新版本

另請參閱

Windows Media 中繼檔元素參考

Windows Media 中繼檔參考

Windows 媒體播放機物件模型