Emoji兼容性

val config = FontRequestEmojiCompatConfig(...)
        .setReplaceAll(true)
        .setEmojiSpanIndicatorEnabled(true)
        .setEmojiSpanIndicatorColor(Color.GREEN)
        .registerInitCallback(object: EmojiCompat.InitCallback() {
            ...
        })

EmojiCompat.Config config = new FontRequestEmojiCompatConfig(...)
       .setReplaceAll(true)
       .setEmojiSpanIndicatorEnabled(true)
       .setEmojiSpanIndicatorColor(Color.GREEN)
       .registerInitCallback(new InitCallback() {...})

添加初始化监听器

EmojiCompat 类提供 registerInitCallback() 和 unregisterInitCallback() 方法来注册初始化回调。要使用这些方法，请创建 EmojiCompat.InitCallback 类的实例。调用这些方法并传递 EmojiCompat.InitCallback 类的实例。当 EmojiCompat 支持库的初始化成功时，EmojiCompat 类会调用 onInitialized() 方法。如果库初始化失败，EmojiCompat 类会调用 onFailed() 方法。

要随时检查初始化状态，请调用 getLoadState() 方法。它返回以下值之一：LOAD_STATE_LOADING、LOAD_STATE_SUCCEEDED 或 LOAD_STATE_FAILED。

将 EmojiCompat 与 AppCompat 小部件一起使用

如果您正在使用 AppCompat 小部件，您可以使用从 AppCompat 小部件 扩展的 EmojiCompat 小部件。

1. 将支持库添加到依赖项部分。

   Groovy

   dependencies {
       ...
       implementation "androidx.emoji:emoji-bundled:$version"
   }

   Kotlin

         dependencies {
             implementation("androidx.emoji:emoji-appcompat:$version")
         }
         

   Groovy

         dependencies {
             implementation "androidx.emoji:emoji-appcompat:$version"
         }
         

2. 在布局 XML 中使用 EmojiCompat AppCompat 小部件。

<android.support.text.emoji.widget.EmojiAppCompatTextView
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiAppCompatEditText
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

<android.support.text.emoji.widget.EmojiAppCompatButton
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

捆绑字体配置

EmojiCompat 支持库也提供捆绑字体版本。此软件包包含带有嵌入式元数据的字体。该软件包还包括一个 BundledEmojiCompatConfig，它使用 AssetManager 加载元数据和字体。

注意：字体的尺寸为几兆字节。

添加支持库依赖项

要将 EmojiCompat 支持库与捆绑字体配置一起使用，您必须修改应用程序项目在开发环境中的类路径依赖项。

向你的应用程序项目添加支持库

1. 打开应用程序的build.gradle 文件。
2. 将支持库添加到dependencies 部分。

dependencies {
    ...
    implementation "androidx.emoji:emoji:28.0.0"
}

dependencies {
    ...
    implementation("androidx.emoji:emoji:28.0.0")
}

使用捆绑字体配置 EmojiCompat

要使用捆绑字体配置 EmojiCompat，请执行以下步骤：

1. 使用 BundledEmojiCompatConfig 创建 EmojiCompat 的实例，并提供 Context 的实例。
2. 调用 init() 方法初始化 EmojiCompat 并传递 BundledEmojiCompatConfig 的实例。

class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()
        val config = BundledEmojiCompatConfig(this)
        EmojiCompat.init(config)
    }
}

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        EmojiCompat.Config config = new BundledEmojiCompatConfig(this);
        EmojiCompat.init(config);
        ...
    }
}

无需小部件即可使用 EmojiCompat

EmojiCompat 使用 EmojiSpan 来渲染正确的图像。因此，它必须将任何给定的 CharSequence 转换为带有 EmojiSpans 的 Spanned 实例。EmojiCompat 类提供了一种方法，可以将 CharSequences 转换为带有 EmojiSpans 的 Spanned 实例。使用此方法，您可以处理和缓存已处理的实例，而不是原始字符串，从而提高应用程序的性能。

val processed = EmojiCompat.get().process("neutral face \uD83D\uDE10")

CharSequence processed = EmojiCompat.get().process("neutral face \uD83D\uDE10");

将 EmojiCompat 用于 IME

使用 EmojiCompat 支持库，键盘可以渲染其交互的应用程序支持的表情符号。IME 可以使用 hasEmojiGlyph() 方法来检查 EmojiCompat 是否能够渲染表情符号。此方法采用表情符号的 CharSequence 并返回 true，如果 EmojiCompat 可以检测和渲染表情符号。

键盘还可以检查应用程序支持的 EmojiCompat 支持库的版本，以确定在调色板中渲染哪些表情符号。要检查版本（如果可用），键盘需要检查 EditorInfo.extras 捆绑包中是否存在以下键：

• EDITOR_INFO_METAVERSION_KEY

如果该键存在于捆绑包中，则该值表示应用程序使用的表情符号元数据的版本。如果此键不存在，则该应用程序未使用 EmojiCompat。

• EDITOR_INFO_REPLACE_ALL_KEY

如果该键存在并设置为 true，则表示该应用程序已调用 SetReplaceAll() 方法。有关 EmojiCompat 配置的更多信息，请参阅 配置选项 部分。

在收到 EditorInfo.extras 捆绑包中的键后，键盘可以使用 hasEmojiGlyph() 方法（其中 metadataVersion 是 EDITOR_INFO_METAVERSION_KEY 的值）来检查应用程序是否可以渲染特定表情符号。

将 EmojiCompat 与自定义小部件一起使用

您可以始终使用 process() 方法预处理应用程序中的 CharSequence 并将其添加到任何可以渲染 Spanned 实例的小部件；例如，TextView。此外，EmojiCompat 提供以下小部件帮助程序类，让您可以轻松地为自定义小部件添加表情符号支持。

• EmojiTextViewHelper
• EmojiEditTextHelper

示例 TextView

Kotlin

class MyTextView(context: Context) : AppCompatTextView(context) {

    private val emojiTextViewHelper: EmojiTextViewHelper by lazy(LazyThreadSafetyMode.NONE) {
        EmojiTextViewHelper(this).apply {
            updateTransformationMethod()
        }
    }

    override fun setFilters(filters: Array<InputFilter>) {
        super.setFilters(emojiTextViewHelper.getFilters(filters))
    }

    override fun setAllCaps(allCaps: Boolean) {
        super.setAllCaps(allCaps)
        emojiTextViewHelper.setAllCaps(allCaps)
    }
}

Java

public class MyTextView extends AppCompatTextView {
   ...
   public MyTextView(Context context) {
       super(context);
       init();
   }
   ...
   private void init() {
       getEmojiTextViewHelper().updateTransformationMethod();
   }

   @Override
   public void setFilters(InputFilter[] filters) {
       super.setFilters(getEmojiTextViewHelper().getFilters(filters));
   }

   @Override
   public void setAllCaps(boolean allCaps) {
       super.setAllCaps(allCaps);
       getEmojiTextViewHelper().setAllCaps(allCaps);
   }

   private EmojiTextViewHelper getEmojiTextViewHelper() {
       ...
   }
}

示例 EditText

Kotlin

class MyEditText(context: Context) : AppCompatEditText(context) {

    private val emojiEditTextHelper: EmojiEditTextHelper by lazy(LazyThreadSafetyMode.NONE) {
        EmojiEditTextHelper(this).also {
            super.setKeyListener(it.getKeyListener(keyListener))
        }
    }

    override fun setKeyListener(input: KeyListener?) {
        input?.also {
            super.setKeyListener(emojiEditTextHelper.getKeyListener(it))
        }
    }

    override fun onCreateInputConnection(outAttrs: EditorInfo): InputConnection {
        val inputConnection: InputConnection = super.onCreateInputConnection(outAttrs)
        return emojiEditTextHelper.onCreateInputConnection(
                inputConnection,
                outAttrs
        ) as InputConnection
    }
}

Java

public class MyEditText extends AppCompatEditText {
   ...
   public MyEditText(Context context) {
       super(context);
       init();
   }
   ...
   private void init() {
       super.setKeyListener(getEmojiEditTextHelper().getKeyListener(getKeyListener()));
   }

   @Override
   public void setKeyListener(android.text.method.KeyListener keyListener) {
       super.setKeyListener(getEmojiEditTextHelper().getKeyListener(keyListener));
   }

   @Override
   public InputConnection onCreateInputConnection(EditorInfo outAttrs) {
       InputConnection inputConnection = super.onCreateInputConnection(outAttrs);
       return getEmojiEditTextHelper().onCreateInputConnection(inputConnection, outAttrs);
   }

   private EmojiEditTextHelper getEmojiEditTextHelper() {
       ...
   }
}

常见问题

• 如何启动字体下载？

如果设备上不存在表情符号字体，则会在第一次请求时下载。下载调度对应用程序是透明的。

• 初始化需要多长时间？

下载字体后，初始化 EmojiCompat 大约需要 150 毫秒。

• EmojiCompat 支持库使用多少内存？

目前，查找表情符号的数据结构加载到应用程序的内存中，大约使用 200KB。

• 我可以将 EmojiCompat 用于自定义 TextView 吗？

可以。EmojiCompat 为自定义小部件提供帮助程序类。也可以预处理给定的字符串并将其转换为 Spanned。有关小部件帮助程序类的更多信息，请参阅 将 EmojiCompat 与自定义小部件一起使用 部分。

• 如果我在运行 Android 4.4（API 级别 19）或更低版本的设备上在布局 XML 中添加小部件会发生什么情况？

您可以在支持运行 Android 4.4（API 级别 19）或更低版本的设备的应用程序中包含 EmojiCompat 支持库或其小部件。但是，如果设备运行的是低于 API 级别 19 的 Android 版本，则 EmojiCompat 及其小部件处于“无操作”状态。这意味着 EmojiTextView 的行为与普通的 TextView 完全相同。EmojiCompat 实例；当您调用 init() 方法时，它会立即进入 LOAD_STATE_SUCCEEDED 状态。

其他资源

有关使用 EmojiCompat 库的更多信息，请观看 EmojiCompat 视频。