Partager via


Windows.Devices.WiFiDirect Espace de noms

Contient des classes qui prennent en charge la connexion aux appareils direct Wi-Fi associés et aux points de terminaison associés pour les PC, les tablettes et les téléphones.

Classes

WiFiDirectAdvertisement

Représente une Wi-Fi publicité directe et permet à l’application de contrôler l’état d’écoute et les éléments d’informations personnalisées dans la publicité.

WiFiDirectAdvertisementPublisher

Objet à publier Wi-Fi publicités directes.

WiFiDirectAdvertisementPublisherStatusChangedEventArgs

Fournit des données pour un événement StatusChanged sur un WiFiDirectAdvertisementPublisher.

WiFiDirectConnectionListener

Classe utilisée pour écouter les demandes de connexion directe entrantes Wi-Fi.

WiFiDirectConnectionParameters

Utilisé par une application pour spécifier les paramètres de connexion d’une Wi-Fi opération de connexion directe/appairage.

Les exemples d’applications qui utilisent cette classe incluent l’exemple Wi-Fi Direct.

WiFiDirectConnectionRequest

Une Wi-Fi demande de connexion directe reçue par un WiFiDirectConnectionListener.

WiFiDirectConnectionRequestedEventArgs

Fournit des données pour un événement ConnectionRequested sur un WiFiDirectConnectionListener.

WiFiDirectDevice

Gère les connexions aux appareils direct Wi-Fi associés.

WiFiDirectInformationElement

Représente des éléments d’informations dans un paquet direct Wi-Fi.

WiFiDirectLegacySettings

Paramètres régissant le mode « hérité » (connexions non Wi-Fi Direct au point d’accès publié.)

Énumérations

WiFiDirectAdvertisementListenStateDiscoverability

Spécifie si l’appareil direct Wi-Fi est à l’écoute et détectable.

WiFiDirectAdvertisementPublisherStatus

Représente les états possibles du WiFiDirectAdvertisementPublisher.

WiFiDirectConfigurationMethod

Spécifie une méthode de configuration direct Wi-Fi. La configuration est la façon dont un utilisateur indique à un élément de Wi-Fi'équipement Direct de se connecter à un autre élément de Wi-Fi'équipement Direct.

WiFiDirectConnectionStatus

Décrit la status de connexion d’un objet WiFiDirectDevice.

WiFiDirectDeviceSelectorType

Spécifie le type de sélecteur d’appareil pour Wi-Fi Direct.

WiFiDirectError

Spécifie certains cas d’erreur courants Wi-Fi Direct.

WiFiDirectPairingProcedure

Spécifie une procédure de jumelage direct.

Exemples

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(); 
    }
}

Remarques

Vous pouvez utiliser la classe WiFiDirectDevice pour établir une connexion de socket avec d’autres appareils dotés d’un appareil Wi-Fi Direct (WFD). Vous pouvez appeler la méthode GetDeviceSelector pour obtenir l’identificateur d’appareil d’un appareil Wi-Fi Direct. Une fois que vous avez une référence à un WiFiDirectDevice sur votre ordinateur, vous pouvez appeler la méthode GetConnectionEndpointPairs pour obtenir un objet EndpointPair et établir une connexion de socket à l’aide de classes dans l’espace de noms Windows.Networking.Sockets .

Vous pouvez ajouter un gestionnaire pour l’événement ConnectionStatusChanged afin d’être averti lorsque la connexion a été établie ou déconnectée.

Une seule application peut être connectée à un appareil direct Wi-Fi à la fois.

Vous devez activer la fonctionnalité Proximité pour communiquer avec Wi-Fi appareils Direct.

Voir aussi