AxWindowsMediaPlayer オブジェクトの ScriptCommand イベント

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

ScriptCommand イベントは、同期されたコマンドまたは URL を受信したときに発生します。

[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 スクリプト コマンドの種類を指定します。
param System.String スクリプト コマンドを指定します。

解説

コマンドは、Windows Media ファイルまたはストリームのサウンドとイメージの間に埋め込むことができます。 コマンドは、ストリーム内の指定された時刻に関連付けられた Unicode 文字列のペアです。 ストリームがコマンドに関連付けられている時間に達すると、Windows メディア プレーヤー コントロールは、2 つのパラメーターを持つ ScriptCommand イベントを送信します。 1 つのパラメーターは送信されるコマンドの種類を指定し、もう 1 つのパラメーターはコマンドを指定します。 パラメーターの型は、コマンド パラメーターの処理方法を決定するために使用されます。 ScriptCommand イベントによって処理されるファイルまたはストリームには、任意の種類のコマンドを埋め込むことができます。

次の表に、Windows メディア プレーヤーによって自動的に処理されるスクリプト コマンドの種類を示します。

Type 説明
キャプション コントロールは、IWMPClosedCaption によって指定された HTML 要素内の関連付けられたテキストを表示します。captioningId。
イベント コントロールは、指定したイベントに対して定義された命令を実行します。
Filename コントロールは URL プロパティをリセットし、指定されたファイルを開こうとし、新しいストリームの再生をすぐに開始します。
OPENEVENT EVENT スクリプトをタイムリーに実行するために、関連付けられている EVENT 型コマンドをバッファーに格納します。
SYNCHRONIZEDLYRIC param パラメーターには、同期された歌詞テキストが含まれています。 Windows メディア プレーヤー再生中機能の閉じたキャプション領域に歌詞テキストが表示されます。
[TEXT] コントロールは、IWMPClosedCaption によって指定された HTML 要素内の関連付けられたテキストを表示します。captioningId。
URL コントロールは、IWMPSettings の場合、既定のインターネット ブラウザーを使用して指定された URL を自動的に開きます。invokeURLs プロパティは true に設定されています。

コマンドを処理するコードを指定する限り、他の種類のコマンドを埋め込むことができます。 不明なコマンドはWindows メディア プレーヤー コントロールによって無視されますが、ScriptCommand イベントに引き続き渡されます。

ファイルが高速転送モードまたは巻き戻しモードでスキャンされている場合、ScriptCommand イベントは呼び出されません。

IWMPSettings の場合、Windows メディア プレーヤー コントロールによって受信された URL コマンドは、既定の Web ブラウザーで自動的に呼び出されます。invokeURLs プロパティは true に設定されています。 IWMPSettings を使用できます。web ページが表示されるターゲット フレームを指定する defaultFrame プロパティ。

Windows メディア プレーヤーに送信される URL は、IWMPSettings で指定されたベース URL を基準にして処理されます。baseURL プロパティ。 ベース URL は相対 URL と連結され、 ScriptCommand イベントによってコマンド パラメーターとして渡される完全に指定された URL になります。

Windows メディア プレーヤー コントロールは、常に次の方法で受信 URL コマンドを処理します。

  1. URL 型のコマンドが受信されます。
  2. IWMPSettings。baseURL は、script コマンドで指定された相対 URL から完全な URL を作成するために使用されます。
  3. ScriptCommand が呼び出されます。
  4. ScriptCommand が返されると、IWMPSettings が返されます。invokeURL がチェックされます。
  5. IWMPSettings の場合。invokeURLs は true で、コマンドは URL コマンドであり、指定された URL が呼び出されます。 IWMPSettings の場合。invokeURLs が false であるか、コマンドが URL コマンドでない場合、コマンドは無視されます。

Windows Media ファイルを作成するときに、パラメーター フィールドに 2 つのアンパサンドとフレーム名を連結することで、新しい URL を表示するフレームを指定できます。 次の例は、一般的な ScriptCommand パラメーターを 示しています。 url mypage を myframe フレームで起動する必要があることを指定します。

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

ファイルがスキャンされている場合 (高速転送または巻き戻し) 場合、ScriptCommand イベントは呼び出されません。

必要条件

要件 値
Version
 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#)