Windows ウィジェットとダッシュボードの開発

Widgets

Windowsウィジェットは、インストールされているアプリに関連付けられた小さな UI コンテナーです。 ウィジェット ボードでは、アプリから提供されるパーソナライズされたコンテンツやクイック アクションを備えたウィジェットが、Windows デスクトップ上にグリッド形式で表示されます。 json テンプレートにデータをバインドするアダプティブ カードを使用してコンテンツを定義したり、Web ウィジェット プロバイダーを使用して URL から HTML を表示したりできます。 Web ウィジェットは引き続きアダプティブ カード JSON ペイロードを使用してコンテンツ URL を指定します。

ウィジェット ボードのスクリーンショット。ボードは丸い四角形で、時刻が上部に表示され、その後に検索バーが表示されます。ボードの残りの部分は、それぞれがウィジェットを表す丸い四角形のグリッドです。個々のウィジェットは、トップニュース記事、現在の天気、現在のトラフィックなどを表示します。

設計ガイダンスについては、「Windows ウィジェットの設計の概要」を参照>。

ウィジェットの開発パスを選択する

次の表を使用して、実装パスと、開く次のトピックを選択します。

もし望むなら... このアプローチを使用する ここから始める
パッケージ化された C# デスクトップ アプリにアダプティブ カード ウィジェットを追加する IWidgetProvider を実装し、WidgetManager でテンプレートとデータの更新を送信し、パッケージ マニフェストを使用してプロバイダーを登録します。 C# ウィジェット プロバイダーのチュートリアル
パッケージ化された C++/WinRT デスクトップ アプリにアダプティブ カード ウィジェットを追加する アウトプロセス COM サーバーに IWidgetProvider を実装し、その CLSID とウィジェットの定義をパッケージ マニフェストに登録します。 C++/WinRT ウィジェット プロバイダーのチュートリアル
デスクトップ ウィジェット内の URL から HTML を表示する Web ウィジェット プロバイダーを使用します。 この機能は、EEA のユーザーのみが使用できます。 プロバイダーは引き続き、Web URL とフォールバック コンテンツを含むアダプティブ カード ペイロードを送信します。 Web ウィジェット プロバイダー
既存のプログレッシブ Web アプリ (PWA) のウィジェットを追加する Web アプリ マニフェストでウィジェットを定義し、サービス ワーカーでウィジェット イベントを処理します。 これは、デスクトップ IWidgetProvider パスとは別です。 PWA 駆動型のウィジェットを構築する
デスクトップ プロバイダーでボタンまたはフォーム アクションを処理する Action.Execute を使用し、OnActionInvoked で動詞を処理します。 $host.isUserContextAuthenticatedが true の場合にのみ表示します。 ウィジェット テンプレートを作成する
プロバイダー コールバックなしでアプリ ページまたは Web サイトを開く Action.OpenUrl を使用します。 ウィジェットのユーザー コンテキストが認証されていない場合、これは引き続き使用できます。 ウィジェット テンプレートを作成する
ユーザーがウィジェットを設定できるようにする IWidgetProvider2 を実装し、マニフェストの IsCustomizable 属性を設定し、カスタマイズ ペイロードを指定します。 ウィジェットのカスタマイズを実装する
サイズ、テーマ、設定、ヘッダー、Web サポート、認証に合わせてコンテンツを調整する アダプティブ カード テンプレートで Windows $hostプロパティを使用し、サポートされているすべてのサイズをパッケージ マニフェストで宣言します。 Windows ウィジェット ホストのプロパティ
読み込み中またはサインアウト状態のコンテンツを表示する 意図的なフォールバック テンプレートとデータを送信します。 コンテンツがまだパーソナライズされていないか、アクション可能でない場合は IsPlaceholderContent を設定します。 ウィジェット プロバイダー
個々のウィジェットではなくダッシュボード フィードを追加する フィード プロバイダーを実装します。 フィード プロバイダーは個別の統合であり、EEA でのみ利用可能です。 ダッシュボードとフィード プロバイダー
ウィジェットの作成と検証をGitHub Copilotに依頼する サポートされている実装方法を選択し、パッケージ、マニフェスト、ビルド、ウィジェット ボードでの検証を必須とする、再利用可能なプロンプトを使用します。 GitHub Copilotを使用してWindowsウィジェットを作成

Dashboards

フィード プロバイダーは、ウィジェット ボードにダッシュボードとして表示されるコンテンツ フィードを登録します。 フィード プロバイダーは、ウィジェット プロバイダーとは別の統合です。ウィジェット内に HTML を表示しても、ダッシュボード フィードは登録されません。

Important

フィード プロバイダーは、欧州経済地域 (EEA) のユーザーのみが利用できます。 可用性と実装の要件については、「 ダッシュボードとフィード プロバイダー」を参照してください。

Discover ダッシュボードを示すスクリーンショット

このセクションでは...

トピック 説明
フィード プロバイダー アプリのコンテンツ フィードを登録して、Windows ウィジェット ボードに直接表示する方法について説明します。
ウィジェット プロバイダー ウィジェットのコンテンツ、レイアウト、対話型要素を提供するウィジェット プロバイダーを実装する方法について説明します。
Web ウィジェット プロバイダー ウィジェットに HTML を表示し、プロバイダーと Web コンテンツの間のリソース要求とメッセージを処理します。
アダプティブ カード デザイナー アダプティブ カード デザイナーを使用してウィジェット テンプレートを作成する手順を説明します。
GitHub Copilotを使用してWindowsウィジェットを作成 再利用可能なプロンプトを使用して、既存のリポジトリ内のウィジェットを生成、パッケージ化、検証します。