Abilitare le funzionalità del dispositivo per un'app di Windows

Questo argomento illustra come dichiarare le funzionalità del dispositivo in Microsoft Visual Studio quando si usano fotocamere, microfoni, sensori di posizione e altri dispositivi in un'app Di Windows.

Specificare le funzionalità del dispositivo che verrà usata dall'app

Devi dichiarare nel manifesto del pacchetto dell'app tipi specifici di dispositivi usati dall'app. In Visual Studio è possibile dichiarare la maggior parte usando Progettazione manifesto oppure è possibile aggiungerli manualmente come descritto in Come specificare le funzionalità del dispositivo in un manifesto del pacchetto (manualmente). Questa esercitazione usa il Manifest Designer.

• In Esplora Soluzioni di Visual Studio, fai doppio clic sul file manifesto del pacchetto Package.appxmanifest.
• Aprire la scheda Funzionalità .
• Selezionare le funzionalità del dispositivo usate dall'app. Se non vedi la funzionalità che stai cercando in Manifest Designer, aggiungila manualmente. Per altre info, vedi Come specificare le funzionalità del dispositivo in un manifesto del pacchetto.

Funzionalità del dispositivo	Progettazione di manifest	Descrizione
Messaggi di chat bloccati		Consente alle app di leggere messaggi SMS e MMS bloccati dall'app Filtro posta indesiderata.
Accesso ai messaggi di chat		Consente alle app di leggere ed eliminare messaggi di testo. Consente anche alle app di archiviare i messaggi di chat nell'archivio dati di sistema.
Generazione di codice		Consente alle app di generare codice in modo dinamico.
Autenticazione aziendale		Questa funzionalità è soggetta ai criteri di Microsoft Store. Offre la possibilità di connettersi alle risorse Intranet aziendali che richiedono credenziali di dominio. Questa funzionalità non è in genere necessaria per la maggior parte delle app.
Internet (client)		Fornisce l'accesso in uscita a Internet e alle reti in luoghi pubblici come aeroporti e bar. Ad esempio, reti Intranet in cui l'utente ha designato la rete come pubblica. La maggior parte delle app che richiedono l'accesso a Internet deve usare la funzionalità .
Internet (Client & Server)		Fornisce l'accesso in ingresso e in uscita a Internet e alle reti in luoghi pubblici come aeroporti e bar. Questa funzionalità è un superset di Internet (Client).This capability is a superset of Internet (Client). Internet (client) non deve essere abilitato se questa funzionalità è abilitata. L'accesso in ingresso alle porte critiche viene sempre bloccato.
Ubicazione		Fornisce l'accesso alla posizione corrente. Questo è ottenuto da hardware dedicato come un sensore GPS nel PC, o derivato dalle informazioni di rete disponibili.
Microfono		Fornisce l'accesso al feed audio del microfono. In questo modo l'app può registrare da microfoni connessi.
Libreria musicale		Offre la possibilità di aggiungere, modificare o eliminare file nella Raccolta musica per i PC locali e i PC homegroup .
Oggetti 3D		Fornisce l'accesso a livello di codice agli oggetti 3D dell'utente, consentendo all'app di enumerare e accedere a tutti i file nella libreria senza interazione dell'utente. Questa funzionalità viene in genere usata nelle app e nei giochi 3D che devono accedere all'intera libreria di oggetti 3D .
Telefonata		Consente alle app di accedere a tutte le linee telefonico sul dispositivo ed eseguire le funzioni seguenti: effettuare una chiamata al telefono e mostrare il dialer di sistema senza chiedere conferma all'utente; accedere ai metadati correlati alla riga; accedere ai trigger correlati alla riga. Consente all'app di filtro spam selezionata dall'utente di impostare e verificare l'elenco di blocco e le informazioni sull'origine delle chiamate.
Raccolta immagini		Offre la possibilità di aggiungere, modificare o eliminare file nella raccolta immagini per i PC locali e i PC homegroup .
Punto di servizio		Fornisce l'accesso alle periferiche Point of Service.
Reti Private (Client e Server)		Fornisce l'accesso in ingresso e in uscita alle reti Intranet con un controller di dominio autenticato o che l'utente ha designato come reti domestico o aziendale. L'accesso in ingresso alle porte critiche viene sempre bloccato.
Prossimità		Fornisce la possibilità di connettersi ai dispositivi in prossimità del PC tramite la comunicazione near-field (NFC). Le tecnologie a campo vicino possono essere utilizzate per inviare file o comunicare con un'app su un dispositivo nelle vicinanze.
Archivi rimovibili		Offre la possibilità di aggiungere, modificare o eliminare file nei dispositivi di archiviazione rimovibili. L'app può accedere solo ai tipi di file nella risorsa di archiviazione rimovibile definita nel manifesto usando la dichiarazione Associazioni di tipi di file . L'app non può accedere allo spazio di archiviazione rimovibile nei PC homegroup .
Certificati utente condivisi		Questa funzionalità è soggetta ai criteri di Microsoft Store. Offre la possibilità di accedere a certificati software e hardware, ad esempio certificati di smart card, per convalidare l'identità di un utente. Quando le API correlate vengono richiamate in fase di esecuzione, l'utente deve intervenire (inserire una scheda, selezionare il certificato e così via). Questa funzionalità non è necessaria se l'app include un certificato privato tramite una dichiarazione Certificati .
Informazioni sull'account utente		Offre alle app la possibilità di accedere al nome e all'immagine dell'utente.
Libreria video		Offre la possibilità di aggiungere, modificare o eliminare file nella raccolta video per i PC locali e i PC homegroup .
Chiamate VOIP		Consente alle app di accedere alle API di chiamata VOIP.
Webcam		Fornisce l'accesso alla fotocamera incorporata o al feed video della webcam collegata. Ciò consente all'app di acquisire snapshot e film.
USB		Fornisce l'accesso a dispositivi USB personalizzati. Questa funzionalità richiede elementi figlio. Questa funzionalità non è supportata in Windows Phone.
Dispositivo di interfaccia umana (HID)		Fornisce l'accesso a Human Interface Devices (HID). Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare le funzionalità del dispositivo per HID.
Bluetooth GATT		Fornisce l'accesso ai dispositivi Bluetooth LE tramite una raccolta di servizi primari, servizi inclusi, caratteristiche e descrittori. Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare le funzionalità del dispositivo per Bluetooth.
Bluetooth RFCOMM		Fornisce l'accesso alle API che supportano il trasporto BR/EDR (Basic Rate/Extended Data Rate) e consente anche all'app di accedere a un dispositivo che implementa il profilo di porta seriale (SPP). Questa funzionalità richiede elementi figlio. Per altre info, vedi Come specificare le funzionalità del dispositivo per Bluetooth.

Considerazioni su Windows App SDK

Quando si usa Windows App SDK, tenere presente quanto segue per quanto riguarda le funzionalità del dispositivo:

• App in pacchetto: le funzionalità del dispositivo vengono dichiarate nello Package.appxmanifest stesso modo delle app UWP. I nomi delle funzionalità e gli elementi XML sono identici.
• App non in pacchetto: le app di Windows App SDK non in pacchetto non usano un manifesto del pacchetto dell'app. L'accesso ai dispositivi è invece regolato dalle autorizzazioni a livello di sistema operativo e dalle richieste di consenso utente in fase di esecuzione. Non sono necessarie dichiarazioni di funzionalità, ma agli utenti potrebbe comunque essere richiesto di concedere l'accesso (ad esempio, per fotocamera o microfono).
• API di Windows Runtime: le API del dispositivo Windows Runtime (ad esempio Windows.Devices.Bluetooth, Windows.Devices.Usbe Windows.Media.Capture) sono disponibili per le app UWP e Windows App SDK. È possibile chiamare queste API direttamente dai progetti WinUI 3.