Trang này được dịch bởi Cloud Translation API.

Bộ chọn biểu tượng cảm xúc

Bộ chọn biểu tượng cảm xúc là một giải pháp giao diện người dùng, mang đến giao diện hiện đại và được cập nhật biểu tượng cảm xúc và dễ sử dụng. Người dùng có thể duyệt xem và chọn biểu tượng cảm xúc cũng như các biến thể của biểu tượng đó hoặc chọn trong số các biểu tượng cảm xúc mà họ đã sử dụng gần đây.

Hình 1. Bộ chọn biểu tượng cảm xúc

Với thư viện này, các ứng dụng từ nhiều nguồn có thể mang đến trải nghiệm biểu tượng cảm xúc toàn diện và hợp nhất cho người dùng mà nhà phát triển không cần phải tạo và duy trì bộ chọn biểu tượng cảm xúc của riêng họ từ đầu.

Tính năng

Bộ chọn biểu tượng cảm xúc có các tính năng sau.

Biểu tượng cảm xúc mới nhất

Các biểu tượng cảm xúc mới phát hành được đưa vào Bộ chọn biểu tượng cảm xúc một cách có chọn lọc. Biểu tượng cảm xúc Thư viện bộ chọn tương thích trên nhiều phiên bản và thiết bị Android.

Biến thể cố định

Nhấn và giữ một biểu tượng cảm xúc để hiển thị trình đơn gồm các biến thể, chẳng hạn như giới tính hoặc giới tính khác nhau tông màu da. Biến thể bạn chọn sẽ được lưu trong Bộ chọn biểu tượng cảm xúc và biến thể được chọn gần đây nhất sẽ được sử dụng trong bảng điều khiển chính.

Với tính năng này, người dùng có thể gửi các biến thể biểu tượng cảm xúc mà họ muốn chỉ bằng một lần nhấn.

các biến thể của biểu tượng cảm xúc — **Hình 2.** Các kiểu biểu tượng cảm xúc.

Biểu tượng cảm xúc gần đây

RecentEmojiProvider chịu trách nhiệm cung cấp biểu tượng cảm xúc trong danh mục Đã dùng gần đây. Thư viện có một trình cung cấp biểu tượng cảm xúc mới nhất mặc định đáp ứng trường hợp sử dụng phổ biến nhất:

Tất cả biểu tượng cảm xúc đã chọn sẽ được lưu theo từng ứng dụng trong lựa chọn ưu tiên dùng chung.
Bộ chọn cho thấy tối đa 3 hàng biểu tượng cảm xúc đã chọn, được loại bỏ trùng lặp, đảo ngược trình tự thời gian.

Nếu hành vi mặc định này là đủ, thì bạn không cần sử dụng setRecentEmojiProvider().

Tuy nhiên, bạn có thể cần tuỳ chỉnh hành vi của trình cung cấp. Sau đây là một số quy tắc thường gặp trường hợp:

Bạn muốn lưu trữ nhiều biểu tượng cảm xúc đã chọn cho mỗi tài khoản người dùng.
Bạn muốn sử dụng bộ nhớ dữ liệu ngoài các lựa chọn ưu tiên dùng chung.
Bạn muốn hiển thị biểu tượng cảm xúc gần đây được sắp xếp theo tần suất.

Sau đó, bạn có thể triển khai và thiết lập giao diện RecentEmojiProvider bằng setRecentEmojiProvider().

Bộ chọn hướng

Kể từ Emoji 15.1, Bộ chọn biểu tượng cảm xúc hỗ trợ biểu tượng cảm xúc hai chiều. Người dùng có thể nhấn vào nút chuyển hai chiều để bật/tắt giữa các phiên bản biểu tượng cảm xúc hướng trái và phải.

Hình 4. Biểu tượng cảm xúc hai chiều hướng sang trái.

Hình 5. Biểu tượng cảm xúc hai chiều hướng sang phải.

Bộ chọn biểu tượng cảm xúc nhiều người

Người dùng có thể chạm và giữ các cặp biểu tượng cảm xúc để hiển thị lựa chọn biểu tượng cảm xúc của nhiều người.

Hình 6. Chạm và giữ một cặp biểu tượng cảm xúc để hiển thị biểu tượng cảm xúc của nhiều người lựa chọn.

Hình 7. Chọn biểu tượng cảm xúc người nửa bên trái.

Hình 8. Chọn biểu tượng cảm xúc người nửa bên phải.

Khi người dùng chọn hình người ở bên trái hoặc nửa bên phải của một cặp biểu tượng cảm xúc, bộ chọn hiển thị bản xem trước ở dưới cùng bên phải, như minh hoạ trong hình 7 và 8. Sau khi chọn cả hai nửa của cặp biểu tượng cảm xúc, người dùng có thể chọn bản xem trước để soạn cặp biểu tượng cảm xúc tuỳ chỉnh.

Khả năng tương thích với `EmojiCompat`

Nếu được bật, một thực thể EmojiCompat sẽ được dùng trong Bộ chọn biểu tượng cảm xúc để hiển thị nhiều biểu tượng cảm xúc nhất có thể. Tuy nhiên, Bộ chọn biểu tượng cảm xúc không yêu cầu EmojiCompat.

Điều kiện tiên quyết

Ứng dụng của bạn phải nhắm đến Android 5.0 (API cấp 21) trở lên.

Sử dụng thư viện

Nhập androidx.emoji2:emojipicker:$version trong build.gradle của ứng dụng tệp.

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

Tăng cường thành phần hiển thị Bộ chọn biểu tượng cảm xúc và tuỳ ý đặt emojiGridRows và emojiGridColumns.

Số lượng mặc định của emojiGridColumns là 9.
Số hàng được tính dựa trên chiều cao của thành phần hiển thị mẹ và giá trị của emojiGridColumns.
Sử dụng giá trị số thực độ chính xác đơn cho emojiGridRows để cho biết rằng người dùng có thể di chuyển để xem thêm biểu tượng cảm xúc.

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

Sử dụng setOnEmojiPickedListener() để nối biểu tượng cảm xúc đã chọn vào một thành phần hiển thị. Ví dụ: để nối vào EditText, hãy làm như sau:
```
emojiPickerView.setOnEmojiPickedListener {
    findViewById<EditText>(R.id.edit_text).append(it.emoji)
}
```
Bạn có thể đặt RecentEmojiProvider (không bắt buộc), hãy xem ứng dụng mẫu để biết ví dụ trong quá trình triển khai.

Tuỳ chọn tuỳ chỉnh kiểu. Tạo kiểu của riêng bạn để ghi đè giao diện chung và áp dụng kiểu cho EmojiPickerView. Ví dụ: việc ghi đè colorControlNormal sẽ làm thay đổi màu biểu tượng danh mục.

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

Ứng dụng mẫu

Ứng dụng mẫu Bộ chọn biểu tượng cảm xúc minh hoạ các trường hợp sử dụng cơ bản cùng với các trường hợp bổ sung sau:

Tính toán lại bố cục khi đặt lại emojiGridRows hoặc emojiGridColumns.
Một trình cung cấp biểu tượng cảm xúc gần đây bị ghi đè và sắp xếp theo tần suất.
Tuỳ chỉnh kiểu bổ sung.