开源软件名称：

开源软件地址：

开源编程语言：

开源软件介绍：

#gobelieve iOS gobelieve iOS SDK

##生成demo的workspace

1. cp demo/dev.podspec ./
2. pod install

##应用集成到自己的客户端

1. podfile

    pod 'gobelieve', :git => 'https://github.com/GoBelieveIO/im_ios.git'
   

2. 在AppDelegate初始化deviceID以及message handler

    [IMService instance].deviceID = deviceID;
    [IMService instance].peerMessageHandler = [PeerMessageHandler instance];
    [IMService instance].groupMessageHandler = [GroupMessageHandler instance];
    [IMService instance].customerMessageHandler = [CustomerMessageHandler instance];
   

3. 在AppDelegate中监听系统网络变化

    -(void)startRechabilityNotifier {
        self.reach = [GOReachability reachabilityForInternetConnection];
        self.reach.reachableBlock = ^(GOReachability*reach) {
            dispatch_async(dispatch_get_main_queue(), ^{
                NSLog(@"internet reachable");
                [[IMService instance] onReachabilityChange:YES];
            });
        };
        
        self.reach.unreachableBlock = ^(GOReachability*reach) {
            dispatch_async(dispatch_get_main_queue(), ^{
                NSLog(@"internet unreachable");
                [[IMService instance] onReachabilityChange:NO];
            });
        };
        
        [self.reach startNotifier];
   
    }
   
    [self startRechabilityNotifier];
    [IMService instance].reachable = [self.reach isReachable];
   

4. 登录成功之后设置token和uid, token和uid从应用本身的登录接口获得

    [IMService instance].token = ""
    [PeerMessageHandler instance].uid = uid
    [GroupMessageHandler instance].uid = uid
    [CustomerMessageHandler instance].uid = uid
   
    SyncKeyHandler *handler = [[SyncKeyHandler alloc] initWithFileName:fileName];
    [IMService instance].syncKeyHandler = handler;
   

5. 初始化消息db

    NSFileManager *fileManager = [NSFileManager defaultManager];
    if (![fileManager fileExistsAtPath:dbPath]) {
        NSString *p = [[NSBundle mainBundle] pathForResource:@"gobelieve" ofType:@"db"];
        [fileManager copyItemAtPath:p toPath:dbPath error:nil];
    }
    FMDatabase *db = [[FMDatabase alloc] initWithPath:dbPath];
    BOOL r = [db openWithFlags:SQLITE_OPEN_READWRITE|SQLITE_OPEN_WAL vfs:nil];
    if (!r) {
        NSLog(@"open database error:%@", [db lastError]);
        db = nil;
        NSAssert(NO, @"");
    }
   
    [PeerMessageDB instance].db = db;
    [GroupMessageDB instance].db = db;
    [CustomerMessageDB instance].db = db;
   

6. 启动IMService开始接受消息

    [[IMService instance] start];
   

7. 添加消息observer，处理相应类型的消息

    //连接状态
    [[IMService instance] addConnectionObserver:ob];
   
    //点对点消息
    [[IMService instance] addPeerMessageObserver:ob];
    //群组消息
    [[IMService instance] addGroupMessageObserver:ob];
    //直播的聊天室消息
    [[IMService instance] addRoomMessageObserver:ob];
    //实时消息,用于voip的信令
    [[IMService instance] addRTMessageObserver:ob];
    //系统消息
    [[IMService instance] addSystemMessageObserver:ob];
   

8. app进入后台,断开socket链接

    [[IMService instance] enterBackground];
   

9. app返回前台,重新链接socket

   [[IMService instance] enterForeground]; 
   

10. 发送点对点消息

    PeerMessageViewController* msgController = [[PeerMessageViewController alloc] init];
    msgController.peerUID = peerUID;
    msgController.peerName = @"";
    msgController.currentUID = uid;
    [self.navigationController pushViewController:msgController animated:YES];
    

11. 发送群组消息

    GroupMessageViewController* msgController = [[GroupMessageViewController alloc] init];
    msgController.groupID = groupID;
    msgController.groupName = @"";
    msgController.currentUID = uid;
    [self.navigationController pushViewController:msgController animated:YES];
    

12. 用户注销

    [[IMService instance] stop]