App-Aktionen unter Windows – Übersicht

App-Aktionen unter Windows sind einzelne Verhaltenseinheiten, die eine Windows-App implementieren und registrieren kann, sodass sie von anderen Apps und Erfahrungen aus aufgerufen werden können, nahtlos in Benutzerworkflows integriert werden können.

Was ist eine App-Aktion?

Eine App-Aktion ist eine atomige Funktionseinheit. Apps erstellen und registrieren Aktionen, und dann können Windows oder andere Apps registrierte Aktionen für den Benutzer zu kontextbezogenen Zeiten und Orten innerhalb des Benutzerworkflows empfehlen. 

App-Aktionsimplementierung

Aktionen können durch Behandeln der URI-Startaktivierung oder durch COM-Aktivierung durch Implementieren der IActionProvider-Schnittstelle implementiert werden. Eine exemplarische Vorgehensweise zum Implementieren eines einfachen App-Aktionsanbieters mithilfe der URI-Aktivierung finden Sie unter "Erste Schritte mit App-Aktionen unter Windows".

Apps müssen über eine Paketidentität verfügen, um eine App-Aktion zu registrieren. Das MSIX-Paketmanifest stellt Metadaten zu den Aktionen bereit, die von der Anbieter-App unterstützt werden. Weitere Informationen zur Manifestsyntax des App-Pakets für die App-Aktion-Registrierung finden Sie unter actions-provider-manifest.md.

Aktionen werden mithilfe eines JSON-Formats definiert, das Metadaten zu einer oder mehreren Aktionen bereitstellt, die Informationen wie den eindeutigen Bezeichner und die Beschreibung für die Aktion sowie die Liste der Eingaben und Ausgaben enthält, auf denen die Aktion ausgeführt wird. Die JSON-Aktionsdefinitionsdatei wird als Inhalt mit der Anbieter-App verpackt. Der Pfad zur Datei innerhalb des Pakets wird im App-Paketmanifest angegeben, sodass das System die Aktionsdefinitionen finden und aufnehmen kann. Weitere Informationen zum JSON-Format zum Deklarieren von Aktionen finden Sie unter JSON-Schema der Aktionsdefinition für Windows-App-Aktionsanbieter.

Eine Entität ist ein Objekt, auf dem eine App-Aktion ausgeführt wird. Aktionen verwenden Entitäten als Eingabe und können Entitäten als Ausgabe zurückgeben. Entitäten werden in Untertypen unterteilt, um verschiedene Inhaltstypen darzustellen, für die eine Aktion ausgeführt werden kann, z. B. "Dokument", "Foto" und "Text". Jeder Entitätstyp verfügt über eine Reihe von Eigenschaften, die Informationen zu jedem Inhaltstyp bereitstellen, z. B. den Pfad oder die Dateierweiterung einer Datei. Entitäten werden in der JSON-Datei der Aktionsdefinition als JSON ausgedrückt, um die Eingaben und Ausgaben einer App-Aktion zu deklarieren. Eine Reihe von WinRT-APIs, die Entitäten darstellen, stehen auch für das Arbeiten mit Entitäten im Code zur Verfügung. Weitere Informationen finden Sie im Windows.AI.Actions-Namespace.

Hinweise zu verantwortungsvoller KI

Wenn Sie KI-gestützte Aktionen erstellen, sind Sie als Aktionsautor für die Inhaltsmoderation und die Missbrauchsüberwachung zuständig, wenn Einheiten an den Benutzer zurückgegeben werden. Weitere Informationen zu den Richtlinien für verantwortungsvolle KI bei Microsoft finden Sie unter Verantwortungsvolle KI bei Microsoft: Prinzipien und Ansatz

Empfohlene Szenarien für App-Aktionen

App-Aktionen sollen atome Funktionseinheiten bereitstellen, die für Szenarien und Workflows außerhalb der Anbieter-App gelten. Beispielsweise kann eine Aktion einen Textabschnitt übersetzen oder ein Bild verarbeiten. Für Szenarien, die vollständig für die Windows-App spezifisch sind, die das Verhalten implementiert, empfiehlt es sich, einen benutzerdefinierten Erweiterbarkeitspunkt mit einer App-Erweiterung zu implementieren. Weitere Informationen finden Sie unter Erstellen und Hosten einer App-Erweiterung.

In der folgenden Liste werden einige Arten von Funktionalitäten beschrieben, die als gute Kandidaten für die Implementierung als Aktion dargestellt werden können.

• Die Funktionalität ist allgemein anwendbar und wiederverwendbar. Die Funktionalität dient der Ermittlung und Wiederverwendung über mehrere Apps oder Kontexte hinweg (z. B. Dateivorgänge, Drucken).
• Andere Apps können die Funktionalität gestalten und erweitern.
• Die Funktionalität ist kontextabhängig und sollte zur Laufzeit dynamisch ermittelt werden (z. B. das Anzeigen kontextspezifischer Befehle in einer Benutzeroberfläche).
• Die Funktionalität ist in vorhandene Systemtools oder andere App-Ökosysteme integriert.
• Die Funktionalität vereinfacht die Benutzerinteraktion, indem komplexe Aufgaben in eine einzelne, übergeordnete Aktion (z. B. benutzergesteuerte Automatisierung) gekapselt werden.
• Die Funktionalität kann unabhängig vom internen Steuerelement der App ausgeführt werden und muss keine strengen App-spezifischen Protokolle befolgen.
• Die Funktionalität, die für verschiedene Teile des Systems oder anderer Apps einheitlich erkannt und aufgerufen werden soll (z. B. eine API zum Bearbeiten von Dateien oder zum Freigeben von Inhalten).