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 와 같은 이 클래스의 정적 멤버를 사용하여 라디오를 쿼리하고 디바이스의 특정 라디오를 나타내는 인스턴스화된 라디오 개체를 검색합니다.

SetStateAsync를 호출하기 전에 코드에서 UI 스레드에서 RequestAccessAsync를 한 번 이상 호출해야 합니다. 일부 지역에서는 일부 사용자 설정을 선택할 때 라디오 상태를 변경하려면 사용자 권한이 필요하기 때문입니다. 이 경우 RequestAccessAsync 를 호출하면 앱이 라디오를 제어할 수 있는 권한을 가질 수 있는지 묻는 프롬프트가 사용자에게 표시됩니다. 앱이 사용자 권한이 필요한 디바이스에서 실행 중이고 코드가 권한을 요청 및 받지 않은 경우 SetStateAsync 는 사용자 권한 부족으로 실패합니다.

속성

Kind	이 개체가 나타내는 라디오 종류를 설명하는 열거형 값을 가져옵니다.
Name	이 개체가 나타내는 라디오의 이름을 가져옵니다.
State	이 개체가 나타내는 라디오의 현재 상태를 가져옵니다.

메서드

FromIdAsync(String)	Radio 개체를 검색하는 정적 메서드입니다. 메서드는 Windows.Devices.Enumeration.DeviceInformation.FindAllAsync를 통해 찾은 'Device.Id'을 허용합니다. 이 절차는 GetRadiosAsync를 사용하여 WINDOWS 10 워크스테이션에서 USB 라디오가 실패하거나 제거된 상황에서 라디오를 가져오는 것보다 더 안정적입니다. 실패하거나 제거된 라디오의 이 instance GetRadiosAsync는 bluetooth 라디오를 반환하지 않습니다. 반면 FindAllAsync는 라디오 개체를 가져오기 위해 FromIdAsync에 전달할 수 있는 유효한 ID를 반환합니다. 이 ID는 현재 'Disabled' 상태인 것으로 보고됩니다.
GetDeviceSelector()	Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 및 관련 메서드를 사용하여 라디오 디바이스를 열거하거나 모니터링하는 데 사용할 AQS(고급 쿼리 구문) 문자열을 반환하는 정적 메서드입니다.
GetRadiosAsync()	프로그램이 시작될 때 시스템에 존재했던 무선 디바이스를 나타내는 Windows.Devices.Radios.Radio 개체의 컬렉션을 검색하는 정적 비동기 메서드입니다. 라디오 추가 또는 제거는 후속 호출에 의해 무시됩니다.
RequestAccessAsync()	현재 사용자가 이 개체가 나타내는 라디오에 대한 액세스 권한을 나타내는 값을 검색하는 비동기 메서드입니다. 라디오에 액세스하기 위해 사용자 권한이 필요한 경우 이 메서드는 사용자에게 사용 권한을 묻는 메시지를 표시합니다. 따라서 항상 UI 스레드에서 이 메서드를 호출합니다.
SetStateAsync(RadioState)	이 개체가 나타내는 라디오의 상태를 설정하려고 시도하는 비동기 작업입니다.

이벤트

StateChanged

이 개체가 나타내는 라디오의 상태 변경으로 인해 발생하는 이벤트입니다. USB Bluetooth 라디오가 제거되거나 오프라인 상태가 되면 상태 변경이 보고되지 않습니다.