Skip to Content
配置配置文件

配置文件

Tracelet 附带多个预定义的配置文件，可帮助您针对不同的用例快速设置后台地理定位。这些配置文件优化了电池消耗和定位精度之间的权衡。

可用的配置文件

1.平衡（未翻译）

对于大多数应用程序来说，这是推荐的默认设置。它在捕获详细路线和延长电池寿命之间提供了高度优化的平衡。

  • 目标用例： 送货应用程序、车队跟踪、里程记录。
  • 准确度： 中到高（取决于硬件）
  • 距离过滤器： ~20-50 米
  • 电池消耗： 低（每小时约 1-3%）
  • **自适应采样：**启用
final config = Config.balanced(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

2. 高精度（NOTRAN0LATE）

此配置文件强制 GPS 硬件保持活动状态并要求尽可能高的精度。它禁用大多数省电启发式方法。

  • 目标用例： 路线导航、运动跟踪（跑步、骑自行车）、精确的地理围栏触发器。
  • **精度：**最大（1-5米）
  • 距离过滤器： 0-10米
  • 电池消耗： 高（每小时约 5-10%）
  • 自适应采样： 禁用
final config = Config.highAccuracy(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

3. 低功耗（NOTRAN0LATE）

该配置文件主要依靠蜂窝塔三角测量和 Wi-Fi 网络而不是耗电的 GPS 芯片，从而最大限度地减少电池影响。更新频率较低且不太精确。

  • 目标用例： 社交应用程序、天气更新、广义区域跟踪。
  • 精度： 城市/社区级别（100-3000米）
  • 距离过滤器： ~500+ 米
  • 电池消耗： 可忽略不计（每小时少于 1%）
  • **自适应采样：**启用
final config = Config.lowPower(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

4.被动（未翻译）

该配置文件代表了电池优化的极端情况。在Android上，它不会主动打开GPS或Wi-Fi扫描仪；相反，它被动地“搭载”其他应用程序（例如，谷歌地图、天气应用程序）或操作系统发出的位置请求。在缺乏真正被动 API 的 iOS 上，这会回落到尽可能低的精度 (kCLLocationAccuracyThreeKilometers)，其功能与低功耗配置文件类似。

  • 目标用例： 极度节省电池，后台数据收集而不影响用户。
  • 准确度： 可变（取决于 Android 上其他应用程序的请求；iOS 上为 3 公里）
  • 电池消耗： 零到可以忽略不计
  • 自适应采样： 禁用
final config = Config.passive(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

自定义配置文件

配置文件只是预先配置的 Config 实例。您可以从配置文件开始并使用 .copyWith() 覆盖特定字段：

final config = Config.balanced().copyWith(
  geo: GeoConfig(
    distanceFilter: 10, // Override just the distance filter
  ),
  sync: SyncConfig(
    url: 'https://my-api.com/locations',
  ),
);
配置接口企业特色