ZHChat
ZHChat是一個開源的聊天組件,能夠幫助iOS開發者快速集成即時聊天功能。支持聲音，視頻，圖片，文字，表情，地理位置等消息模塊，易擴展，支持二次開發。Welcome to pull Request.
Gif
Features
- 界面模仿蘋果消息應用。
- 支持高度自定義,例如聊天氣泡自定義,聊天消息模塊自定義。
- 支持的消息種類滿足大部分即時通訊需求。
- 基于蘋果原生UITableView，二次開發成本低。
- 支持Objective-C 和 Swift 兩種語言。
Design Goals
簡單快捷集成聊天UI框架。
Requirements
- iOS 7.0+
- ARC
Usage
CocoaPods (recommended)
pod 'ZHChat', '~> 0.2.2'
拷貝整個ZHCMessagesViewController文件夾至你工程中。
Getting Started
導入所有ZHChat頭文件：
#import <ZHChat/ZHCMessages.h> // import all the things
關于Objective-C/Swift Demo的使用
- 下載整個工程。
- 終端進入相關文件夾運行
pod install或者pod update
自定義消息模塊
- 繼承
ZHCMediaItem類。 - 實現
ZHCMessageMediaData協議中的方法:
-
- (nullable UIView *)mediaView//用于展示所有非文字的消息類型，例如圖片，聲音，視頻，地理位置。這里你也可以自定義所有你想要的消息類型例如圖片+文字組合。 -
-(CGSize)mediaViewDisplaySize//用于確定mediaView消息視圖的大小。這里你可以根據需求限定一個最大值或者最小值，也可以是固定的大小。
自定義時可以參考ZHCMediaItem,添加自己的新增的屬性（例如網絡下載資源鏈接）,和初始化方法,并實現前面介紹的兩個接口即可。
這里重點提下關于網絡下載資源，例如圖片：你可以增加一個下載地址:imgUrl 然后實現一個有下載地址的初始化接口:
-(instancetype)initWithImgUrl:(NSString *)url
并實現多媒體展示視圖接口：
- (UIView *)mediaView
{
if (self.cachedImageView == nil) {
CGSize size = [self mediaViewDisplaySize];
UIImageView *imageView = [[UIImageView alloc] init];
imageView.frame = CGRectMake(0.0f, 0.0f, size.width, size.height);
imageView.contentMode = UIViewContentModeScaleAspectFill;
imageView.clipsToBounds = YES;
[ZHCMessagesMediaViewBubbleImageMasker applyBubbleImageMaskToMediaView:imageView isOutgoing:self.appliesMediaViewMaskAsOutgoing];
self.cachedImageView = imageView;
[imageView sd_setImageWithURL:[NSURL URLWithString:self.imageUrl] placeholderImage:nil completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
if (!error) {
dispatch_async(dispatch_get_main_queue(), ^{
self.cachedImageView = imageView;
});
}
}];
}
return self.cachedImageView;
}
當然這只是很簡單的網絡下載圖片顯示的例子：實際iM通訊中消息有很多狀態:你需要根據不同的狀態進行相應的顯示,例如下載進度，上傳進度，下載失敗，上傳失敗，發送上傳成功等等....
網絡加載頭像
需要在繼承ZHCMessagesViewController的接口中進行操作：
- (nullable id<ZHCMessageAvatarImageDataSource>)tableView:(ZHCMessagesTableView *)tableView avatarImageDataForCellAtIndexPath:(NSIndexPath *)indexPath
這里你可以下載完成后刷新TableView即可。
消息點擊事件
需要在繼承ZHCMessagesViewController的接口中進行操作：
-(void)tableView:(ZHCMessagesTableView *)tableView didTapMessageBubbleAtIndexPath:(NSIndexPath *)indexPath
你可以根據消息的類型進行相關操作，例如展示大圖片，播放視頻等等。
** 更多使用方法請看參考Demo,接口和屬性介紹請看工程頭文件的介紹。如果您在使用中遇到了什么疑問可以通過郵件或者在GitHub中新建Issue，或者直接留言。**
