自定义表情符号是使您的应用程序更具活力和可定制的有趣方式。它们在许多最流行的应用程序中都有,如 Slack、Discord 和 Twitch。然而,iOS SDK 并没有直接支持开箱即用的自定义表情符号。现在,您只需几行代码就可以使用此库将它们添加到您自己的应用程序中。
Streamoji 是一个用于 iOS 的自定义表情符号渲染库。它支持 GIF 、图片
和 unicode
使用方法
1. 定义表情符号
第一步是在一个字典中定义您的自定义表情符号,其中键是表情符号的 :简码:,EmojiSource 是表情符号的来源!它可以是从 GIF 或本地资源中的图片,远程 URL,甚至是 unicode 字符。您还可以定义别名(替代代码)。
let exampleEmojis: [String: EmojiSource] = [
"baby_yoda": .imageAsset("baby-yoda-soup.gif"),
"banana_dance": .imageAsset("bananadance.gif"),
"excuse_me": .imageAsset("excuseme.gif"),
"party_parrot": .imageAsset("party_parrot.gif"),
"this_is_fine": .imageAsset("this-is-fine-fire.gif"),
"what": .imageAsset("what.png"),
"homer_disappear": .imageAsset("homer-disappear.gif"),
"let_me_in": .imageUrl("https://github.com/GetStream/Streamoji/blob/main/meta/emojis/let_me_in.gif?raw=true"),
"smiley": .character("😄"),
"heart": .character("❤️"),
"banana": .alias("banana_dance"),
"parrot": .alias("party_parrot")
]
2. 配置 UITextView
定义完表情符号后,您应调用 UITextView.configureEmojis
textView.attributedText = NSAttributedString(string:
"""
:banana_dance: Streamoji :party_parrot:
:baby_yoda: This is a UITextView! :excuse_me:
Supports:
GIF :this_is_fine:
Image :what:
Local file :homer_disappear:
Remote file :let_me_in:
Unicode :smiley:
"""
)
textView.configureEmojis(exampleEmojis, rendering: .highestQuality)
您还可以调整一些(目前)的渲染选项:与周围文本相关的质量和缩放。
示例
要运行示例项目,克隆仓库,并在 Example 目录下先运行 pod install
。
安装
Streamoji 可通过 CocoaPods 获取。要安装它,只需在您的 Podfile 中添加以下行
pod 'Streamoji'
作者
许可
Streamoji 在 MIT 许可下提供。有关更多信息,请参阅 LICENSE 文件。