DeviceCapability (Windows 10)

Articolo
02/01/2024

Dichiara una funzionalità del dispositivo richiesta da un pacchetto. In Windows 10.0.10240.0 può contenere fino a 100 elementi Device. In Windows 10.0.10586.0 può contenere fino a 1000 (per la sintassi e gli esempi, vedere Esempi).

Gerarchia degli elementi

<DeviceCapability>

Sintassi

<DeviceCapability
    Name = 'A string with a value between 1 and 50 characters in length or a GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

  <!-- Child elements -->
  Device{0,1000}

</DeviceCapability>

Chiave

{} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
Nome	Nome della funzionalità del dispositivo, specificato come nome descrittivo o GUID della classe dell'interfaccia del dispositivo.	Stringa con un valore compreso tra 1 e 50 caratteri di lunghezza o GUID nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Sì

Elementi figlio

Elemento figlio	Descrizione
Dispositivo	Dichiara una funzione per un dispositivo associato a DeviceCapability. In Windows 10.0.10240.0 un oggetto DeviceCapability può contenere fino a 100 elementi Device. In Windows 10.0.10586.0 può contenere fino a 1000 (per altri dettagli, vedere DeviceCapability).

Elementi padre

Elemento padre	Descrizione
Capabilities	Dichiara l'accesso alle risorse utente protette richieste dal pacchetto. È possibile avere più elementi DeviceCapability e Capability nell'elemento Capabilities , ma tutti gli elementi DeviceCapability devono venire dopo gli elementi Capability .

Osservazioni

Se l'attributo Name viene specificato come GUID, viene convalidato come GUID.

Per impostazione predefinita, alle app viene concesso l'accesso ad alcuni dispositivi. Per accedere ad altri tipi di dispositivi, è necessario specificarli usando un elemento DeviceCapability . Alcune funzionalità del dispositivo devono essere aggiunte manualmente al manifesto del pacchetto. Per altre info, vedi Come specificare funzionalità dei dispositivi nel manifesto di un pacchetto.

Per altre informazioni sulle dichiarazioni di funzionalità, vedi Dichiarazioni di funzionalità dell'app.

Le funzionalità del dispositivo seguenti richiedono elementi figlio.

Funzionalità di dispositivo	Descrizione
Usb	Fornisce l'accesso alle API nello spazio dei nomi Windows.Devices.Usb . Questa funzionalità richiede elementi figlio. Per altre info, vedi Aggiornamento del pacchetto manifesto dell'app per un dispositivo USB.
humaninterfacedevice	Fornisce l'accesso alle API nello spazio dei nomi Windows.Devices.HumanInterfaceDevice . Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare funzionalità dei dispositivi per HID.
bluetooth.genericAttributeProfile	Fornisce l'accesso alle API nello spazio dei nomi Windows.Devices.Bluetooth.GenericAttributeProfile . Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare funzionalità dei dispositivi per Bluetooth.
bluetooth.rfcomm	Fornisce l'accesso alle API nello spazio dei nomi Windows.Devices.Bluetooth.Rfcomm . Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare funzionalità dei dispositivi per Bluetooth.

Esempi

Ecco un esempio di nodo Capabilities che funzionerà sia in Windows 10.0.10240.0 che in 10.0.10586.0 (anche se, Windows 10.0.10240.0 analizzerà solo gli <elementi Device>). Windows 10.0.10586.0, invece, supporta fino a 100 < Elementi del dispositivo> più <f2:Elementi del dispositivo> per un complemento totale di 1000.

<Package
    xmlns:f2="http://schemas.microsoft.com/appx/manifest/foundation/windows10/2">
...
<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10586.0"/>
</Dependencies>
...
<Capabilities>
    <DeviceCapability Name="microphone"/>
    <DeviceCapability Name="webcam"/>
    <DeviceCapability Name="<name>">
        <Device Id="id_000" ... />
        ...
        <Device Id="id_099" ... />
        <f2:Device Id="id_100" ... />
        ...
        <f2:Device Id="id_999" ... />
    </DeviceCapability>
</Capabilities>

Se si vuole supportare solo Windows 10.0.10240.0, è necessario solo l'elemento <Device>. Se si vuole supportare solo Windows 10.0.10586.0, è necessario solo l'elemento <f2:Device>.

Per altri esempi, vedere Come specificare le funzionalità del dispositivo in un manifesto del pacchetto.

Vedi anche

Dichiarazioni di funzionalità delle app

Come specificare funzionalità dei dispositivi nel manifesto di un pacchetto

Requisiti

Elemento	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`

Condividi tramite