WiFiDirectDevice WiFiDirectDevice WiFiDirectDevice WiFiDirectDevice Class

Definition

public : sealed class WiFiDirectDevice : IWiFiDirectDevice, IClosablepublic sealed class WiFiDirectDevice : IWiFiDirectDevice, IDisposablePublic NotInheritable Class WiFiDirectDevice Implements IWiFiDirectDevice, IDisposable// You can use this class in JavaScript.

Attributes

ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute StaticAttribute StaticAttribute

Examples

Windows.Devices.WiFiDirect.WiFiDirectDevice wfdDevice;
private async System.Threading.Tasks.Task<String> Connect(string deviceId)
{
    string result = ""; 

    try
    {
        // No device Id specified.
        if (String.IsNullOrEmpty(deviceId)) { return "Please specify a Wi- Fi Direct device Id."; }

        // Connect to the selected Wi-Fi Direct device.
        wfdDevice = await Windows.Devices.WiFiDirect.WiFiDirectDevice.FromIdAsync(deviceId);

        if (wfdDevice == null)
        {
            result = "Connection to " + deviceId + " failed.";
        }

        // Register for connection status change notification.
        wfdDevice.ConnectionStatusChanged += new TypedEventHandler<Windows.Devices.WiFiDirect.WiFiDirectDevice, object>(OnConnectionChanged);

        // Get the EndpointPair information.
        var EndpointPairCollection = wfdDevice.GetConnectionEndpointPairs();

        if (EndpointPairCollection.Count > 0)
        {
            var endpointPair = EndpointPairCollection[0];
            result = "Local IP address " + endpointPair.LocalHostName.ToString() + 
                " connected to remote IP address " + endpointPair.RemoteHostName.ToString();
        }
        else
        {
           result = "Connection to " + deviceId + " failed.";
        }
    }
    catch (Exception err)
    {
        // Handle error.
        result = "Error occurred: " + err.Message;
    }

    return result;
}

private void OnConnectionChanged(object sender, object arg)
{
    Windows.Devices.WiFiDirect.WiFiDirectConnectionStatus status = 
        (Windows.Devices.WiFiDirect.WiFiDirectConnectionStatus)arg;

    if (status == Windows.Devices.WiFiDirect.WiFiDirectConnectionStatus.Connected)
    {
        // Connection successful.
    }
    else
    {
        // Disconnected.
        Disconnect();
    }
}

private void Disconnect()
{
    if (wfdDevice != null) 
    {
        wfdDevice.Dispose(); 
    }
}

var wfdDevice;

function connect(deviceId) {
    var result = ""; 

    try
    {
        // No device Id specified.
        if (!deviceId) { return "Please specify a Wi- Fi Direct device Id."; }

        // Connect to the selected Wi-Fi Direct device.
        Windows.Devices.WiFiDirect.WiFiDirectDevice.fromIdAsync(deviceId).then(
            function (wfdDeviceResult) {
                if (!wfdDeviceResult) {
                    result = "Connection to " + deviceId + " failed.";
                }

                wfdDevice = wfdDeviceResult;

                // Register for connection status change notification.
                wfdDevice.onconnectionstatuschanged = onConnectionChanged; 

                // Get the EndpointPair information.
                var endpointPairCollection = wfdDevice.getConnectionEndpointPairs();

                if (endpointPairCollection.Count > 0) {
                    var endpointPair = endpointPairCollection[0];
                    result = "Local IP address " + endpointPair.localHostName.toString() + 
                        " connected to remote IP address " + endpointPair.remoteHostName.toString();
                }
                else {
                    result = "Connection to " + deviceId + " failed.";
                }
            });

    }
    catch (err) {
        // Handle error.
        result = "Error occurred: " + err.message;
    }

    return result;
}

function onConnectionChanged(status) {
    if (status == Windows.Devices.WiFiDirect.WiFiDirectConnectionStatus.connected) {
        // Connection successful.
    }
    else {
        // Disconnected.
       disconnect();
    }
}

function disconnect() {
    if (wfdDevice) {
        wfdDevice.dispose(); 
    }
}

Remarks

You can use the WiFiDirectDevice class to establish a socket connection with other devices that have a Wi-Fi Direct (WFD) capable device. You can call the GetDeviceSelector method to get the device identifier for a Wi-Fi Direct device. Once you have a reference to a WiFiDirectDevice on your computer, you can call the GetConnectionEndpointPairs method to get an EndpointPair object and establish a socket connection using the Windows.Networking.Sockets API.

You can add a handler for the ConnectionStatusChanged event to be notified when the connection has been established or disconnected.

Only one app can be connected to a Wi-Fi Direct device at a time.

You must enable the Proximity capability to communicate with Wi-Fi Direct devices.

public : WiFiDirectConnectionStatus ConnectionStatus { get; }public WiFiDirectConnectionStatus ConnectionStatus { get; }Public ReadOnly Property ConnectionStatus As WiFiDirectConnectionStatus// You can use this property in JavaScript.

public : PlatForm::String DeviceId { get; }public string DeviceId { get; }Public ReadOnly Property DeviceId As string// You can use this property in JavaScript.

public : void Close()This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

This member is not implemented in C++void Dispose()Sub Disposevoid Dispose()

public : static IAsyncOperation<WiFiDirectDevice> FromIdAsync(PlatForm::String deviceId)public static IAsyncOperation<WiFiDirectDevice> FromIdAsync(String deviceId)Public Static Function FromIdAsync(deviceId As String) As IAsyncOperation( Of WiFiDirectDevice )// You can use this method in JavaScript.

public : static IAsyncOperation<WiFiDirectDevice> FromIdAsync(PlatForm::String deviceId, WiFiDirectConnectionParameters connectionParameters)public static IAsyncOperation<WiFiDirectDevice> FromIdAsync(String deviceId, WiFiDirectConnectionParameters connectionParameters)Public Static Function FromIdAsync(deviceId As String, connectionParameters As WiFiDirectConnectionParameters) As IAsyncOperation( Of WiFiDirectDevice )// You can use this method in JavaScript.

public : IVectorView<EndpointPair> GetConnectionEndpointPairs()public IReadOnlyList<EndpointPair> GetConnectionEndpointPairs()Public Function GetConnectionEndpointPairs() As IReadOnlyList( Of EndpointPair )// You can use this method in JavaScript.

public : static PlatForm::String GetDeviceSelector()public static string GetDeviceSelector()Public Static Function GetDeviceSelector() As string// You can use this method in JavaScript.

public : static PlatForm::String GetDeviceSelector(WiFiDirectDeviceSelectorType type)public static string GetDeviceSelector(WiFiDirectDeviceSelectorType type)Public Static Function GetDeviceSelector(type As WiFiDirectDeviceSelectorType) As string// You can use this method in JavaScript.

public : event TypedEventHandler ConnectionStatusChanged<WiFiDirectDevice,  object>public event TypedEventHandler ConnectionStatusChanged<WiFiDirectDevice,  object>Public Event ConnectionStatusChanged<WiFiDirectDevice,  object>// You can use this event in JavaScript.

See Also

• WiFiDirectDevice sample