WifiManager.wps()

La méthode wps est utilisée pour traiter un handle de connexionWPS avec les réseaux qui soutiennent cette fonctionnalité.

Un réseau suportant une connexion WPS à la chaîne WPS disponible dans le tableau WifiManager.capabilities.

Une connexion WPS est un moyen simple de connecter un périphérique à un réseau. Il nécessite moins de connaissances de l'utilisateur et rend les choses plus faciles pour lui.Fondamentalement, quand un utilisateur a un routeur WiFi compatible WPS, il peut choisir cette méthode pour connecter son appareil sur le réseau au lieu de saisir son mot de passe.

Il existe deux façons de lancer une connexion WPS:

• La plus simple est d'appuyer sur un bouton dédié du routeur WiFi.
• Une alternative est d'indiquer un code PIN fourni par le routeur WiFi. Il y a alors deux cas d'utilisation :
  1. Le routeur WiFi enverra un code PIN à l'appareil que l'utilisateur doit saisir sur l'interface de routeur WiFi.
  2. Le routeur WiFi attend que l'utilisateur saisisse un code PIN sur son périphérique (généralement, un tel code PIN est affiché sur le routeur WiFi lui-même).

Syntaxe

var request = navigator.mozWifiManager.wps(param);

Paramètres

param

Un objet de configuration avec les propriétés suivantes :

• method : l'une des chaînes suivantes :
  • cancel pour annuler une tentative de connexion WPS.
  • pbs pour tenter une connexion en appuyant sur ​​le bouton physique du routeur WiFi.
  • pin pour tenter une connexion avec un code pin.
• bssid : une chaîne représentant le bssid du réseau pour se connecter. Il est obligatoire si la propriété method est définie à pin .
• pin : une chaîne représentant le code pin saisi par l'utilisateur. Il est obligatoire si la propriété method est définie à pin.

Résultats

Elle renvoie un handle DOMRequestqui indique le succès ou l'échec de l'opération.

Lorsque la propriété method est définie à pin, si l'opération est réussie et si l'utilisateur doit saisir un numéro d'identification sur son interface de routeur WiFi, le résultat de la requête est une chaîne représentant le code PIN.

Exemple

var wifi = navigator.mozWifiManager;

var request = wifi.getNetworks();

request.onsuccess = function () {
  // Utilisons du premier réseau.
  var network = this.result[0];
  var isWPSEnabled = network.capabilities.indexOf('WPS') > -1;
  var wpsRequest;

  if (isWPSEnabled) {
    if (comfirm('Voulez-vous utiliser le bouton poussoir pour connecter votre appareil ?')) {
      wpsRequest = wifi.wps({
        method : 'pbs'
      });
    }

    else if (confirm('Voulez-vous saisir un numéro de code PIN sur votre interface de routeur wifi ?')){
      wpsRequest = wifi.wps({
        method : 'pin',
        bssid: network.bssid
      })

      wpsRequest.onsuccess = function () {
        alert('Veuillez saisir ce numéro sur votre interface de routeur WiFi:' + this.result)
      }
    }

    else {
      wpsRequest = wifi.wps({
        method : 'pin',
        bssid: network.bssid
        pin: prompt('Veuillez indiquer le code PIN de votre routeur WiFi.')
      })
    }
  }
}

Spécification

Ne fait partie d'aucune spécification.

Voir aussi

• WifiManager
• WifI Information API