Overzicht van app-acties in Windows

App-acties in Windows zijn afzonderlijke gedragseenheden die een Windows-app kan implementeren en registreren, zodat ze toegankelijk zijn vanuit andere apps en ervaringen, naadloos kunnen worden geïntegreerd in gebruikerswerkstromen.

Wat is een app-actie?

Een app-actie is een atomische eenheid van functionaliteit. Apps bouwen en registreren acties en vervolgens kunnen Windows of andere apps geregistreerde acties aanbevelen aan de gebruiker op contextafhankelijk relevante tijdstippen en locaties binnen de gebruikerswerkstroom. 

Implementatie van app-actie

Acties kunnen worden geïmplementeerd door URI-startactivering af te handelen of via COM-activering door de interface IActionProvider te implementeren. Zie Aan de slag met app-acties in Windows voor een overzicht van het implementeren van een eenvoudige app-actieprovider met behulp van URI-activering.

Apps moeten een pakketidentiteit hebben om een app-actie te kunnen registreren. Het MSIX-pakketmanifest bevat metagegevens over de acties die worden ondersteund door de provider-app. Zie voor meer informatie over de syntaxis van het app-pakketmanifest voor App Action-registratie Windows-app Action provider package manifest XML format.

Acties worden gedefinieerd met behulp van een JSON-indeling die metagegevens bevat over een of meer acties, waaronder informatie zoals de unieke id en beschrijving voor de actie, evenals de lijst met invoer en uitvoer waarvoor de actie werkt. Het JSON-actiedefinitiebestand is verpakt met de provider-app als inhoud. Het pad naar het bestand in het pakket wordt opgegeven in het app-pakketmanifest, zodat het systeem de actiedefinities kan vinden en opnemen. Zie JSON-schema van de actiedefinitie voor Windows-app Action-providers voor meer informatie over de JSON-indeling voor het declareren van acties.

Een entiteit is een object waarop een app-actie werkt. Acties nemen entiteiten als invoer en kunnen entiteiten als uitvoer retourneren. Entiteiten zijn onderverdeeld in subtypen om verschillende typen inhoud weer te geven waarop een actie kan worden uitgevoerd, zoals Document, Foto en Tekst. Elk entiteitstype heeft een set eigenschappen die informatie bieden met betrekking tot elk inhoudstype, zoals het pad of de bestandsextensie van een bestand. Entiteiten worden uitgedrukt als JSON in het JSON-bestand voor de actiedefinitie om de invoer en uitvoer van een app-actie te declareren. Een set WinRT-API's die entiteiten vertegenwoordigen, zijn ook beschikbaar voor het werken met entiteiten in code. Zie de naamruimte Windows.AI.Actions voor meer informatie.

Verantwoordelijke AI-Notities

Bij het bouwen van door AI ondersteunde acties bent u verantwoordelijk voor inhoudsmoderatie en misbruikcontrole voor entiteiten die worden geretourneerd aan de gebruiker. Zie Microsoft Responsible AI: Principles and approach voor meer informatie over Microsoft Responsible AI-beleid.

Aanbevolen scenario's voor app-acties

App-acties zijn bedoeld om atomische functionaliteitseenheden te bieden die van toepassing zijn op scenario's en werkstromen buiten de provider-app. Een actie kan bijvoorbeeld een stuk tekst vertalen of een afbeelding verwerken. Voor scenario's die volledig specifiek zijn voor de Windows-app die het gedrag implementeert, is het aanbevolen pad een aangepast uitbreidbaarheidspunt te implementeren met een app-extensie. Zie Een app-extensie maken en hosten voor meer informatie.

In de volgende lijst worden enkele soorten functionaliteit beschreven die goede kandidaten kunnen zijn voor de implementatie als een actie.

• De functionaliteit is breed van toepassing en herbruikbaar. De functionaliteit is bedoeld voor detectie en hergebruik in meerdere apps of contexten (bijvoorbeeld bestandsbewerkingen, afdrukken).
• Andere apps kunnen de functionaliteit opstellen en uitbreiden.
• De functionaliteit is contextafhankelijk en moet dynamisch worden gedetecteerd tijdens runtime (bijvoorbeeld het weergeven van contextspecifieke opdrachten in een gebruikersinterface).
• De functionaliteit kan worden geïntegreerd met bestaande systeemhulpprogramma's of andere app-ecosystemen.
• De functionaliteit vereenvoudigt de gebruikersinteractie door complexe taken in één actie op een hoger niveau in te kapselen (bijvoorbeeld door gebruikers gestuurde automatisering).
• De functionaliteit kan onafhankelijk van de interne controle van de app worden uitgevoerd en hoeft geen strikte app-specifieke protocollen te volgen.
• De functionaliteit is naar verwachting vindbaar en kan op een uniforme manier worden aangeroepen in verschillende onderdelen van het systeem of andere apps (bijvoorbeeld een API voor het bewerken van bestanden of het delen van inhoud).