Habilitar funcionalidades do dispositivo para um aplicativo da Plataforma Universal do Windows
Este tópico explica como declarar funcionalidades do dispositivo no Microsoft Visual Studio para usar câmeras, microfones, sensores de localização e outros dispositivos para um aplicativo da Plataforma Universal do Windows (UWP).
Especifique as funcionalidades do dispositivo que o seu aplicativo usará
Os aplicativos do Windows exigem que você especifique no manifesto do pacote do aplicativo quando você usa determinados tipos de dispositivos. No Visual Studio, é possível declarar a maioria dos recursos usando o Designer de Manifesto ou adicioná-los manualmente, conforme descrito em Como especificar recursos de dispositivo em um manifesto de pacote (manualmente). Este tutorial pressupõe que você esteja usando o Designer de Manifesto.
Observação
Alguns tipos de dispositivos, como impressoras, scanners e sensores, não precisam ser declarados no manifesto do pacote do aplicativo.
- No Gerenciador de Soluções do Visual Studio, clique duas vezes no arquivo do manifesto do pacote Package.appxmanifest.
- Abra a guia Capacidades.
- Selecione as funcionalidade do dispositivo que o aplicativo usa. Se você não vir o recurso que está procurando no Designer de Manifesto, adicione-o manualmente. Para obter mais informações, consulte Como fazer para especificar as capacidades do dispositivo em um manifesto do pacote.
| Funcionalidade do dispositivo | Designer de manifesto | Descrição |
|---|---|---|
| AllJoyn |  |
Permite que aplicativos e dispositivos habilitados para AllJoyn em uma rede descubram e interajam entre si. Os aplicativos que acessam APIs no namespace Windows.Devices.AllJoyn devem usar essa funcionalidade. |
| Mensagens de chat bloqueadas | |
Permite que os aplicativos leiam mensagens de SMS e MMS bloqueadas pelo aplicativo Filtro de Spam. |
| Acesso a mensagem de chat | |
Permite que os aplicativos leiam e excluam mensagens de texto. Também permite que os aplicativos armazenem mensagens de chat no armazenamento de dados do sistema. |
| Geração de código | |
Permite que os aplicativos gerem código dinamicamente. |
| Autenticação de Empresa | |
Esse recurso está sujeito à política da Microsoft Store. Ele fornece a capacidade de se conectar a recursos da intranet corporativa que exigem credenciais de domínio. Esse recurso normalmente não é necessário para a maioria dos aplicativos. |
| Internet (Cliente) | |
Oferece acesso de saída para a Internet e redes em lugares públicos, como aeroportos e restaurantes. Por exemplo, redes de intranet em que o usuário designou a rede como pública. A maioria dos aplicativos que exige o acesso à Internet deve usar o recurso. |
| Internet (Cliente e Servidor) | |
Oferece acesso de entrada e saída para a Internet e redes em lugares públicos, como aeroportos e restaurantes. Esse recurso é um superconjunto da Internet (Cliente). A Internet (Cliente) não precisará ser habilitada se esse recurso também estiver habilitado. O acesso de entrada a portas críticas sempre é bloqueado. |
| Localidade | |
Fornece acesso ao local atual. Obtido de hardware dedicado como um sensor GPS no PC ou derivado das informações de rede disponíveis. |
| Microfone | |
Fornece acesso à alimentação de áudio do microfone. Isso permite que o aplicativo grave a partir de microfones conectados. |
| Biblioteca de Músicas | |
Oferece a capacidade de adicionar, alterar ou excluir arquivos na Biblioteca de Música para o PC local e PCs do Grupo Doméstico. |
| Objetos 3D | |
Oferece acesso programático aos usuário a objetos 3D, permitindo que o aplicativo enumere e acesse todos os arquivos na biblioteca sem a interação do usuário. Em geral, essa funcionalidade é usada em aplicativos 3D e jogos que precisam acessar toda a biblioteca de objetos 3D. |
| Telefonema | |
Permite que os aplicativos acessem todas as linhas telefônicas do dispositivo e executem as seguintes funções: fazer uma chamada no telefone e mostrar o discador do sistema sem avisar o usuário; acessar metadados relacionados à linha; gatilhos relacionados à linha de acesso. Permite que o aplicativo de filtro de spam selecionado pelo usuário defina e verifique a lista de bloqueios e as informações de origem das chamadas. |
| Biblioteca de Imagens | |
Oferece a capacidade de adicionar, alterar ou excluir arquivos na Biblioteca de Imagens para o PC local e PCs do Grupo Doméstico. |
| Ponto de Serviço | |
Fornece acesso a periféricos de ponto de serviço. Essa funcionalidade é necessária para acessar APIs no namespace Windows.Devices.PointOfService. |
| Redes Privadas (Cliente e Servidor) | |
Fornece acesso de entrada e saída para as redes de intranet que tenham um controlador de domínio autenticado ou que o usuário tenha designado como uma rede doméstica ou de trabalho. O acesso de entrada a portas críticas sempre é bloqueado. |
| Proximidade | |
Fornece a capacidade de se conectar a dispositivos próximos ao PC por meio da comunicação a curta distância (NFC). A proximidade a curta distância pode ser usada para enviar arquivos ou para se conectar a um aplicativo em um dispositivo próximo. |
| Armazenamento removível | |
Fornece a capacidade de adicionar, alterar ou excluir arquivos em dispositivos de armazenamento removível. O aplicativo só pode acessar os tipos de arquivo no armazenamento removível definidos no manifesto usando a declaração Associações de Tipo de Arquivo. O aplicativo não pode acessar o armazenamento removível em PCs do Grupo Doméstico. |
| Certificados Compartilhados de Usuário | |
Esse recurso está sujeito à política da Microsoft Store. Ele fornece a capacidade de acessar certificados de software e hardware, como certificados de cartão inteligente, para validar a identidade de um usuário. Quando APIs relacionadas são invocadas em tempo de execução, o usuário deve executar uma ação (inserir cartão, selecionar certificado etc.). Esse recurso não será necessário se o aplicativo incluir um certificado particular por meio de uma declaração de Certificados. |
| Informações de conta do usuário | |
Oferece aos aplicativos a capacidade de acessar o nome e a imagem do usuário. Essa funcionalidade é necessária para acessar algumas APIs no namespace Windows.System.UserProfile. |
| Biblioteca de Vídeos | |
Oferece a capacidade de adicionar, alterar ou excluir arquivos na Biblioteca de vídeos para o PC local e PCs do Grupo Doméstico. |
| Chamadas VoIP | |
Permite que os aplicativos acessem as APIs de chamadas VOIP no namespace Windows.ApplicationModel.Calls. |
| Webcam | |
Fornece acesso à câmera integrada ou ao feed de vídeo da webcam conectada. Isso permite ao aplicativo capturar instantâneos e filmes. |
| USB | Fornece acesso a dispositivos USB personalizados. Esse recurso requer elementos filho. Esse recurso não tem suporte no telefone Windows. | |
| Dispositivo de interface humana (HID) | Fornece acesso a dispositivos de interface humana (HID). Esse recurso requer elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo para HID. | |
| Bluetooth GATT | Fornece acesso a dispositivos Bluetooth LE por meio de uma coleção de serviços primários, serviços incluídos, características e descritores. Esse recurso requer elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo para Bluetooth. | |
| Bluetooth RFCOMM | Fornece acesso a APIs que oferecem suporte ao transporte BR/EDR (Basic Rate/Extended Data Rate) e também permite que seu aplicativo UWP acesse um dispositivo que implementa SPP (perfil de porta serial). Esse recurso requer elementos filho. Para obter mais informações, consulte Como especificar funcionalidades do dispositivo para Bluetooth. |
Usar a API do Windows Runtime para se comunicar com o dispositivo
A tabela a seguir conecta alguns dos recursos às APIs do Windows Runtime.
| Funcionalidade do dispositivo | API |
|---|---|
| AllJoyn | Windows.Devices.AllJoyn |
| Mensagens de chat bloqueadas | Windows.ApplicationModel.CommunicationBlocking |
| Localidade | Para obter mais informações, consulte Visão geral de localização e mapas. |
| Telefonema | Windows.ApplicationModel.Calls |
| Informações de conta do usuário | Windows.System.UserProfile |
| Chamadas VoIP | Windows.ApplicationModel.Calls |
| USB | Windows.Devices.Usb |
| HID | Windows.Devices.HumanInterfaceDevice |
| Bluetooth GATT | Windows.Devices.Bluetooth.GenericAttributeProfile |
| Bluetooth RFCOMM | Windows.Devices.Bluetooth.Rfcomm |
| Ponto de Serviço | Windows.Devices.PointOfService |