Radio Classe

Definição

Namespace:

Windows.Devices.Radios

Representa um dispositivo de rádio no sistema.

public ref class Radio sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class Radio final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class Radio

Public NotInheritable Class Radio

Herança

Object Platform::Object IInspectable Radio

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Seu código usa membros estáticos dessa classe, como GetRadiosAsync, GetDeviceSelector e FromIdAsync para consultar rádios e recuperar objetos Radio instanciados que representam rádios específicos no dispositivo.

Observe que seu código deve chamar RequestAccessAsync pelo menos uma vez, do thread da interface do usuário, antes de tentar chamar SetStateAsync. Isso ocorre porque, em algumas regiões, com algumas opções de configurações de usuário, tentar alterar o estado de rádio requer permissão do usuário. Nessa situação, chamar RequestAccessAsync mostra ao usuário um prompt perguntando se ele deseja permitir que seu aplicativo tenha permissão para controlar o rádio. Se o aplicativo estiver em execução em um dispositivo que exija permissão de usuário e seu código não tiver solicitado e recebido permissão, SetStateAsync falhará por falta de permissão do usuário.

Propriedades

Kind	Obtém um valor de enumeração que descreve que tipo de rádio esse objeto representa.
Name	Obtém o nome do rádio representado por este objeto .
State	Obtém o estado atual do rádio representado por este objeto .

Métodos

FromIdAsync(String)	Um método estático que recupera um objeto Radio . O método aceita o 'Device.Id' encontrado por meio de Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. Este procedimento é mais confiável do que usar GetRadiosAsync para obter um rádio em situações em que uma rádio USB falhou ou foi removida em uma estação de trabalho do Windows 10. Nesta instância de um rádio com falha ou removido, GetRadiosAsync não retorna nenhum rádio Bluetooth. FindAllAsync, por outro lado, retorna uma ID válida que pode ser passada para FromIdAsync para obter o objeto de rádio, que relatará a si mesmo como se estivesse agora no estado de 'Desabilitado'.
GetDeviceSelector()	Um método estático que retorna uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) a ser usada para enumerar ou monitorar dispositivos de rádio com Windows.Devices.Enumeration.DeviceInformation.FindAllAsync e métodos relacionados.
GetRadiosAsync()	Um método estático e assíncrono que recupera uma coleção de objetos Windows.Devices.Radios.Radio que representam dispositivos de rádio que existiam no sistema no momento em que o programa foi iniciado. Adições ou remoções de rádios são ignoradas por chamadas subsequentes.
RequestAccessAsync()	Um método assíncrono que recupera um valor que indica qual acesso o usuário atual tem ao rádio representado por esse objeto. Em circunstâncias em que a permissão do usuário é necessária para acessar o rádio, esse método solicita permissão ao usuário. Consequentemente, sempre chame esse método no thread da interface do usuário.
SetStateAsync(RadioState)	Uma operação assíncrona que tenta definir o estado do rádio representado por esse objeto.

Eventos

StateChanged

Evento gerado por uma alteração de estado no rádio representado por esse objeto. Quando um rádio Bluetooth USB é removido ou, de outra forma, fica offline, nenhuma alteração de estado é relatada.