telephony_sms 0.1.0

A Flutter plugin that allows you to send SMS messages in the background.

example/lib/main.dart

import 'package:flutter/material.dart';

import 'package:telephony_sms/telephony_sms.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(home: HomePage());
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final _telephonySMS = TelephonySMS();
  final _phoneController = TextEditingController();
  final _messageController = TextEditingController(text: 'Hello from Flutter!');

  bool _awaitDelivery = false;
  bool _sending = false;

  @override
  void dispose() {
    _phoneController.dispose();
    _messageController.dispose();
    super.dispose();
  }

  void _report(String text) {
    if (!mounted) return;
    ScaffoldMessenger.of(context)
      ..hideCurrentSnackBar()
      ..showSnackBar(SnackBar(content: Text(text)));
  }

  Future<void> _requestPermission() async {
    try {
      final granted = await _telephonySMS.requestPermission();
      _report(granted ? 'Permission granted' : 'Permission denied');
    } on TelephonySmsException catch (e) {
      _report('Could not request permission: ${e.message}');
    }
  }

  Future<void> _sendSMS() async {
    setState(() => _sending = true);
    try {
      await _telephonySMS.sendSMS(
        phone: _phoneController.text,
        message: _messageController.text,
        completeOn: _awaitDelivery
            ? SmsCompletion.delivered
            : SmsCompletion.sent,
      );
      _report(_awaitDelivery ? 'Delivered' : 'Sent');
    } on TelephonySmsException catch (e) {
      // isTransient is what tells you whether a retry is worth attempting: a
      // radio that is off will come back, a denied permission will not.
      final hint = e.code.isTransient ? ' (retryable)' : '';
      _report('${e.code.name}$hint: ${e.message}');
    } finally {
      if (mounted) setState(() => _sending = false);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('TelephonySMS Plugin example app')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            TextField(
              controller: _phoneController,
              keyboardType: TextInputType.phone,
              decoration: const InputDecoration(
                labelText: 'Phone number',
                border: OutlineInputBorder(),
              ),
            ),
            const SizedBox(height: 12),
            TextField(
              controller: _messageController,
              decoration: const InputDecoration(
                labelText: 'Message',
                border: OutlineInputBorder(),
              ),
            ),
            SwitchListTile(
              contentPadding: EdgeInsets.zero,
              value: _awaitDelivery,
              onChanged: (value) => setState(() => _awaitDelivery = value),
              title: const Text('Wait for delivery report'),
              subtitle: const Text(
                'Many carriers never send one, so this often times out even '
                'when the message arrived.',
              ),
            ),
            const SizedBox(height: 12),
            ElevatedButton(
              onPressed: _requestPermission,
              child: const Text('Check Permission'),
            ),
            const SizedBox(height: 12),
            ElevatedButton(
              onPressed: _sending ? null : _sendSMS,
              child: Text(_sending ? 'Sending…' : 'Send SMS'),
            ),
          ],
        ),
      ),
    );
  }
}