Die Emoji-Auswahl ist eine UI-Lösung, die ein modernes Design, aktuelle Emojis und eine einfache Bedienbarkeit bietet. Nutzer können nach Emojis und ihren Varianten suchen oder aus den zuletzt verwendeten Emojis wählen.
Mithilfe dieser Bibliothek können Apps aus verschiedenen Quellen ihren Nutzern ein inklusives und einheitliches Emoji-Erlebnis bieten, ohne dass Entwickler eine eigene Emoji-Auswahl von Grund auf neu erstellen und verwalten müssen.
Funktionen
Aktuelle Emojis
Neu veröffentlichte Emojis sind selektiv in der Emoji-Auswahl enthalten. Die Emoji-Auswahl ist mit mehreren Android-Versionen und -Geräten kompatibel.
Fixierte Varianten
Halten Sie ein Emoji lange gedrückt, um ein Menü mit Varianten aufzurufen, z. B. mit verschiedenen Geschlechts- oder Hauttönen. Die von Ihnen ausgewählte Variante wird in der Emoji-Auswahl gespeichert und die zuletzt ausgewählte Variante im Hauptbereich verwendet.
Mit dieser Funktion können Nutzer ihre bevorzugten Emoji-Varianten mit nur einmal tippen senden.
Letzte Emojis
Über RecentEmojiProvider
werden Emojis in der Kategorie Kürzlich verwendet bereitgestellt. Die Bibliothek enthält einen standardmäßigen aktuellen Emoji-Anbieter, der den häufigsten Anwendungsfall erfüllt:
- Alle ausgewählten Emojis werden für jede App in den gemeinsamen Einstellungen gespeichert.
- In der Auswahl werden maximal 3 Zeilen ausgewählter Emojis, dedupliziert, in umgekehrter chronologischer Reihenfolge angezeigt.
Wenn dieses Standardverhalten ausreicht, müssen Sie setRecentEmojiProvider()
nicht verwenden.
Möglicherweise müssen Sie jedoch das Verhalten des Anbieters anpassen. Hier einige häufige Szenarien:
- Sie möchten unterschiedliche ausgewählte Emojis pro Nutzerkonto speichern.
- Sie möchten einen anderen Datenspeicher als gemeinsame Einstellungen verwenden.
- Sie möchten kürzlich verwendete Emojis nach Häufigkeit sortiert anzeigen lassen.
Sie können dann die Schnittstelle RecentEmojiProvider
implementieren und mit setRecentEmojiProvider()
festlegen.
Kompatibilität mit EmojiCompat
Wenn diese Option aktiviert ist, wird in der Emoji-Auswahl eine EmojiCompat
-Instanz verwendet, um so viele Emojis wie möglich zu rendern. Für die Emoji-Auswahl ist EmojiCompat
jedoch nicht erforderlich.
Voraussetzungen
Deine App muss auf Android 5.0 (API-Level 21) oder höher ausgerichtet sein.
Bibliothek verwenden
Importieren Sie
androidx.emoji2:emojipicker:$version
in die Dateibuild.gradle
Ihrer Anwendung.dependencies { implementation "androidx.emoji2:emojipicker:$version" }
Maximieren Sie die Ansicht der Emoji-Auswahl und legen Sie optional
emojiGridRows
undemojiGridColumns
fest.- Die Standardanzahl von
emojiGridColumns
ist 9. - Die Zeilenanzahl wird basierend auf der Höhe der übergeordneten Ansicht und dem Wert von
emojiGridColumns
berechnet. - Verwende einen Gleitkommawert für
emojiGridRows
, um anzugeben, dass der Nutzer nach unten scrollen kann, um weitere Emojis zu sehen.
<androidx.emoji2.emojipicker.EmojiPickerView android:id="@+id/emoji_picker" android:layout_width="match_parent" android:layout_height="match_parent" app:emojiGridColumns="9" />
val emojiPickerView = EmojiPickerView(context).apply { emojiGridColumns = 15 layoutParams = ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT ) } findViewById<ViewGroup>(R.id.emoji_picker_layout).addView(emojiPickerView)
- Die Standardanzahl von
Verwenden Sie
setOnEmojiPickedListener()
, um die ausgewählten Emojis einer Ansicht hinzuzufügen. So hängen Sie beispielsweise an einEditText
an:emojiPickerView.setOnEmojiPickedListener { findViewById<EditText>(R.id.edit_text).append(it.emoji) }
Legen Sie optional
RecentEmojiProvider
fest. Eine Beispielimplementierung finden Sie in der Beispiel-App.Passen Sie die Stile bei Bedarf an. Erstellen Sie einen eigenen Stil, um allgemeine Designattribute zu überschreiben, und wenden Sie den Stil auf die
EmojiPickerView
an. Wenn SiecolorControlNormal
überschreiben, ändert sich beispielsweise die Farbe des Kategoriesymbols.<style name="CustomStyle" > <item name="colorControlNormal">#FFC0CB</item> </style> <androidx.emoji2.emojipicker.EmojiPickerView android:id="@+id/emoji_picker" android:layout_width="match_parent" android:layout_height="match_parent" android:theme="@style/CustomStyle" app:emojiGridColumns="9" />
Beispiel-App
Die Beispiel-App zur Emoji-Auswahl veranschaulicht grundlegende Anwendungsfälle sowie die folgenden zusätzlichen Szenarien:
- Neuberechnung des Layouts, wenn
emojiGridRows
oderemojiGridColumns
zurückgesetzt werden. - Ein überschriebener aktueller Emoji-Anbieter, der nach Häufigkeit sortiert.
- Zusätzliche Stilanpassung.