Поставщики ключей оборудования Microsoft Copilot

Начиная с Windows Build 22621 приложения могут быть включены в пользовательский интерфейс средства выбора, который позволяет пользователям выбирать приложение, которое запускается при нажатии аппаратного ключа Microsoft Copilot или клавиши Windows + C.

Замечание

Рекомендуется, чтобы приложения, которые регистрируются в качестве поставщика ключей оборудования Microsoft Copilot, реализуются как приложения с одним окном.

Расширение приложения ключей оборудования Microsoft Copilot

Для регистрации в качестве поставщика ключей оборудования Microsoft Copilot необходимо упаковать приложение. Дополнительные сведения о упаковке приложений см. в разделе Обзор идентификации пакета в приложении Windows. Файл Package.appxmanifestманифеста пакета приложения поддерживает множество различных расширений и функций для приложений Windows. Формат манифеста пакета приложения определяется набором схем, которые описаны в справочнике по схемам манифеста пакета. Поставщики ключей оборудования Microsoft Copilot объявляют сведения о регистрации в uap3:AppExtension. Атрибут Name расширения должен иметь значение 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>

В следующей таблице uap3:AppExtension описываются атрибуты элемента uap3:AppExtension .

Свойство	Описание	Обязательно
Идентификатор	Идентификатор, определяемый приложением.	Да
Отображаемое имя	Имя приложения, отображаемое в пользовательском интерфейсе средства выбора аппаратной кнопки Windows Copilot.	Да
Описание	Описание приложения, отображаемое в интерфейсе выбора кнопки устройства Windows Copilot.	Да
PublicFolder	Папка, объявленная экземпляром в качестве расположения, где хост может иметь доступ к файлам только для чтения через брокер.	Да

Подпишите поставщика аппаратных ключей Windows Copilot

Для того чтобы приложения поставщика могли быть использованы в качестве цели аппаратного ключа Microsoft Copilot, они должны быть подписаны. Для получения сведений об упаковке и подписывании вашего приложения см. статью "Упаковка и подписывание классического или UWP приложения в Visual Studio".

Запрос к текущему поставщику ключей оборудования Copilot

Проверьте, является ли ваше приложение целевым объектом для ключа оборудования Copilot и сочетания клавиш Windows + C, запрашивая значение следующих разделов реестра. Дополнительные сведения см. в разделе "Получение данных из реестра".

Ключ реестра	Описание	Ценность
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Определяет, выбрал ли пользователь поиск или приложение в качестве целевого объекта ключа Copilot. Значение AppEnforcedByPolicy указывает, что цель приложения ключа Copilot была задана политикой ИТ-администратора. Для получения дополнительной информации см. Политики CSP – WindowsAI.	"Поиск", "Приложение", "ПриложениеПринужденноеПолитикой"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Определяет идентификатор модели пользователя приложения (AUMID, также известный как AppId) поставщика аппаратных ключей Copilot, который был настроен в последний раз, даже если в настоящее время ключ настроен на режим "Поиска".	An AUMID.

Чтобы обеспечить хороший пользовательский опыт, приложения должны уважительно относиться к выбору пользователя относительно приложения поставщика ключей оборудования Copilot и не должны постоянно или назойливо запрашивать изменение этого выбора.