Zprostředkovatelé hardwarových klíčů Microsoft Copilot

Od verze Windows Build 22621 se aplikace mohou registrovat k tomu, aby byly zahrnuty v uživatelském rozhraní výběru, které umožňuje uživatelům vybrat aplikaci, která se spustí, když se stiskne hardwarová klávesa Microsoft Copilot nebo kombinace kláves Windows + C.

Poznámka:

Doporučuje se, aby aplikace, které se registrují jako poskytovatelé hardwarových klíčů pro Microsoft Copilot, byly implementovány jako jedno-okenní aplikace.

Rozšíření aplikace Microsoft Copilot pro hardwarový klíč

Aby se aplikace mohla zaregistrovat jako poskytovatel hardwarového klíče Microsoft Copilotu, musí být zabalená. Informace o balení aplikací najdete v tématu Přehled identity balíčku v aplikaci pro Windows. Soubor manifestu balíčku aplikace, Package.appxmanifest, podporuje mnoho různých rozšíření a funkcí pro aplikace Windows. Formát manifestu balíčku aplikace je definován sadou schémat, která jsou zdokumentována v odkazu na schéma manifestu balíčku . Poskytovatelé hardwarových klíčů Microsoft Copilot deklarují své registrační informace v rámci uap3:AppExtension. Atribut Název rozšíření musí být nastaven na "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>

Následující tabulka uap3:AppExtension popisuje atributy prvku uap3:AppExtension.

Vlastnost	Popis	Povinné
identifikační číslo	Identifikátor definovaný aplikací pro aplikaci.	Ano
ZobrazovanéJméno	Název aplikace zobrazený v uživatelském rozhraní pro výběr hardwarového tlačítka Windows Copilot.	Ano
Popis	Popis aplikace zobrazený v uživatelském rozhraní pro výběr hardwarového tlačítka Windows Copilot.	Ano
PublicFolder	Složka, kterou instance deklaruje jako místo, kde host může mít prostřednictvím zprostředkovatele přístup k souborům pro čtení.	Ano

Podepsání zprostředkovatele hardwarového klíče Windows Copilot

Aby mohly být aplikace poskytovatelů povoleny jako cíle pro hardwarový klíč Microsoft Copilot, musí být podepsány. Pro více informací o balení a podepisování vaší aplikace viz Zabalení konvenční nebo UWP aplikace v sadě Visual Studio.

Dotaz na aktuálního zprostředkovatele hardwarového klíče Copilot

Pomocí dotazu na hodnotu následujících klíčů v registru zkontrolujte, zda je vaše aplikace určena jako cílová pro hardwarovou klávesu Copilot a klávesovou zkratku Windows + C. Další informace naleznete v tématu Načítání dat z registru.

Klíč registru	Popis	Hodnota
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Určuje, jestli uživatel jako cíl klíče Copilot vybral funkci Hledat nebo aplikaci. Hodnota "AppEnforcedByPolicy" označuje, že cíl aplikace klíče Copilot byl nastaven zásadami správce IT. Další informace najdete v tématu CSP zásad – WindowsAI.	"Hledat", "Aplikace", "AplikaceVynucenáPolicí"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Identifikuje ID modelu uživatele aplikace (AUMID, označované také jako AppId) zprostředkovatele hardwarového klíče Copilotu, který byl naposledy nakonfigurován, i když je klíč aktuálně nakonfigurovaný pro vyhledávání.	An AUMID.

Aby bylo možné zajistit dobré uživatelské prostředí, měly by aplikace respektovat výběr uživatele pro aplikaci zprostředkovatele hardwarového klíče Copilot a neměly by zobrazovat trvalé nebo hlučné žádosti o změnu výběru uživatele.