Flutter短信增强功能插件sms_enricher的使用

SMS Enricher Flutter插件是一个全面的解决方案，用于在Android设备上访问和处理短信。它允许Flutter应用程序请求用户权限以访问短信，根据特定过滤器检索短信，对设备上的短信数据进行增强，并将处理后的数据安全地发送到指定的后端服务器。

特性

• 用户权限：请求用户同意以访问短信。
• 数据检索：通过发件人或内容筛选检索短信。
• 数据增强：执行本地数据增强，例如情感分析和命名实体识别。
• 安全传输：通过HTTPS安全地将增强数据发送到后端端点。

开始使用

要将SMS Enricher插件集成到您的Flutter应用中，请遵循以下步骤：

安装

1. 在pubspec.yaml文件的依赖项部分添加sms_enricher：

dependencies:
  flutter:
    sdk: flutter
  sms_enricher: ^1.0.0

1. 运行flutter pub get来安装插件。

flutter pub get

使用

1. 在Dart代码中导入sms_enricher包：

import 'package:sms_enricher/sms_enricher.dart';

1. 请求用户访问短信的权限：

bool isPermissionGranted = await SmsEnricher.requestSmsPermissions();

1. 检索并增强短信消息：

List<dynamic> messages = await SmsEnricher.retrieveSmsMessages(targetName: 'Bank');
List<dynamic> enrichedMessages = await SmsEnricher.enrichSmsMessages(messages);

1. 将增强的数据发送到后端服务器：

bool success = await SmsEnricher.sendToBackend(enrichedMessages, 'https://yourbackend.endpoint/api/messages');
if (!success) {
  // 处理传输错误
}

安全性

确保您的应用遵守最新的隐私法规。在访问短信之前始终请求用户同意，并安全地处理数据。

许可证

该插件基于MIT许可证发布。更多详细信息请参阅LICENSE文件。

示例代码

以下是完整的示例代码，展示了如何在Flutter应用中使用sms_enricher插件。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SmsEnricher.initialize();
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final SmsEnricher _smsEnricher = SmsEnricher();
  bool _permissionsGranted = false;
  List<dynamic> _enrichedMessages = [];
  String _filterText = ''; // 状态变量用于过滤文本

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

  Future<void> _requestPermissions() async {
    bool permissionsGranted = await _smsEnricher.requestSmsPermissions();
    setState(() {
      _permissionsGranted = permissionsGranted;
    });

    if (_permissionsGranted) {
      _retrieveAndEnrichMessages();
    } else {
      // 处理权限拒绝
      // 记录错误
      print('Error: SMS permission denied.');
    }
  }

  Future<void> _retrieveAndEnrichMessages() async {
    try {
      List<dynamic> messages = await _smsEnricher.retrieveSmsMessages(targetName: 'Test Target');
      List<dynamic> enrichedMessages = await _smsEnricher.enrichSmsMessages(messages);
      setState(() {
        _enrichedMessages = enrichedMessages;
      });
      _sendToBackend(enrichedMessages);
    } catch (e) {
      // 处理错误
    }
  }

  Future<void> _sendToBackend(List<dynamic> enrichedMessages) async {
    bool success = await _smsEnricher.sendToBackend(
        enrichedMessages.take(100).toList(),
        'https://example.com',
        'john.doe@test.com',
        'Company Name',
        'John Doe');
    if (!success) {
      // 处理传输错误
      print('Error: Failed to send messages to backend.');
    }
    // 成功处理
  }

  List<dynamic> _filteredMessages() {
    if (_filterText.isEmpty) {
      return _enrichedMessages;
    } else {
      return _enrichedMessages
          .where((message) => message.toString().toLowerCase().contains(_filterText.toLowerCase()))
          .toList();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(),
        body: Column(
          children: [
            SizedBox(
              width: MediaQuery.of(context).size.width * 0.8,
              child: TextField(
                decoration: const InputDecoration(
                  hintText: '搜索...',
                  icon: Icon(Icons.search),
                  border: OutlineInputBorder(),
                ),
                onChanged: (text) {
                  setState(() {
                    _filterText = text;
                  });
                },
              ),
            ),
            SizedBox(
              height: MediaQuery.of(context).size.height * 0.6,
              child: SingleChildScrollView(
                scrollDirection: Axis.vertical,
                child: SizedBox(
                  height: MediaQuery.of(context).size.height * 0.6,
                  child: _permissionsGranted
                      ? ListView.builder(
                          itemCount: _filteredMessages().length,
                          itemBuilder: (context, index) {
                            return Container(
                              margin: const EdgeInsets.all(8.0),
                              decoration: BoxDecoration(
                                border: Border.all(
                                  color: Colors.white,
                                  width: 1.0,
                                ),
                                color: const Color.fromARGB(255, 219, 244, 251),
                                borderRadius: BorderRadius.circular(5.0),
                              ),
                              child: ListTile(
                                title: Text('消息 ${index + 1}'),
                                subtitle: Text('${_filteredMessages()[index]}'),
                              ),
                            );
                          },
                        )
                      : const Text('请求权限中...'),
                ),
              ),
            ),
            SizedBox(
              height: 50,
              child: ElevatedButton(
                onPressed: () async {
                  _requestPermissions();
                },
                child: const Text('请求短信权限'),
              ),
            )
          ],
        ),
      ),
    );
  }
}