Flutter短信发送与接收管理插件flutter_sms的使用

发布于 1周前 作者 vueper 来自 Flutter

Flutter短信发送与接收管理插件flutter_sms的使用

插件概述

flutter_sms 是一个用于在Flutter应用程序中发送SMS和MMS的插件。它支持Android和iOS平台,当发送给多个接收者时会以MMS形式发送,在iOS上如果接收者是iPhone并且启用了iMessage,则会通过iMessage发送。

GitHub stars Pub Package

使用方法

安装和导入包

首先确保你已经在pubspec.yaml文件中添加了flutter_sms依赖项,并且已经运行了flutter pub get命令来安装该包。

然后在Dart代码中导入这个包:

import 'package:flutter_sms/flutter_sms.dart';

发送短信

你可以通过以下几种方式构建短信:

  1. 只有消息内容而没有指定接收人。
  2. 只有接收人列表但没有消息内容。
  3. 同时包含消息内容和接收人列表。

下面是一个简单的例子,展示如何定义一个发送短信的功能:

void _sendSMS(String message, List<String> recipients) async {
  String result = await sendSMS(message: message, recipients: recipients).catchError((onError) {
    print(onError);
  });
  print(result);
}

要发送一条测试消息,可以这样做:

String message = "这是测试信息!";
List<String> recipients = ["1234567890", "5556787676"];
_sendSMS(message, recipients);

直接发送(仅限Android)

对于Android设备,你可以选择直接发送短信而不显示额外的对话框,但这需要特别注意应用商店政策以及用户权限问题。如果你确实需要此功能,请确保你的应用符合相关要求并正确处理权限请求。

String message = "这是测试信息!";
List<String> recipients = ["1234567890", "5556787676"];

String result = await sendSMS(message: message, recipients: recipients, sendDirect: true).catchError((onError) {
  print(onError);
});
print(result);

注意: 使用sendDirect选项还需要在AndroidManifest.xml中声明SEND_SMS权限:

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

示例Demo

为了更好地理解如何在实际项目中使用flutter_sms,这里提供了一个完整的示例程序,展示了如何创建一个界面让用户输入电话号码和消息内容,并最终发送出去。

import 'dart:async';

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

void main() => runApp(MyApp());

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

class _MyAppState extends State<MyApp> {
  late TextEditingController _controllerPeople, _controllerMessage;
  String? _message, body;
  String _canSendSMSMessage = 'Check is not run.';
  List<String> people = [];
  bool sendDirect = false;

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

  Future<void> initPlatformState() async {
    _controllerPeople = TextEditingController();
    _controllerMessage = TextEditingController();
  }

  Future<void> _sendSMS(List<String> recipients) async {
    try {
      String _result = await sendSMS(
        message: _controllerMessage.text,
        recipients: recipients,
        sendDirect: sendDirect,
      );
      setState(() => _message = _result);
    } catch (error) {
      setState(() => _message = error.toString());
    }
  }

  Future<bool> _canSendSMS() async {
    bool _result = await canSendSMS();
    setState(() => _canSendSMSMessage =
        _result ? 'This unit can send SMS' : 'This unit cannot send SMS');
    return _result;
  }

  Widget _phoneTile(String name) {
    return Padding(
      padding: const EdgeInsets.all(3),
      child: Container(
          decoration: BoxDecoration(
              border: Border(
            bottom: BorderSide(color: Colors.grey.shade300),
            top: BorderSide(color: Colors.grey.shade300),
            left: BorderSide(color: Colors.grey.shade300),
            right: BorderSide(color: Colors.grey.shade300),
          )),
          child: Padding(
            padding: const EdgeInsets.all(4),
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              mainAxisSize: MainAxisSize.min,
              children: <Widget>[
                IconButton(
                  icon: const Icon(Icons.close),
                  onPressed: () => setState(() => people.remove(name)),
                ),
                Padding(
                  padding: const EdgeInsets.all(0),
                  child: Text(
                    name,
                    textScaleFactor: 1,
                    style: const TextStyle(fontSize: 12),
                  ),
                )
              ],
            ),
          )),
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SMS/MMS Example'),
        ),
        body: ListView(
          children: <Widget>[
            if (people.isEmpty)
              const SizedBox(height: 0)
            else
              SizedBox(
                height: 90,
                child: Padding(
                  padding: const EdgeInsets.all(3),
                  child: ListView(
                    scrollDirection: Axis.horizontal,
                    children: List<Widget>.generate(people.length, (int index) {
                      return _phoneTile(people[index]);
                    }),
                  ),
                ),
              ),
            ListTile(
              leading: const Icon(Icons.people),
              title: TextField(
                controller: _controllerPeople,
                decoration:
                    const InputDecoration(labelText: 'Add Phone Number'),
                keyboardType: TextInputType.number,
                onChanged: (String value) => setState(() {}),
              ),
              trailing: IconButton(
                icon: const Icon(Icons.add),
                onPressed: _controllerPeople.text.isEmpty
                    ? null
                    : () => setState(() {
                          people.add(_controllerPeople.text.toString());
                          _controllerPeople.clear();
                        }),
              ),
            ),
            const Divider(),
            ListTile(
              leading: const Icon(Icons.message),
              title: TextField(
                decoration: const InputDecoration(labelText: 'Add Message'),
                controller: _controllerMessage,
                onChanged: (String value) => setState(() {}),
              ),
            ),
            const Divider(),
            ListTile(
              title: const Text('Can send SMS'),
              subtitle: Text(_canSendSMSMessage),
              trailing: IconButton(
                padding: const EdgeInsets.symmetric(vertical: 16),
                icon: const Icon(Icons.check),
                onPressed: () {
                  _canSendSMS();
                },
              ),
            ),
            SwitchListTile(
                title: const Text('Send Direct'),
                subtitle: const Text(
                    'Should we skip the additional dialog? (Android only)'),
                value: sendDirect,
                onChanged: (bool newValue) {
                  setState(() {
                    sendDirect = newValue;
                  });
                }),
            Padding(
              padding: const EdgeInsets.all(8),
              child: ElevatedButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.resolveWith(
                      (states) => Theme.of(context).colorScheme.secondary),
                  padding: MaterialStateProperty.resolveWith(
                      (states) => const EdgeInsets.symmetric(vertical: 16)),
                ),
                onPressed: () {
                  _send();
                },
                child: Text(
                  'SEND',
                  style: Theme.of(context).textTheme.displayMedium,
                ),
              ),
            ),
            Visibility(
              visible: _message != null,
              child: Row(
                mainAxisAlignment: MainAxisAlignment.center,
                children: <Widget>[
                  Expanded(
                    child: Padding(
                      padding: const EdgeInsets.all(12),
                      child: Text(
                        _message ?? 'No Data',
                        maxLines: null,
                      ),
                    ),
                  ),
                ],
              ),
            ),
          ],
        ),
      ),
    );
  }

  void _send() {
    if (people.isEmpty) {
      setState(() => _message = 'At Least 1 Person or Message Required');
    } else {
      _sendSMS(people);
    }
  }
}

以上就是关于flutter_sms插件的基本介绍和用法示例,希望对你有所帮助!如果有任何疑问或者需要进一步的帮助,请随时提问。


更多关于Flutter短信发送与接收管理插件flutter_sms的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter短信发送与接收管理插件flutter_sms的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何在Flutter项目中使用flutter_sms插件来发送和接收短信的示例代码。flutter_sms插件允许你访问设备的短信功能,但请注意,由于短信功能涉及用户隐私,在实际应用中需要确保你的应用具有相应的权限,并且符合用户隐私政策。

首先,你需要在pubspec.yaml文件中添加flutter_sms依赖:

dependencies:
  flutter:
    sdk: flutter
  flutter_sms: ^2.2.0  # 请检查最新版本号

然后运行flutter pub get来安装依赖。

接下来,在Android的AndroidManifest.xml文件中添加必要的权限:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.yourapp">

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

    <application
        ... >
        <!-- 如果需要接收短信,需要声明一个BroadcastReceiver -->
        <receiver android:name=".SmsReceiver" android:exported="true" android:permission="android.permission.BROADCAST_SMS">
            <intent-filter>
                <action android:name="android.provider.Telephony.SMS_DELIVER_ACTION" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

注意:SmsReceiver是一个你需要实现的BroadcastReceiver类,用于接收短信。但在Flutter中使用flutter_sms插件时,通常不需要手动实现这个类,因为插件已经处理了这部分。这里的声明主要是为了确保在AndroidManifest中有接收短信的权限声明。

接下来是Flutter代码部分,用于发送和监听短信:

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

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

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

class _MyAppState extends State<MyApp> {
  String _smsResult = "";

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter SMS Example'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              TextButton(
                onPressed: _sendSms,
                child: Text('Send SMS'),
              ),
              SizedBox(height: 20),
              Text('SMS Result: $_smsResult'),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> _sendSms() async {
    String phoneNumber = "+1234567890"; // 替换为实际的电话号码
    String message = "Hello, this is a test message!";

    try {
      bool result = await FlutterSms.sendSms(
        to: [phoneNumber],
        message: message,
      );

      setState(() {
        _smsResult = result ? "SMS sent successfully" : "Failed to send SMS";
      });
    } catch (e) {
      setState(() {
        _smsResult = "Error: ${e.message}";
      });
    }
  }

  // 注意:flutter_sms插件本身不提供直接监听短信的功能。
  // 监听短信通常需要在原生代码中实现,然后通过MethodChannel与Flutter通信。
  // 这部分超出了简单示例的范围,但你可以查阅flutter_sms的文档和源码了解更多细节。
}

在这个示例中,我们创建了一个简单的Flutter应用,其中包含一个按钮用于发送短信,并在界面上显示发送结果。请注意,flutter_sms插件本身不提供直接监听短信接收的功能。如果你需要监听短信接收,你需要在原生Android或iOS代码中实现一个BroadcastReceiver或相应的监听机制,然后通过MethodChannel与Flutter代码进行通信。

务必确保你的应用有适当的权限声明,并且在运行时请求这些权限(特别是Android 6.0及以上版本)。此外,由于隐私政策的变化,某些应用商店或设备可能限制或禁止应用访问短信功能,因此在实际部署前请进行充分的测试。

回到顶部