Fornecedores de widgets

Os widgets do Windows são pequenos contentores de interface que mostram conteúdos fornecidos por uma aplicação Windows ou Progressive Web App (PWA). Pode fornecer um modelo de Adaptive Card e dados, ou usar um widget web para mostrar HTML a partir de uma URL. Os widgets web continuam a usar um payload Adaptive Card JSON para especificar o URL do conteúdo.

Para uma aplicação de ambiente de trabalho empacotada, implementa-se um fornecedor de widgets que responde a pedidos do anfitrião do widget e envia atualizações através do WidgetManager. Uma PWA utiliza as definições de widgets no manifesto da sua aplicação web e gere eventos de widgets no seu service worker.

Para uma visão geral da experiência com widgets do Windows e orientações de design para criar os seus próprios widgets, consulte widgets do Windows.

Atualmente, pode implementar um fornecedor de widgets usando uma aplicação de desktop Win32 integrada ou uma Progressive Web App (PWA). Para obter mais informações, veja:

APIs e capacidades dos fornecedores de widgets do ambiente de trabalho

Implemente IWidgetProvider para a criação, eliminação, ativação, alterações de contexto e ações do utilizador de widgets. A interface base continua a ser necessária quando adicionas interfaces opcionais para personalização ou conteúdo web.

Capacidade API ou orientação Availability
Ciclo de vida dos widgets e atualizações do Adaptive Card IWidgetProvider e WidgetManager SDK de Aplicações Windows 1.2
Personalização do usuário IWidgetProvider2 e o atributo IsCustomizable do manifesto SDK de Aplicações Windows 1.4
Conteúdo web, pedidos de recursos e mensagens Fornecedores de widgets web, IWidgetResourceProvider, IWidgetProviderMessage e WidgetManager.SendMessageToContent SDK de Aplicações Windows 1.6.3; verifique também o alojamento do widget web e os requisitos regionais.
A indicar conteúdo que ainda não está personalizado ou passível de ação WidgetUpdateRequestOptions.IsPlaceholderContent SDK de Aplicações Windows 1.6.6
Callbacks de análise de widgets IWidgetProviderAnalytics Windows Widgets Board suporta estes callbacks a partir da compilação 26900 do Windows 11. Outros hosts também devem suportar a interface; ver as observações da API.

As versões do SDK identificam quando as APIs ficaram disponíveis, não qual a versão que deve instalar. Use uma versão estável atualmente suportada dos canais de lançamento do SDK de Aplicações Windows e teste as funcionalidades que utiliza no seu dispositivo Windows de destino e no anfitrião do widget. Para opções de apresentação do cabeçalho, consulte Personalizar a área do cabeçalho do widget. A API de service worker da PWA é um caminho de implementação separado; as interfaces para computador nesta tabela não se aplicam a ela.

O anfitrião do widget pode ativar e liberar o seu provider independentemente da vida útil dos widgets fixados. Restaure o estado do widget quando o provider inicia e não retenha objetos de argumento de callback após o retorno do callback do IWidgetProvider. Para mais informações, consulte as observações do IWidgetProvider.

Para a referência completa da API, consulte o namespace Microsoft.Windows.Widgets.Providers.

Para uma explicação dos conceitos básicos de criação de widgets e implementação de um fornecedor de widgets, veja o episódio de Tabs vs Spaces "Criar Widgets para Windows 11".

Recursos adicionais

  • Última atualização a