ServiceTask3 要素

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

Note

このセクションでは、オンライン ストアで使用するために設計された機能について説明します。 オンライン ストアのコンテキスト外でのこの機能の使用はサポートされていません。

ServiceTask3 要素は、3 番目のオンライン ストア作業ウィンドウを表します。

<ServiceTask3
    URL = "URL"
/>

属性

期間 説明
URL (必須)
Windows メディア プレーヤー表示される Web ページの URL。

親/子要素

Hierarchy 要素
親要素 ServiceInfo
子要素 ButtonTextButtonTip

解説

ServiceTask1 は、商業活動に関与するための主要な作業ウィンドウと見なされます。 これは、ユーザーが音楽の購入を選択したときに表示される作業ウィンドウです。 他のオンライン ストア アクティビティには ServiceTask3 を使用します。

Note

Windows メディア プレーヤー 10 には、オンライン ストアが Web ページを表示できる 3 つの作業ウィンドウがあります。 オンライン ストアでは、作業ウィンドウの 1 つ、2 つ、または 3 つすべてを使用できます。 Windows メディア プレーヤー 11 には作業ウィンドウが 1 つだけあり、ユーザーは [オンライン ストア] タブをクリックして表示できます。Windows メディア プレーヤー 11 は ServiceTask2 要素と ServiceTask3 要素を無視します。

オンライン ストアの作業ウィンドウは、1 つのブラウザー インスタンスを共有します。 つまり、ユーザーが現在のサービス タスクから切り替えたときに実行し続けると予想されるスクリプト コードを Web ページに記述しないでください。

ユーザーが作業ウィンドウを切り替えると、Windows メディア プレーヤー URL とセッション Cookie が格納されます。 ユーザーが作業ウィンドウに戻ると、プレーヤーは URL と Cookie を復元します。 ユーザーが別のオンライン ストアを使用することを選択した場合、URL とセッション データはクリアされます。

次の表では、URL 要求と共に送信されるパラメーターについて詳しく説明します。

名前
ジオイド Windows の地理的な場所 ID。 場所 ID は、コントロール パネルの [地域と言語のオプション] 設定の [場所] 領域でユーザーによって指定されます。
locale ロケール ID をWindows メディア プレーヤーします。
userlocale Windows ロケール ID。 ロケールは、コントロール パネルの [地域と言語のオプション] 設定の [標準と書式] 領域でユーザーによって指定されます。
version Windows メディア プレーヤーバージョン番号の形式は 10.0.x.xxxx または 11.0.x.xxxx です。

必要条件

要件
Version
Windows メディア プレーヤー 10 以降。

関連項目

Type 1 Online Store の ServiceInfo ドキュメントの例

Type 2 Online Store の ServiceInfo ドキュメントの例

ServiceInfo ドキュメント