AxWindowsMediaPlayer 物件的 ScriptCommand 事件

  • 發行項

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

當收到同步處理命令或 URL 時，就會發生 ScriptCommand 事件。

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

事件資料

與此事件相關聯的處理常式類型為 AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler。 此處理程式會收到類型 為 AxWMPLib._WMPOCXEvents_ScriptCommandEvent的引數，其中包含與這個事件相關的下列屬性。

屬性 描述
scType System.String 指定指令碼命令的類型。
參數 System.String 指定指令碼命令。

備註

命令可以內嵌在 Windows 媒體檔案或資料流程的音效和影像中。 命令是一對與資料流程中指定時間相關聯的 Unicode 字串。 當資料流程到達與命令相關聯的時間時，Windows 媒體播放機控制項會傳送具有兩個參數的ScriptCommand事件。 一個參數會指定要傳送的命令類型，而另一個參數則指定命令。 參數的類型可用來判斷命令參數的處理方式。 任何類型的命令都可以內嵌在 ScriptCommand 事件所處理的檔案或資料流程中。

下表列出Windows 媒體播放機自動處理的指令碼命令類型。

類型 描述
CAPTION 控制項會在 IWMPClosedCaption 所指定的 HTML 專案中顯示相關聯的文字。captioningId。
事件 控制項會執行為指定事件定義的指令。
檔案名 控制項會重設其 URL 屬性、嘗試開啟指定的檔案，並開始立即播放新的資料流程。
OPENEVENT 緩衝相關聯的 EVENT 類型命令，以及時執行 EVENT 腳本。
SYNCHRONIZEDLYRICLYRIC param參數包含同步的 lyric 文字。 Windows 媒體播放機會在[立即播放] 功能的關閉標題區域中顯示 lyric 文字。
TEXT 控制項會在 IWMPClosedCaption 所指定的 HTML 專案中顯示相關聯的文字。captioningId。
URL 如果 IWMPSettings，控制項會自動開啟使用預設網際網路瀏覽器指定的 URL。invokeURLs 屬性設定為 true。

只要您提供程式碼來處理命令，就可以內嵌任何其他類型的命令。 雖然Windows 媒體播放機控制項會忽略未知的命令，但它們仍會交給ScriptCommand事件。

如果在快速向前或倒轉模式中掃描檔案，則不會呼叫 ScriptCommand 事件。

如果 IWMPSettings，系統會自動在預設網頁瀏覽器中叫用Windows 媒體播放機控制項所接收的 URL 命令。invokeURLs屬性設定為 true。 您可以使用 IWMPSettings。defaultFrame 屬性可指定網頁出現的目標框架。

傳送至Windows 媒體播放機的 URL 會相對於 IWMPSettings 所指定的基底 URL 進行處理。baseURL屬性。 基底 URL 會與相對 URL 串連，導致 ScriptCommand 事件以命令參數的形式傳遞的完整指定 URL。

Windows 媒體播放機控制項一律會以下列方式處理傳入 URL 命令：

  1. 收到 URL 類型命令。
  2. IWMPSettings。baseURL 是用來從指令碼命令中指定的相對 URL 建立完整 URL。
  3. 呼叫 ScriptCommand 。
  4. 在 ScriptCommand 傳回之後，IWMPSettings。已檢查 invokeURLs。
  5. 如果 IWMPSettings。invokeURLs 為 true，而命令為 URL 命令，則會叫用指定的 URL。 如果 IWMPSettings。invokeURLs 為 false，或如果命令不是 URL 命令，則會忽略命令。

撰寫 Windows 媒體檔案時，您可以藉由串連兩個 ampersand 和參數欄位中的框架名稱，來指定顯示新 URL 的框架。 下列範例說明典型的 ScriptCommand 參數。 它會指定必須在 myframe 框架中啟動 URL mypage 。

scType = "URL"
Param = https://myweb/mypage.html&&myframe

如果正在掃描檔案，則不會呼叫 ScriptCommand 事件， (快速轉送或重新轉送) 。

規格需求

需求 值
版本
 Windows 媒體播放機 9 系列或更新版本
命名空間
 AxWMPLib
組件
AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

另請參閱

AxWindowsMediaPlayer 物件 (VB 和 C#)

AxWindowsMediaPlayer.URL (VB 和 C#)

IWMPClosedCaption.captioningId (VB 和 C#)

IWMPSettings.baseURL (VB 和 C#)

IWMPSettings.defaultFrame (VB 和 C#)

IWMPSettings.invokeURLs (VB 和 C#)