Partager via

Fournisseurs de clés matérielles Microsoft Copilot

À compter de Windows Build 22621, les applications peuvent s’inscrire pour être incluses dans l’interface utilisateur du sélecteur qui permet aux utilisateurs de sélectionner l’application lancée lorsque la touche matérielle Microsoft Copilot ou la touche Windows + C est enfoncée.

Remarque

Il est recommandé que les applications qui s’inscrivent pour être un fournisseur de clés matérielles Microsoft Copilot soient implémentées en tant qu’applications à fenêtre unique.

Extension d'application pour la touche physique Microsoft Copilot

Une application doit être empaquetée pour s’inscrire en tant que fournisseur de clés matérielles Microsoft Copilot. Pour plus d’informations sur l’empaquetage d’applications, consultez Une vue d’ensemble de l’identité de package dans l’application Windows. Le fichier manifeste du package d’application, prend Package.appxmanifesten charge de nombreuses extensions et fonctionnalités différentes pour les applications Windows. Le format du manifeste du package d’application est défini par un ensemble de schémas documentés dans les Informations de référence sur le schéma du manifeste de package. Les fournisseurs de clés matérielles Microsoft Copilot déclarent leurs informations d’inscription dans le uap3:AppExtension. L’attribut Name de l’extension doit être défini sur « 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>

Le tableau suivant uap3 :AppExtension décrit les attributs de l’élément uap3 :AppExtension .

Caractéristique Descriptif Obligatoire
Id Identificateur défini par l’application. Oui
Nom affiché Nom de l’application affiché dans l’interface utilisateur du sélecteur de bouton matériel Windows Copilot. Oui
Descriptif Description de l’application affichée dans l’interface utilisateur du sélecteur de bouton matériel Windows Copilot. Oui
PublicFolder Dossier que l’instance déclare comme emplacement où un hôte peut avoir accès en lecture aux fichiers via un répartiteur. Oui

Signez votre fournisseur de touche physique Windows Copilot

Les applications de fournisseur doivent être connectées pour être activées en tant que cible de la clé matérielle Microsoft Copilot. Pour plus d’informations sur l’empaquetage et la signature de votre application, consultez Packager une application de bureau ou UWP dans Visual Studio.

Rechercher le fournisseur actuel de clés matérielles Copilot

Vérifiez si votre application est la cible de l’utilisateur pour la touche matérielle Copilot et le raccourci clavier Windows + C en interrogeant la valeur des touches de Registre suivantes. Pour plus d’informations, consultez Récupération de données à partir du Registre.

Clé du Registre Descriptif Valeur
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType Identifie si l’utilisateur a sélectionné Rechercher ou une application comme cible de la clé Copilot. La valeur « AppEnforcedByPolicy » indique qu'une application ciblée par la clé Copilot a été définie par une politique administrateur IT. Pour plus d’informations, consultez Stratégie CSP - WindowsAI. « Recherche », « App », « AppEnforcedByPolicy »
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid Identifie l’ID de modèle utilisateur de l’application (AUMID, également appelé AppId) du fournisseur de clés matérielles Copilot qui a été configuré pour la dernière fois, même si la clé est actuellement en mode Recherche. An AUMID.

Pour offrir une expérience utilisateur optimale, les applications doivent respecter la sélection de l’utilisateur pour l’application fournisseur de clés matérielles Copilot et ne doivent pas afficher de demandes persistantes ou bruyantes pour que l’utilisateur modifie sa sélection.

  • Last updated on