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 ativação de iniciação por URI ou através 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 mais informações sobre a sintaxe do manifesto do pacote de aplicação para registo de Ações de Aplicação, consulte formato XML do manifesto do pacote do fornecedor do Aplicação do Windows Action.

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 mais informações sobre o formato JSON para declarar ações, consulte Esquema JSON de definição de ações para fornecedores de Aplicação do Windows Action.

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 sobre os 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, é responsável pela moderação de conteúdos e monitorização de abusos relativamente às entidades devolvidas ao utilizador. Para mais informações sobre as políticas de IA Responsável da Microsoft, 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.
• Espera-se que a funcionalidade seja descobrível e invocada de forma uniforme em várias partes do sistema ou noutras aplicações (por exemplo, uma API para manipular ficheiros ou partilhar conteúdo).