בוחר אמוג'י

הכלי לבחירת אמוג'י הוא פתרון לממשק משתמש עם מראה ותחושה מודרניים, אמוג'י עדכניים וקלות שימוש. המשתמשים יכולים לעיין באמוג'י ובגרסאות השונות שלהם ולבחור מתוכם, או לבחור מתוך האמוג'י שהיו בשימוש לאחרונה.

הספרייה הזו מאפשרת לאפליקציות ממקורות שונים לספק למשתמשים חוויית אמוג'י מאוחדת ומכילה, בלי שהמפתחים יצטרכו ליצור ולתחזק מאפס חלונית לבחירת אמוג'י משלהם.

תכונות

בוחר האמוג'י כולל את התכונות הבאות.

אמוג'י עדכני

אמוג'י חדשים נכללים בבוחר האמוג'י באופן סלקטיבי. ספריית הבוחר של אמוג'י תואמת למספר גרסאות ומכשירים של Android.

וריאציות קבועות

לוחצים לחיצה ארוכה על אמוג'י כדי להציג תפריט של וריאציות, כמו מגדרים שונים או גווני עור שונים. הווריאציה שתבחרו תישמר בבורר האמוג'י, והווריאציה האחרונה שנבחרה תשמש בחלונית הראשית.

התכונה הזו מאפשרת למשתמשים לשלוח את הגרסאות המועדפות של סמלי האמוג'י בלחיצה אחת.

אמוג'י שהיו בשימוש לאחרונה

האמוג'י בקטגוריה בשימוש לאחרונה מסופקים על ידי RecentEmojiProvider. בספרייה יש ספק ברירת מחדל של אמוג'יס שהיו בשימוש לאחרונה, שמתאים לתרחיש השימוש הנפוץ ביותר:

• כל האמוג'י שנבחרו נשמרים בהעדפות משותפות לכל אפליקציה.
• בכלי לבחירת אמוג'י מוצגות לכל היותר שלוש שורות של אמוג'י שנבחרו, ללא כפילויות, בסדר כרונולוגי הפוך.

אם התנהגות ברירת המחדל הזו מספיקה, אין צורך להשתמש ב-setRecentEmojiProvider().

עם זאת, יכול להיות שתצטרכו להתאים אישית את אופן הפעולה של הספק. הנה כמה תרחישים נפוצים:

• אתם רוצים לאחסן אמוג'י נבחרים שונים לכל חשבון משתמש.
• אתם רוצים להשתמש במאגר נתונים שונה מהעדפות משותפות.
• אתם רוצים להציג אמוג'י שהיו בשימוש לאחרונה, ממוינים לפי תדירות השימוש.

אחר כך תוכלו להטמיע את הממשק RecentEmojiProvider ולהגדיר אותו באמצעות setRecentEmojiProvider().

בורר הכיוון

החל מאמוג'י 15.1, בוחר האמוג'י תומך באמוג'י דו-כיווני. המשתמשים יכולים להקיש על המתג לשינוי כיוון כדי לעבור בין גרסאות של אמוג'י שפונות ימינה או שמאלה.

איור 4. אמוג'י דו-כיווני שפונה שמאלה.

איור 5. אמוג'י דו-כיווני שפונה ימינה.

בורר אמוג'י עם כמה אנשים

משתמשים יכולים ללחוץ לחיצה ארוכה על זוגות אמוג'י כדי לראות מבחר של אמוג'י עם כמה אנשים.

איור 6. לוחצים לחיצה ארוכה על אמוג'י של זוג כדי לראות מבחר של אמוג'י עם כמה אנשים.

איור 7. בוחרים אמוג'י של חצי אדם שפונה שמאלה.

איור 8. בוחרים אמוג'י של חצי גוף של אדם.

כשמשתמש בוחר את האמוג'י של חצי אישה או חצי גבר מתוך זוג אמוג'י, בתצוגה המקדימה של בוחר האמוג'י מופיע אמוג'י של זוג, כמו שמוצג באיורים 7 ו-8. אחרי שבוחרים את שני חצאי האמוג'י של הזוג, המשתמשים יכולים לבחור את התצוגה המקדימה כדי ליצור את האמוג'י המותאם אישית של הזוג.

תאימות ל-EmojiCompat

אם ההגדרה הזו מופעלת, נעשה שימוש במופע EmojiCompat בכלי לבחירת אמוג'י כדי להציג כמה שיותר אמוג'י. עם זאת, לא צריך EmojiCompat כדי להשתמש בבוחר האמוג'י.

דרישות מוקדמות

האפליקציה צריכה לטרגט ל-Android 5.0 (רמת API‏ 21) ומעלה.

שימוש בספרייה

1. מייבאים את androidx.emoji2:emojipicker:$version לקובץ build.gradle באפליקציה.

   dependencies {
       implementation "androidx.emoji2:emojipicker:$version"
   }
   

2. מגדילים את התצוגה של בוחר האמוג'י, ואם רוצים, מגדירים את emojiGridRows ואת emojiGridColumns.

   • מספר ברירת המחדל של emojiGridColumns הוא 9.
   • מספר השורות מחושב על סמך הגובה של התצוגה הראשית והערך של emojiGridColumns.
   • כדי לציין שהמשתמש יכול לגלול כדי לראות עוד סמלי אמוג'י, צריך להשתמש בערך מסוג float בשדה emojiGridRows.

   <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)
   

3. משתמשים ב-setOnEmojiPickedListener() כדי להוסיף את האמוג'י שנבחר לתצוגה. לדוגמה, כדי להוסיף ל-EditText:

   emojiPickerView.setOnEmojiPickedListener {
       findViewById<EditText>(R.id.edit_text).append(it.emoji)
   }
   

4. אפשר להגדיר את RecentEmojiProvider. דוגמה להטמעה מופיעה באפליקציה לדוגמה.

5. אפשר להתאים אישית את הסגנונות. אפשר ליצור סגנון משלכם כדי לשנות מאפיינים נפוצים של עיצוב ולהחיל את הסגנון על EmojiPickerView. לדוגמה, החלפת colorControlNormal משנה את צבע הסמל של הקטגוריה.

   <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" />
   

אפליקציה לדוגמה

אפליקציית הדוגמה Emoji Picker מדגימה תרחישי שימוש בסיסיים, וגם את התרחישים הנוספים הבאים:

• חישוב מחדש של הפריסה כשמאפסים את emojiGridRows או את emojiGridColumns.
• ספק אמוג'י שהוגדר כברירת מחדל, שממיין את האמוג'י לפי תדירות השימוש.
• התאמה אישית נוספת של הסגנון.