Radio Класс

Ссылка

Определение

Пространство имен:: Windows.Devices.Radios

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Представляет радиоустройство в системе.

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

Наследование: Object Platform::Object IInspectable Radio

Атрибуты: ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

В коде используются статические члены этого класса, такие как GetRadiosAsync, GetDeviceSelector и FromIdAsync , для запроса радиосвязи и извлечения экземпляров объектов Radio, представляющих определенные радиосвязи на устройстве.

Обратите внимание, что код должен вызвать RequestAccessAsync хотя бы один раз из потока пользовательского интерфейса, прежде чем пытаться вызвать SetStateAsync. Это связано с тем, что в некоторых регионах при выборе некоторых пользовательских параметров для попытки изменить состояние радио требуется разрешение пользователя. В этом случае при вызове RequestAccessAsync пользователю будет предложено разрешить приложению управлять радио. Если приложение выполняется на устройстве, для которого требуется разрешение пользователя, а код не запросил и не получил разрешение, setStateAsync завершится ошибкой из-за отсутствия разрешения пользователя.

Свойства

Kind	Возвращает значение перечисления, описывающее, какой тип радиосвязи представляет этот объект.
Name	Возвращает имя радиомодуля, представленного этим объектом.
State	Возвращает текущее состояние радиомодуля, представленного данным объектом .

Методы

FromIdAsync(String)	Статический метод, извлекающий объект Radio . Метод принимает Device.Id, найденный с помощью Windows.Devices.Enumeration.DeviceInformation.FindAllAsync. Эта процедура является более надежной, чем использование GetRadiosAsync для получения радио в ситуациях, когда USB-радио произошел сбой или был удален на рабочей станции Windows 10. В этом случае неудачного или удаленного радиосвязи GetRadiosAsync не возвращает bluetooth-радио. FindAllAsync, напротив, возвращает допустимый идентификатор , который можно передать в FromIdAsync для получения объекта-переключателя, который будет сообщать о том, что сейчас он в состоянии "Отключено".
GetDeviceSelector()	Статический метод, возвращающий строку расширенного синтаксиса запросов (AQS), которая будет использоваться для перечисления или мониторинга радиоустройств с помощью Windows.Devices.Enumeration.DeviceInformation.FindAllAsync и связанных методов.
GetRadiosAsync()	Статический асинхронный метод, который извлекает коллекцию объектов Windows.Devices.Radios.Radio , представляющих радиоустройства, которые существовали в системе на момент запуска программы. Добавление или удаление радиосвязи игнорируются последующими звонками.
RequestAccessAsync()	Асинхронный метод, извлекающий значение, указывающее, какой доступ имеет текущий пользователь к радио, представленному этим объектом. В случаях, когда для доступа к радио требуется разрешение пользователя, этот метод запрашивает у пользователя разрешение. Следовательно, всегда вызывайте этот метод в потоке пользовательского интерфейса.
SetStateAsync(RadioState)	Асинхронная операция, которая пытается задать состояние радиомодуля, представленного этим объектом.

События

StateChanged

Событие, вызванное изменением состояния в радиомодуле, представленном этим объектом. При удалении или отключении usb-радиомодулем Bluetooth не сообщается об изменении состояния.

Применяется к

Поделиться через