Freigeben über

Microsoft Copilot-Hardwareschlüsselanbieter

Ab Windows Build 22621 können Apps registriert werden, die in der Auswahlbenutzeroberfläche enthalten sein sollen, mit der Benutzer die App auswählen können, die gestartet wird, wenn die Microsoft Copilot-Hardwaretaste oder die Windows-Taste +C gedrückt wird.

Hinweis

Es wird empfohlen, Apps, die sich als Microsoft Copilot-Hardwareschlüsselanbieter registrieren, als Ein-Fenster-Apps zu implementieren.

Microsoft Copilot Hardware-Schlüssel App-Erweiterung

Eine App muss verpackt werden, um sich als Microsoft Copilot-Hardwareschlüsselanbieter zu registrieren. Informationen zum Verpacken von Apps finden Sie in der Übersicht über die Paketidentität in der Windows-App. Die App-Paketmanifestdatei, Package.appxmanifestunterstützt viele verschiedene Erweiterungen und Features für Windows-Apps. Das Format des App-Paketmanifests wird durch eine Reihe von Schemas definiert, die in der Paketmanifestschemareferenz dokumentiert sind. Microsoft Copilot-Hardwareschlüsselanbieter deklarieren ihre Registrierungsinformationen innerhalb der uap3:AppExtension. Das Name-Attribut der Erweiterung muss auf "com.microsoft.windows.copilotkeyprovider" festgelegt werden.

<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>

In der folgenden Tabelle "uap3:AppExtension " werden die Attribute des uap3:AppExtension-Elements beschrieben.

Merkmal BESCHREIBUNG Erforderlich
Id Der von der App definierte Bezeichner für die App. Ja
Anzeigename Der App-Name, der in der Windows Copilot-Benutzeroberfläche für die Hardwaretastenauswahl angezeigt wird. Ja
BESCHREIBUNG Die App-Beschreibung, die in der Windows Copilot-Benutzeroberfläche für die Hardwaretastenauswahl angezeigt wird. Ja
PublicFolder Der Ordner, den die Instanz als Speicherort deklariert, an dem ein Host Lesezugriff auf Dateien über einen Broker haben kann. Ja

Signieren des Windows Copilot-Hardwareschlüsselanbieters

Anbieter-Apps müssen angemeldet sein, damit sie als Ziel des Microsoft Copilot-Hardwareschlüssels aktiviert werden können. Informationen zum Verpacken und Signieren Ihrer App finden Sie unter Verpacken einer Desktop- oder UWP-App in Visual Studio.

Abfrage des aktuellen Anbieters für Copilot-Hardwareschlüssel

Überprüfen Sie, ob Ihre App das Ziel des Benutzers für die Copilot-Hardwaretaste und die Tastenkombination Windows-Taste +C ist, indem Sie den Wert der folgenden Registrierungsschlüssel abfragen. Weitere Informationen finden Sie unter Abrufen von Daten aus der Registrierung.

Registrierungsschlüssel BESCHREIBUNG Wert
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType Gibt an, ob der Benutzer "Suche" oder eine App als Ziel des Copilot-Schlüssels ausgewählt hat. Der Wert "AppEnforcedByPolicy" gibt an, dass ein App-Ziel des Copilot-Schlüssels von der IT-Administratorrichtlinie festgelegt wurde. Weitere Informationen finden Sie unter Policy CSP – WindowsAI. "Suche", "App", "AppEnforcedByPolicy"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid Ermittelt die Application User Model ID (AUMID, auch bekannt als AppId) des zuletzt konfigurierten Hardware-Schlüsselanbieters von Copilot, selbst wenn der Schlüssel aktuell für die Suche konfiguriert ist. Eine AUMID.

Um eine gute Benutzererfahrung zu bieten, sollten Apps die Auswahl des Benutzers für die Copilot-Hardwareschlüsselanbieter-App respektieren und nicht dauerhafte oder laute Anforderungen anzeigen, damit der Benutzer seine Auswahl ändern kann.

  • Last updated on