共用方式為


Microsoft Copilot 硬體密鑰提供者

自從 Windows 建置 22621 起,應用程式可以註冊以被納入選擇器介面,這樣用戶就能選擇在按下 Microsoft Copilot 硬體鍵或 Windows 鍵 + C 時要啟動的應用程式。

備註

建議註冊為 Microsoft Copilot 硬體密鑰提供者的應用程式應設計為單一視窗應用程式。

Microsoft Copilot 硬體金鑰應用程式擴充套件

要註冊為 Microsoft Copilot 硬體金鑰提供者,應用程式必須進行封裝。 有關應用程式包裝的資訊,請參閱Windows 應用程式中包裝識別概述。 應用程式套件的清單檔案 Package.appxmanifest 支援許多不同的擴充功能和 Windows 應用程式的特性。 應用程式套件清單格式是由一組在套件清單結構描述參考中記載的架構所定義的。 Microsoft Copilot 硬體密鑰提供者會在 uap3:AppExtension 中宣告其註冊資訊。 延伸模組的 Name 屬性必須設定為 「com.microsoft.windows.copilotkeyprovider」。。

<Package
...

  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
...>
    <Applications>
        <Application...>
            ...
            <Extensions>
                <uap3:Extension Category="windows.appExtension">
                    <uap3:AppExtension Name="com.microsoft.windows.copilotkeyprovider" 
                        Id="MyAppId"
                        DisplayName="App display name"
                        Description="App description"
                        PublicFolder="Public" />
                </uap3:Extension>
            </Extensions>
          ...
    </Application>
    </Applications>
    ...
</Package>

以下表格 uap3:AppExtension 描述了 uap3:AppExtension 元素的屬性。

屬性 說明 為必填項目
身份識別碼 應用程式定義的應用程式識別碼。 是的
顯示名稱 Windows Copilot 硬體按鈕選擇器 UI 中顯示的應用程式名稱。 是的
說明 在 Windows Copilot 硬體按鈕選擇器界面中顯示的應用程式描述。 是的
公共資料夾 該資料夾是實例指定為位置,主機可以通過代理訪問文件的地方。 是的

簽署您的 Windows Copilot 硬體金鑰提供者

必須先簽署提供者應用程式,才能啟用為 Microsoft Copilot 硬體密鑰的目標。 如需封裝和簽署應用程式的資訊,請參閱 在Visual Studio中封裝桌面或UWP應用程式

查詢目前的 Copilot 硬體金鑰提供者

查詢下列登錄機碼的值,檢查您的應用程式是否是 Copilot 硬體鍵和 Windows 鍵 + C 鍵盤快速鍵的使用者目標。 如需詳細資訊,請參閱從登錄擷取資料。

登錄鍵 說明 價值觀
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType 識別使用者是否已選取 [搜尋] 或應用程式作為 Copilot 金鑰的目標。 值 “AppEnforcedByPolicy” 指示 IT 系統管理員根據政策設定了 Copilot 金鑰的應用程式目標。 如需詳細資訊,請參閱 原則 CSP - WindowsAI “搜索”、“應用程序”、“AppEnforcedByPolicy”
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid 識別上次設定的 Copilot 硬體金鑰提供者的應用程式使用者模型識別碼 (AUMID,也稱為 AppId),即使金鑰目前設定為搜尋也一樣。 AUMID識別碼。

為了提供良好的使用者體驗,應用程式應該尊重使用者對於 Copilot 硬體金鑰提供者應用程式的選擇,並避免顯示頻繁或煩擾的要求用戶更改其選擇。