AppFriends UI

AppFriendsUI 是一个开放源代码库，它提供了可自定义的 UI 组件和 AppFriends 的示例用法。它是使用 AppFriends 构建应用程序的绝佳起点。它可以帮助您节省大量开发时间。除了 UI 组件外，该库还为您提供方便的方法来处理对话框、发送/接收消息和查询用户。它使用 CoreData 存储对话框和

示例应用程序

您可以通过运行包含在该存储库中的 AFChatUISample 应用程序来查看如何与 AppFriendsCore SDK 一起使用此 SDK。

集成

步骤 1 - Cocoapod 安装

要将 AppFriends iOS SDK 集成到您的 Xcode iOS 项目中，请在其 Podfile 中添加此行

pod 'AppFriendsUI'

另外，将 use_frameworks! 添加到该文件中。例如：

platform :ios, "8.0"
use_frameworks!
...

步骤 2 - 初始化

安装后，您需要做的第一件事就是初始化 SDK。查找 AppFriendsUI 并调用： public func initialize(completion: ((success: Bool, error: NSError?) -> ())? = nil)。在您初始化 AppFriendsCore 库之后，您需要这样做。

步骤 3 - 登录

然后您需要通过 AppFriendsCore 对用户进行登录。登录成功后，您可以开始使用 AppFriendsUI 的所有组件。

UI 组件

AppFriends 聊天容器

AppFriendsUI 有一个 HCChatContainerViewController，其中包含对话列表视图、好友列表视图和聊天视图。这是使用 AppFriends 的最简单方法。您可以调用它来使用它：

let chatContainer = HCChatContainerViewController(tabs:HCTitles.dialogsTabTitle, HCTitles.contactsTabTitle])
let nav = UINavigationController(rootViewController: chatContainer)
nav.navigationBar.tintColor = UIColor.whiteColor()
self.presentVC(nav)

对话列表

HCDialogsListViewController 是一个类，可以帮助您显示您的对话框列表。

聊天界面UI

HCBaseChatViewController 或 HCDialogChatViewController 是一个你可以用来显示聊天界面的类。它提供了基本的聊天界面。

输入指示器

你可以用 startTyping 和 endTyping 发送输入事件。如果你使用这个库提供的聊天视图，输入指示器会自动提供，因此你不需要编写额外的代码。

开始输入

DialogsManager.sharedInstance.startTyping(_dialogID, dialogType: _dialogType)

结束输入

DialogsManager.sharedInstance.endTyping(_dialogID, dialogType: _dialogType)

搜索用户

AppFriendsUI 为你提供了一个方便的 UI 来搜索用户。要使用这个 UI，你可以直接使用 HCUserSearchViewController 或创建其子类。

侧边面板

有时候，你可能不希望离开当前屏幕来显示聊天。使用 AppFriendsUI，你可以通过使用侧边面板非常容易地实现这一点。

示例

// use this code in one of your view controller
AppFriendsUI.sharedInstance.presentVCInSidePanel(fromVC: self, showVC: channelChatVC, direction: .Left)

用户界面定制

AppFriendsUI 的定制可以通过 HCUIConfiguration 完成。你可以修改颜色、字体和文本。示例

HCColorPalette.chatBackgroundColor = UIColor(hexString: "0d0e28")
HCColorPalette.SegmentSelectorOnBgColor = UIColor(hexString: "3c3a60")

如果需要更高级的定制，你可以子类化 AppFriendsUI 的组件。

登出

当你想要切换用户时，不要忘记使用 AppFriendsUI.sharedInstance.logout() 来注销用户。