Flutter在线客服插件jivosdk_plugin的使用

Jivo Mobile SDK 允许你在你的 Flutter 移动应用程序中嵌入聊天功能以接收客户请求。集成只需几分钟，因为聊天界面和消息流已经实现——你只需要在项目中添加几行代码。

当前版本特性

• 客户与代理之间的聊天
• 双向文件传输
• 聊天历史记录
• 消息状态指示器（已发送、已送达、已读）
• PUSH 通知

更新日志

查看 更新日志 以了解包的最新更改。

示例应用

此存储库包含一个完全功能的 示例应用。

添加依赖

将以下依赖项添加到你的包的 pubspec.yaml 文件中：

dependencies:
  jivosdk_plugin: ^1.0.0

然后运行 flutter packages get。

快速开始

import 'package:jivosdk_plugin/bridge.dart';

// 配置授权用户
Jivo.session.setContactInfo(name: "Homer", email: "h.simpson@springfield.com", phone: "Simpson", brief: "Family guy");
Jivo.session.setup(channelId: "YOUR_CHANNEL_ID", userToken: "USER_JWT_TOKEN");

// 或者配置匿名用户
Jivo.session.setup(channelId: "YOUR_CHANNEL_ID", userToken: "");

// 显示聊天窗口
Jivo.display.present();

配置

平台：iOS

请在初始运行之前在 ios/Podfile 的开头添加以下行：

source 'https://github.com/cocoapods/specs'
source 'https://github.com/jivochat/cocoapods-repo'

请确保在 AppDelegate 类中调用一些相应的 JivoSDK 方法来处理 APNS，例如以下示例：

import UserNotifications
import Flutter
import JivoSDK

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        GeneratedPluginRegistrant.register(with: self)
        Jivo.notifications.handleLaunch(options: launchOptions)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
    
    override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        Jivo.notifications.setPushToken(data: deviceToken)
    }
    
    override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        Jivo.notifications.setPushToken(data: nil)
    }
    
    override func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
        if let result = Jivo.notifications.didReceiveRemoteNotification(userInfo: userInfo) {
            completionHandler(result)
        } else {
            completionHandler(.noData)
        }
    }
    
    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
        if let options = Jivo.notifications.willPresent(notification: notification, preferableOptions: .banner) {
            completionHandler(options)
        } else {
            completionHandler([])
        }
    }
    
    override func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        Jivo.notifications.didReceive(response: response)
        completionHandler()
    }
}

平台：Android

在你的根级（项目级）Gradle 文件（<project>/build.gradle）中添加 Google 服务插件作为依赖项：

buildscript {
    ...
    repositories {
        google()
        mavenCentral()
        maven { url 'https://www.jitpack.io' }
    }
    dependencies {
        ...
        classpath 'com.google.gms:google-services:4.3.14'
    }
}

allprojects {
    repositories {
        ...
        google()
        mavenCentral()
        maven { url 'https://www.jitpack.io' }
    }
}

在你的模块（应用级）Gradle 文件（通常是 <project>/<app-module>/build.gradle）中添加依赖项并启用数据绑定：

plugins {
    ...
    id "dev.flutter.flutter-gradle-plugin"
    id 'com.google.gms.google-services'
}

android {
   ...
   buildFeatures {
       dataBinding = true
   }
   ...
}

dependencies {
    ...
    api platform('com.google.firebase:firebase-bom:32.7.2')
    api 'com.google.firebase:firebase-messaging'
}