Flutter集成特定服务插件flutter_naurt_sdk的使用

Flutter集成特定服务插件flutter_naurt_sdk的使用

Naurt’s Official flutter plugin

flutter_naurt_sdk 是 Naurt 官方提供的 Flutter 插件。它允许开发者在 Flutter 应用中集成 Naurt 的服务功能。

使用步骤

以下是一个完整的示例,展示如何在 Flutter 应用中集成 flutter_naurt_sdk 插件。

1. 添加依赖

首先,在项目的 pubspec.yaml 文件中添加 flutter_naurt_sdkpermission_handler 依赖:

dependencies:
  flutter:
    sdk: flutter
  flutter_naurt_sdk: ^版本号 # 替换为最新版本号
  permission_handler: ^版本号 # 替换为最新版本号

然后运行以下命令安装依赖:

flutter pub get

2. 初始化插件

在应用的入口文件中初始化 flutter_naurt_sdk,并请求必要的权限。

import 'dart:io';
import 'dart:isolate';

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:flutter_naurt_sdk/flutter_naurt_sdk.dart';

import 'package:permission_handler/permission_handler.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> {
  bool isInitialised = false;
  bool isRunning = false;
  bool isValidated = false;

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

  Future<void> getPermissions() async {
    if (Platform.isAndroid) {
      Map<Permission, PermissionStatus> statuses =
          await [Permission.location, Permission.phone].request();
    } else if (Platform.isIOS) {
      Map<Permission, PermissionStatus> statuses = await [
        Permission.location,
        Permission.storage,
        Permission.sensors,
        Permission.phone
      ].request();
    }
  }

  // 平台消息是异步的,因此我们在异步方法中进行初始化。
  Future<void> initPlatformState() async {
    await getPermissions();

    // 可能会抛出 PlatformException,我们使用 try/catch 来捕获异常。
    try {
      final naurt = Naurt.shared;

      // 监听位置更新事件
      naurt.onLocationChanged.listen((location) {
        print('onLocationChanged: ${location.toString()}');
      });

      // 监听初始化状态
      naurt.onInitialised = (bool isInitialisedIn) {
        setState(() {
          isInitialised = isInitialisedIn;
        });
      };

      // 监听验证状态
      naurt.onValidation = (bool isValid) {
        setState(() {
          isValidated = isValid;
        });
      };

      // 监听运行状态
      naurt.onRunning = (bool isRunning) {
        setState(() {
          this.isRunning = isRunning;
        });
      };

      // 初始化插件
      isInitialised = await naurt.initialise(apiKey: '', precision: 6);
    } on PlatformException {
      isInitialised = false;
    }

    // 如果小部件从树中移除时异步平台消息仍在飞行中,则丢弃回复而不是调用 setState 更新非存在的外观。
    if (!mounted) return;
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Naurt SDK'),
          actions: [
            TextButton(
                onPressed: () async {
                  final isRunning = await Naurt.shared.isRunning();

                  if (isRunning) {
                    final couldStop = await Naurt.shared.stop();
                  } else {
                    final couldStart = await Naurt.shared.start();
                  }
                },
                child: const Text(
                  'Toggle Recording',
                  style: TextStyle(color: Colors.white),
                ))
          ],
        ),
        body: Card(
            margin: const EdgeInsets.all(16),
            child: Padding(
              padding: const EdgeInsets.all(16.0),
              child: Column(
                mainAxisSize: MainAxisSize.min,
                children: [
                  StatusRow(
                    title: 'Is Initialised?',
                    isValid: isInitialised,
                  ),
                  const SizedBox(
                    height: 8,
                  ),
                  StatusRow(
                    title: 'Is Validated?',
                    isValid: isValidated,
                  ),
                  const SizedBox(
                    height: 8,
                  ),
                  StatusRow(
                    title: 'Is Running?',
                    isValid: isRunning,
                  )
                ],
              ),
            )),
      ),
    );
  }
}

class StatusRow extends StatelessWidget {
  final String title;
  final bool isValid;
  const StatusRow({Key? key, required this.title, required this.isValid})
      : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Row(
      mainAxisAlignment: MainAxisAlignment.spaceBetween,
      children: [
        Text(
          title,
        ),
        isValid
            ? const Icon(
                Icons.check_circle,
                color: Colors.green,
              )
            : const Icon(
                Icons.cancel,
                color: Colors.red,
              )
      ],
    );
  }
}

更多关于Flutter集成特定服务插件flutter_naurt_sdk的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter集成特定服务插件flutter_naurt_sdk的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


要在Flutter项目中集成并使用 flutter_naurt_sdk 插件,你需要按照以下步骤进行操作。假设你已经有一个Flutter项目,或者你可以创建一个新的Flutter项目。

1. 添加依赖

首先,你需要在 pubspec.yaml 文件中添加 flutter_naurt_sdk 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  flutter_naurt_sdk: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的Dart文件中导入 flutter_naurt_sdk 插件。

import 'package:flutter_naurt_sdk/flutter_naurt_sdk.dart';

3. 初始化SDK

在使用SDK之前,你需要初始化它。通常,你可以在 main.dart 文件中的 main 函数中进行初始化。

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化Naurt SDK
  await Naurt.initialize(apiKey: 'YOUR_API_KEY');
  
  runApp(MyApp());
}

请确保将 YOUR_API_KEY 替换为你在Naurt平台上获取的实际API密钥。

4. 使用SDK功能

flutter_naurt_sdk 提供了多种功能,例如位置跟踪、事件处理等。以下是一些基本的使用示例。

4.1 开始和停止位置跟踪

你可以使用 Naurt.startTracking()Naurt.stopTracking() 来开始和停止位置跟踪。

void startTracking() async {
  await Naurt.startTracking();
  print("Tracking started");
}

void stopTracking() async {
  await Naurt.stopTracking();
  print("Tracking stopped");
}

4.2 监听位置更新

你可以使用 Naurt.onLocationUpdate 来监听位置更新。

void listenToLocationUpdates() {
  Naurt.onLocationUpdate.listen((location) {
    print("New location: ${location.latitude}, ${location.longitude}");
  });
}

4.3 处理事件

你可以使用 Naurt.onEvent 来监听和处理事件。

void listenToEvents() {
  Naurt.onEvent.listen((event) {
    print("Event received: ${event.type}");
  });
}

5. 处理权限

在使用位置服务时,确保你已经请求了必要的权限。你可以在 AndroidManifest.xmlInfo.plist 中添加相应的权限声明。

Android

android/app/src/main/AndroidManifest.xml 中添加以下权限:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

iOS

ios/Runner/Info.plist 中添加以下权限:

<key>NSLocationWhenInUseUsageDescription</key>
<string>We need your location to provide accurate tracking.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>We need your location to provide accurate tracking even when the app is in the background.</string>

6. 运行项目

完成上述步骤后,你可以运行你的Flutter项目并测试 flutter_naurt_sdk 的功能。

flutter run

7. 调试和测试

在开发过程中,确保你正确处理了所有可能的错误和异常。你可以使用 try-catch 块来捕获和处理异常。

void startTracking() async {
  try {
    await Naurt.startTracking();
    print("Tracking started");
  } catch (e) {
    print("Failed to start tracking: $e");
  }
}
回到顶部