ウィジェット ピッカーと統合する

現在のリリースでは、ウィジェット ホストは、Windows 11に組み込まれているウィジェット ボードのみです。 ウィジェットボードはウィジェットを表示し、ボード上のレイアウトを管理します。 また、ユーザーがボードに表示される使用可能なウィジェットを選択できるウィジェット ピッカーも提供します。 この記事では、ウィジェットがウィジェット ピッカーに正常に統合するために必要な資産について説明します。

ウィジェットのスクリーンショット画像

各ウィジェットは、ウィジェットにフォーカスがあるときに、ウィジェット ピッカーにプレビューとして表示されるスクリーンショット画像を提供する必要があります。 スクリーンショットは、アプリのパッケージ マニフェストでウィジェット プロバイダーによって指定されます。 ウィジェットのスクリーンショットに使用するイメージ ファイルを指定する方法の技術的な情報については、「 win32 アプリでのウィジェット プロバイダーの実装 および Widget プロバイダー パッケージ マニフェスト XML 形式を参照してください。

次のスクリーンショットは、ウィジェット ピッカー内でのスクリーンショット画像の配置を示しています。

スクリーンショットの画像の要件

一貫性のあるユーザー エクスペリエンスを提供するには、ウィジェット ピッカーのウィジェットのスクリーンショットが次のガイドラインに従っている必要があります。

• スクリーンショットには、ウィジェットの中サイズバージョンが表示されます。
• 画像は幅 300 ピクセル、高さ 304 ピクセルにする必要があります。
• イメージには、透明で丸い角が必要です。

ウィジェット プロバイダー マニフェストには、設定できる 3 つの異なる Screenshot 要素が含まれています。 最上位のスクリーンショットは必須であり、ウィジェット ピッカーによって既定として使用されます。 マニフェストの LightMode セクションと DarkMode セクションは省略可能であり、ライト モードとダーク モードでウィジェットの個別のスクリーンショットを指定できます。 これらのオプションのスクリーンショットの一方または両方を指定した場合、ウィジェットピッカーはデバイスの現在のテーマに一致するものを使用します。 現在のテーマ専用のイメージを指定しない場合、ウィジェット ピッカーでは、代わりに既定の最上位レベルのスクリーンショットが使用されます。

複数のロケールのウィジェットのスクリーンショットを提供できます。 各スクリーンショットのロケールは、アプリ パッケージを基準としたアセットへのパスで指定されます。

• イメージ アセットのパッケージ 化プロジェクトにディレクトリを作成します。 例: "Assets"。
• 言語に依存しないアセットまたはフォールバック アセットは、このフォルダーに直接配置できます。 例: "Assets/Screenshot.png"
• 言語固有のアセットは、適用先のロケールにちなんだサブディレクトリに配置できます。 例:
  • "英語 (米国)" アセットは、"en-us": "Assets/en-us/Screenshot.png" という名前のサブディレクトリに配置する必要があります。
  • "フランス語 (フランス)" アセットは、"fr-fr": "Assets/fr-fr/Screenshot.png" という名前のサブディレクトリに配置する必要があります
• ms-appx: URI スキームを使用して、appxmanifest でこれらのイメージを参照します。 例: Screenshot="ms-appx:Assets\Screenshot.png"
• 特定のロケールのイメージを含めない場合は、ルート ディレクトリのフォールバック イメージが使用されます。

リソース ローダーは、表示する言語に適した資産を自動的に選択します。 詳細については、「 スケール、テーマ、ハイ コントラストなどに合わせて調整されたイメージとアセットを読み込むを参照してください。

ウィジェットのスクリーンショット画像の例を次に示します。