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 ao usuário em momentos 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 através da manipulação da ativação de URI ou por meio da ativação COM, implementando a interface IActionProvider. Para obter um passo a passo sobre como implementar um provedor de ação de aplicativo simples usando a ativação de URI, consulte Introdução às ações do aplicativo no Windows.

Os aplicativos devem ter identidade de pacote para registrar uma ação do aplicativo. O manifesto do pacote MSIX fornece metadados sobre as ações suportadas pelo aplicativo provedor. Para obter mais informações sobre a sintaxe do manifesto do pacote do aplicativo para o registro da Ação do 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 incluem informações como o identificador exclusivo e a descrição da ação, bem como a lista de entradas e saídas nas quais a ação opera. O arquivo de definição de ação JSON é empacotado com o aplicativo 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 aplicativos 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 do aplicativo. Um conjunto de APIs do WinRT representando 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 sobre IA Responsável

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

Cenários recomendados para Ações do Aplicativo

As Ações do Aplicativo destinam-se a fornecer unidades atômicas de funcionalidade que são aplicáveis a cenários e fluxos de trabalho fora do aplicativo do provedor. Por exemplo, uma ação pode traduzir um 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 funcionalidade que podem ser bons candidatos para implementação como uma 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 do contexto e deve ser descoberta dinamicamente em tempo de execução (por exemplo, exibindo comandos específicos do contexto em uma interface do usuário).
• A funcionalidade integra-se com ferramentas de sistema existentes ou outros ecossistemas de aplicativos.
• A funcionalidade simplifica a interação do usuário, encapsulando tarefas complexas em uma única ação de nível mais alto (por exemplo, automação orientada pelo usuário).
• A funcionalidade pode operar independentemente do controle interno do aplicativo e não precisa seguir protocolos rígidos específicos do aplicativo.
• A funcionalidade deve ser detetável e invocada de maneira uniforme em várias partes do sistema ou outros aplicativos (por exemplo, uma API para manipular arquivos ou compartilhar conteúdo).