AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Funciones WiFi
  • Casos especiales
  • Permisos necesarios
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Inicia la detección de los puntos de acceso Wi-Fi a los que se puede acceder desde el dispositivo.
AndroidWidget Android Observaciones:
  • Para añadir la red associated con un punto de acceso a la lista de redes configuradas en el dispositivo, utilice WiFiAddNetwork.
  • El acceso Wi-Fi no está disponible en el emulador de Android.
Ejemplo
NextTitle("Detecting the Wi-Fi access points")
ListPoint is string
sSSID is string
sBSSID is string
ListPoint = WiFiDetectAccessPoint()
FOR EACH STRING AccessPoint OF ListPoint SEPARATED BY CR
sSSID = ExtractString(AccessPoint, 2, TAB)
sBSSID = ExtractString(AccessPoint, 3, TAB)
...
END
Sintaxis
<Result> = WiFiDetectAccessPoint([<Timeout>])
<Result>: Cadena de caracteres
  • Lista de puntos de acceso Wi-Fi detectados separados por caracteres CR (Carriage Return),
  • Cadena vacía ("") si no se ha detectado ningún punto de acceso Wi-Fi. El ErrorOccurred Variable se utiliza para saber si se ha producido un error al detectar los puntos de acceso. ErrorInfo devuelve más información sobre el error.
Por cada red, se devuelve un conjunto de información en el siguiente formato:
<Identifier> + TAB + <SSID> + TAB + <BSSID> +
TAB + <Security> + TAB + <Signal strength>
donde:
  • <Identificador> : Identificador de la red associated con el punto de acceso, cadena vacía ("") si el punto de acceso no corresponde a ninguna red configurada en el dispositivo.
  • : SSID (Service set Identifier) de la red Wi-Fi associated con el punto de acceso.
  • : BSSID (Basic Service set Identifier) del punto de acceso
  • : Tipo de seguridad utilizado por la red Wi-Fi:
    wifiSecurityIEEE8021XSeguridad que utiliza el estándar IEEE 802.1x.
    wifiSecurityNoneNo se utiliza ningún tipo de seguridad.
    wifiSecurityWEPSeguridad basada en una clave WEP (Wired Equivalent Privacy)
    wifiSecurityWPA2Seguridad que utiliza el mecanismo WPA2 (Wi-Fi protected Access).
    wifiSecurityWPASeguridad que utiliza el mecanismo WPA (Wi-Fi protected Access).
    wifiSecurityWPA _EAPSeguridad que utiliza el mecanismo WPA (Wi-Fi protected Access) y el mecanismo EAP (Extensible Authentication Protocol).
  • : Intensidad de la señal expresada en dBm (decibelios por milivatios).
<Timeout>: Entero o duración opcional
Duración máxima de la detección en centésimas de segundo.
  • Se produce un error si se alcanza este tiempo límite antes del final de la detección.
  • Si este tiempo de espera no se especifica o es set a 0, no se aplicará ningún límite de tiempo.
Este parámetro puede ser:
  • un número entero que corresponde al número de centésimas de segundo,
  • una variable de tipo Duration,
  • la duración en un formato legible (por ejemplo, 1 s o 10 ms).
Observaciones

Casos especiales

  • La lista de puntos de acceso devuelta por WiFiDetectAccessPoint está ordenada por orden de intensidad de la señal (de la señal más fuerte a la más débil).
  • AndroidWidget Android Si el subproceso principal de la aplicación ejecuta la función, se mostrará una barra de progreso infinita durante la detección de los puntos de acceso. Para especificar el mensaje que se mostrará en el reloj de arena, use NextTitle antes de llamar a WiFiDetectAccessPoint 2300 .
  • Desde Android 6.0: La ubicación debe estar habilitada en el dispositivo. De lo contrario, la función devolverá una lista vacía. GPSStatus se utiliza para saber si la localización está habilitada o no.
AndroidWidget Android

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Permisos necesarios:
  • ACCESS_WIFI_STATE: Permite a las aplicaciones acceder a la información relativa a las redes Wi-Fi..
  • CAMBIAR_WIFI_STATE: Permite a las aplicaciones modificar el estado de la conectividad Wi-Fi.
Caso específico de Android 11: Esta función requiere la Permission ACCESS_BACKGROUND_LOCATION para acceder a la ubicación del dispositivo.
Esta Permission permite utilizar la función cuando la aplicación está en la Background.
Si la aplicación necesita utilizar la ubicación de Background:
  • Agregar manualmente el permiso "ACCESS_BACKGROUND_LOCATION" en el asistente de generación de la aplicación Android.
  • Solicitar explícitamente la ubicación de fondo Permission con PermissionRequest. Por ejemplo:
    PermissionRequest(permBackgroundLocation, Callback)
    INTERNAL PROCEDURE Callback(p is Permission)
    IF p.Granted THEN
    // Functions that require background location access can be used
    END
    END
Una ventana permite a los usuarios:
  • permitir el acceso a la ubicación del dispositivo mientras la aplicación está en la Background,
  • permitir el acceso a la ubicación sólo mientras la aplicación está en uso,
  • negar el acceso a la ubicación. El usuario puede cambiar estos permisos en cualquier momento en la configuración de Android.

Observaciones:
  • Siga las directrices de Google para las aplicaciones que requieren acceso a la ubicación de Background. Para obtener más información, consulte https://support.google.com/googleplay/android-developer/answer/9799150. Si no se cumplen estas condiciones (especialmente los requisitos de información del usuario), es posible que no se acepte la publicación de las aplicaciones en Google Play.
  • La ubicación de fondo Permission sólo debe solicitarse si se ha concedido la ubicación Permission. De lo contrario, PermissionRequest fallará.
  • Si la opción elegida por el usuario para la solicitud de acceso a la localización de Background es más restrictiva que la opción elegida para la solicitud de acceso a la localización, la aplicación se reiniciará automáticamente.
  • En los dispositivos con Android 10 o anterior, si se ha concedido la ubicación Permission a la aplicación, se concederá la ubicación de fondo Permission sin mostrar una ventana.
Componente: wd290com.dll
Versión mínima requerida
  • Versión 16
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 23/06/2023

Señalar un error o enviar una sugerencia | Ayuda local