REF 要素

  • [アーティクル]

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

REF 要素は、デジタル メディア コンテンツの URL を指定します。

<REF
   HREF = "URL"
>
</REF>

属性

HREF (必須)

Windows メディア プレーヤーでサポートされているメディア コンテンツの任意の部分への URL。

親/子要素

Hierarchy 要素
親要素 エントリ
子要素 DURATION、 ENDMARKER、 PREVIEWDURATION、 STARTMARKER、 STARTTIME

解説

この要素は、メディア コンテンツの一部の URL を指定します。 URL は、Windows メディア プレーヤーでサポートされている任意のプロトコルを使用して、サポートされている任意のメディアの種類を指すことができます。

サポートされているメディアの種類には、.gifや.jpgイメージなどの静止画像、.swf ファイル名拡張子を持つ Flash ファイルが含まれます。 これらのメディアタイプは、プレイリスト内に広告コンテンツを含めるのに役立ちます。 イメージ ファイルと Flash ファイルがループで再生される場合は、REF 要素内に DURATION 要素を含めることで、メディア項目を表示する時間も指定する必要があります。 プレイリスト内の次のエントリがバッファーされている間にイメージの表示を継続する場合は、ENTRY 要素内に PARAM 要素を含め、その name 属性を ShowWhileBuffering に設定し、その value 属性を true に設定します。

CD またはそれを許可する DVD 上のコンテンツを参照するために、wmpcd プロトコルと wmpdvd プロトコルが提供されます。 たとえば、 HREF 属性を "wmpdvd://f/5/3" に設定すると、DVD のタイトル 5 の第 3 章が再生されますが、DVD が作成されて許可されている場合にのみ再生されます。

ファイアウォールの背後からデジタル メディアを開くアプリケーションでは、IP アドレスではなくドメイン ネーム サーバー (DNS) 名を使用してアドレスが指定されている場合、メディア項目を開くときにパフォーマンスが向上します。

この要素の最も一般的な用途は、URL ロールオーバーです。 Windows メディア プレーヤー REF 要素で定義されているメディアの一部を開くことができない場合は、次の REF 要素で URL を試みます。 Windows メディア プレーヤー 1 つの ENTRY 要素のスコープ内で定義された URL からメディア コンテンツを開くと、その ENTRY 要素内の後続の REF タグは無視されます。 コンテンツの再生が完了すると、次の ENTRY 要素 (存在する場合) に移動Windows メディア プレーヤー。

  • 大事なWindows メディア プレーヤーが参照先コンテンツへの接続を確立すると、接続が正常に終了するか異常終了したかに関係なく、その ENTRY 内の他のすべての REF 要素は無視されます。

参照されるメディア項目がイメージ ファイルの場合は、 DURATION 要素を使用してイメージの表示時間を指定する必要があります。

注:

最初のフレームでサウンドを含む Flash メディアを再生しようとすると、予期しない結果が発生する可能性があります。 2 番目のフレームより早く開始してサウンドを再生するには、Flash コンテンツを作成する必要があります。

例

<ASX VERSION="3.0">
   <ENTRY>
   <TITLE>Example Clip</TITLE>
      <REF HREF="mms://example.microsoft.com/selection1.asf" />
      <REF HREF="mms://sample.microsoft.com/mirror/selection1.asf" />
   </ENTRY>
</ASX>

要件

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

関連項目

サポートされているプロトコルとファイルの種類

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

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