Flutter集成PTWCODE众包连接插件ptwcode_crowd_connected的使用

Flutter集成PTWCODE众包连接插件ptwcode_crowd_connected的使用

简介

ptwcode_crowd_connected 并不是官方的 crowd_connected 包。

此插件实现了 Android 和 iOS 的原生 crowd_connected SDK。

开始使用

在 android/app/src/main/AndroidManifest.xml 文件中设置 ACCESS_BACKGROUND_LOCATION 权限：

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

详细信息请参阅示例应用。

示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中集成并使用 ptwcode_crowd_connected 插件。

import 'dart:io';

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

import 'package:flutter/services.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:ptwcode_crowd_connected/ptwcode_crowd_connected.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> {
  String _platformVersion = 'Unknown';
  final _ptwcodeCrowdConnectedPlugin = PtwcodeCrowdConnected();

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

  // 异步平台消息初始化
  Future<void> initPlatformState() async {
    String platformVersion;
    // 处理可能的 PlatformException
    try {
      platformVersion = await _ptwcodeCrowdConnectedPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果组件从树中移除，则不更新界面
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  // 请求权限
  void _onTapPermission() async {
    // 请求位置权限（仅在使用中）
    final locationWhenInUse = await Permission.locationWhenInUse.request();
    debugPrint('====> Permission.locationWhenInUse: $locationWhenInUse');

    // 请求位置权限（始终）
    final locationAlways = await Permission.locationAlways.request();
    debugPrint('====> Permission.locationAlways: $locationAlways');

    // Android 特定权限请求
    if (Platform.isAndroid) {
      final bluetoothScan = await Permission.bluetoothScan.request();
      debugPrint('====> Permission.bluetoothScan: $bluetoothScan');
    }

    // iOS 特定权限请求
    if (Platform.isIOS) {
      final bluetooth = await Permission.bluetooth.request();
      debugPrint('====> Permission.bluetooth: $bluetooth');
    }
  }

  // 启动服务
  void _startService() async {
    await _ptwcodeCrowdConnectedPlugin.start(
      // TODO 添加 appKey
      appKey: '',
      // TODO 添加 publicToken
      publicToken: '',
      // TODO 添加 secretToken
      secretToken: '',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          children: [
            const Row(children: []), // 可以在这里添加其他 UI 组件
            Text('运行在: $_platformVersion\n'),
            TextButton(
              onPressed: _onTapPermission,
              child: const Text('请求权限'),
            ),
            TextButton(
              onPressed: _startService,
              child: const Text('启动服务'),
            ),
          ],
        ),
      ),
    );
  }
}