Bagikan melalui

Windows.Networking.Proximity Ruang nama

  • Referensi
Edit

Berisi kelas yang mendukung koneksi antar perangkat yang berada dalam rentang dekat.

Kelas

ConnectionRequestedEventArgs

Berisi properti yang diteruskan ke aplikasi dengan peristiwa ConnectionRequested .
PeerFinder

Memungkinkan Anda menemukan instans lain dari aplikasi Anda di perangkat terdekat dan membuat koneksi soket antara aplikasi serekan dengan menggunakan gerakan ketukan atau dengan menjelajah. Untuk membuat koneksi soket Bluetooth pada Windows 8.1 dan yang lebih baru, gunakan Windows.Devices.Bluetooth.Rfcomm sebagai gantinya.
PeerInformation

Berisi informasi yang mengidentifikasi serekan.
PeerWatcher

Secara dinamis menemukan aplikasi serekan dalam rentang nirkabel.
ProximityDevice

Memungkinkan Anda menerbitkan pesan untuk memproksi perangkat atau berlangganan pesan dari perangkat yang diproksi.
ProximityMessage

Mewakili pesan yang diterima dari langganan.
TriggeredConnectionStateChangedEventArgs

Berisi properti yang diteruskan peristiwa TriggeredConnectionStateChanged ke aplikasi.

Enum

PeerDiscoveryTypes

Menunjukkan opsi penemuan mana yang tersedia untuk digunakan dengan kelas PeerFinder .
PeerRole

Menjelaskan peran aplikasi serekan saat tersambung ke beberapa rekan.
PeerWatcherStatus

Menjelaskan status objek PeerWatcher .
TriggeredConnectState

Menunjukkan status koneksi saat ini ke aplikasi peer.

Delegasikan

DeviceArrivedEventHandler

Menjelaskan metode yang menangani peristiwa DeviceArrived .
DeviceDepartedEventHandler

Menjelaskan metode yang menangani peristiwa DeviceDeparted .
MessageReceivedHandler

Menjelaskan metode yang akan menangani peristiwa yang diaktifkan ketika pesan yang telah berlangganan telah diterima.
MessageTransmittedHandler

Menjelaskan metode yang akan menangani peristiwa yang diaktifkan saat pesan yang diterbitkan telah dikirimkan.

Contoh

Contoh ini menunjukkan bagaimana Anda dapat menggunakan kelas ProximityDevice untuk menentukan kapan perangkat masuk dan meninggalkan kedekatan.

Windows.Networking.Proximity.ProximityDevice proximityDevice;

private void InitializeProximityDevice()
{
    proximityDevice = Windows.Networking.Proximity.ProximityDevice.GetDefault();

    if (proximityDevice != null) {
        proximityDevice.DeviceArrived += ProximityDeviceArrived;
        proximityDevice.DeviceDeparted += ProximityDeviceDeparted;

        WriteMessageText("Proximity device initialized.\n");
    }
    else
    {
        WriteMessageText("Failed to initialized proximity device.\n");
    }
}

private void ProximityDeviceArrived(Windows.Networking.Proximity.ProximityDevice device)
{
    WriteMessageText("Proximate device arrived. id = " + device.DeviceId + "\n");
}

private void ProximityDeviceDeparted(Windows.Networking.Proximity.ProximityDevice device)
{
    WriteMessageText("Proximate device departed. id = " + device.DeviceId + "\n");
}

// Write a message to MessageBlock on the UI thread.
private Windows.UI.Core.CoreDispatcher messageDispatcher = Window.Current.CoreWindow.Dispatcher;

async private void WriteMessageText(string message, bool overwrite = false)
{
    await messageDispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal,
        () =>
        {
            if (overwrite)
                MessageBlock.Text = message;
            else
                MessageBlock.Text += message;
        });
}

Dim proximityDevice As Windows.Networking.Proximity.ProximityDevice

Private Sub InitializeProximityDevice()

    proximityDevice = Windows.Networking.Proximity.ProximityDevice.GetDefault()

    If proximityDevice IsNot Nothing Then
        AddHandler proximityDevice.DeviceArrived, AddressOf ProximityDeviceArrived
        AddHandler proximityDevice.DeviceDeparted, AddressOf ProximityDeviceDeparted

        WriteMessageText("Proximity device initialized." & vbTab)
    Else
        WriteMessageText("Failed to initialized proximity device." & vbTab)
    End If
End Sub

Private Sub ProximityDeviceArrived(device As Windows.Networking.Proximity.ProximityDevice)
    WriteMessageText("Proximate device arrived. id = " & device.DeviceId & vbTab)
End Sub

Private Sub ProximityDeviceDeparted(device As Windows.Networking.Proximity.ProximityDevice)
    WriteMessageText("Proximate device departed. id = " & device.DeviceId & vbTab)
End Sub

' Write a message to MessageBlock on the UI thread.
Private Async Sub WriteMessageText(message As String, Optional overwrite As Boolean = False)
    Await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal,
        Sub()
            If overwrite Then
                MessageBlock.Text = message
            Else
                MessageBlock.Text &= message
            End If
        End Sub)
End Sub

Keterangan

Anda dapat menggunakan kedekatan untuk menyambungkan komputer dengan menggunakan gerakan ketukan sederhana. Jika dua komputer datang dalam jarak 3 sentimeter hingga 4 sentimeter satu sama lain, atau diketuk bersama-sama, sistem operasi setiap komputer mendeteksi komputer lain. Anda kemudian dapat menyambungkan kedua komputer untuk berbagi konten atau menerbitkan dan berlangganan pesan. Kedekatan juga mendukung penemuan perangkat serekan melalui Wi-Fi Direct.

Penting

API kedekatan tidak menyediakan autentikasi, enkripsi, atau integritas pesan. Jangan gunakan kedekatan untuk bertukar informasi sensitif pengguna seperti kata sandi, data keuangan, pesan teks, email, foto, atau nomor id pemerintah.

Lihat juga