Windows.Devices.WiFiDirect Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.