EVENT 要素

  • [アーティクル]

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

EVENT 要素は、イベントとしてラベル付けされたスクリプト コマンドを受け取ったときにWindows メディア プレーヤーによって実行される動作またはアクションを定義します。

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

属性

NAME (必須)

イベントの名前です。

WHENDONE (必須)

参照先のコンテンツを再生した後のWindows メディア プレーヤーの動作を定義する 値。

次の値を使用できます。

値 説明
RESUME 現在のエントリ (イベントによって中断されたクリップ) が再生を再開します。 コンテンツが格納されている場合、コンテンツは停止したのと同じ時点で再開されます。コンテンツがブロードキャストされている場合は、現在の位置で再開されます。
NEXT 次の ENTRY 要素は、イベントが発生せず、Windows メディア プレーヤーが現在のクリップの末尾に達したかのように再生されます。
BREAK 現在のエントリが REPEAT ループ内にある場合、 ループ は繰り返し数が完了したかのように終了します。 それ以外の場合、Windows メディア プレーヤーは、最終的なエントリが通常どおりに完了したかのようにプレイリストの末尾にジャンプします。

親/子要素

Hierarchy 要素
親要素 Asx
子要素 ENTRY、 ENTRYREF

解説

この要素は、イベントとしてラベル付けされたスクリプト コマンドを受け取ったときにWindows メディア プレーヤーによって実行される動作またはアクションを定義します。 イベントは、二重文字列で構成されるWindows メディア プレーヤーに送信されるストリームに埋め込まれた特定の種類のスクリプト コマンドです。 最初の文字列は "event" という単語で、2 番目の文字列はイベント名です。 2 番目の文字列のイベント名は、メタファイルで定義されているイベント名と一致している必要があります。 (一致では大文字と小文字は区別されません)。イベントは、リアルタイム ストリームを受信Windows メディア プレーヤーに送信することも、オンデマンドユニキャスト ストリームとして配信される .asf、.wma、または .wmv ファイルに保存することもできます。 Windows メディア プレーヤースクリプト コマンドを受け取ると、EVENT 要素によって定義されたイベントが処理されます。

この要素は、名前付きイベントを含むスクリプト コマンドWindows メディア プレーヤー受信するたびに処理される ENTRY 要素または ENTRYREF 要素のスコープを定義します。 ENTRYREF には、ASP ページを指す URL を指定できます。 この要素を使用すると、他のコンテンツまたは Windows Media メタファイルへの参照を使用して事前に作成されたストリーム変更とは対照的に、ストリーム切り替えの動作をほぼリアルタイムで指定できます。

ASP ページを使用してプレイリストを生成する場合は、Response の値を指定する必要があります。ContentType プロパティと Response。Windows メディア プレーヤーに関する待機時間の問題のため、ASP ページの expires プロパティ。 応答。ContentType は、Windows Media メタファイルの有効なファイル名拡張子である必要があります。 有効な型には、.asf、.asx、.wma、.wax、.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"。

EVENTクリップがスキップされないように、ENTRY 属性 CLIENTSKIP が NO に設定されています。 再生する必要があります。

このスクリプトWHENDONE="RESUME"は、Adlink.asf が完了したらすぐに切り替えた以前のメディアの再生を再開するようにWindows メディア プレーヤーに指示します。

<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>

必要条件

要件 値
Version
 Windows メディア プレーヤー バージョン 7.0 以降

関連項目

Windows Media メタファイル要素リファレンス

Windows Media メタファイル リファレンス

Windows メディア プレーヤー オブジェクト モデル