Microsoft Copilot donanım anahtar sağlayıcıları

Windows Build 22621 ile başlayarak, uygulamalar Microsoft Copilot donanım tuşuna veya Windows tuşu + C'ye basıldığında başlatılacak uygulamayı seçmenize olanak tanıyan seçim kullanıcı arayüzüne dahil olmak için kayıt yaptırabilir.

Uyarı

Microsoft Copilot donanım anahtar sağlayıcısı olarak kayıt yaptıran uygulamaların, tek pencere uygulamaları olarak uygulanması önerilir.

Microsoft Copilot donanım anahtarı uygulama uzantısı

Bir uygulamanın Microsoft Copilot donanım anahtarı sağlayıcısı olarak kaydedilmesi için paketlenmesi gerekmektedir. Windows uygulamalarında Paket Kimliği Hakkında Genel Bilgi için, Windows uygulamasında Paket Kimliği Genel Bakışı bölümüne bakın. Uygulama paketi bildirim dosyası, Package.appxmanifestWindows uygulamaları için birçok farklı uzantıyı ve özelliği destekler. Uygulama paketi bildirim biçimi, Paket bildirim şeması referansı belgelenen bir dizi şema tarafından tanımlanır. Microsoft Copilot donanım anahtarı sağlayıcıları kayıt bilgilerini uap3:AppExtension içinde bildirir. Uzantının İsim özelliği "com.microsoft.windows.copilotkeyprovider" olarak ayarlanmalıdır.

<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şağıdaki uap3:AppExtension tablosunda uap3:AppExtension öğesinin öznitelikleri açıklanmaktadır.

Özellik	Açıklama	Gerekli
Kimlik	Uygulama için uygulama tarafından tanımlanan tanımlayıcı.	Evet
Gösterim Adı	Windows Copilot donanım düğmesi seçim arayüzünde görüntülenen uygulama adı.	Evet
Açıklama	Windows Copilot donanım düğmesi seçim arayüzünde gösterilen uygulama açıklaması.	Evet
Ortak Kullanım Klasörü	Örneğin, bir ana bilgisayarın bir aracılık sistemi aracılığıyla dosyalara okuma erişimine sahip olabileceği konum olarak belirttiği klasör.	Evet

Windows Copilot donanım anahtarı sağlayıcınızı imzalama

Microsoft Copilot donanım anahtarının hedefi olarak etkinleştirilebilmesi için sağlayıcı uygulamalarının oturum açması gerekir. Uygulamanızı paketleme ve imzalama hakkında bilgi için bkz. Visual Studio'da masaüstü veya UWP uygulaması paketleme.

Geçerli Copilot donanım anahtarı sağlayıcısını sorgulama

Aşağıdaki kayıt defteri anahtarlarının değerini sorgulayarak uygulamanızın Copilot donanım tuşu ve Windows tuşu + C klavye kısayolu için kullanıcının hedefi olup olmadığını denetleyin. Daha fazla bilgi için bkz. Kayıt Defterinden Veri Alma.

Kayıt defteri anahtarı	Açıklama	Değer
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Kullanıcının Copilot anahtarının hedefi olarak Ara'yı mı yoksa bir uygulamayı mı seçtiğini tanımlar. "AppEnforcedByPolicy" değeri, Copilot anahtarının uygulama hedefinin BT yönetici ilkesi tarafından ayarlandığını gösterir. Daha fazla bilgi için bakınız: Politika CSP - WindowsAI.	"Arama", "App", "Uygulama, Politika Tarafından Zorunlu"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Copilot donanım anahtarı sağlayıcısının en son yapılandırılmış Uygulama Kullanıcı Modeli Kimliğini (AUMID, ayrıca AppId olarak bilinir), anahtar şu anda Arama olarak yapılandırılmış olsa bile tanımlar.	An AUMID.

İyi bir kullanıcı deneyimi sağlamak için uygulamalar, copilot donanım anahtarı sağlayıcısı uygulaması için kullanıcının seçimine saygılı olmalı ve kullanıcının seçimini değiştirmesi için kalıcı veya gürültülü istekler göstermemelidir.