다음을 통해 공유

WiFiDirectServiceAdvertiser 클래스

  • 참조

정의

네임스페이스:
Windows.Devices.WiFiDirect.Services
편집

서비스 광고주를 나타냅니다. 이 클래스는 Wi-Fi Direct Services를 보급하는 디바이스의 코드에서 서비스를 보급하는 데 사용됩니다.

public ref class WiFiDirectServiceAdvertiser sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectServiceAdvertiser final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectServiceAdvertiser
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser
function WiFiDirectServiceAdvertiser(serviceName)
Public NotInheritable Class WiFiDirectServiceAdvertiser
상속
Object Platform::Object IInspectable WiFiDirectServiceAdvertiser
특성
ActivatableAttribute 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 항목을 참조하세요.

서비스 이름은 WiFiDirectServiceAdvertiser 생성자에 설정됩니다. 서비스 이름은 255자 이하의 UTF-8 문자열입니다. 이름에는 역방향 도메인 이름 표기법을 사용하는 것이 좋습니다. 여기서 서비스 소유자의 DNS 이름(예: "contoso.com")이 역방향이고 서비스 이름의 시작 부분으로 사용됩니다(예: "com.contoso.serviceX"). 이 규칙은 고유한 서비스 이름을 쉽게 선택할 수 있도록 하기 위한 것입니다. "org.wi-fi.wfds"로 시작하는 서비스 이름은 Wi-Fi Alliance에서 사용하도록 예약되어 있으며 해당 이름을 서비스에 사용할 수 없습니다.

생성자

WiFiDirectServiceAdvertiser(String)

WiFiDirectServiceAdvertiser 클래스의 instance 만듭니다. Wi-Fi Direct Service 보급을 시작하려면 이 클래스의 instance 만들고 해당 속성을 서비스에 적절하게 설정한 다음 Start 메서드를 호출합니다.

속성

AdvertisementStatus

광고의 현재 상태 설명하는 값을 가져옵니다.
AutoAcceptSession

이 서비스 보급 알림에 대한 자동 수락 속성을 가져오거나 설정합니다.
CustomServiceStatusCode

사용자 지정 서비스 상태 코드를 가져오거나 설정합니다. ServiceStatus 속성 값이 Custom인 경우에만 유효합니다.
DeferredSessionInfo

예를 들어 서비스가 사용자 입력이 요청을 완료하기 위해 대기하는 경우처럼 세션을 설정할 때 세션 요청자에게 전달되는 서비스 관련 정보를 가져오거나 설정합니다. 요청자는 요청이 지연될 때 120초 시간 제한을 구현해야 합니다.
PreferGroupOwnerMode

서비스가 Wi-Fi P2P(직접 피어 투 피어) 그룹 소유자여야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

그룹 소유자가 됨을 사용하면 서비스에서 P2P 연결 구성 및 연결 프로세스를 보다 자세히 제어할 수 있습니다. 자세한 내용은 Wi-Fi Alliance에서 제공되는 Wi-Fi Direct P2P 기술 사양을 참조하세요.
PreferredConfigurationMethods

기본 설정 세션 구성 메서드의 목록( IVector 인터페이스를 구현)을 가져옵니다. 코드는 목록에서 IVector 작업을 사용하여 목록에서 요소를 추가하거나 제거합니다.
ServiceError

AdvertisementStatus가 중단된 경우 특정 오류 코드를 가져옵니다.
ServiceInfo

서비스 정보 Blob을 가져오거나 설정합니다. Blob의 형식 및 콘텐츠는 개별 서비스에 의해 결정되며 서비스 검색 중에 구직자가 사용할 수 있습니다.
ServiceName

서비스 이름을 가져옵니다.
ServiceNamePrefixes

구직자가 접두사 검색을 사용할 때 이 서비스와 일치해야 하는 서비스 이름 접두사 목록을 가져옵니다. 코드는 IVector 메서드를 사용하여 목록에서 요소를 추가하거나 제거합니다.
ServiceStatus

서비스 상태 가져오거나 설정합니다.

메서드

ConnectAsync(DeviceInformation)

PIN을 요구하지 않고 세션 요청을 수락합니다.
ConnectAsync(DeviceInformation, String)

지정된 PIN에 연결하여 세션 요청을 수락합니다.
Start()

현재 속성 값을 사용하여 광고의 매개 변수를 설정하여 서비스 보급을 시작합니다.
Stop()

서비스 광고를 중지합니다. 이는 서비스에 연결된 기존 세션에 영향을 주지 않습니다.

이벤트

AdvertisementStatusChanged

AdvertisementStatus 속성 값이 변경될 때 발생하는 이벤트입니다.
AutoAcceptSessionConnected

서비스가 세션 요청을 자동으로 수락했을 때 발생하는 이벤트입니다. 이벤트 처리기는 이벤트 인수 개체에 나열된 엔드포인트 쌍에 대한 소켓 연결을 설정해야 합니다.
SessionRequested

이 WiFiDirectServiceAdvertiser instance 연결된 서비스와 세션을 설정해 달라고 요청했을 때 발생하는 이벤트입니다. 요청을 수락하려면 이벤트 처리기에서 WiFiDirectServiceAdvertiser.ConnectAsync 를 호출합니다.

적용 대상