PARAM 要素
[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
PARAM 要素は、プレイリストまたはプレイリストの要素に関連付けられたカスタム パラメーターを定義します。
<PARAM
NAME = "parameter name"
VALUE = "parameter value"
/>
パラメーター
パラメーターは、 ASX タグの直後にこの要素を配置することで、個々のクリップではなくショーに関連付けることもできます。 これらの項目は、名前と 0 で始まるインデックス値によって参照されます。
注意
この ASX 要素は、Windows メディア プレーヤー バージョン 6.01 以降でのみ使用できます。 Microsoft Internet エクスプローラー 5 の標準インストールには、互換性のあるバージョンのWindows メディア プレーヤーが含まれています。
属性
名前
パラメーター値にアクセスするために使用される名前。 名前には任意の有効な文字列を指定できます。 次の文字列は既に定義されています。
| String | 説明 |
|---|---|
| AllowShuffle | VALUE 属性は、メタファイルプレイリストでWindows メディア プレーヤーシャッフル機能がエントリをランダムな順序で再生できるかどうかを指定します。 VALUE 属性は、"Yes" または "No" に設定できます。 既定値は "いいえ" です。 |
| CanPause | VALUE 属性は、ユーザーが再生を一時停止できるかどうかを指定します。 VALUE 属性は、"Yes" または "No" に設定できます。 既定値は "Yes" です。 |
| CanSeek | VALUE 属性は、シーク バー、早送り、または高速反転を使用して、ユーザーが現在の再生位置を変更できるかどうかを指定します。 VALUE 属性は、"Yes" または "No" に設定できます。 既定値は "Yes" です。 |
| CanSkipBack | VALUE 属性は、ユーザーが [前へ] をクリックして前のプレイリスト項目に戻ることができるかどうかを指定します。 VALUE 属性は、"Yes" または "No" に設定できます。 既定値は "Yes" です。 |
| CanSkipForward | VALUE 属性は、ユーザーが [次へ] をクリックして次のプレイリスト項目に進むことができるかどうかを指定します。 VALUE 属性は、"Yes" または "No" に設定できます。 既定値は "Yes" です。 |
| CPRadioID | VALUE 属性は、タイプ 1 のオンライン ストアによって提供される無線フィードの ID を指定します。 つまり、 VALUE 属性は、オンライン ストアのカタログ内のいずれかのラジオ フィードの RadioID フィールドと等しい必要があります。 親要素は ASX 要素です。 |
| エンコード | VALUE 属性は"utf-8" に設定され、メタファイルが Unicode (UTF-8) でエンコードされたファイルであることを示します。 |
| HtmlFlink | VALUE 属性は、タイプ 1 のオンライン ストアによって提供される文字列です。 Windows メディア プレーヤーは、オンライン ストアのプラグインによって実装される IWMPContentPartner::GetItemInfo メソッドに文字列を渡します。 GetItemInfo メソッドは、プレーヤーの [再生中] ウィンドウに表示する Web ページの URL を返します。 Web ページは、 External オブジェクトが型 1 ストアに公開するすべてのメソッドにアクセスできます。 これらのメソッドの一覧については、「 Type 1 Online Stores の外部オブジェクト」を参照してください。 |
| HTMLView | VALUE 属性は、親要素が ASX 要素であるか ENTRY 要素であるかに応じて、プレイリストまたは現在のエントリの期間中、フル モード Player の [再生中] ウィンドウに表示される URL を指定します。 HTMLView は、Windows メディア プレーヤー コントロールではサポートされていません。 |
| Log:FieldName[:NameSpace] | VALUE 属性は、指定されたログ フィールドが設定される値を指定します。 NAME 属性の :NameSpace 部分は省略可能です。 |
| Prebuffer | VALUE 属性は、次のプレイリストエントリが現在のエントリの終了前にバッファリングを開始するかどうかを指定します。これにより、シームレスな切り替えが可能になります。 VALUE 属性は、"true" または "false" に設定できます。 |
| ShowWhileBuffering | VALUE 属性は、現在の ENTRY 要素によって参照されるイメージ ファイルが、次のプレイリスト エントリがバッファーに格納されている間、指定した期間を過ぎても表示し続けるかどうかを指定します。 VALUE 属性は、"true" または "false" に設定できます。 |
VALUE
このパラメーターに関連付けられている値。 数値または文字列値を指定できます。
親/子要素
| Hierarchy | 要素 |
|---|---|
| 親要素 | ASX、 ENTRY |
| 子要素 | なし |
解説
この要素を使用すると、ユーザーは各クリップに関する追加情報を、それを含む ENTRY 要素内に配置できます。 プレイリスト ENTRY で指定されたメタデータ情報を取得するには、 Media を使用します。getItemInfo メソッド。 メディア。getItemInfo メソッドは、パラメーターの名前を指定して VALUE 属性の値を取得します。 以前のバージョンのWindows メディア プレーヤーは、パラメーターの名前とエントリのインデックス番号を指定した GetMediaParameter メソッドを使用して、プレイリスト ENTRY で指定されたメタデータ情報を取得します。
パラメーターは、 ASX タグの直後にこの要素を配置することで、個々のクリップではなくショーに関連付けることもできます。 これらの項目は、名前と 0 で始まるインデックス値によって参照されます。
注:
この ASX 要素は、Windows メディア プレーヤー バージョン 6.01 以降でのみ使用できます。 Microsoft Internet エクスプローラー 5 の標準インストールには、互換性のあるバージョンのWindows メディア プレーヤーが含まれています。
例
<ASX VERSION="3.0">
<TITLE>Example Media Player Show</TITLE>
<PARAM NAME="Director" VALUE="Jane D." />
<ENTRY>
<TITLE>Example Clip</TITLE>
<REF HREF="https://sample.microsoft.com/media.asf" />
<PARAM NAME="Location" VALUE="North America" />
<PARAM NAME="Release Date" VALUE="March 1998" />
</ENTRY>
<ENTRY>
<TITLE>Another Clip</TITLE>
<REF HREF="https://sample.microsoft.com/more_media.asf" />
<PARAM NAME="Location" VALUE="Japan">
<PARAM NAME="Release Date" VALUE="December 1996" />
</ENTRY>
</ASX>
要件
| 要件 | 値 |
|---|---|
| Version |
バージョン 7.0 以降Windows メディア プレーヤー、定義済みの NAME 属性には Windows メディア プレーヤー 9 シリーズ以降が必要です。事前に定義された名前 CanPause、CanSeek、CanSkipBack、CanSkipForward には、Windows メディア プレーヤー 10 以降が必要です |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示