/im_ios

GoBelieveIO IM iOS sdk

Primary LanguageObjective-CMIT LicenseMIT

#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]