Player.ScriptCommand イベント

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

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

構文

Player.ScriptCommand(
  scType,
  Param
)

パラメーター

scType

スクリプト コマンドの種類を指定する文字列。

Param

スクリプト コマンドを指定する文字列。

戻り値

このイベントでは値は返されません。

解説

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

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

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

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

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

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

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

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

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

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

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

イベント パラメーターの値は Windows メディア プレーヤー によって指定され、指定されたパラメーター名を使用して、インポートされた JScript ファイル内のメソッドにアクセスしたり、メソッドに渡すことができます。 このパラメーター名は、大文字と小文字を含めて、示されているとおりに入力する必要があります。

要件

要件	値
Version	バージョン 7.0 以降をWindows メディア プレーヤーします。
[DLL]	Wmp.dll

関連項目

Player オブジェクト

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs