WiFiDirectService 클래스

정의

네임스페이스:

Windows.Devices.WiFiDirect.Services

Wi-Fi Direct 서비스를 나타냅니다. 이 클래스는 Wi-Fi Direct Service를 사용하려는 디바이스의 코드에서 서비스 공급자와 Wi-Fi Direct Service 세션을 설정하는 데 사용됩니다.

public ref class WiFiDirectService sealed

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

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

Public NotInheritable Class WiFiDirectService

상속

Object Platform::Object IInspectable WiFiDirectService

특성

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에서 도입되었습니다.)

설명

이는 디바이스가 그룹 소유자여야 하는 기본 설정으로 두 디바이스 연결을 지원하는 여러 클래스 중 하나입니다. 디바이스 페어링에 대한 설명과 그룹 소유자 기본 설정을 무시할 수 있는 방법(및 이를 해결하는 방법)은 Windows.Devices.WiFiDirect.Service 항목을 참조하세요.

코드는 이 클래스를 직접 인스턴스화하지 않습니다. 대신 코드는 이 프로세스에 따라 이 클래스의 instance 가져와서 이 클래스를 사용하여 Wi-Fi Direct Service 세션을 설정합니다.

1. GetSelector 메서드 중 하나를 사용하여 특정 서비스에 대한 쿼리 문자열을 가져옵니다.
2. 쿼리 문자열과 일치하는 광고주를 감시하는 DeviceWatcher 를 만듭니다. 광고주가 발견되면 프로그래밍 방식으로 또는 사용자에게 선택을 표시하도록 요청하여 해당 광고주를 사용할지 여부를 결정합니다.
3. 구직자가 원하는 서비스 광고주를 식별하면 선택한 광고주 디바이스의 디바이스 ID를 사용하여 정적 FromIdAsync 메서드를 호출합니다. FromIdAsync는 요청된 디바이스에서 요청된 서비스에 대한 WiFiDirectService의 instance 검색합니다.
4. WiFiDirectService.ConnectAsync를 호출하여 세션을 설정합니다.

속성

PreferGroupOwnerMode	서비스 instance P2P(직접 지점 및 지점) GO(그룹 소유자) 모드를 Wi-Fi 선택할지 여부를 지정하는 값을 가져오거나 설정합니다.
RemoteServiceInfo	이 서비스 instance 서비스 정보 Blob을 가져옵니다.
ServiceError	서비스에 연결하려는 최신 시도에 대한 오류 정보입니다.
SessionInfo	세션을 시작할 때 서버에 전달되는 앱별 세션 정보를 가져오거나 설정합니다.
SupportedConfigurationMethods	기본 설정에 따라 정렬된 지원되는 구성 메서드 목록을 가져옵니다. 코드는 IVector 작업을 사용하여 목록의 내용을 수정합니다.

메서드

ConnectAsync()	이 instance 나타내는 Wi-Fi Direct Service를 사용하여 서비스 세션의 설정을 시작합니다.
ConnectAsync(String)	PIN을 사용하여 세션을 구성하는 이 instance 나타내는 Wi-Fi Direct Service를 사용하여 서비스 세션의 설정을 시작합니다.
FromIdAsync(String)	지정된 디바이스 ID를 사용하여 디바이스에서 제공하는 Wi-Fi Direct Service에 대한 WiFiDirectService instance 검색하는 정적 메서드입니다.
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)	Wi-Fi 직접 서비스 세션 프로비저닝 정보를 비동기적으로 검색합니다.
GetSelector(String)	특정 서비스에 대한 Wi-Fi Direct Service 광고주를 찾는 데 사용할 AQS(고급 쿼리 구문) 문자열을 가져옵니다.
GetSelector(String, IBuffer)	지정된 바이트 시퀀스가 광고주의 서비스 정보 Blob에 표시되는 특정 서비스에 대한 Wi-Fi Direct Service 광고주를 찾는 데 사용할 AQS(고급 쿼리 구문) 문자열을 가져옵니다.

이벤트

SessionDeferred

세션 요청이 지연되었을 때 발생하는 이벤트입니다. 이는 요청이 실패했거나 거부되었음을 의미하지는 않습니다. 사용자가 PIN을 입력할 때까지 기다리는 것과 같이 서버가 긴 작업을 수행하고 있다는 알림입니다. 이 메시지를 수신하는 구직자는 서버가 작업을 완료할 시간을 주기 위해 세션 요청을 시간 초과하기 전에 120초 대기를 시작해야 합니다. 이벤트 인수에는 추가 정보가 포함된 지연 알림의 서버에서 제공하는 버퍼가 포함됩니다.