Flutter手机状态管理插件phone_state_handler的使用

Flutter手机状态管理插件phone_state_handler的使用

描述

此插件由 phone_state 修改而来。

该插件允许你快速且简便地知道你的Android或iOS设备是否正在接收电话，并了解通话的状态。

• 原生Android: TelephonyManager
• 原生iOS: CallKit

注意事项

• 在iOS模拟器上无法工作。
• 仅在Android上可以获取来电号码。

如何安装

Flutter

dependencies:
  flutter:
    sdk: flutter
  phone_state: 1.0.1

Android: 在manifest文件中添加权限

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

警告: 添加 READ_CALL_LOG 权限后，如果您的应用没有合理的理由使用它，可能会被Google Play商店移除。但是如果不添加该权限，您将无法获取来电号码。

如何使用

获取电话状态流

StreamBuilder<PhoneState>(
  initialData: PhoneState.nothing(),
  stream: PhoneState.stream,
  ...
)

截图

完整示例代码

以下是一个完整的示例代码，展示了如何使用 phone_state_handler 插件来监控电话状态。

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:phone_state_handler/phone_state_handler.dart';

void main() {
  runApp(
    const MaterialApp(
      home: Example(),
    ),
  );
}

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

  [@override](/user/override)
  State<Example> createState() => _ExampleState();
}

class _ExampleState extends State<Example> {
  PhoneStateHandler status = PhoneStateHandler.nothing();
  bool granted = false;

  Future<bool> requestPermission() async {
    // 请求权限
    var status = await Permission.phone.request();

    // 返回权限请求结果
    return switch (status) {
      PermissionStatus.denied ||
      PermissionStatus.restricted ||
      PermissionStatus.limited ||
      PermissionStatus.permanentlyDenied =>
        false,
      PermissionStatus.provisional || PermissionStatus.granted => true,
    };
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    if (Platform.isIOS) setStream();
  }

  void setStream() {
    // 监听电话状态变化
    PhoneStateHandler.stream.listen((event) {
      setState(() {
        status = event;
      });
    });
  }

  // 根据状态返回图标
  IconData getIcons() {
    return switch (status.status) {
      PhoneStateHandlerStatus.NOTHING => Icons.clear,
      PhoneStateHandlerStatus.CALL_INCOMING => Icons.add_call,
      PhoneStateHandlerStatus.CALL_STARTED => Icons.call,
      PhoneStateHandlerStatus.CALL_ENDED => Icons.call_end,
    };
  }

  // 根据状态返回颜色
  Color getColor() {
    return switch (status.status) {
      PhoneStateHandlerStatus.NOTHING ||
      PhoneStateHandlerStatus.CALL_ENDED =>
        Colors.red,
      PhoneStateHandlerStatus.CALL_INCOMING => Colors.green,
      PhoneStateHandlerStatus.CALL_STARTED => Colors.orange,
    };
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Phone State'),
        centerTitle: true,
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            if (Platform.isAndroid)
              MaterialButton(
                onPressed: !granted
                    ? () async {
                        bool temp = await requestPermission();
                        setState(() {
                          granted = temp;
                          if (granted) {
                            setStream();
                          }
                        });
                      }
                    : null,
                child: const Text('Request permission of Phone'),
              ),
            const Text(
              'Status of call',
              style: TextStyle(fontSize: 24),
            ),
            if (status.status == PhoneStateHandlerStatus.CALL_INCOMING ||
                status.status == PhoneStateHandlerStatus.CALL_STARTED)
              Text(
                'Number: ${status.number}',
                style: const TextStyle(fontSize: 24),
              ),
            Icon(
              getIcons(),
              color: getColor(),
              size: 80,
            )
          ],
        ),
      ),
    );
  }
}