ZHChat

ZHChat是一个免费的开源聊天UI组件，支持发送语音、图片、文字、表情、位置、视频消息。ZHChat可以帮助开发者快速集成IM服务，简单聊天，提供完全免费的许可协议，支持二次开发。欢迎提交Pull Request。

俄语README链接

感谢Gargo的翻译。

中文README链接

功能

• 界面模仿苹果消息应用界面。
• 包含文本、图片、语音、位置、发送视频消息的功能。
• 未包含基于UITableView的聊天界面，更容易理解整个UI框架。

设计目标

简单集成聊天功能。

需求

• iOS 7.0+
• ARC

用法

CocoaPods（推荐）

pod 'ZHChat'

将文件夹ZHMessagesViewController复制到您的项目中

入门指南

ZHChat入门指南

#import <ZHChat/ZHCMessages.h> // import all the things

• ** 示例项目**

  • 有一个美味的示例项目：“ZHChat.xcworkspace”
    • 先运行‘pod install’

• 自定义

  • 示例项目有详细的注释。请以此为指导。

  • 视图控制器

  • 继承ZHCMessagesViewController。

  • 在ZHCMessagesTableViewDataSource协议中实现所需的方法。

  • 在ZHCMessagesTableViewDelegate协议中实现所需的方法。

  • 在ZHCMessagesMoreViewDelegate协议中实现所需的方法。

  • 在ZHCMessagesMoreViewDataSource协议中实现所需的方法。

  • 在ZHCEmojiViewDelegate协议中实现所需的方法。

  • 在ZHCMessagesInputToolbarDelegate协议中实现所需的方法。

  • 设置您的senderId和senderDisplayName。这些属性对应于ZHCMessageData中找到的方法，确定哪些消息是传入或传出的。

• 头像模型

  • 您的头像模型对象应遵守ZHCMessageBubbleImageDataSource协议。
  • 但是，您可以使用提供的ZHCMessagesAvatarImage类。
  • 还可以查看ZHCMessagesAvatarImageFactory以轻松生成自定义头像。

• 消息气泡模型

  • 您的消息气泡模型对象应遵守ZHCMessageAvatarImageDataSource协议。
  • 但是，您可以使用提供的ZHCMessagesAvatarImage类。
  • 还可以查看ZHCMessagesBubbleImageFactory和UIImage+ZHCMessages以轻松生成自定义气泡。

• 消息模型

  • 您的消息模型对象应遵守ZHCMessageData协议。
  • 但是，您可以使用提供的ZHCMessage类。

• 媒体附件模型

  • 您的媒体附件模型对象应遵守ZHCMessageMediaData协议。
  • 但是，您可以使用提供的类：ZHCAudioMediaItem、ZHCLocationMediaItem、ZHCPhotoMediaItem。
  • 创建您自己的自定义媒体项目很容易！只需遵循内置媒体类型使用的模式。
  • 还可以查看ZHCMessagesMediaPlaceholderView以将您的自定义媒体视图作为消息气泡进行遮罩。

• 更多模块

  • 您可以查看 ZHCMessagesMoreView .
  • 在ZHCMessagesMoreViewDelegate协议中实现所需的方法。
  • 在ZHCMessagesMoreViewDataSource协议中实现所需的方法。

• 音频模块

  • 您可以看到 ZHCMessagesVoiceRecorder 和 ZHCMessagesAudioProgressHUD .
  • ZHCMessagesAudioProgressHUD 是一个录音动画视图。
  • ZHCMessagesVoiceRecorder 是录音器。它在 ZHCMessagesVoiceDelegate 协议中实现了所需的方法。

• 表情模块

  • 您可以看到 ZHCMessagesEmojiView .
  • 在ZHCEmojiViewDelegate协议中实现所需的方法。
  • 表情资源在 ZHCEmojiList.plist 中。

待办

• 增加适配旋转和横屏显示功能的工作。

谢谢

感谢 Jesse Squires 在 JSQMessagesViewController 上绘制的结构和资源。

许可证

此代码根据 MIT 许可协议 的条款和条件分发。