Flutter插件octant的介绍与使用

Flutter插件octant的介绍与使用

Octant 是一个位置跟踪服务，由 Nextbillion.Pte.Ltd 开发和维护。

在调用 Octant 的任何其他功能之前，必须先调用 Octant.init(userId, teamCode, baseUrl) 来初始化服务。

为了保持 Octant 的 Android 服务处于运行状态，我们将启动一个前台服务。因此，我们需要指定一个正在进行的通知的图标名称、标题和内容。

对于 drawableName 的约定： 例如，假设我们在 drawables 文件夹中有一个名为 R.drawable.ic_launcher 的图标，请将 drawableName 设置为 ic_launcher 并传递给 Octant.startService()。

在调用 Octant.startTracing() 之前，我们需要确保 Octant 服务已经启动。否则会抛出错误。

示例代码

以下是一个完整的示例代码，展示如何使用 Octant 插件。

import 'package:flutter/material.dart';
import 'package:octant/octant.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化 Octant 服务
    Octant.init('1', teamCode: '1', baseUrl: 'https://nextbillion.zodme.com');
    Octant.enableDebug(true); // 启用调试模式
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Octant 示例应用'),
        ),
        body: SingleChildScrollView(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.center,
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              // 按钮：启动服务
              GradientButton('启动服务', () {
                Octant.startService(
                  notificationDrawable: 'ic_launcher', // 图标名称
                  notificationTitle: 'Octant 示例', // 通知标题
                  notificationContent: '位置跟踪进行中...', // 通知内容
                );
              }),

              // 按钮：开始跟踪
              const GradientButton('开始跟踪', Octant.startTracing),

              // 按钮：停止服务
              const GradientButton('停止服务', Octant.stopService),

              // 按钮：配置间隔
              GradientButton('配置间隔', () {
                Octant.configureIntervals(
                  gatheringInterval: 12, // 收集间隔（秒）
                  uploadingInterval: 1, // 上传间隔（秒）
                );
              }),

              // 按钮：查询排名
              GradientButton('查询排名', () {
                int startTime = DateTime.now()
                    .subtract(const Duration(days: 7))
                    .millisecondsSinceEpoch; // 一周前的时间戳
                int endTime = DateTime.now().microsecondsSinceEpoch; // 当前时间戳
                int limit = 10; // 返回结果数量限制
                List<String> userCodeList = ['0', '1', '2']; // 用户编码列表
                Octant.queryRanking(
                  startTime: startTime,
                  endTime: endTime,
                  limit: limit,
                  userCodeList: userCodeList,
                );
              }),

              // 按钮：查询用户坐标
              GradientButton('查询用户坐标', () {
                int startTime = DateTime.now()
                    .subtract(const Duration(days: 7))
                    .millisecondsSinceEpoch; // 一周前的时间戳
                int endTime = DateTime.now().microsecondsSinceEpoch; // 当前时间戳
                int limit = 10; // 返回结果数量限制
                Octant.queryUserCoordinate(
                  startTime: startTime,
                  endTime: endTime,
                  limit: limit,
                );
              }),
            ],
          ),
        ),
      ),
    );
  }
}

// 自定义渐变按钮组件
class GradientButton extends StatelessWidget {
  const GradientButton(this.text, this.onPressed, {Key? key})
      : super(key: key);

  final String text;
  final VoidCallback? onPressed;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      alignment: Alignment.center,
      height: 50,
      margin: const EdgeInsets.fromLTRB(16, 50, 16, 16),
      child: RaisedButton(
        onPressed: onPressed,
        shape: RoundedRectangleBorder(
          borderRadius: BorderRadius.circular(80),
        ),
        padding: const EdgeInsets.all(0),
        child: Ink(
          decoration: BoxDecoration(
            gradient: const LinearGradient(
              colors: [Color(0xff007bff), Color(0xff64B6ff)],
              begin: Alignment.centerLeft,
              end: Alignment.centerRight,
            ),
            borderRadius: BorderRadius.circular(30.0),
          ),
          child: Container(
            constraints:
                const BoxConstraints(minHeight: 50, maxWidth: 250),
            alignment: Alignment.center,
            child: Text(
              text,
              textAlign: TextAlign.center,
              style: const TextStyle(color: Colors.white),
            ),
          ),
        ),
      ),
    );
  }
}