Udostępnij za pośrednictwem

Akcje aplikacji w systemie Windows — omówienie

Akcje aplikacji w systemie Windows to poszczególne jednostki zachowania, które aplikacja systemu Windows może implementować i rejestrować, aby można było uzyskiwać do nich dostęp z innych aplikacji i środowisk, bezproblemowo integrując się z przepływami pracy użytkownika.

Co to jest akcja aplikacji?

Akcja aplikacji to niepodzielna jednostka funkcjonalności. Aplikacje tworzą i rejestrują akcje, a następnie system Windows lub inne aplikacje mogą polecać zarejestrowane akcje użytkownikowi w kontekstowych okresach i lokalizacjach w przepływie pracy użytkownika. 

Implementacja akcji aplikacji

Akcje można zaimplementować poprzez obsługę aktywacji uruchomienia identyfikatora URI lub poprzez aktywację COM przez implementację interfejsu IActionProvider. Aby zapoznać się z przewodnikiem wdrażania prostego dostawcy akcji aplikacji za pomocą aktywacji URI, przeczytaj Wprowadzenie do akcji aplikacji w systemie Windows.

Aplikacje muszą mieć tożsamość pakietu w celu zarejestrowania akcji aplikacji. Manifest pakietu MSIX zawiera metadane dotyczące akcji obsługiwanych przez aplikację dostawcy. Aby uzyskać więcej informacji na temat składni manifestu pakietu aplikacji na potrzeby rejestracji akcji aplikacji, zobacz actions-provider-manifest.md.

Akcje są definiowane przy użyciu formatu JSON, który dostarcza metadane dotyczące co najmniej jednej akcji, która zawiera informacje takie jak unikatowy identyfikator i opis akcji, a także lista danych wejściowych i wyjściowych, na których działa akcja. Plik definicji akcji JSON jest spakowany z aplikacją dostawcy jako zawartością. Ścieżka do pliku w pakiecie jest określona w manifeście pakietu aplikacji, aby system mógł znaleźć i pozyskać definicje akcji. Aby uzyskać więcej informacji na temat formatu JSON na potrzeby deklarowania akcji, zobacz Schemat JSON definicji akcji dla dostawców akcji aplikacji systemu Windows.

Jednostka jest obiektem, na którym działa akcja aplikacji. Akcje przyjmują jednostki jako dane wejściowe i mogą zwracać jednostki jako dane wyjściowe. Jednostki są podzielone na podtypy, aby reprezentować różne typy zawartości, na których może działać akcja, na przykład Dokument, Zdjęcie i Tekst. Każdy typ jednostki ma zestaw właściwości, które zawierają informacje związane z poszczególnymi typami zawartości, takimi jak ścieżka lub rozszerzenie pliku pliku. Jednostki są wyrażane jako dane JSON w pliku JSON definicji akcji w celu zadeklarowania danych wejściowych i wyjściowych akcji aplikacji. Zestaw interfejsów API WinRT reprezentujących jednostki jest również dostępny do pracy z jednostkami w kodzie. Aby uzyskać więcej informacji, zobacz przestrzeń nazw Windows.AI.Actions.

Informacje o odpowiedzialnej sztucznej inteligencji

Podczas budowania akcji wspieranych przez sztuczną inteligencję, jako autor akcji masz obowiązek moderować treści i monitorować nadużycia w zakresie jednostek przekazywanych użytkownikowi. Aby uzyskać więcej informacji na temat zasad odpowiedzialnej sztucznej inteligencji firmy Microsoft, zobacz Odpowiedzialne używanie sztucznej inteligencji firmy Microsoft: zasady i podejście

Uwaga / Notatka

Rozważ, czy dzieci powinny mieć dostęp do akcji za pomocą właściwości "contentAgeRating" w definicji akcji JSON.

Akcje aplikacji mają na celu zapewnienie niepodzielnych jednostek funkcjonalności, które mają zastosowanie do scenariuszy i przepływów pracy spoza aplikacji dostawcy. Na przykład akcja może przetłumaczyć fragment tekstu lub przetworzyć obraz. W scenariuszach, które są całkowicie specyficzne dla aplikacji systemu Windows implementujące zachowanie, zalecaną ścieżką jest zaimplementowanie niestandardowego punktu rozszerzalności z rozszerzeniem aplikacji. Aby uzyskać więcej informacji, zobacz Tworzenie i hostowanie rozszerzenia aplikacji.

Na poniższej liście opisano niektóre rodzaje funkcjonalności, które mogą być dobrymi kandydatami do wdrożenia jako akcje.

  • Funkcjonalność szeroko stosowana i nadająca się do wielokrotnego użytku. Funkcja ta jest przeznaczona do odnajdywania i ponownego używania wielu aplikacji lub kontekstów (np. operacji na plikach, drukowania).
  • Inne aplikacje mogą tworzyć i rozszerzać funkcjonalność.
  • Funkcjonalność jest zależna od kontekstu i powinna być dynamicznie wykrywana w czasie wykonywania (np. wyświetlanie poleceń specyficznych dla kontekstu w interfejsie użytkownika).
  • Ta funkcja integruje się z istniejącymi narzędziami systemowymi lub innymi ekosystemami aplikacji.
  • Funkcjonalność upraszcza interakcję użytkownika przez hermetyzowanie złożonych zadań w jedną akcję wyższego poziomu (np. automatyzację opartą na użytkownikach).
  • Funkcjonalność może działać niezależnie od wewnętrznej kontroli aplikacji i nie musi być zgodna z rygorystycznymi protokołami specyficznymi dla aplikacji.
  • Funkcje, które powinny być wykrywalne i wywoływane w jednolity sposób w różnych częściach systemu lub innych aplikacji (np. interfejs API do manipulowania plikami lub udostępniania zawartości).