flutter_ios_voip_kit_karmm 是一个用于在 Flutter 应用中实现 iOS VoIP（Voice over Internet Protocol）通信的插件。它允许开发者在 iOS 设备上实现 VoIP 功能，如接听和拨打电话。以下是如何使用 flutter_ios_voip_kit_karmm 插件的基本步骤：

1. 添加依赖

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

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

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

2. 配置 iOS 项目

在 iOS 项目中，你需要进行一些配置以支持 VoIP 功能。

2.1 启用后台模式

在 Info.plist 文件中，添加以下键值对以启用 VoIP 后台模式：

<key>UIBackgroundModes</key>
<array>
    <string>voip</string>
</array>

2.2 配置推送通知

VoIP 功能通常依赖于推送通知来唤醒应用。你需要在 Info.plist 文件中配置推送通知：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

3. 初始化插件

在你的 Flutter 应用中，初始化 flutter_ios_voip_kit_karmm 插件：

import 'package:flutter_ios_voip_kit_karmm/flutter_ios_voip_kit_karmm.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterIosVoipKitKarmm.initialize();
  runApp(MyApp());
}

4. 处理 VoIP 事件

你可以监听 VoIP 事件，如来电、接听、挂断等：

FlutterIosVoipKitKarmm.onCallReceived.listen((call) {
  // 处理来电
  print('Incoming call from ${call.callerId}');
});

FlutterIosVoipKitKarmm.onCallAnswered.listen((call) {
  // 处理接听
  print('Call answered');
});

FlutterIosVoipKitKarmm.onCallEnded.listen((call) {
  // 处理挂断
  print('Call ended');
});

5. 拨打电话

你可以使用插件提供的 API 拨打电话：

FlutterIosVoipKitKarmm.makeCall('1234567890');

6. 处理推送通知

VoIP 功能通常依赖于推送通知来唤醒应用。你需要在 AppDelegate 中处理推送通知：

#import "AppDelegate.h"
#import <flutter_ios_voip_kit_karmm/FlutterIosVoipKitKarmmPlugin.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [FlutterIosVoipKitKarmmPlugin registerWithRegistrar:[self registrarForPlugin:@"FlutterIosVoipKitKarmmPlugin"]];
    return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    [FlutterIosVoipKitKarmmPlugin didReceiveRemoteNotification:userInfo];
    completionHandler(UIBackgroundFetchResultNewData);
}

@end

7. 处理 VoIP 推送通知

你需要在 AppDelegate 中处理 VoIP 推送通知：

- (void)pushRegistry:(PKPushRegistry *)registry didReceiveIncomingPushWithPayload:(PKPushPayload *)payload forType:(PKPushType)type withCompletionHandler:(void (^)(void))completion {
    [FlutterIosVoipKitKarmmPlugin didReceiveIncomingPushWithPayload:payload forType:type];
    completion();
}

8. 处理 VoIP 通话状态

你可以在 Flutter 中监听 VoIP 通话状态的变化：

FlutterIosVoipKitKarmm.onCallStateChanged.listen((state) {
  // 处理通话状态变化
  print('Call state changed: $state');
});

9. 结束通话

你可以使用插件提供的 API 结束通话：

FlutterIosVoipKitKarmm.endCall();

10. 处理权限

确保在 iOS 设备上请求必要的权限，如麦克风和摄像头权限：

import 'package:permission_handler/permission_handler.dart';

void requestPermissions() async {
  await Permission.microphone.request();
  await Permission.camera.request();
}

11. 处理错误

你可以监听插件的错误事件：

FlutterIosVoipKitKarmm.onError.listen((error) {
  // 处理错误
  print('Error: $error');
});

12. 清理资源

在应用退出时，确保清理 VoIP 相关的资源：

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