SwiftyChat - SwiftUI聊天界面开发工具包

项目介绍：SwiftyChat

SwiftyChat 是一个为 iOS 开发者设计的简单聊天界面库，它利用 SwiftUI 的优势提供了即插即用的消息功能。该项目旨在帮助开发者快速创建功能丰富且灵活的聊天应用。

项目背景

SwiftyChat 提供了一套易于上手的默认消息单元格，使得开发者可以快速启用聊天特性。此外，它还支持多种不同类型的消息格式，为用户提供丰富的交互体验。

项目特性

支持属性字符串：利用 SwiftUI 的特性，SwiftyChat 支持富文本消息。
横屏支持：在横屏模式下会自动调整消息单元格的宽度。
用户头像显示：可以选择显示或隐藏，并且可自定义头像的位置。
快速关闭键盘：点击聊天界面任意空白区域即可收起键盘。
多行输入框：使用户可以输入长文本。
滚动到底部：单击按钮可以快速滚动到最新消息。
画中画模式：支持后台视频播放。
自定义消息单元格：支持开发者自定义消息显示样式。
特定边角圆角：为文本消息添加更具个性化的边角修饰。

快速预览

SwiftyChat 提供了基本和高级两种示例预览。基本示例展示了文本消息在浅色和深色模式下的界面，而高级示例则展示了包括联系人、快捷回复、文本、图片、地图、轮播和上下文菜单在内的多种消息类型的界面。

安装方式

开发者可以通过 Swift Package Manager (SPM) 安装 SwiftyChat，只需在项目中添加以下地址即可：

https://github.com/EnesKaraosman/SwiftyChat.git

消息种类

SwiftyChat 支持多种消息类型，包括：

文本消息
图片消息（支持本地和远程）
位置消息（地图展示）
联系人消息
快捷回复（多项选择）
轮播消息
视频消息

使用范例

ChatView

要使用 SwiftyChat，开发者只需创建一个 ChatView 视图，并传入消息和输入框。可以通过简单的代码初始化并运行 SwiftyChat：

import SwiftyChat
import SwiftyChatMock

@State private var scrollToBottom = false
@State private var messages: [MockMessages.ChatMessageItem] = []

ChatView<MockMessages.ChatMessageItem, MockMessages.ChatUserItem>(
    messages: $messages,
    scrollToBottom: $scrollToBottom
) {
    // 在这里使用 InputView
}
.environmentObject(
    ChatMessageCellStyle()
)
.onReceive(
    messages.debounce(for: .milliseconds(650), scheduler: RunLoop.main),
    perform: { _ in
        scrollToBottom = true
    }
)

InputView

开发者可以根据需要自定义输入框（InputView），也可以使用 SwiftyChat 提供的基础输入框 BasicInputView。

@State private var message = ""

var inputBarView: some View {
    BasicInputView(
        message: $message,
        placeholder: "输入内容",
        onCommit: { messageKind in
            self.messages.append(
                .init(user: MockMessages.sender, messageKind: messageKind, isSender: true)
            )
        }
    )
    .background(Color.primary.colorInvert())
    .embedInAnyView()
}

ChatView(messages: $messages) {
    inputBarView 
}

样式与自定义

项目提供ChatMessageCellStyle类，用于自定义消息单元格的样式。开发者可以通过初始化该类来调整特定样式，例如文本样式、边距、头像样式等。所有样式都支持默认初始化，并可以通过 environmentObject 注入。

需要更多详细信息，请参阅 Styles.md 或 CustomMessage.md。

项目启发

SwiftyChat 的灵感来源于 UIKit 的 MessageKit 和 SwiftUI 的 Nio，它集成了许多优秀的功能，为开发者提供了更便捷的聊天界面解决方案。

欢迎社区贡献，开发者可以提交 PR 增加新功能或修复已知问题。