Provider di chiavi hardware di Microsoft Copilot

A partire da Windows Build 22621, le app possono registrarsi per essere incluse nell'interfaccia utente di selezione che consente agli utenti di selezionare l'app avviata quando viene premuto il tasto hardware di Microsoft Copilot.

Nota

È consigliabile implementare le app che si registrano come provider di chiavi hardware di Microsoft Copilot come app a finestra singola.

Estensione dell'app per le chiavi hardware di Microsoft Copilot

Un'app deve essere inserita in un pacchetto per eseguire la registrazione come provider di chiavi hardware di Microsoft Copilot. Per informazioni sulla creazione di pacchetti di app, vedere Panoramica dell'identità del pacchetto nell'app di Windows. Il file manifesto del pacchetto dell'app, Package.appxmanifest, supporta molte estensioni e funzionalità diverse per le app di Windows. Il formato manifesto del pacchetto dell'app è definito da un set di schemi documentati nel Riferimento dello schema del manifesto del pacchetto. I provider di chiavi hardware di Microsoft Copilot dichiarano le informazioni di registrazione all'interno di uap3:AppExtension. L'attributo Name dell'estensione deve essere impostato su "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>

La tabella seguente uap3:AppExtension descrive gli attributi dell'elemento uap3:AppExtension .

Attributo	Descrizione	Richiesto
ID.	Identificatore definito dall'app per l'app.	Sì
DisplayName	Nome dell'app visualizzato nell'interfaccia utente di selezione del pulsante hardware di Windows Copilot.	Sì
Descrizione	Descrizione dell'app visualizzata nell'interfaccia utente di selezione del pulsante hardware di Windows Copilot.	Sì
Cartella pubblica	Cartella dichiarata dall'istanza come percorso in cui un host può avere accesso in lettura ai file tramite un broker.	Sì