iOS SDK 接入

一. 注册智齿账号

请先确保已注册智齿客服账号（www.sobot.com）。

1. 获取appKey

<管理后台-设置-支持渠道-APP>

二. 下载智齿SDK

点击下载最新最新SDK包。

<iOS SDK V2.2.2>

<安卓SDK V2.2.2>

三. 快速集成

一. 将SDK添加到项目（必须）

1. CocoaPods集成

在 Podfile 文件中加入：

pod 'SobotKit'

如果搜索不到最新版本，请运行以下命令更新CocoPods仓库

pod repo update --verbose

2. 手动集成

解压[iOS_SDK]，添加必要文件SobotKit.framework、ZCEmojiExpression.bundle和SobotKit.bundle到你的工程里。智齿iOS_SDK 的实现，依赖了一些系统的框架，在开发应用时需要在工程里加入这些框架。开发者首先点击工程右边的工程名，然后在工程名右边依次选择TARGETS -> BuiLd Phases -> Link Binary With Libraries，展开 LinkBinary With Libraries后点击展开后下面的+来添加下面的依赖项:

• AVFoundation.framework
• AssetsLibrary.framework
• AudioToolbox.framework
• SystemConfiguration.framework
• MobileCoreServices.framework
• libz.1.2.5.tbd( dylib)

3. 文件介绍

SDK包含（SobotKit.framework、ZCEmojiExpression.bundle和SobotKit.bundle）、SobotDemo、SobotLocalizable语言文件和相关说明文档。

二. 初始化SDK（必须）

初始化参数和调用方式：初始化信息和UI自定义分为2个模型，使用ZCLibInitInfo存储初始化属性，ZCKitInfo设置相关UI属性，一起传递给初始化方法，详情见Demo调用代码；

主要调用代码如下（详细见Demo）：

1. 启动

// 启动
ZCLibInitInfo *initInfo = [ZCLibInitInfo new];
// 企业编号 必填
initInfo.appKey = @"Your appKey";
// 用户id，用于标识用户，建议填写 (注意：userId不要写死，否则获取的历史记录相同)
initInfo.userId = @"Your userId";
//配置UI
ZCKitInfo *uiInfo=[ZCKitInfo new];
// 是否显示转人工按钮
uiInfo.isShowTransfer = YES;

//设置启动参数
[[ZCLibClient getZCLibClient] setLibInitInfo:initInfo];
// 智齿SDK初始化启动事例
[ZCSobot startZCChatView:uiInfo with:self pageBlock:^(ZCUIChatController *objec
t, ZCPageBlockType type) {
  // 点击返回
  if(type==ZCPageBlockGoBack){
    NSLog(@"点击了返回按钮");
  }
  // 页面UI初始化完成，可以获取UIView，自定义UI
  if(type==ZCPageBlockLoadFinish){
    // banner 返回按钮
    // [object.backButton setTitle:@" 返回" forState:UIControlStateNormal];
    // banner 标题
    // [object.titleLabel setFont:[UIFont systemFontOfSize:30]];
    // banner 底部View
    // [object.topView setBackgroundColor:[UIColor greenColor]];
    // 输入框
    // UITextView *tv=[object getChatTextView];
    // [tv setBackgroundColor:[UIColor redColor]];
  }
} messageLinkClick:nil];
// messageLinkClick: // 如果为nil，SDK内部处理理消息中的链接,如果用户自己实现了这个方法，SDK内部
点击链接的事件不在执行，需要用户自己去实现,^(NSString *link)中link为点击的链接。

2. 离线消息

//  初始化智齿客服，会建立长连接通道，监听服务端消息（建议启动应用时调用，没有发起过咨询不会浪费资源，至少转一次人工才有效果）
[[ZCLibClient getZCLibClient] initZCIMCaht];       
// ReceivedMessageBlock 未读消息数， obj 当前消息  unRead 未读消息数
[ZCLibClient getZCLibClient].receivedBlock=^(id obj,int unRead){
  NSLog(@"未读消息数量：\n%d,%@",unRead,obj);   
}];

// 关闭通道，清理内存，退出智齿客户
 说明：调用此方法后将不能接收到离线消息，除非再次进入智齿SDK重新激活
 isClosePush:YES ,是关闭push；NO离线用户，但是可以收到push推送+(void) closeAndoutZCServer:(BOOL) isClosePush; 
[ZCLibClient  closeAndoutZCServer:YES];

注：如果你需要SDK推送的功能请参考以下消息通知、注册推送的相关代码，如果您的项目不需要请略过。

3. 消息通知

在ZCLibClient.h中

/**
推送的token
每次启动应用都需要重新设置
*/
@property (nonatomic,strong) NSData *token;
/**
测试模式，
根据此设置调用的推送证书，默认NO
NO ,调用生产环境
YES，测试环境
*/
@property (nonatomic,assign) BOOL isDebugMode;
/**
自动提醒消息
说明：如果开启自动提醒消息，当没有在智齿聊天页面的时候，都会主动把消息作为本地通知展示
*/
@property (nonatomic,assign) BOOL autoNotification;
/**
获取未读消息数
@return 未读消息数(进入智齿聊天页面会清空)
*/
-(int) getUnReadMessage;
/**
移除消息推送
退出账号时，切记移除消息推送
uid，根据传入的userId生成的唯一标识，token，当前推送的token，error退出错误
error为nil说明成功(如果token和uid都是空不会调用)
*/
-(void)removePush:(void (^)(NSString *uid, NSData *token,NSError *error))result
Block;

a. 注册推送

在AppDelegate.m 文件中注册推送。

b. 导入头文件

#import <SobotKit/SobotKit.h>
#import <UserNotifications/UserNotifications.h>
#define SYSTEM_VERSION_GRATERTHAN_OR_EQUALTO(v) ([[[UIDevice currentDevice] systemVersion] compare:v 
options:NSNumericSearch] != NSOrderedAscending)

c. 服从协议

<UIApplicationDelegate,UNUserNotificationCenterDelegate>

d. 注册

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDic
tionary *)launchOptions {
    // Override point for customization after application launch.

    [[UIApplication sharedApplication] setStatusBarHidden:YES withAnimation:UIStatusBarAnimationNone];
    [[UIApplication sharedApplication] setStatusBarHidden:NO withAnimation:UIStatusBarAnimationNone];

    if (SYSTEM_VERSION_GRATERTHAN_OR_EQUALTO(@"10")) {
        UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
        center.delegate = self;
        [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert |UNAut
        horizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
            if (!error) {
                [[UIApplication sharedApplication] registerForRemoteNotifications];
            }
        }];
    }else{
         [self registerPush:application];
    }
    [[ZCLibClient getZCLibClient].libInitInfo setAppKey:@"your appKey"];
    // 设置推送是否是测试环境，测试环境将使用开发证书
    [[ZCLibClient getZCLibClient] setIsDebugMode:YES];
    // 错误日志收集
    [ZCLibClient setZCLibUncaughtExceptionHandler];
    return YES;
}

-(void)registerPush:(UIApplication *)application{
    // ios8后，需要添加这个注册，才能得到授权
    if ([[UIApplication sharedApplication] respondsToSelector:@selector(registerUserNotificationSettings:)]) {
        //IOS8
        //创建UIUserNotificationSettings，并设置消息的显示类类型
        UIUserNotificationSettings *notiSettings = [UIUserNotificationSettings settingsForTypes:(UIUserNotification
        TypeBadge | UIUserNotificationTypeAlert | UIRemoteNotificationTypeSound) categories:nil];

        [application registerUserNotificationSettings:notiSettings];

    } else{ // ios7
        [application registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge|UIRemoteNotificationTypeSou
        nd|UIRemoteNotificationTypeAlert)];
    }
}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)pToken{
    NSLog(@"---Token--%@", pToken);
    // 注册token
    [[ZCLibClient getZCLibClient] setToken:pToken];

}

e. APNS消息推送及提醒

// 是否自动提醒
[[ZCLibClient getZCLibClient] setAutoNotification:YES];

// 设置推送环境 
[[ZCLibClient getZCLibClient] setIsDebugMode:NO];

// 关闭推送
[[ZCLibClient getZCLibClient] removePush:^(NSString *uid, NSData *token, NSError *error) {
  if((uid==nil &&  token==nil) || error!=nil){
    // 移除失败，可设置uid或token(uid可不设置)后再调用
  }else{
    // 移除成功
  }
}];

4. ios10权限设置

<key>NSCameraUsageDescription</key>
<string>访问相机</string>
<key>NSLocalizedDescription</key>
<string>使用推送服务</string>
<key>NSMicrophoneUsageDescription</key>
<string>访问麦克风</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>访问相册</string>

三. 自定义设置（可选）

用户会话页面支持UI自定义

• 在导航栏区域，我们支持自定义导航栏区域的颜色及其字体颜色；
• 在会话页面区域，我们支持自定义会话区域的背景颜色、会话气泡颜色、会话字体颜色、提示气泡颜色、提示字体颜色、时间文字颜色；
• 在底部区域，我们支持自定义底部bottom背景颜色及输入框线条背景颜色；
• 其它部分，我们支持自定义相册导航栏的背景颜色及文字颜色、评价弹框中的文字颜色及按钮颜色、录音控件中的文字、商品详情展示中文字颜色（标题、详情、标签、发送）；

注：代码未涉及到的自定义UI，可以通过替换SobotKit.bundle中的图片，达到你想要的效果

1. ZCKitInfo类说明（UI相关配置）

2. ZCLibInitInfo类说明

3. 对接指定技能组

获取技能组编号

// 外部直接定义技能组（可选，如果传入技能组ID那么SDK内部转人工之后不在弹技能组的选择框，直接跳转到传入ID所对应的技能组中。）
// 如果选择传入技能组，根据传递的值转接到对应的技能组,不传不起作用
uiInfo.skillSetId =  @"技能组ID";

4. 商品页咨询信息

// 商品的自定义类 ZCProductInfo  如果选择添加商品信息，请添加以下信息，其中标题"title"和页面地址url"link"是必
填字段，如果没有添加页面中是不会显示的。
ZCProductInfo *productInfo = [ZCProductInfo new];
//thumbUrl 缩略图地址
productInfo.thumbUrl = @"缩略图的Url";
//  title 标题 (必填)
productInfo.title = @"标题";
//  desc 摘要
productInfo.desc = @"摘要";
//  label 标签
productInfo.label = @"标签";
//  页面地址url（必填) 
productInfo.link = @"发送商品链接";
uiInfo.productInfo = productInfo;

5. 留言页面用户信息项自定义配置

您可在留言页中设置用户联系方式的各显示字段（显示和添加，可选）。

// 留言页面中是否显示昵称
uiInfo.isShowNickName = YES;
// 提交留言时，在选择显示昵称之后，选择昵称是否是必填项，如果是必填，昵称提交时不能为空。
uiInfo.isAddNickName = NO;

6. 获取未读消息数

//直接获取未读消息数
[[ZCLibClientgetZCLibClient]getUnReadMessage];

7. 对接机器人

获取机器人编号：

// 对接机器人ID（指定对接的机器人，如果不设置，取默认）
uiInfo.robotFlag = @"机器人ID";

8. 对接指定客服

获取指定客服ID

// 指定客服ID（指定对接的客服，如果不设置，取默认）
uiInfo.receptionistId = @"客服ID";
// 设置指定客服之后是否必须转入指定客服 （0可转入其他客服1必须转入指定客服 注意：如果设置为1，
当指定的客服不在线，不能再转接到其他客服）
uiInfo.tranReceptionistFlag = @"0";

附：智齿 iOS_SDK Git下载地址：https://github.com/ZCSDK/SobotKit