Compartilhar via

Visão geral das ações do aplicativo no Windows

As Ações de Aplicativo no Windows são unidades individuais de comportamento que um aplicativo do Windows pode implementar e registrar para que possam ser acessadas de outros aplicativos e experiências, integrando-se perfeitamente aos fluxos de trabalho do usuário.

O que é uma ação de aplicativo?

Uma Ação de Aplicativo é uma unidade atômica de funcionalidade. Os aplicativos criam e registram ações e, em seguida, o Windows ou outros aplicativos podem recomendar ações registradas para o usuário em horários e locais contextualmente relevantes dentro do fluxo de trabalho do usuário. 

Implementação da ação do aplicativo

As ações podem ser implementadas manipulando a ativação de lançamento de URI, ou através da ativação por COM, implementando a interface IActionProvider. Para obter um passo a passo da implementação de um provedor de ação de aplicativo simples usando a ativação de URI, consulte Introdução às Ações de Aplicativo no Windows.

Os aplicativos devem ter a identidade do pacote para registrar uma ação de aplicativo. O manifesto do pacote MSIX fornece metadados sobre as ações compatíveis com o aplicativo provedor. Para obter mais informações sobre a sintaxe do manifesto do pacote de aplicativos para o registro da Ação de Aplicativo, consulte actions-provider-manifest.md.

As ações são definidas usando um formato JSON que fornece metadados sobre uma ou mais ações, que inclui informações como o identificador exclusivo e a descrição da ação, bem como a lista de entradas e saídas em que a ação opera. O arquivo de definição de ação JSON é empacotado com o aplicativo do provedor como conteúdo. O caminho para o arquivo dentro do pacote é especificado no manifesto do pacote do aplicativo para que o sistema possa localizar e ingerir as definições de ação. Para obter mais informações sobre o formato JSON para declarar ações, consulte Esquema JSON de definição de ação para provedores de Ação de Aplicativo do Windows.

Uma entidade é um objeto no qual uma Ação de Aplicativo opera. As ações tomam entidades como entradas e podem retornar entidades como saídas. As entidades são divididas em subtipos para representar diferentes tipos de conteúdo nos quais uma ação pode operar, como Documento, Foto e Texto. Cada tipo de entidade tem um conjunto de propriedades que fornecem informações relacionadas a cada tipo de conteúdo, como o caminho ou a extensão de arquivo de um arquivo. As entidades são expressas como JSON no arquivo JSON de definição de ação para declarar as entradas e saídas de uma ação de aplicativo. Um conjunto de APIs do WinRT que representam entidades também está disponível para trabalhar com entidades no código. Para obter mais informações, consulte o Namespace Windows.AI.Actions.

Notas de IA responsáveis

Ao criar ações apoiadas por IA, é sua responsabilidade, como autor da ação, realizar a moderação de conteúdo e o monitoramento de abuso quando se trata de entidades retornadas ao usuário. Para obter mais informações sobre as políticas de IA Responsável da Microsoft, consulte Microsoft Responsible AI: Princípios e abordagem

Observação

Considere se as crianças devem ter acesso à ação usando a propriedade 'contentAgeRating' no JSON da definição da ação.

As Ações de Aplicativo destinam-se a fornecer unidades atômicas de funcionalidade aplicáveis a cenários e fluxos de trabalho fora do aplicativo provedor. Por exemplo, uma ação pode traduzir um trecho de texto ou processar uma imagem. Para cenários totalmente específicos do aplicativo do Windows que implementa o comportamento, o caminho recomendado é implementar um ponto de extensibilidade personalizado com uma extensão de aplicativo. Para obter mais informações, consulte Criar e hospedar uma extensão de aplicativo.

A lista a seguir descreve alguns tipos de funcionalidades que podem ser bons candidatos para implementar como ação.

  • A funcionalidade é amplamente aplicável e reutilizável. A funcionalidade destina-se à descoberta e reutilização em vários aplicativos ou contextos (por exemplo, operações de arquivo, impressão).
  • Outros aplicativos podem compor e estender a funcionalidade.
  • A funcionalidade depende de contexto e deve ser descoberta dinamicamente em runtime (por exemplo, exibindo comandos específicos de contexto em uma interface do usuário).
  • A funcionalidade se integra às ferramentas do sistema existentes ou a outros ecossistemas de aplicativos.
  • A funcionalidade simplifica a interação do usuário encapsulando tarefas complexas em uma única ação de nível superior (por exemplo, automação controlada pelo usuário).
  • A funcionalidade pode operar independentemente do controle interno do aplicativo e não precisa seguir protocolos estritos específicos do aplicativo.
  • A funcionalidade esperada para ser detectável e invocada de forma uniforme em várias partes do sistema ou outros aplicativos (por exemplo, uma API para manipular arquivos ou compartilhar conteúdo).