Flutter电话功能扩展插件another_telephony的使用

插件简介

another_telephony 是一个用于Flutter应用程序中处理电话功能的插件，它提供了诸如发送短信、查询短信、监听收到的短信等功能。该插件是基于原Telephony包进行fork后维护更新的一个版本，旨在保持与最新版Flutter的兼容性。需要注意的是，此插件目前仅支持Android平台。

功能特性

• ✅ 发送短信（Send SMS）
• ✅ 查询短信（Query SMS）
  • ✅ 收件箱(Inbox)
  • ✅ 已发送(Sent)
  • ✅ 草稿箱(Draft)
• ✅ 查询对话（Query Conversations）
• ✅ 监听收到的短信（Listen to incoming SMS）
  • ✅ 应用在前台时
  • ✅ 应用在后台时
• ✅ 网络数据和指标（Network data and metrics）
  • ✅ 包含但不限于：蜂窝网络状态、通话状态、网络运营商名称等信息
• ✅ 开始拨打电话（Start Phone Call）
• ❌ 计划发送短信（Schedule a SMS） 未实现
• ❌ 使用SMS Retriever API 未实现

使用方法

准备工作

首先，在项目的pubspec.yaml文件中添加another_telephony作为依赖项：

dependencies:
  another_telephony: ^latest_version # 替换为最新的版本号

然后在需要使用的地方导入：

import 'package:another_telephony/telephony.dart';

获取单例实例：

final Telephony telephony = Telephony.instance;

权限申请

确保手动请求必要的权限（如发送短信、读取短信等），并在AndroidManifest.xml中声明这些权限。例如，对于发送短信需要如下权限：

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

通过以下方式请求权限：

bool permissionsGranted = await telephony.requestPhoneAndSmsPermissions;

示例代码

下面是一个完整的示例应用，展示了如何使用another_telephony来监听新到达的消息，并展示最后一条接收到的短信内容：

import 'package:another_telephony/telephony.dart';
import 'package:flutter/material.dart';

@pragma('vm:entry-point')
void onBackgroundMessage(SmsMessage message) {
  debugPrint("onBackgroundMessage called");
}

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _message = "";
  final Telephony telephony = Telephony.instance;

  void onMessage(SmsMessage message) async {
    setState(() {
      _message = message.body ?? "Error reading message body.";
    });
  }

  void onSendStatus(SendStatus status) {
    setState(() {
      _message = status == SendStatus.SENT ? "sent" : "delivered";
    });
  }

  Future<void> initPlatformState() async {
    final bool? result = await telephony.requestPhoneAndSmsPermissions;

    if (result != null && result) {
      telephony.listenIncomingSms(
          onNewMessage: onMessage, onBackgroundMessage: onBackgroundMessage);
    }
  }

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
        home: Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Center(child: Text("Latest received SMS: $_message")),
          TextButton(
              onPressed: () async {
                await telephony.openDialer("123413453");
              },
              child: Text('Open Dialer'))
        ],
      ),
    ));
  }
}

以上就是关于another_telephony插件的基本介绍及使用说明，更多详细信息可以参考官方文档。希望这篇指南能帮助您快速上手并充分利用这个强大的工具！