AWARE: WiFi
该传感器使我们能够处理 WiFi 条件和事件。
要求
iOS 10 及更高版本
安装
com.awareframework.ios.sensor.wifi 可通过 CocoaPods 获取。
- 要安装它,只需将以下行添加到您的 Podfile 中
pod 'com.awareframework.ios.sensor.wifi'
- 将 com.awareframework.ios.sensor.wifi 库导入到您的源代码中。
import com_awareframework_ios_sensor_wifi
- 在 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>除非适用法律要求或以书面形式达成协议,否则在许可证下分发的软件按照"原样"基础分发,不提供任何明示或暗示的保证或条件。请参阅许可证以了解具体的管理许可和限制。