Penyedia kunci perangkat keras Microsoft Copilot

Dimulai dengan Windows Build 22621, aplikasi dapat mendaftar untuk disertakan dalam UI pemilih yang memungkinkan pengguna memilih aplikasi yang diluncurkan saat kunci perangkat keras Microsoft Copilot atau tombol Windows + C ditekan.

Nota

Disarankan agar aplikasi yang mendaftar menjadi penyedia kunci perangkat keras Microsoft Copilot diimplementasikan sebagai aplikasi jendela tunggal.

Ekstensi aplikasi kunci perangkat keras untuk Microsoft Copilot

Aplikasi harus dipaketkan untuk mendaftar sebagai penyedia kunci perangkat keras Microsoft Copilot. Untuk informasi tentang kemasan aplikasi, lihat Gambaran umum Identitas Paket di aplikasi Windows. File manifes paket aplikasi, Package.appxmanifest, mendukung banyak ekstensi dan fitur yang berbeda untuk aplikasi Windows. Format manifes paket aplikasi didefinisikan oleh sekumpulan skema yang terdapat pada skema referensi manifes paket. Penyedia kunci perangkat keras Microsoft Copilot mendeklarasikan informasi pendaftaran mereka dalam uap3:AppExtension. Atribut Nama dari ekstensi harus disetel ke "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>

Tabel berikut uap3:AppExtension menjelaskan atribut elemen uap3:AppExtension .

Karakteristik	Deskripsi	Diperlukan
Nomor Identitas	Pengidentifikasi yang ditentukan oleh aplikasi.	Ya
NamaTampilan	Nama aplikasi yang ditampilkan di antarmuka pemilih tombol perangkat keras Windows Copilot.	Ya
Deskripsi	Deskripsi aplikasi ditampilkan di UI pemilih tombol perangkat keras Windows Copilot.	Ya
PublicFolder	Folder yang dinyatakan oleh instans sebagai tempat di mana host dapat memiliki akses baca ke file melalui broker.	Ya

Menandatangani penyedia kunci perangkat keras Windows Copilot Anda

Aplikasi penyedia harus ditandatangani agar dapat diaktifkan sebagai target tombol perangkat keras Microsoft Copilot. Untuk informasi tentang pengemasan dan penandatanganan aplikasi Anda, lihat Mengemas desktop atau aplikasi UWP di Visual Studio.

Permintaan untuk penyedia kunci perangkat keras Copilot saat ini

Periksa apakah aplikasi Anda adalah target pengguna untuk kunci perangkat keras Copilot & tombol Windows + pintasan keyboard C dengan mengkueri nilai kunci registri berikut. Untuk informasi selengkapnya, lihat Mengambil Data dari Registri.

Kunci registri	Deskripsi	Nilai
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType	Mengidentifikasi apakah pengguna telah memilih Pencarian atau aplikasi sebagai target kunci Copilot. Nilai "AppEnforcedByPolicy" menunjukkan bahwa target aplikasi kunci Copilot telah ditetapkan oleh kebijakan administrator TI. Untuk informasi selengkapnya, lihat Policy CSP - WindowsAI.	"Pencarian", "Aplikasi", "AppEnforcedByPolicy"
HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid	Mengidentifikasi Id Model Pengguna Aplikasi (AUMID, juga dikenal sebagai AppId) dari penyedia kunci perangkat keras Copilot yang terakhir dikonfigurasi, bahkan jika kunci saat ini dikonfigurasi untuk Pencarian.	AUMID.

Untuk memberikan pengalaman pengguna yang baik, aplikasi harus menghormati pilihan pengguna untuk aplikasi penyedia kunci perangkat keras Copilot dan tidak boleh menampilkan permintaan persisten atau berisik bagi pengguna untuk mengubah pilihan mereka.