Fornecedores de chaves de hardware do Microsoft Copilot

A partir da Compilação do Windows 22621, as aplicações podem registar-se para serem incluídas na interface do utilizador do seletor, que permite aos utilizadores selecionar a aplicação que é iniciada quando a tecla de hardware do Microsoft Copilot ou a combinação de teclas Windows + C é pressionada.

Observação

Recomenda-se que as aplicações que se registam para ser um fornecedor de chave de hardware para o Microsoft Copilot sejam implementadas como aplicações de janela única.

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

Uma aplicação deve ser empacotada para se registar como fornecedor de chave de hardware do Microsoft Copilot. Para obter informações sobre o empacotamento do aplicativo, consulte Visão geral da identidade do pacote no aplicativo do Windows. O ficheiro de manifesto do pacote de aplicações, Package.appxmanifest, suporta muitas extensões e funcionalidades diferentes para aplicações Windows. O formato de manifesto do pacote do aplicativo é definido por um conjunto de esquemas que são documentados na referência do esquema de manifesto do pacote . Os provedores de chave de hardware do Microsoft Copilot declaram suas informações de registro dentro do 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 para a aplicação.	Yes
Nome de Exibição	O nome da aplicação exibido na interface de seleção de botões de hardware do Windows Copilot.	Yes
Descrição	A descrição da aplicação exibida na interface do botão de seleção de hardware do Windows Copilot.	Yes
Pasta de Utilização Pública	A pasta que a instância declara como o local onde um host pode ter acesso de leitura a ficheiros através de um intermediário.	Yes

Assine o fornecedor da chave de hardware do Windows Copilot

As aplicações do provedor devem ser assinadas para serem habilitadas 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.

Interrogação ao atual provedor de chave de hardware Copilot

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

Chave de registo	Descrição	Valor
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Identifica se o usuário selecionou Pesquisar ou um aplicativo como o destino da chave Copilot. O valor "AppEnforcedByPolicy" indica que uma aplicação alvo da chave Copilot foi definida pela política do administrador de TI. Para obter mais informações, consulte Policy CSP - WindowsAI.	"Pesquisa", "App", "AppEnforcedByPolicy"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Identifica a ID do Modelo de Usuário do Aplicativo (AUMID, também conhecida como AppId) do provedor de chave de hardware Copilot que foi configurado pela última vez, mesmo que a chave esteja atualmente configurada para Pesquisar.	Um AUMID.

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