Compartir a través de

Información general sobre acciones de la aplicación en Windows

Las acciones de aplicación en Windows son unidades de comportamiento individuales que una aplicación de Windows puede implementar y registrar para que se pueda acceder a ellas desde otras aplicaciones y experiencias, integrando sin problemas en flujos de trabajo de usuario.

¿Qué es una acción de aplicación?

Una acción de aplicación es una unidad atómica de funcionalidad. Las aplicaciones crean y registran acciones y, a continuación, Windows u otras aplicaciones pueden recomendar acciones registradas al usuario en momentos y ubicaciones contextualmente relevantes dentro del flujo de trabajo de usuario. 

Implementación de acción de App

Las acciones se pueden implementar mediante el manejo de la activación de lanzamiento del URI o mediante la activación COM implementando la interfaz IActionProvider. Para ver un tutorial sobre cómo implementar un proveedor de acciones de aplicación simple mediante la activación de URI, consulte Introducción a acciones de aplicación en Windows.

Las aplicaciones deben tener identidad de paquete para registrar una acción de aplicación. El manifiesto del paquete MSIX proporciona metadatos sobre las acciones admitidas por la aplicación de proveedor. Para obtener más información sobre la sintaxis del manifiesto del paquete de aplicaciones para el registro de acciones del aplicación, consulte actions-provider-manifest.md.

Las acciones se definen mediante un formato JSON que proporciona metadatos sobre una o varias acciones, que incluye información como el identificador único y la descripción de la acción, así como la lista de entradas y salidas en las que opera la acción. El archivo de definición de acción JSON se empaqueta con la aplicación del proveedor como contenido. La ruta de acceso al archivo dentro del paquete se especifica en el manifiesto del paquete de aplicación para que el sistema pueda encontrar e ingerir las definiciones de acción. Para obtener más información sobre el formato JSON para declarar acciones, consulte Esquema JSON de definición de acción para proveedores de acciones de aplicaciones de Windows.

Una entidad es un objeto en el que opera una acción de aplicación. Las acciones toman entidades como entradas y pueden devolver entidades como salidas. Las entidades se dividen en subtipos para representar diferentes tipos de contenido en los que puede funcionar una acción, como Documento, Foto y Texto. Cada tipo de entidad tiene un conjunto de propiedades que proporcionan información relacionada con cada tipo de contenido, como la ruta de acceso o la extensión de archivo de un archivo. Las entidades se expresan como JSON en el archivo JSON de definición de acción para declarar las entradas y salidas de una acción de aplicación. También hay disponible un conjunto de API de WinRT que representan entidades para trabajar con entidades en el código. Para obtener más información, consulte el espacio de nombres Windows.AI.Actions.

Notas de IA responsable

Al compilar acciones respaldadas por IA, es su responsabilidad como autor de las acciones realizar la moderación de contenido y el monitoreo de abusos cuando se trata de entidades devueltas al usuario. Para obtener más información sobre las directivas de inteligencia artificial responsable de Microsoft para obtener más información, consulte Inteligencia artificial responsable de Microsoft: Principios y enfoque.

Nota:

Considere si los niños deben tener acceso a la acción utilizando la propiedad "contentAgeRating" en el JSON de definición de la acción.

Las acciones de aplicación están diseñadas para proporcionar unidades atómicas de funcionalidad que son aplicables a escenarios y flujos de trabajo fuera de la aplicación de proveedor. Por ejemplo, una acción podría traducir un fragmento de texto o procesar una imagen. Para escenarios que son completamente específicos de la aplicación de Windows que implementa el comportamiento, la ruta de acceso recomendada es implementar un punto de extensibilidad personalizado con una extensión de aplicación. Para obtener más información, consulte Creación y hospedaje de una extensión de aplicación.

En la lista siguiente se describen algunos tipos de funcionalidad que pueden ser buenos candidatos para implementar como una acción.

  • La funcionalidad es ampliamente aplicable y reutilizable. La funcionalidad está pensada para la detección y reutilización en varias aplicaciones o contextos (por ejemplo, operaciones de archivo, impresión).
  • Otras aplicaciones pueden crear y ampliar la funcionalidad.
  • La funcionalidad depende del contexto y debe detectarse dinámicamente en tiempo de ejecución (por ejemplo, mostrar comandos específicos del contexto en una interfaz de usuario).
  • La funcionalidad se integra con las herramientas del sistema existentes u otros ecosistemas de aplicaciones.
  • La funcionalidad simplifica la interacción del usuario mediante la encapsulación de tareas complejas en una sola acción de nivel superior (por ejemplo, automatización controlada por el usuario).
  • La funcionalidad puede funcionar independientemente del control interno de la aplicación y no necesita seguir protocolos estrictos específicos de la aplicación.
  • Se espera que la funcionalidad sea reconocible e invocada de forma uniforme en varias partes del sistema u otras aplicaciones (por ejemplo, una API para manipular archivos o compartir contenido).