Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

絵文字選択ツール

絵文字選択ツールは、最新のルックアンドフィール、最新の絵文字、使いやすさを提供する UI ソリューションです。ユーザーは、絵文字とそのバリエーションをブラウジングして選択したり、最近使用した絵文字から選択したりできます。

図 1.絵文字選択ツール

このライブラリを使用すると、さまざまなソースのアプリで、包括的で統一された絵文字エクスペリエンスをユーザーに提供できます。デベロッパーが独自の絵文字選択ツールをゼロから構築して維持する必要はありません。

機能

絵文字選択ツールには次の機能があります。

固定バリアント

絵文字を長押しすると、性別や肌の色などのバリエーションのメニューが表示されます。選択したバリエーションは絵文字選択ツールに保存され、最後に選択したバリエーションがメインパネルで使用されます。

この機能により、ユーザーは好みの絵文字バリエーションを 1 回のタップで送信できます。

方向セレクタ

Emoji 15.1 以降、絵文字選択ツールは双方向の絵文字をサポートしています。ユーザーは双方向切り替えボタンをタップして、絵文字の左向きバージョンと右向きバージョンを切り替えることができます。

図 4. 左を向いている双方向の絵文字。

図 5. 右を向いている双方向の絵文字。

複数人の絵文字セレクタ

カップルの絵文字を長押しすると、複数の人物の絵文字を選択できます。

図 6. 絵文字のカップルを長押しすると、複数の人物の絵文字が表示されます。

図 7. 左半分の絵文字の人物を選択します。

図 8. 右半分の絵文字の人物を選択します。

ユーザーが絵文字カップルの左半分または右半分の絵文字を選択すると、図 7 と図 8 に示すように、セレクタの右下にプレビューが表示されます。絵文字カップルの両半分を選択すると、ユーザーはプレビューを選択してカスタム絵文字カップルを作成できます。

`EmojiCompat` との互換性

有効にすると、絵文字選択ツールで EmojiCompat インスタンスが使用され、できるだけ多くの絵文字がレンダリングされます。ただし、絵文字選択ツールでは EmojiCompat は必要ありません。

前提条件

アプリは Android 5.0（API レベル 21）以降をターゲットにする必要があります。

ライブラリを使用する

アプリの build.gradle ファイルに androidx.emoji2:emojipicker:$version をインポートします。
```
dependencies {
    implementation "androidx.emoji2:emojipicker:$version"
}
```

絵文字選択ツールビューをインフレートし、必要に応じて emojiGridRows と emojiGridColumns を設定します。

emojiGridColumns のデフォルト値は 9 です。
行数は、親ビューの高さと emojiGridColumns の値に基づいて計算されます。
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)

setOnEmojiPickedListener() を使用して、選択した絵文字をビューに追加します。たとえば、EditText に追加するには、次の操作を行います。
```
emojiPickerView.setOnEmojiPickedListener {
    findViewById<EditText>(R.id.edit_text).append(it.emoji)
}
```
必要に応じて RecentEmojiProvider を設定します。実装例については、サンプルアプリをご覧ください。

必要に応じてカスタムスタイルをカスタマイズします。独自のスタイルを作成して、共通のテーマ属性をオーバーライドし、そのスタイルを 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" />

サンプルアプリ

絵文字選択ツールのサンプルアプリは、基本的なユースケースと、次の追加シナリオを示しています。

emojiGridRows または emojiGridColumns がリセットされたときのレイアウトの再計算。
頻度で並べ替える、オーバーライドされた最新の絵文字プロバイダ。
その他のスタイルのカスタマイズ。

絵文字選択ツール コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

機能

最新の絵文字