Flutter消息通信插件infobip_mobilemessaging的使用

Flutter消息通信插件infobip_mobilemessaging的使用

Mobile Messaging SDK 插件介绍

Mobile Messaging SDK 是为您的移动应用程序设计和开发的，旨在轻松启用推送通知通道。几乎在实施过程中，您就可以在应用程序中获取推送通知，并访问 Infobip IP Messaging Platform 的功能。

本文档描述了将插件集成到您的 Flutter 项目中的步骤。

需求

• Flutter 3.3.0+
• iOS 项目：
  • Xcode 116.x
  • 最小部署目标 12.0
• Android 项目：
  • Android Studio
  • 支持的 API 级别：21 (Android 5.0 - Lollipop) - 34 (Android 14)

快速启动指南

此指南旨在帮助您快速上手 Flutter 中的 Mobile Messaging SDK 插件。

1. 确保在 Infobip 平台上设置应用（如果尚未设置）。
2. 在 pubspec.yaml 文件中添加 infobip_mobilemessaging 插件依赖项：

dependencies:
  infobip_mobilemessaging: '^6.1.0'

1. 运行 flutter pub get 安装插件。
2. 配置平台：
   • iOS： 更新 ios/Podfile 以设置 iOS 部署目标平台 12.0，如果需要的话，在 Terminal 中执行 cd ios && pod update。 导入 MobileMessaging 和在 <ProjectName>/ios/Runner/AppDelegate.m 中添加 [MobileMessagingPluginApplicationDelegate install];（这要求 OS 回调如 didRegisterForRemoteNotifications 被原生 MobileMessaging SDK 捕获）：

@import MobileMessaging;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    ...
    [MobileMessagingPluginApplicationDelegate install];
    ...
}
...

参考 Swift 代码：

import MobileMessaging
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        ...
        MobileMessagingPluginApplicationDelegate.install()
        ...
    }
}
...

1. 配置您的项目以支持推送通知，详情请参阅 iOS 整合快速启动指南中的第 2 步。

2. 将 Notification Service Extension 集成到您的应用中，以便获得：

   • 更准确的消息处理和交付统计
   • 锁屏上的丰富通知支持

3. Android：

   • 添加 com.google.gms:google-services 到 android/build.gradle 文件中。
   • 在 android/app/build.gradle 文件末尾添加 apply plugin: 'com.google.gms.google-services' 以应用 Google Services Gradle 插件。
   • 设置 Firebase 为您的项目，并将 Firebase 配置文件（google-services.json）添加到 app 目录下。通常需要添加到 android/app 目录中。

4. 如果您想以不同的方式提供 Firebase 配置，请参阅 Applying Firebase configuration in MobileMessaging Flutter plugin。

5. 从 Android 13 开始，Google 要求用户授予通知权限。请遵循 Android 13 通知权限处理指南。

使用插件示例代码

import 'package:flutter/material.dart';
import 'package:infobip_mobilemessaging/infobip_mobilemessaging.dart';
import 'package:infobip_mobilemessaging/models/configurations/configuration.dart' as mmconfiguration;
import 'screens/homepage.dart';
import 'widgets/page.dart';

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

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

  [@override](/user/override)
  State createState() => _MyAppState();
}

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    if (!mounted) return;

    await InfobipMobilemessaging.init(mmconfiguration.Configuration(
      applicationCode: 'Your Application Code',
      inAppChatEnabled: true,
      fullFeaturedInAppsEnabled: false,
      defaultMessageStorage: true,
      iosSettings: mmconfiguration.IOSSettings(
          notificationTypes: ['alert', 'badge', 'sound'],
          forceCleanup: false,
          logging: true,
          withoutRegisteringForRemoteNotifications: false),
      webRTCUI: mmconfiguration.WebRTCUI(
          configurationId: 'Your WEBRTC push configuration id'),
    ));
    // Comment out to automatically enable WebRTC
    // try {
    //   await InfobipMobilemessaging.enableChatCalls();
    //   print('Calls enabled.');
    // } catch (err) {
    //   print('Calls enable error: $err');
    // }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Infobip Flutter Example',
      routes: Map.fromEntries(pages.map((d) => MapEntry(d.route, d.builder))),
      home: const HomePage(),
      navigatorKey: navigatorKey,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.white),
        scaffoldBackgroundColor: const Color(0xfff4ff22),
        useMaterial3: true,
        fontFamily: 'RobotoMono',
      ),
    );
  }
}