Flutter短信发送与接收管理插件flutter_sms的使用
Flutter短信发送与接收管理插件flutter_sms的使用
插件概述
flutter_sms
是一个用于在Flutter应用程序中发送SMS和MMS的插件。它支持Android和iOS平台,当发送给多个接收者时会以MMS形式发送,在iOS上如果接收者是iPhone并且启用了iMessage,则会通过iMessage发送。
使用方法
安装和导入包
首先确保你已经在pubspec.yaml
文件中添加了flutter_sms
依赖项,并且已经运行了flutter pub get
命令来安装该包。
然后在Dart代码中导入这个包:
import 'package:flutter_sms/flutter_sms.dart';
发送短信
你可以通过以下几种方式构建短信:
- 只有消息内容而没有指定接收人。
- 只有接收人列表但没有消息内容。
- 同时包含消息内容和接收人列表。
下面是一个简单的例子,展示如何定义一个发送短信的功能:
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
更多关于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及以上版本)。此外,由于隐私政策的变化,某些应用商店或设备可能限制或禁止应用访问短信功能,因此在实际部署前请进行充分的测试。