Flutter VoIP推送通知插件flutter_voip_push_notification_v2的使用

当然，下面是一个关于如何使用 flutter_voip_push_notification_v2 插件的简要指南和代码示例。这个插件主要用于在 Flutter 应用中实现 VoIP 推送通知。

环境配置

首先，确保你的 Flutter 项目已经创建，并且在 pubspec.yaml 文件中添加了 flutter_voip_push_notification_v2 依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_voip_push_notification_v2: ^x.y.z  # 替换为最新版本号

然后运行 flutter pub get 来获取依赖。

iOS 配置

对于 iOS，你需要配置你的 Info.plist 和 AppDelegate.swift 或 AppDelegate.m 文件。

1. 在 Info.plist 中添加权限请求：

<key>NSVoIPUsageDescription</key>
<string>需要VoIP权限来接收来电</string>

1. 在 AppDelegate.swift 中配置：

import UIKit
import Flutter
import flutter_voip_push_notification_v2

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    
    // 注册VoIP推送通知
    if let voipRegistration = VoIPPushNotificationManager.shared() {
      voipRegistration.setupVoIP()
    }
    
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }

  override func application(_ application: UIApplication,
                           didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                           fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    // 处理VoIP推送通知
    if let voipRegistration = VoIPPushNotificationManager.shared() {
      voipRegistration.handleVoIPPush(userInfo: userInfo)
    }
    completionHandler(.newData)
  }

  override func applicationDidEnterBackground(_ application: UIApplication) {
    // 当应用进入后台时，保持VoIP socket连接
    if let voipRegistration = VoIPPushNotificationManager.shared() {
      voipRegistration.keepAlive()
    }
  }
}

Android 配置

对于 Android，你需要在 AndroidManifest.xml 和创建一个 VoIPService。

1. 在 AndroidManifest.xml 中添加权限：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>

1. 创建一个 VoIPService 类：

import android.app.Notification
import android.app.PendingIntent
import android.app.Service
import android.content.Context
import android.content.Intent
import android.os.Build
import android.os.IBinder
import androidx.core.app.NotificationCompat
import androidx.core.app.NotificationManagerCompat
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.embedding.engine.FlutterEngineCache
import io.flutter.plugins.generated.VoipPushNotificationPluginRegistrant
import com.example.yourapp.VoIPPushNotificationManager  // 替换为你的包名

class VoIPService : Service() {

    private lateinit var flutterEngine: FlutterEngine

    override fun onCreate() {
        super.onCreate()
        flutterEngine = FlutterEngine(this)
        flutterEngine.navigationChannel.setInitialRoute("/")
        VoipPushNotificationPluginRegistrant.registerWith(flutterEngine)

        VoIPPushNotificationManager.shared(flutterEngine).setupVoIP(this)

        startForeground(1, createNotification())
    }

    private fun createNotification(): Notification {
        val intent = Intent(this, MainActivity::class.java)
        val pendingIntent: PendingIntent = PendingIntent.getActivity(this, 0, intent, 0)

        val builder: Notification.Builder
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channelId = "voip_channel"
            val channelName = "VoIP Channel"
            val importance = NotificationManager.IMPORTANCE_HIGH
            val channel = NotificationChannel(channelId, channelName, importance).apply {
                description = "Channel for VoIP notifications"
            }
            val notificationManager: NotificationManager =
                getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
            notificationManager.createNotificationChannel(channel)
            builder = Notification.Builder(this, channelId)
        } else {
            builder = Notification.Builder(this)
        }

        return builder.setContentTitle("VoIP Call")
            .setContentText("Incoming call")
            .setSmallIcon(R.drawable.ic_notification)
            .setContentIntent(pendingIntent)
            .build()
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        return START_STICKY
    }

    override fun onBind(intent: Intent?): IBinder? {
        return null
    }

    override fun onDestroy() {
        flutterEngine.destroy()
        super.onDestroy()
    }
}

1. 在 AndroidManifest.xml 中注册 VoIPService：

<service android:name=".VoIPService"
         android:foregroundServiceType="voip"
         android:permission="android.permission.BIND_VOIP_SERVICE"/>

Flutter 代码示例

在 Flutter 端，你可以使用以下代码来初始化并处理 VoIP 推送通知：

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

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

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

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    VoIPPushNotificationManager.shared()
      ..initialize(
        onIncomingCall: (Map<String, dynamic> payload) async {
          // 处理来电
          print('Incoming call payload: $payload');
        },
        onReportNew: (Map<String, dynamic> payload) {
          // 处理其他VoIP事件
          print('Report new payload: $payload');
        },
      )
      ..registerVoIP();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('VoIP Push Notification Demo'),
        ),
        body: Center(
          child: Text('Waiting for VoIP Push Notification...'),
        ),
      ),
    );
  }
}

总结

上述代码展示了如何在 Flutter 项目中集成 flutter_voip_push_notification_v2 插件来处理 VoIP 推送通知。这包括在 iOS 和 Android 上的必要配置以及 Flutter 端的代码实现。确保按照文档和实际需求调整配置和代码。