Flutter位置追踪插件traccar_flutter的使用

Flutter位置追踪插件traccar_flutter的使用

一个用于将Traccar跟踪平台集成到Flutter应用中的库。该包作为Android和iOS原生实现的桥梁，实现了无缝的位置跟踪和配置。

注意事项

此插件不是官方的Traccar项目。它由我独立开发，以帮助将Traccar的功能集成到Flutter应用程序中。

如果您有任何问题、建议或需要支持，可以随时联系：

• Mostafa Movahhed在LinkedIn

功能特性

• 跨平台支持Android和iOS。
• 提供以下方法：
  • 初始化Traccar服务。
  • 配置跟踪设置。
  • 启动和停止跟踪服务。
  • 查看服务状态日志。
• 使用官方Traccar原生SDK以确保可靠和高效的跟踪。

原生Traccar SDKs

该库利用了以下原生SDK：

• Traccar Android SDK
• Traccar iOS SDK

必要权限

为确保插件正常运行，您需要向您的应用添加以下权限。

Android

在AndroidManifest.xml文件中，包含以下权限：

<!-- 位置访问权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- Traccar服务权限 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

<!-- 制造商特定权限 -->
<uses-permission android:name="oppo.permission.OPPO_COMPONENT_SAFE" />
<uses-permission android:name="com.huawei.permission.external_app_settings.USE_COMPONENT" />

<!-- 硬件功能 -->
<uses-feature android:name="android.hardware.location.network" />
<uses-feature android:name="android.hardware.location.gps" />

请确保处理Android 6.0（API级别23）及以上的运行时权限。

iOS

在Info.plist文件中，添加以下键以定义所需的定位权限：

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>这是追踪应用，因此需要访问位置服务</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>这是追踪应用，因此需要访问位置服务</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>这是追踪应用，因此需要访问位置服务</string>
<key>UIBackgroundModes</key>
<array>
    <string>location</string>
</array>

这些权限是为了使应用能够在前台和后台模式下访问位置服务。

其他注意事项

• Android：对于Android API 23或更高的版本，必须动态请求位置权限。
• iOS：必须由用户授予位置权限。当使用后台位置更新时，确保遵守Apple的App Store指南。

安装

在pubspec.yaml文件中添加以下内容：

dependencies:
  traccar_flutter: ^1.0.0

然后运行：

flutter pub get

使用

以下是使用TraccarFlutter包的方法：

导入包

import 'package:traccar_flutter/traccar_flutter.dart';

示例代码

import 'package:traccar_flutter/traccar_flutter.dart';

void main() async {
  final traccar = TraccarFlutter();

  // 初始化服务
  await traccar.initTraccar();

  // 设置配置
  final configs = TraccarConfigs(
    deviceId: 'your-device-id',
    serverUrl: 'http://demo.traccar.org:5055',
    interval: 15000, // 15秒
    accuracy: AccuracyLevel.high,
    offlineBuffering: true,
  );
  await traccar.setConfigs(configs);

  // 启动服务
  await traccar.startService();

  // 可选：查看状态日志
  final logs = await traccar.showStatusLogs();
  print('服务日志: $logs');
}

配置参数

示例用法

final configs = TraccarConfigs(
  deviceId: 'unique-device-id',
  serverUrl: 'http://demo.traccar.org:5055',
  interval: 15000, // 每15秒发送一次更新
  distance: 10,    // 移动10米后发送更新
  angle: 30,       // 方向变化30度后发送更新
  accuracy: AccuracyLevel.high, // 使用高精度模式
  offlineBuffering: true, // 启用离线数据存储
  wakelock: true, // 保持设备唤醒
  notificationIcon: 'custom_icon', // 可选的通知图标
);

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:traccar_flutter/entity/traccar_configs.dart';
import 'package:traccar_flutter/traccar_flutter.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _traccarFlutterPlugin = TraccarFlutter();
  bool isServiceStarted = false;
  String? traccingMessage;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息异步初始化
  Future<void> initPlatformState() async {
    traccingMessage = await _traccarFlutterPlugin.initTraccar();
    traccingMessage = await _traccarFlutterPlugin.setConfigs(TraccarConfigs(
      deviceId: '1241234123',
      serverUrl: 'http://demo.traccar.org:5055',
      notificationIcon: 'ic_notification',
    ));

    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Traccar Demo'),
        ),
        body: Center(
          child: Text(
            'Traccar Message: \n\n ${traccingMessage ?? '-'}',
            textAlign: TextAlign.center,
          ),
        ),
        floatingActionButton: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            FloatingActionButton(
              onPressed: () {
                _traccarFlutterPlugin.showStatusLogs();
              },
              child: const Icon(Icons.screenshot_monitor),
            ),
            const SizedBox(height: 16),
            FloatingActionButton(
              onPressed: _toggleService,
              child: Icon(isServiceStarted ? Icons.stop : Icons.play_arrow),
            ),
          ],
        ),
      ),
    );
  }

  _toggleService() async {
    try {
      String? result;
      if (isServiceStarted) {
        result = await _traccarFlutterPlugin.stopService();
      } else {
        result = await _traccarFlutterPlugin.startService();
      }
      setState(() {
        traccingMessage = result;
        isServiceStarted = !isServiceStarted;
      });
    } catch (e) {
      setState(() {
        traccingMessage = e.toString();
      });
    }
  }
}