Contact Center AI 平台 (CCAI 平台) 提供多種方法 (包括 React)，可與行動應用程式整合。本文說明如何整合 iOS 適用的 React Native。
請先按照「適用於 Mobile SDK 的 React Native」中的操作說明完成設定，再進行下列 Android 專用步驟。
使用 CocoaPods 整合 SDK
如要使用 CocoaPods 整合行動 SDK，請開啟 Podfile，然後將下列依附元件新增至目標：
UJETPodspec = { :podspec => 'https://sdk.ujet.co/ios/UJET.podspec' } pod 'UJET', UJETPodspec pod 'UJET/Cobrowse', UJETPodspec從 ios 資料夾執行
pod-install指令，或從應用程式資料夾執行 npx pod-install，安裝依附元件。
設定推播通知
如要為行動 SDK 設定推播通知，請按照下列步驟操作：
開啟 Xcode 專案。
開啟符合
RCTAppDelegate的檔案，然後新增下列程式碼：#import <UJETKit/UJETKit.h> #import <PushKit/PushKit.h> @interface AppDelegate() <PKPushRegistryDelegate> @end - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { PKPushRegistry *voipRegistry = [[PKPushRegistry alloc] initWithQueue: dispatch_get_main_queue()]; voipRegistry.delegate = self; voipRegistry.desiredPushTypes = [NSSet setWithObject:PKPushTypeVoIP]; } #pragma mark PushKit - (NSString *)tokenFromData:(NSData *)data { const void *bytes = [data bytes]; const unsigned char *d = (const unsigned char *)bytes; NSMutableString *token = [NSMutableString string]; for (NSUInteger i = 0; i < [data length]; ++i) { [token appendFormat:@"%02X", d[i]]; } return [token lowercaseString]; } - (void)pushRegistry:(PKPushRegistry *)registry didUpdatePushCredentials:(PKPushCredentials *)credentials forType:(PKPushType)type { NSLog(@"voip token: %@", [self tokenFromData:credentials.token]); if ([type isEqual:PKPushTypeVoIP]) { [UJET updatePushToken:credentials.token type:UjetPushTypeVoIP]; } } - (void)pushRegistry:(PKPushRegistry *)registry didInvalidatePushTokenForType:(PKPushType)type { if ([type isEqual:PKPushTypeVoIP]) { [UJET updatePushToken:nil type:UjetPushTypeVoIP]; } } - (void)pushRegistry:(PKPushRegistry *)registry didReceiveIncomingPushWithPayload:(PKPushPayload *)payload forType:(PKPushType)type withCompletionHandler:(void (^)(void))completion { if ([type isEqual:PKPushTypeVoIP] && payload.dictionaryPayload[@"ujet"]) { [UJET receivedNotification:payload.dictionaryPayload completion:completion]; } else { completion(); } } #pragma mark APNS - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { NSLog(@"apns token: %@", [self tokenFromData:deviceToken]); [UJET updatePushToken:deviceToken type:UjetPushTypeAPN]; } - (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(nonnull NSError *)error { [UJET updatePushToken:nil type:UjetPushTypeAPN]; } - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { if (userInfo[@"ujet"]) { [UJET receivedNotification:userInfo completion:nil]; } else { // handle your notifications } }Swift：
import UJETKit import PushKit func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { let voipRegistry = PKPushRegistry(queue: DispatchQueue.main) voipRegistry.desiredPushTypes = Set([PKPushType.voIP]) voipRegistry.delegate = self } // MARK: Push Notifications extension AppDelegate { func tokenFromData(data: Data) -> String { return data.map { String(format: "%02x", $0) }.joined() } func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { print("apns token: ", tokenFromData(data: deviceToken)) UJET.updatePushToken(deviceToken, type: .APN) } func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) { UJET.updatePushToken(nil, type: .APN) } func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { if userInfo["ujet"] != nil { UJET.receivedNotification(userInfo, completion: nil) } else { // handle your notifications } } } // 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 && payload.dictionaryPayload["ujet"] != nil { UJET.receivedNotification(payload.dictionaryPayload, completion: completion) } else { completion() } } }選取 .xcodeproj，然後選取應用程式目標。在「Frameworks, Libraries, and Embedded Content」區段中新增 PushKit.framework。
設定深層連結
如要在行動應用程式中支援深層連結，請使用下列程式碼：
#pragma mark Deep Link
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
if ([url.scheme isEqualToString:@"ujet"]) {
return [self handleRouting:url];
}
return NO;
}
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray<id<UIUserActivityRestoring>> * __nullable restorableObjects))restorationHandler {
// Universal links
if ([NSUserActivityTypeBrowsingWeb isEqualToString:userActivity.activityType]) {
return [self handleRouting:userActivity.webpageURL];
} else if ([userActivity.activityType isEqualToString:@"INStartAudioCallIntent"]) {
// Open app from Call history
[UJET startWithOptions:nil];
return YES;
}
return NO;
}
- (BOOL)handleRouting:(NSURL *)url {
NSArray *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" // TODO: or your universal link
];
NSArray *availableHostAndPath = @[
@"call", // custom URL scheme
@"ujet.cx/app" // universal link
];
if (![availableSchema containsObject:url.scheme]) {
return NO;
}
NSString *hostAndPath = [NSString stringWithFormat:@"%@%@", url.host, url.path];
if (![availableHostAndPath containsObject:hostAndPath]) {
return NO;
}
// ujetrn://call?call_id={call_id}&nonce={nonce}
// https://ujet.co/app?call_id={call_id}&nonce={nonce}
NSURLComponents *urlComponents = [NSURLComponents componentsWithURL:url
resolvingAgainstBaseURL:NO];
NSArray *queryItems = urlComponents.queryItems;
NSString *callId = [self valueForKey:@"call_id" fromQueryItems:queryItems];
// validate call ID
if (![self isValidCallId:callId]) {
return NO;
}
NSString *nonce = [self valueForKey:@"nonce" fromQueryItems:queryItems];
UJETStartOptions *options = [[UJETStartOptions alloc] initWithCallId:callId nonce:nonce];
[UJET startWithOptions:options];
return YES;
}
- (NSString *)valueForKey:(NSString *)key fromQueryItems:(NSArray *)queryItems {
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name=%@", key];
NSURLQueryItem *queryItem = [[queryItems
filteredArrayUsingPredicate:predicate]
firstObject];
return queryItem.value;
}
- (BOOL)isValidCallId:(NSString *)callId {
if (callId.length == 0) {
return NO;
}
NSCharacterSet *nonNumbers = [[NSCharacterSet decimalDigitCharacterSet] invertedSet];
NSRange r = [callId rangeOfCharacterFromSet: nonNumbers];
return r.location == NSNotFound;
}
Swift：
// MARK: Deep Link
extension AppDelegate {
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
print("Open app with url: \(url.absoluteString)")
return self.handleRouting(url)
}
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
let model = DataController.shared.startOptions()
let startOptions = StartOptionsController().convert(model)
UJET.start(with: startOptions)
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
}
}
目標設定
本節說明目標設定所需的功能和額外資訊。
功能
推播通知
背景模式 (請勾選下列項目)：
音訊和 AirPlay
網路電話 (VoIP)
資訊
新增下列鍵值並附上說明：
NSMicrophoneUsageDescription
NSCameraUsageDescription
NSPhotoLibraryUsageDescription
NSFaceIDUsageDescription