共用方式為


Windows 上的應用程式動作概觀

Windows 上的應用程式動作是 Windows 應用程式可以實作和註冊的個別行為單位,以便從其他應用程式和體驗存取它們,順暢地整合到使用者工作流程中。

什麼是應用程式動作?

應用程式動作是不可分割的功能單位。 應用程式會建置和註冊動作,然後 Windows 或其他應用程式可以在使用者工作流程內的內容相關時間與位置,向使用者建議已註冊的動作。 

應用程式動作實作

動作可以透過處理 URI 啟動,或透過實作 IActionProvider 介面來進行 COM 啟用。 如需使用 URI 啟用實作簡單應用程式動作提供者的逐步解說,請參閱 開始使用 Windows 上的應用程式動作

應用程式必須具有套件身分識別,才能註冊應用程式動作。 MSIX 套件指令清單提供提供者應用程式所支援動作的相關元數據。 如需應用程式動作註冊之應用程式套件指令清單語法的詳細資訊,請參閱 actions-provider-manifest.md

動作是使用 JSON 格式來定義,以提供一或多個動作的相關元數據,其中包含動作的唯一標識碼和描述,以及動作所作的輸入和輸出清單等資訊。 JSON 動作定義檔案會作為內容封裝在提供者應用程式中。 套件內檔案的路徑是在應用程式套件指令清單中指定,讓系統可以找到並內嵌動作定義。 如需宣告動作之 JSON 格式的詳細資訊,請參閱 Windows 應用程式動作提供者的動作定義 JSON 架構

實體是 App Action 作用的物件。 動作會將實體當作輸入,而且可以將實體當做輸出傳回。 實體分成子類型,以代表動作可以作的不同類型內容,例如 Document、Photo 和 Text。 每個實體類型都有一組屬性,可提供與每個內容類型相關的資訊,例如檔案的路徑或擴展名。 實體會在動作定義 JSON 檔案中以 JSON 表示,以宣告應用程式動作的輸入和輸出。 一組表示實體的 WinRT API 也可用於在程式碼中操作實體。 如需詳細資訊,請參閱 Windows.AI.Actions 命名空間

負責任AI筆記

建置 AI 驅動的動作時,動作作者有責任在實體回傳給使用者時執行內容仲裁和濫用監控。 如需Microsoft負責任 AI 原則的詳細資訊,請參閱 Microsoft負責任 AI:原則和方法

備註

考慮兒童是否應該有權使用動作定義 JSON 中的『contentAgeRating』屬性以存取該動作。

應用程式動作旨在提供適用於提供者應用程式之外情境和工作流程的基本功能單位。 例如,動作可能會翻譯一段文字,或處理影像。 針對僅在執行該行為的 Windows 應用程式中特定的情境,建議的方式是透過應用程式擴充件來實作自訂的延展點。 如需詳細資訊,請參閱 建立和裝載應用程式延伸模組

下列清單描述一些適合作為動作實作的功能。

  • 功能廣泛適用且可重複使用。 此功能適用於跨多個應用程式或內容進行探索和重複使用(例如檔案作業、列印)。
  • 其他應用程式可以撰寫和擴充功能。
  • 此功能與內容相關,且應在運行時間動態探索(例如,在UI中顯示內容特定命令)。
  • 此功能會與現有的系統工具或其他應用程式生態系統整合。
  • 此功能可將複雜的工作封裝成單一較高層級的動作,以簡化用戶互動(例如使用者驅動自動化)。
  • 此功能可以獨立於應用程式的內部控制運作,而且不需要遵循嚴格的應用程式特定通訊協定。
  • 預期系統或其他應用程式的各部分將以統一方式發現並調用其功能(例如,用來操作檔案或共享內容的 API)。