Compartilhar via

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
Nome Visível 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.

Solicitação para o provedor de chave de hardware Copilot atual

Verifique se seu aplicativo é o destino do usuário para a tecla de hardware Copilot & tecla do Windows + atalho de teclado C consultando o valor das seguintes chaves do 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 da chave Copilot foi definido pela política de 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 AUMID (ID do Modelo de Usuário do Aplicativo, também conhecido como AppId) do provedor de chaves de hardware Copilot, o último a ser configurado, mesmo que a chave esteja atualmente configurada para Pesquisa. 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.

  • Last updated on