Widget-szolgáltatók

Windows widgetek olyan kis felhasználói felületi tárolók, amelyek egy Windows alkalmazás vagy progresszív webalkalmazás (PWA) által biztosított tartalmat jelenítenek meg. Megadhat adaptív kártyasablont és -adatokat, vagy webes widget használatával megjelenítheti a HTML-t egy URL-címről. A webes widgetek továbbra is Adaptive Card JSON-adattartalmat használnak a tartalom URL-címének megadásához.

Csomagolt asztali alkalmazások esetén implementál egy widgetszolgáltatót, amely válaszol a widget-gazdagéptől érkező kérésekre, és frissítéseket küld a WidgetManageren keresztül. A PWA a webalkalmazás-manifesztumban szereplő widgetdefiníciókat használja, és kezeli a widgeteseményeket a service workerében.

A Windows widgetek felületének áttekintéséért és a saját widgetek létrehozásához szükséges tervezési útmutatóért tekintse meg Windows widgeteket.

Jelenleg egy csomagolt Win32 asztali alkalmazással vagy progresszív webalkalmazással (PWA) implementálhat widget-szolgáltatót. További információk:

Asztali widgetszolgáltatók API-jai és funkciói

Valósítsa meg az IWidgetProvider felületet a widgetek létrehozásához, törléséhez, aktiválásához, a környezeti változások és a felhasználói műveletek kezeléséhez. Az alapfelületre továbbra is szükség van, ha opcionális felületeket ad hozzá a testreszabáshoz vagy a webes tartalomhoz.

Capability API vagy útmutató Availability
Widget életciklusa és Adaptive Card-frissítései IWidgetProvider és WidgetManager Windows App SDK 1.2
Felhasználó testreszabása IWidgetProvider2 és a jegyzék IsCustomizable attribútuma Windows App SDK 1.4
Webes tartalom, erőforrás-kérelmek és üzenetküldés webes widgetszolgáltatók, IWidgetResourceProvider, IWidgetProviderMessage, és WidgetManager.SendMessageToContent Windows App SDK 1.6.3; ellenőrizze a web-widget gazdagépét és a regionális követelményeket is.
Olyan tartalom jelzése, amely még nem személyre szabott, vagy amellyel még nem lehet műveletet végezni WidgetUpdateRequestOptions.IsPlaceholderContent Windows App SDK 1.6.6
Widgetelemzési callbackek IWidgetProviderAnalytics A Windows Widgets Board támogatja ezeket a visszahívásokat a Windows 11 26900-es buildjétől kezdve. Más gazdagépeknek is támogatniuk kell az interfészt; lásd az API-megjegyzéseket.

Az SDK-verziók azt azonosítják, hogy mikor váltak elérhetővé az API-k, és nem azt, hogy melyik kiadást kell telepítenie. Használjon egy jelenleg támogatott stabil kiadást a Windows App SDK kiadási csatornái közül, és tesztelje a cél Windows eszközén és widget-gazdagépén használt képességeket. A fejléc megjelenítési beállításairól további információt a a widget fejlécterületének testreszabása című témakörben talál. A PWA service-worker API egy különálló megvalósítási útvonal; a táblázat asztali felületei nem vonatkoznak rá.

A widget-gazdagép a rögzített widgetek élettartamától függetlenül aktiválhatja és felszabadíthatja a providert. Állítsa vissza a widget állapotát, amikor a szolgáltató elindul, és ne őrizze meg a visszahívási argumentum objektumait, miután egy IWidgetProvider visszahívás befejeződött. További információkért lásd az IWidgetProvider megjegyzéseit.

A teljes API-referenciaért tekintse meg a Microsoft.Windows. Widgets.Providers névtér.

A widgetek létrehozásának és a widget-szolgáltató implementálásának alapjainak áttekintéséhez tekintse meg a Tabs vs Spaces (Widgetek létrehozása Windows 11) című Tabs vs Spaces című epizódot.

További források

  • Utolsó frissítés időpontja: