Dostawcy widżetów

Windows widżety to małe kontenery interfejsu użytkownika, które wyświetlają zawartość dostarczaną przez aplikację Windows lub progresywną aplikację internetową (PWA). Możesz podać szablon i dane karty adaptacyjnej lub użyć widżetu internetowego do wyświetlania kodu HTML z adresu URL. Widżety internetowe nadal używają ładunku JSON karty Adaptive Card, aby określić adres URL zawartości.

W przypadku spakowanej aplikacji klasycznej należy zaimplementować dostawcę widżetu, który odpowiada na żądania z hosta widżetu i wysyła aktualizacje za pośrednictwem WidgetManager. Aplikacja PWA używa definicji widżetów w manifeście aplikacji internetowej i obsługuje zdarzenia widżetów w swoim Service Workerze.

Aby zapoznać się z omówieniem środowiska widżetów Windows i wskazówek dotyczących projektowania tworzenia własnych widżetów, zobacz Windows widżety.

Obecnie można zaimplementować dostawcę widżetu przy użyciu spakowanej aplikacji klasycznej Win32 lub progresywnej aplikacji internetowej (PWA). Aby uzyskać więcej informacji, zobacz:

Interfejsy API i możliwości dostawców widżetów pulpitu

Zaimplementuj IWidgetProvider na potrzeby tworzenia, usuwania, aktywacji, zmian kontekstu i akcji użytkownika. Interfejs podstawowy pozostaje wymagany podczas dodawania opcjonalnych interfejsów do dostosowywania lub treści internetowych.

Capability Interfejs API lub wytyczne Availability
Aktualizacje cyklu życia widżetu i Adaptive Card IWidgetProvider i WidgetManager Zestaw SDK do aplikacji systemu Windows 1.2
Dostosowywanie użytkownika IWidgetProvider2 i atrybut IsCustomizable manifestu Zestaw SDK do aplikacji systemu Windows 1.4
Zawartość internetowa, żądania zasobów i komunikacja Dostawcy widżetów sieci Web, IWidgetResourceProvider, IWidgetProviderMessage i WidgetManager.SendMessageToContent Zestaw SDK do aplikacji systemu Windows 1.6.3; sprawdź również wymagania dotyczące hosta widżetu internetowego oraz wymagania regionalne.
Wskazuje zawartość, która nie jest jeszcze spersonalizowana lub nie nadaje się jeszcze do podjęcia działania WidgetUpdateRequestOptions.IsPlaceholderContent Zestaw SDK do aplikacji systemu Windows 1.6.6
Callbacki analityczne widżetów IWidgetProviderAnalytics Tablica widżetów Windows obsługuje te wywołania zwrotne, począwszy od kompilacji Windows 11 26900. Inne hosty muszą również obsługiwać interfejs; zobacz uwagi dotyczące interfejsu API.

Wersje zestawu SDK identyfikują, kiedy interfejsy API stały się dostępne, a nie wersję, którą należy zainstalować. Użyj obecnie obsługiwanej stabilnej wersji z kanałów wydania Zestaw SDK do aplikacji systemu Windows i przetestuj możliwości używane na docelowym urządzeniu Windows i hoście widżetu. Informacje o opcjach prezentacji nagłówka znajdziesz w sekcji Dostosowywanie obszaru nagłówka widżetu. Interfejs API service workera usługi PWA jest oddzielną ścieżką implementacji; interfejsy pulpitu w tej tabeli nie mają do niego zastosowania.

Host widżetu może aktywować i zwolnić instancję dostawcy niezależnie od okresu istnienia przypiętych widżetów. Przywróć stan widżetu po uruchomieniu dostawcy i nie zachowuj obiektów argumentów wywołania zwrotnego po powrocie wywołania zwrotnego IWidgetProvider. Aby uzyskać więcej informacji, zobacz uwagi IWidgetProvider.

Aby uzyskać pełną dokumentację interfejsu API, zobacz Microsoft.Windows.Widgets.Providers.

Aby zapoznać się z przewodnikiem po podstawach tworzenia widżetu i implementowania dostawcy widżetów, obejrzyj odcinek Tabs vs Spaces "Create Widgets for Windows 11" (Tworzenie widżetów dla Windows 11).

Dodatkowe zasoby

  • Ostatnia aktualizacja o