iOS용 Flutter

Flutter를 비롯한 다양한 방법으로 고객센터 AI 플랫폼 (CCAI 플랫폼)과 연동되도록 모바일 앱을 설정할 수 있습니다. 이 페이지에서는 Flutter를 사용하여 iOS SDK를 iOS 앱에 통합하는 방법을 설명합니다.

시작하기 전에

이 페이지의 안내를 따르기 전에 먼저 Flutter를 사용하여 통합의 안내를 따라야 합니다.

CocoaPods를 사용하여 SDK 통합

CocoaPods를 사용하여 SDK를 통합하려면 다음 단계를 따르세요.

Podfile을 열고 다음 코드 샘플과 같이 타겟에 종속 항목을 추가합니다.

UJETPodspec = { :podspec => 'https://sdk.ujet.co/ios/UJET.podspec' }

pod 'UJET', UJETPodspec
pod 'UJET/Cobrowse', UJETPodspec

터미널에서 example/ios 디렉터리로 이동하여 pod install 명령어를 실행하여 종속 항목을 설치합니다.

iOS 푸시 알림 설정

iOS 푸시 알림을 설정하려면 다음 단계를 따르세요.

XCode에서 example/ios/Runner.xcodeproj을 엽니다.

다음 코드를 AppDelegate.swift 파일에 추가하세요.

import PushKit
import UJETKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    // Register Flutter Plugins
    GeneratedPluginRegistrant.register(with: self)
    UJETModule.register(with: self.registrar(forPlugin: "UjetModule")!)
    UJETModule.onInitDone = {
        // setup push notification
        let voipRegistry = PKPushRegistry(queue: DispatchQueue.main)
        voipRegistry.desiredPushTypes = Set([PKPushType.voIP])
        voipRegistry.delegate = self
        UNUserNotificationCenter.current().delegate = self
    }
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}

// Extension for Push Notification

extension AppDelegate {
    func tokenFromData(data: Data) -> String {
        return data.map { String(format: "%02x", $0) }.joined()
    }

    override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        print("apns token: ", tokenFromData(data: deviceToken))

        UJET.updatePushToken(deviceToken, type: .APN)
    }

    override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        UJET.updatePushToken(nil, type: .APN)
    }

    override func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
        handleNotification(userInfo: userInfo, completion: nil)
    }
}

// MARK: PushKit

extension AppDelegate: PKPushRegistryDelegate {
    func pushRegistry(_ registry: PKPushRegistry, didUpdate credentials: PKPushCredentials, for type: PKPushType) {
        print("voip token: ", tokenFromData(data: credentials.token))

        if type == .voIP {
            UJET.updatePushToken(credentials.token, type: .voIP)
        }
    }

    func pushRegistry(_ registry: PKPushRegistry, didInvalidatePushTokenFor type: PKPushType) {
        if type == .voIP {
            UJET.updatePushToken(nil, type: .voIP)
        }
    }

    func pushRegistry(_ registry: PKPushRegistry, didReceiveIncomingPushWith payload: PKPushPayload, for type: PKPushType, completion: @escaping () -> Void) {
        if type == .voIP {
            handleNotification(userInfo: payload.dictionaryPayload, completion: completion)
        }
    }
}

extension AppDelegate {
// handle push received in foreground state
override func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    let userInfo = notification.request.content.userInfo
    handleNotification(userInfo: userInfo, completion: nil)
}

// handle push received and tapped in background state
override func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo
    handleNotification(userInfo: userInfo, completion: nil)
}
}

private func handleNotification(userInfo: [AnyHashable: Any], completion: (() -> Void)?) {
    if userInfo["ujet"] != nil {
        UJET.receivedNotification(userInfo, completion: completion)
    } else {
        // Handle your notification here
        completion?()
    }
}

.xcodeproj를 선택한 다음 앱 타겟을 선택합니다. Frameworks, Libraries, and Embedded Content 섹션에 PushKit.framework를 추가합니다.

딥 링크 설정

딥 링크를 설정하려면 다음 코드를 추가합니다.

// Extension for deep linking

extension AppDelegate {
    override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
        print("Open app with url: \(url.absoluteString)")

        return self.handleRouting(url)
    }

    override func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
        // Universal links
        if NSUserActivityTypeBrowsingWeb == userActivity.activityType {
            return self.handleRouting(userActivity.webpageURL!)
        } else if userActivity.activityType == "INStartAudioCallIntent" {
            // Open app from Call history
            UJET.start(with: UJETStartOptions())

            return true
        }
        return false
    }

    func handleRouting(_ url: URL) -> Bool {
        let availableSchema = [
            "ujetrn", // TODO: Change to your custom URL scheme. Config from Portal > Developer Settings > Mobile App > Enable Send SMS to Download App > iOS App > URL
            "https" // universal link
        ]
        let availableHostAndPath = [
            "call",         // custom URL scheme
            "ujet.cx/app"  // universal link,
        ]

        if !(availableSchema.contains(url.scheme ?? "")) {
            return false
        }

        let hostAndPath = String.init(format: "%@%@", url.host ?? "", url.path)
        if !(availableHostAndPath.contains(hostAndPath)) {
            return false
        }

        // ujet://call?call_id={call_id}&nonce={nonce}
        // https://ujet.co/app?call_id={call_id}&nonce={nonce}
        let urlComponents: URLComponents? = URLComponents(url: url, resolvingAgainstBaseURL: false)
        let queryItems = urlComponents?.queryItems
        let callId = value(forKey: "call_id", fromQueryItems: queryItems)

        // validate call ID
        if !isValidCallId(callId) {
            return false
        }

        guard let nonce = value(forKey: "nonce", fromQueryItems: queryItems) else {
            return false
        }

        let options = UJETStartOptions.init(callId: callId!, nonce: nonce)

        UJET.start(with: options)

        return true
    }

    func value(forKey key: String?, fromQueryItems queryItems: [URLQueryItem]?) -> String? {
        let predicate = NSPredicate(format: "name=%@", key ?? "")
        let filtered = (queryItems as NSArray?)?.filtered(using: predicate) as? [URLQueryItem]
        let queryItem: URLQueryItem? = filtered?.first

        return queryItem?.value
    }

    func isValidCallId(_ callId: String?) -> Bool {
        if (callId ?? "").isEmpty {
            return false
        }

        let nonNumbers = CharacterSet.decimalDigits.inverted
        let r = callId?.rangeOfCharacter(from: nonNumbers)

        return r == nil
    }
}

iOS용 Flutter 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

CocoaPods를 사용하여 SDK 통합

iOS 푸시 알림 설정

딥 링크 설정

iOS용 Flutter