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) のユーザーのみが利用できます。 可用性と実装の要件については、「 ダッシュボードとフィード プロバイダー」を参照してください。
このセクションでは...
| トピック | 説明 |
|---|---|
| フィード プロバイダー | アプリのコンテンツ フィードを登録して、Windows ウィジェット ボードに直接表示する方法について説明します。 |
| ウィジェット プロバイダー | ウィジェットのコンテンツ、レイアウト、対話型要素を提供するウィジェット プロバイダーを実装する方法について説明します。 |
| Web ウィジェット プロバイダー | ウィジェットに HTML を表示し、プロバイダーと Web コンテンツの間のリソース要求とメッセージを処理します。 |
| アダプティブ カード デザイナー | アダプティブ カード デザイナーを使用してウィジェット テンプレートを作成する手順を説明します。 |
| GitHub Copilotを使用してWindowsウィジェットを作成 | 再利用可能なプロンプトを使用して、既存のリポジトリ内のウィジェットを生成、パッケージ化、検証します。 |
Windows developer