com.awareframework.ios.sensor.wifi 0.5.2

com.awareframework.ios.sensor.wifi 0.5.2

tetujinyuuki.nishiyama 维护。



  • Yuuki Nishiyama

AWARE: WiFi

CI rtatus Version License Platform

该传感器使我们能够处理 WiFi 条件和事件。

要求

iOS 10 及更高版本

安装

com.awareframework.ios.sensor.wifi 可通过 CocoaPods 获取。

  1. 要安装它,只需将以下行添加到您的 Podfile 中
pod 'com.awareframework.ios.sensor.wifi'
  1. 将 com.awareframework.ios.sensor.wifi 库导入到您的源代码中。
import com_awareframework_ios_sensor_wifi
  1. 在 Xcode 项目中打开 访问 WiFi 信息 能力

公共函数

Wi-Fi传感器

  • init(config:WiFiSensor.Config?):使用可选配置初始化Wi-Fi传感器。
  • start():使用可选配置启动Wi-Fi传感器。
  • stop():停止服务。

Wi-Fi传感器.Config

一个类,用于存储传感器的配置。

字段

  • sensorObserver: WiFiObserver:实时数据更新的回调。
  • enabled: Boolean 传感器是否启用。 (默认 = false)
  • debug: Boolean 启用/禁用输出到 Logcat。 (默认 = false)
  • label: String 数据的标签。(默认 = "")
  • deviceId: String 将与事件和传感器关联的设备 ID。(默认 = "")
  • dbEncryptionKey 数据库的加密密钥。(默认 = null)
  • dbType: Engine 要用于保存数据的数据库引擎。(默认 = Engine.DatabaseType.NONE)
  • dbPath: String 数据库的路径。(默认 = "aware_wifi")
  • dbHost: String 同步数据库的宿主。(默认 = null)

广播

  • WiFiSensor.ACTION_AWARE_WIFI_CURRENT_AP 当前连接到此 AP。在 extras 中,WiFiSensor.EXTRA_DATA 包括以 json 字符串格式的 WiFiData。
  • WiFiSensor.ACTION_AWARE_WIFI_NEW_DEVICE 探测到新的 WiFi AP 设备。在 extras 中,WiFiSensor.EXTRA_DATA 包括以 json 字符串格式的 WiFiData。
  • WiFiSensor.ACTION_AWARE_WIFI_SCAN_STARTED Wi-Fi 扫描开始
  • WiFiSensor.ACTION_AWARE_WIFI_SCAN_ENDED Wi-Fi 扫描结束。

数据表示

WiFi扫描数据

字段 类型 描述
bssid 字符串 当前连接的访问点MAC地址
ssid 字符串 当前连接的访问点网络名称
deviceId 字符串 AWARE设备UUID
标签 字符串 可自定义的标签。用于数据校准或追踪
时间戳 长整型 自1970年以来的Unix时间戳毫秒
时区 整型 设备的WiFi
操作系统 字符串 设备的操作系统(例如android)

示例用法

let wifiSensor = WiFiSensor.init(WifiSensor.Config().apply{config in
    config.sensorObserver = Observer()
    config.dbType = .REALM
    config.debug = true
    // more configuration ...
})
// To start the sensor
wifiSensor.start()

// To stop the sensor
wifiSensor.stop()
// Implement an interface of WifiObserver
class Observer:WiFiObserver {
    func onWiFiAPDetected(data: WiFiScanData) {
        // Your code here ..
    }

    func onWiFiDisabled() {
        // Your code here ..
    }

    func onWiFiScanStarted() {
        // Your code here ..
    }

    func onWiFiScanEnded() {
        // Your code here ..
    }
}

许可证

版权所有 (c) 2021 AWARE移动上下文仪器中间件/框架 (<http://www.awareframework.com>)

遵循Apache License, Version 2.0("许可证");除非遵守许可证,否则不得使用此文件。您可以在以下位置获取许可证的副本:

<https://apache.ac.cn/licenses/LICENSE-2.0>除非适用法律要求或以书面形式达成协议,否则在许可证下分发的软件按照"原样"基础分发,不提供任何明示或暗示的保证或条件。请参阅许可证以了解具体的管理许可和限制。