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 que os usuários selecionem o aplicativo que é iniciado quando a tecla de hardware do Microsoft Copilot é 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 do aplicativo, consulte Uma visão geral do Identidade do Pacote no aplicativo 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 para o aplicativo.	Sim
DisplayName	O nome do aplicativo exibido na interface do usuário do seletor de botão de hardware do Windows Copilot.	Sim
Descrição	A descrição do aplicativo exibida na interface do usuário do seletor de botão de hardware do Windows Copilot.	Sim
PublicFolder	A pasta que a instância declara como o local onde um host pode ter acesso de leitura aos arquivos por meio de um agente.	Sim