WiFiDirectService Classe

Définition

Espace de noms:

Windows.Devices.WiFiDirect.Services

Représente un service direct Wi-Fi. Cette classe est utilisée par le code sur un appareil qui cherche à utiliser un service direct Wi-Fi pour établir une session de service direct Wi-Fi avec le fournisseur de services.

public ref class WiFiDirectService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiDirectService final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiDirectService

Public NotInheritable Class WiFiDirectService

Héritage

Object Platform::Object IInspectable WiFiDirectService

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Il s’agit de l’une des différentes classes qui prennent en charge la connexion de deux appareils avec une préférence pour lequel l’appareil doit être le propriétaire du groupe. Consultez la rubrique Windows.Devices.WiFiDirect.Service pour une présentation du jumelage d’appareils et de la façon dont il peut entraîner l’ignorer (et comment résoudre ce problème).

Votre code n’instancie pas directement cette classe. Au lieu de cela, votre code suit ce processus pour obtenir une instance de cette classe et l’utiliser pour établir une session Wi-Fi Direct Service.

1. Utiliser l’une des méthodes GetSelector pour obtenir une chaîne de requête pour un service particulier
2. Créez un DeviceWatcher qui surveille les annonceurs qui correspondent à la chaîne de requête. Lorsqu’un annonceur est trouvé, décidez s’il faut l’utiliser, par programmation ou en demandant à l’utilisateur d’indiquer un choix.
3. Une fois que votre chercheur a identifié l’annonceur de service souhaité, appelez la méthode statique FromIdAsync avec l’ID d’appareil de l’appareil de l’annonceur choisi. FromIdAsync récupère une instance de WiFiDirectService pour le service demandé sur l’appareil demandé.
4. Continuez à établir une session en appelant WiFiDirectService.ConnectAsync.

Propriétés

PreferGroupOwnerMode	Obtient ou définit une valeur spécifiant si le instance de service doit choisir Wi-Fi mode de propriétaire de groupe (GO) point à point direct (P2P).
RemoteServiceInfo	Obtient l’objet blob d’informations de service à partir de ce service instance.
ServiceError	Informations d’erreur sur la dernière tentative de connexion au service.
SessionInfo	Obtient ou définit des informations de session spécifiques à l’application transmises au serveur lors du lancement d’une session.
SupportedConfigurationMethods	Obtient une liste des méthodes de configuration prises en charge, classées par préférence. Votre code utilise les opérations IVector pour modifier le contenu de la liste.

Méthodes

ConnectAsync()	Lance l’établissement d’une session de service avec le service direct Wi-Fi représenté par cette instance.
ConnectAsync(String)	Lance l’établissement d’une session de service avec le service direct Wi-Fi représenté par cette instance, à l’aide d’un code confidentiel pour configurer la session.
FromIdAsync(String)	Méthode statique qui récupère un instance WiFiDirectService pour un service direct Wi-Fi offert par l’appareil avec un ID d’appareil donné.
GetProvisioningInfoAsync(WiFiDirectServiceConfigurationMethod)	Récupère de manière asynchrone Wi-Fi informations d’approvisionnement de session Direct Service.
GetSelector(String)	Obtient une chaîne AQS (Advanced Query Syntax) à utiliser pour rechercher Wi-Fi annonceurs Direct Service pour un service particulier.
GetSelector(String, IBuffer)	Obtient une chaîne AQS (Advanced Query Syntax) à utiliser pour rechercher Wi-Fi annonceurs de service direct pour un service particulier, où une séquence d’octets donnée apparaît dans l’objet blob d’informations de service de l’annonceur.

Événements

SessionDeferred

Événement déclenché lorsqu’une demande de session a été différée. Notez que cela ne signifie pas que la demande a échoué ou a été refusée. Il s’agit d’une notification indiquant que le serveur effectue une opération longue, comme attendre qu’un utilisateur entre un code confidentiel. Le demandeur qui reçoit ce message doit commencer une attente de 120 secondes avant d’expirer la demande de session, afin de donner au serveur le temps d’effectuer son opération. Les arguments d’événement incluent une mémoire tampon fournie par le serveur dans la notification de report avec des informations supplémentaires.