이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

ProximityDevice Class

근접한 장치에 메시지를 게시하거나 근접한 장치에서 메시지를 구독할 수 있습니다.

구문


var proximityDevice = Windows.Networking.Proximity.ProximityDevice;

특성

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

멤버

ProximityDevice클래스에는 다음과 같은 형식의 멤버가 있습니다.

이벤트

ProximityDevice클래스에는 다음과 같은 이벤트가 있습니다.

이벤트Description
DeviceArrived Occurs when a device enters the proximate range.
DeviceDeparted Occurs when a device leaves the proximate range.

 

메서드

The ProximityDevice 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
FromId Creates an instance of a ProximityDevice class and activates the specified proximity device interface.
GetDefault Creates an instance of a ProximityDevice class and activates the default proximity provider.
GetDeviceSelector Returns the class selection string that you can use to enumerate proximity devices.
PublishBinaryMessage(String, IBuffer) Publishes a message that contains binary data to subscribers of the specified message type.
PublishBinaryMessage(String, IBuffer, MessageTransmittedHandler) Publishes a message that contains binary data to subscribers of the specified message type. The specified handler is called when the message has been transmitted.
PublishMessage(String, String) Publishes a message to subscribers of the specified message type.
PublishMessage(String, String, MessageTransmittedHandler) Publishes a message to subscribers of the specified message type. The specified handler is called when the message has been transmitted.
PublishUriMessage(Uri) Publishes a Uniform Resource Identifier (URI) to a proximate device.
PublishUriMessage(Uri, MessageTransmittedHandler) Publishes a Uniform Resource Identifier (URI) to a proximate device. The specified handler is called when the message has been transmitted.
StopPublishingMessage Stops publishing a message.
StopSubscribingForMessage Cancels a message subscription.
SubscribeForMessage Creates a subscription for a specified message type.

 

속성

ProximityDevice클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

BitsPerSecond

읽기 전용Gets the transfer rate of a proximity device.

DeviceId

읽기 전용Gets the DeviceInformation Id for a proximity device.

MaxMessageBytes

읽기 전용Gets the maximum size of a published message that this proximity device supports.

 

설명

ProximityDevice 클래스를 사용하면 응용 프로그램이 장치에서 실행 중인 응용 프로그램과 일반적으로 3~4센티미터 범위 내에서 통신할 수 있습니다.

GetDefault 또는 FromId 정적 메서드를 사용하여 ProximityDevice의 인스턴스를 만들 수 있습니다.

ProximityDevice 클래스는 게시/구독 의미 체계를 사용하며 소량의 데이터 블록을 알리고 받는 데 유용합니다. 데이터 양이 더 많은 경우 또는 영구 통신의 경우 PeerFinderStreamSocket 클래스를 사용합니다. Windows 스토어 앱의 경우 호출 앱이 포그라운드에 있을 경우에만 게시 및 구독이 활성화됩니다.

중요   

근접 API는 인증, 암호화 또는 메시지 무결성을 제공하지 않습니다. 근접을 사용하여 암호, 재무 데이터, 텍스트 메시지, 전자 메일, 사진 또는 정부 ID 번호와 같은 중요 사용자 정보를 교환하지 마십시오.

예제


function id(elementId) {
    return document.getElementById(elementId);
}

var proximityDevice;

function initializeProximityDevice() {
    proximityDevice = Windows.Networking.Proximity.ProximityDevice.getDefault();

    if (proximityDevice) {
        proximityDevice.addEventListener("devicearrived", proximityDeviceArrived);
        proximityDevice.addEventListener("devicedeparted", proximityDeviceDeparted);

        id("messageDiv").innerHTML += "Proximity device initialized.<br />";
    }
    else {
        id("messageDiv").innerHTML += "Failed to initialized proximity device.<br />";
    }
}

function proximityDeviceArrived(device) {
    id("messageDiv").innerHTML += "Proximate device arrived. id = " + device.deviceId + "<br />";
}

function proximityDeviceDeparted(device) {
    id("messageDiv").innerHTML += "Proximate device departed. id = " + device.deviceId + "<br />";
}


요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱, 데스크톱 앱]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱, 데스크톱 앱]

지원되는 최소 전화

Windows Phone 8

Namespace

Windows.Networking.Proximity
Windows::Networking::Proximity [C++]

Metadata

Windows.winmd

Capabilities

proximity
ID_CAP_PROXIMITY [Windows Phone]

참고 항목

근접 연결 및 탭(JavaScript)
근접 연결 및 탭(C#/VB/C++)
샘플
근접 연결 샘플

 

 

표시:
© 2015 Microsoft