GeolocatorAndroidSettings
GeolocatorAndroidSettings
类具有以下值:
accuracy
位置数据的准确性。
值的类型为 GeolocatorPositionAccuracy
,默认为 GeolocatorPositionAccuracy.BEST
。
distance_filter
设备在水平移动多远后才会生成更新事件的最小距离(以米为单位)。
值的类型为 int
,默认为 0
。
force_location_manager
强制 Geolocator 插件使用旧版 LocationManager,而不是 FusedLocationProviderClient。
值的类型为 bool
,默认为 False
。
foreground_notification_text
前台服务通知的正文内容。
foreground_notification_title
前台服务通知的标题。
foreground_notification_enable_wake_lock
在后台执行开始时是否应该获取 wakelock。如果为 False
,系统仍然可以进入睡眠状态,所有位置事件将在系统再次唤醒时一次性接收。
获取 wakelock 权限应首先使用 PermissionHandler
。
如果未设置 foreground_notification_text
或 foreground_notification_title
,则无效。
默认为 False
。
foreground_notification_enable_wifi_lock
在后台执行开始时是否应该获取 WifiLock。这允许应用程序保持 Wi-Fi 无线电工作,即使用户一段时间未使用设备(例如,用于后台网络通信)。
获取 Wi-Fi 锁权限应首先使用 PermissionHandler
。
如果未设置 foreground_notification_text
或 foreground_notification_title
,则无效。
默认为 False
。
foreground_notification_color
在呈现通知时应用的标准样式模板的强调 颜色。
如果未设置 foreground_notification_text
或 foreground_notification_title
,则无效。
foreground_notification_channel_name
通知频道的用户可见名称。通知频道名称将在系统设置中显示。推荐的最大长度为 40 个字符,如果过长,名称可能会被 截断。
如果未设置 foreground_notification_text
或 foreground_notification_title
,则无效。
值的类型为 str
,默认为 "Background Location"
。
foreground_notification_set_ongoing
显示的通知是否为持久性,用户无法关闭。
如果未设置 foreground_notification_text
或 foreground_notification_title
,则无效。
默认为 True
。
interval_duration
主动位置更新的期望间隔时间。
值的类型为 Duration
,默认为 5000 毫秒。
time_limit
位置请求的超时时间。默认情况下没有时间限制。
值的类型为 Duration
。
use_mls_altitude
是否应根据 NMEA 消息计算 MSL(EGM2008)高度并报告为高度,而不是使用地球椭球高度(WSG84)。将此属性设置为 true 将有助于将 Android 高度与 iOS 对齐,因为 iOS 使用 MSL。
此属性仅在位置流更新时有效(Geolocator.on_position_change
),获取当前位置或最后已知位置时无效。
值的类型为 bool
,默认为 False
。