Fornecedores de chaves de hardware do Microsoft Copilot

A partir do Windows Build 22621, os aplicativos podem se registrar para serem incluídos na interface do usuário do seletor que permite aos usuários selecionar o aplicativo que é iniciado quando a tecla de hardware do Microsoft Copilot ou a tecla Windows + C é pressionada.

Observação

É recomendável que os aplicativos que se registram como um provedor de chave de hardware do Microsoft Copilot sejam implementados como aplicativos de janela única.

Extensão do aplicativo de chave de hardware do Microsoft Copilot

Um aplicativo deve ser empacotado para se registrar como um provedor de chaves de hardware do Microsoft Copilot. Para obter informações sobre o empacotamento de aplicativos, consulte Uma visão geral da Identidade de Pacote em aplicativos do Windows. O arquivo de manifesto do pacote do aplicativo, Package.appxmanifest, dá suporte a muitas extensões e recursos diferentes para aplicativos do Windows. O formato do manifesto do pacote do aplicativo é definido por um conjunto de esquemas documentados na Referência de esquemas de manifesto do pacote. Os provedores de chaves de hardware do Microsoft Copilot declaram suas informações de registro no uap3:AppExtension. O atributo Name da extensão deve ser definido como "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>

A tabela a seguir uap3:AppExtension descreve os atributos do elemento uap3:AppExtension .

Atributo	Descrição	Obrigatório
ID	O identificador definido pelo aplicativo.	Yes
DisplayName	O nome do aplicativo exibido na interface do usuário do seletor de botão de hardware do Windows Copilot.	Yes
Descrição	A descrição do aplicativo exibido na interface do usuário do seletor de botão de hardware do Windows Copilot.	Yes
PublicFolder	A pasta que a entidade declara como o local onde um host pode ter acesso de leitura aos arquivos através de um intermediário.	Yes

Assine o provedor de chaves de hardware do Windows Copilot

Os aplicativos de provedor devem ser assinados para serem habilitados como alvo da chave de hardware do Microsoft Copilot. Para obter informações sobre como empacotar e assinar seu aplicativo, consulte Empacotar um aplicativo de área de trabalho ou UWP no Visual Studio.

Consulte o provedor de chave de hardware Copilot atual

Verifique se seu aplicativo é o destino do usuário para o atalho de teclado & (tecla Windows + C) da chave de hardware Copilot, consultando o valor das seguintes chaves de registro. Para obter mais informações, consulte Recuperando dados do Registro.

Chave do Registro	Descrição	Value
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Identifica se o usuário selecionou Pesquisa ou um aplicativo como o destino da tecla Copilot. O valor "AppEnforcedByPolicy" indica que um destino de aplicativo para a chave Copilot foi definido pela política do administrador de TI. Para obter mais informações, consulte Policy CSP para WindowsAI.	"Search", "App", "AppEnforcedByPolicy"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Identifica o ID do Modelo de Usuário do Aplicativo (AUMID, também conhecido como AppId) do provedor de chave de hardware Copilot que foi configurado por último, mesmo que a chave esteja configurada para "Search".	Um AUMID.

Para proporcionar uma boa experiência de usuário, os aplicativos devem respeitar a seleção do usuário para o aplicativo do provedor de chaves de hardware Copilot e não devem exibir solicitações persistentes ou irritantes para que o usuário altere sua seleção.