基础功能

本文档介绍 PDBotLib 的基础功能，在您阅读此文档时，我们假定您已经具备了基础的 iOS 应用开发经验，并能够理解相关基础概念。

初始化SDK

1. 引入头文件

#import <PDBotKit/PDBotKit.h>

2. 初始化 BotKitClient 对象（在APP启动时进行）

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    NSString* accessKey = [ Access Key ];  // Access Key 在管理后台接入页面获取
    [[PDBotKitClient sharedClient] initWithAccessKey:accessKey];
}

3. 设置用户信息（可选）

PDVisitorInfo* info = [[PDVisitorInfo alloc] init];
info.userId = [ User Id ]; // 用户的唯一标识
info.userName = [ User Name ];
info.phone = [ Phone ];
......
[[PDBotKitClient sharedClient] setVisitor:info];

4. 设置代理

[[PDBotKitClient sharedClient] setDelegate:self];

5. 实现代理方法并

@interface MyViewController () <PDBotLibClientDelegate>

建立连接

完成初始化后，调用 connect 方法建立连接

[[PDBotKitClient sharedClient] connect];

断开连接

客服会话结束后，调用 disconnect 方法释放连接

[[PDBotKitClient sharedClient] disconnect];

重连

当掉线时，iOS SDK 会自动重连，只需要监听重连相关的回调，无需进行任何操作。

- (void)onConnectionStateChanged:(PDConnectionState)state
{
    switch (state)
    {
        case PDConnectionIdel:
            self.navigationItem.title = @"连接断开";
            break;
        case PDConnectionConnecting:
            self.navigationItem.title = @"正在连接...";
            break;
        case PDConnectionConnectedRobot:
        case PDConnectionConnectedHuman:
            self.navigationItem.title = [PDBotKitClient sharedClient].robotName;  // 显示机器人名字
            break;
        default:
            self.navigationItem.title = @"连接失败";
            break;
    }
}