Come specificare funzionalità dei dispositivi nel manifesto di un pacchetto

Nota

Per Windows 10, vedere Novità di Windows 10.

 

Per dichiarare ogni funzionalità di dispositivo richiesta dall'app Windows Runtime, aggiungere un elemento DeviceCapability e gli elementi figlio applicabili al manifesto del pacchetto.

Importante

Alcune funzionalità del dispositivo devono essere specificate manualmente. Ad esempio, è necessario usare l'editor XML (testo) per specificare le funzionalità del dispositivo per le API USB, HID (Human Interface Device), POS (Point of Service), Bluetooth GATT e Bluetooth RFCOMM.

 

Passaggio 1:

Apri il file Package.appxmanifest. In Microsoft Visual Studio aprire il file con l'editor XML (testo). A tale scopo, in Esplora soluzioni fare clic con il pulsante destro del mouse sul file e scegliere Apri con. Selezionare quindi Editor XML (testo) e fare clic su OK.

Passaggio 2:

Aggiungere un elemento DeviceCapability per ogni funzionalità del dispositivo. È possibile avere più elementi DeviceCapability e Capability nell'elemento Capabilities , ma tutti gli elementi DeviceCapability devono essere dopo gli elementi Capability . Si noti che alcune funzionalità del dispositivo richiedono più elementi figlio. Per altre informazioni, vedi DeviceCapability.

Nota

Non tutte le API sono disponibili sia per le app UWP che Windows 8.x Telefono app. Per altri dettagli sui dispositivi supportati da ogni API, vedere la documentazione di riferimento dell'API.

 

Esempio di webcam

Ecco un esempio della funzionalità del dispositivo webcam . Questa funzionalità del dispositivo non richiede elementi figlio. Per un esempio di come usare una webcam, vedere Come registrare audio o video.

<Capabilities>
  <Capability Name="internetClient"/>
  <Capability Name="musicLibrary"/>
  <Capability Name="videosLibrary"/>
  <DeviceCapability Name="microphone"/>
  <DeviceCapability Name="webcam"/>
</Capabilities>

Esempio di USB

La funzionalità del dispositivo USB consente l'accesso alle API nel Windows. Spazio dei nomi Devices.Usb. Per altre informazioni, vedere Aggiornamento del pacchetto manifesto dell'app per un dispositivo USB.

<DeviceCapability Name="usb">
    <Device Id="vidpid:xxxx xxxx">
      <Function Type="classId:xx xx xx"/>
      <Function Type="name:xxxxx"/>
      <Function Type="winUsbId:xxxxx"/>
    </Device>
</DeviceCapability>

Esempio di dispositivo HID (Human Interface Device)

La funzionalità del dispositivo humaninterfacedevice consente l'accesso alle API nel Windows. Spazio dei nomi Devices.HumanInterfaceDevice. In questo esempio la funzionalità consente l'accesso a qualsiasi dispositivo di una funzione specifica. Per altre info, vedi Come specificare funzionalità dei dispositivi per HID.

<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:xxxx xxxx"/>
    </Device>
</DeviceCapability>

Esempio pos (Point of Service)

La funzionalità di dispositivo pointOfService consente l’accesso alle API nello spazio dei nomi Windows.Devices.PointOfService. Questa funzionalità del dispositivo non richiede elementi figlio.

<Capabilities>
  <DeviceCapability Name="pointOfService"/>
</Capabilities>

Bluetooth esempio GATT

La funzionalità di dispositivo bluetooth.genericAttributeProfile consente l'accesso alle API nel Windows. Dispositivi. Bluetooth. Spazio dei nomi GenericAttributeProfile. In questo esempio la funzionalità consente l'accesso a qualsiasi dispositivo di una funzione specifica. Per altre info, vedi Come specificare funzionalità dei dispositivi per Bluetooth.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.genericAttributeProfile">
      <m2:Device Id="any">
        <m2:Function Type="name:xxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

Bluetooth esempio RFCOMM

La funzionalità di dispositivo bluetooth.rfcomm consente l'accesso alle API nel Windows. Dispositivi. Bluetooth. Spazio dei nomi Rfcomm. In questo esempio la funzionalità consente l'accesso a qualsiasi dispositivo di una funzione specifica. Per altre info, vedi Come specificare funzionalità dei dispositivi per Bluetooth.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.rfcomm">
      <m2:Device Id="any">
        <m2:Function Type="serviceId:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

Argomenti correlati

Dispositivi, sensori e alimentazione

Riferimento all'elemento DeviceCapability

Dichiarazioni di funzionalità delle app