ASX 要素

  • [アーティクル]

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

ASX 要素は、ファイルをメタファイルとして定義します。

<ASX
   VERSION = "number"
   PREVIEWMODE = "YES" | "NO"
   BANNERBAR = "AUTO" | "FIXED"
>
</ASX>

属性

VERSION (必須)

メタファイルの構文のバージョン番号を表す 10 進数。 3 または 3.0 に設定します。

PREVIEWMODE (省略可能)

最初のクリップを再生する前Windows メディア プレーヤープレビュー モードに入るかどうかを示す値。

次のいずれかの値を指定する必要があります。

値 説明
YES Windows メディア プレーヤーは、最初のクリップを再生する前にプレビュー モードに入ります。
NO 既定値。 Windows メディア プレーヤーは、最初のクリップを再生する前にプレビュー モードになりません。

BANNERBAR (省略可能)

バナー グラフィックの領域Windows メディア プレーヤー予約するかどうかを示す値。

次のいずれかの値を指定する必要があります。

値 説明
AUTO 既定値。 Windows メディア プレーヤーは、コンテンツの一部にバナー バーが含まれている場合にのみ、バナー バーの領域を予約します。
FIXED Windows メディア プレーヤーは、関連するバナーがあるかどうかに関係なく、再生されるすべてのコンテンツのバナー グラフィックの固定スペースを予約します。

親/子要素

Hierarchy 要素
親要素 [なし] : ASX 要素は、すべてのメタファイルの最初の要素である必要があります。
子要素 ABSTRACT、 AUTHOR、 BANNER、 BASE、 COPYRIGHT、 ENTRY、 ENTRYREF、 EVENT、 MOREINFO、 PREVIEWDURATION、 PARAM、 REPEAT、 TITLE

解説

メタファイルプレイリストの最初の4文字は"ASX"<である必要があります。 ASX 要素のスコープ内で定義されている他の要素 (TITLE、AUTHOR など) は、Windows メディア プレーヤーによって表示される show 情報に関連付けられます。

Windows メディア プレーヤーの場合、構文のバージョン番号は 3.0 です。 Windows メディア プレーヤーでは、以前のすべてのバージョンのメタファイル構文がサポートされています。 VERSION 属性に使用できる値には、3.0 と 3 の両方が含まれます (小数点なし)。

PREVIEWMODE 属性の値が YES の場合、Windows メディア プレーヤーは最初のクリップを再生する前に直ちにプレビュー モードになります。 Windows メディア プレーヤーがプレビュー モードになると、メタファイルで参照されている各クリップがプレビューされます。 PREVIEWDURATION 要素は、各プレビューの期間を決定します。

BANNERBAR 属性は、バナー グラフィックの領域Windows メディア プレーヤー予約するかどうかを定義します。 バナーは、メディア コンテンツの再生中にビデオ表示領域に表示されるグラフィックです。 (コンテンツにバナーを追加するには、BANNER 要素を使用します)。BANNERBAR の値が FIXED の場合、Windows メディア プレーヤーは、メディア コンテンツにバナーがあるかどうかに関係なく、すべてのメディア コンテンツのバナー領域を予約します。 メディア コンテンツの一部にバナーが関連付けられていない場合、そのメディア コンテンツ用に予約されている領域は黒になります。 BANNERBAR 属性の値が AUTO の場合、Windows メディア プレーヤーはメディア コンテンツに含まれている場合にのみバナーの領域を予約します。

複数のクリップ (ENTRY 要素または ENTRYREF 要素) を含むメタファイルを作成し、BANNERBAR 属性の値を AUTO に設定すると、Windows メディア プレーヤーは 1 つのクリップのバナー グラフィックのスペースを許可するようにサイズを変更し、次のクリップにバナー グラフィックが含まれていない場合は再びサイズを変更できます。 ウィンドウのサイズを同じにする場合 (ビデオ サイズが変更された場合を除く)、 BANNERBAR 属性に FIXED 値を使用します。

バナー グラフィック用に予約されているスペースは、高さ 32 x 幅 194 ピクセルです。 予約済み領域は、レンダリングされたビデオ コンテンツの下に表示され、ビデオ領域の下端の 6 ピクセル上に表示され、6 ピクセルのビデオ領域の境界線にスペースを確保できます。 予約済みのバナースペースは水平方向の中央に配置されます。

Windows メディア プレーヤーバナー領域の左端のピクセルで始まるグラフィックをレンダリングします。 グラフィックがスペース全体を塗りつぶすと、水平方向の中央に表示されます。 それ以外の場合は、末尾にスペースがあります。 WINDOWS メディア プレーヤーの最小幅は、BANNERBAR 属性の値に関係なく、ビデオ クリップのサイズよりも常に広くなります。

例

<ASX VERSION="3.0" PREVIEWMODE="YES" BANNERBAR="auto"  >
   <ENTRY HREF="https://sample.microsoft.com/sample1.ASX" />
</ASX>

要件

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

関連項目

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

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