flutter_phone_call_handler 是一个用于处理电话呼叫事件的 Flutter 插件。它允许你在 Flutter 应用中监听电话的呼入、呼出和挂断事件。这个插件在需要根据电话状态执行特定操作的应用中非常有用，例如在呼叫期间暂停媒体播放或在呼叫结束后恢复操作。

安装

首先，你需要在 pubspec.yaml 文件中添加 flutter_phone_call_handler 依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_phone_call_handler: ^1.0.0  # 请使用最新版本

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

使用

1. 导入包

   在你的 Dart 文件中导入 flutter_phone_call_handler 包：

   import 'package:flutter_phone_call_handler/flutter_phone_call_handler.dart';
   

2. 初始化插件

   在使用插件之前，需要先初始化它。通常你可以在 initState 方法中进行初始化：

   class MyApp extends StatefulWidget {
     [@override](/user/override)
     _MyAppState createState() => _MyAppState();
   }
   
   class _MyAppState extends State<MyApp> {
     late PhoneCallHandler _phoneCallHandler;
   
     [@override](/user/override)
     void initState() {
       super.initState();
       _phoneCallHandler = PhoneCallHandler();
       _initPhoneCallHandler();
     }
   
     void _initPhoneCallHandler() async {
       await _phoneCallHandler.initialize();
       _phoneCallHandler.onCallStateChanged.listen((callState) {
         _handleCallState(callState);
       });
     }
   
     void _handleCallState(CallState callState) {
       switch (callState) {
         case CallState.incoming:
           print("Incoming call");
           break;
         case CallState.outgoing:
           print("Outgoing call");
           break;
         case CallState.ended:
           print("Call ended");
           break;
       }
     }
   
     [@override](/user/override)
     Widget build(BuildContext context) {
       return MaterialApp(
         home: Scaffold(
           appBar: AppBar(
             title: Text('Phone Call Handler Example'),
           ),
           body: Center(
             child: Text('Check console for call state changes'),
           ),
         ),
       );
     }
   }
   

3. 处理电话状态变化

   在上面的代码中，_handleCallState 方法负责处理电话状态的变化。你可以根据 callState 的值执行不同的操作。

   • CallState.incoming: 当有电话呼入时触发。
   • CallState.outgoing: 当有电话呼出时触发。
   • CallState.ended: 当电话结束时触发。

4. 释放资源

   在不需要监听电话状态时，确保释放资源。你可以在 dispose 方法中调用 dispose 方法：

   [@override](/user/override)
   void dispose() {
     _phoneCallHandler.dispose();
     super.dispose();
   }
   

注意事项

• 权限: 在某些平台上，可能需要特定的权限来监听电话状态。确保在 Android 的 AndroidManifest.xml 文件中添加以下权限：

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

• 平台支持: flutter_phone_call_handler 插件主要支持 Android 和 iOS 平台。在使用之前，请确保你的目标平台支持该功能。

示例

以下是一个完整的示例，展示了如何使用 flutter_phone_call_handler 插件来监听电话状态变化：

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

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late PhoneCallHandler _phoneCallHandler;

  [@override](/user/override)
  void initState() {
    super.initState();
    _phoneCallHandler = PhoneCallHandler();
    _initPhoneCallHandler();
  }

  void _initPhoneCallHandler() async {
    await _phoneCallHandler.initialize();
    _phoneCallHandler.onCallStateChanged.listen((callState) {
      _handleCallState(callState);
    });
  }

  void _handleCallState(CallState callState) {
    switch (callState) {
      case CallState.incoming:
        print("Incoming call");
        break;
      case CallState.outgoing:
        print("Outgoing call");
        break;
      case CallState.ended:
        print("Call ended");
        break;
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Phone Call Handler Example'),
        ),
        body: Center(
          child: Text('Check console for call state changes'),
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _phoneCallHandler.dispose();
    super.dispose();
  }
}