EmojiCompat

EDITOR_INFO_METAVERSION_KEY

String EDITOR_INFO_METAVERSION_KEY

Key in extras that represents the emoji metadata version used by the widget. The existence of the value means that the widget is using EmojiCompat.

If exists, the value for the key is an int and can be used to query EmojiCompat to see whether the widget has the ability to display a certain emoji using hasEmojiGlyph(CharSequence, int).

Constant Value: "android.support.text.emoji.emojiCompat_metadataVersion"

EDITOR_INFO_REPLACE_ALL_KEY

String EDITOR_INFO_REPLACE_ALL_KEY

Key in extras that represents setReplaceAll(boolean) configuration parameter. The key is added only if EmojiCompat is used by the widget. If exists, the value is a boolean.

Constant Value: "android.support.text.emoji.emojiCompat_replaceAll"

LOAD_STATE_FAILED

int LOAD_STATE_FAILED

An unrecoverable error occurred during initialization of EmojiCompat. Calls to functions such as process(CharSequence) will fail.

Constant Value: 2 (0x00000002)

LOAD_STATE_LOADING

int LOAD_STATE_LOADING

EmojiCompat is initializing.

Constant Value: 0 (0x00000000)

LOAD_STATE_SUCCEEDED

int LOAD_STATE_SUCCEEDED

EmojiCompat successfully initialized.

Constant Value: 1 (0x00000001)

REPLACE_STRATEGY_ALL

int REPLACE_STRATEGY_ALL

Replace strategy to add EmojiSpans for all emoji that were found.

Constant Value: 1 (0x00000001)

REPLACE_STRATEGY_DEFAULT

int REPLACE_STRATEGY_DEFAULT

Replace strategy that uses the value given in EmojiCompat.Config.

Constant Value: 0 (0x00000000)

REPLACE_STRATEGY_NON_EXISTENT

int REPLACE_STRATEGY_NON_EXISTENT

Replace strategy to add EmojiSpans only for emoji that do not exist in the system.

Constant Value: 2 (0x00000002)

get

EmojiCompat get ()

Return singleton EmojiCompat instance. Should be called after init(EmojiCompat.Config) is called to initialize the singleton instance.

getAssetSignature

String getAssetSignature ()

Returns signature for the currently loaded emoji assets. The signature is a SHA that is constructed using emoji assets. Can be used to detect if currently loaded asset is different then previous executions. When used on devices running API 18 or below, returns empty string.

getLoadState

int getLoadState ()

Returns loading state of the EmojiCompat instance. When used on devices running API 18 or below always returns LOAD_STATE_SUCCEEDED.

handleDeleteSurroundingText

boolean handleDeleteSurroundingText (InputConnection inputConnection, 
                Editable editable, 
                int beforeLength, 
                int afterLength, 
                boolean inCodePoints)

Handles deleteSurroundingText commands from InputConnection and tries to delete an EmojiSpan from an Editable. Returns true if an EmojiSpan is deleted.

If there is a selection where selection start is not equal to selection end, does not delete.

When used on devices running API 18 or below, always returns false.

handleOnKeyDown

boolean handleOnKeyDown (Editable editable, 
                int keyCode, 
                KeyEvent event)

Handles onKeyDown commands from a KeyListener and if keyCode is one of KEYCODE_DEL or KEYCODE_FORWARD_DEL it tries to delete an EmojiSpan from an Editable. Returns true if an EmojiSpan is deleted with the characters it covers.

If there is a selection where selection start is not equal to selection end, does not delete.

When used on devices running API 18 or below, always returns false.

hasEmojiGlyph

boolean hasEmojiGlyph (CharSequence sequence)

Returns true if EmojiCompat is capable of rendering an emoji. When used on devices running API 18 or below, always returns false.

hasEmojiGlyph

boolean hasEmojiGlyph (CharSequence sequence, 
                int metadataVersion)

Returns true if EmojiCompat is capable of rendering an emoji at the given metadata version. When used on devices running API 18 or below, always returns false.

init

EmojiCompat init (EmojiCompat.Config config)

Initialize the singleton instance with a configuration. When used on devices running API 18 or below, the singleton instance is immediately moved into LOAD_STATE_SUCCEEDED state without loading any metadata.

process

CharSequence process (CharSequence charSequence)

Checks a given CharSequence for emojis, and adds EmojiSpans if any emojis are found. When used on devices running API 18 or below, returns the given charSequence without processing it.

process

CharSequence process (CharSequence charSequence, 
                int start, 
                int end, 
                int maxEmojiCount, 
                int replaceStrategy)

Checks a given CharSequence for emojis, and adds EmojiSpans if any emojis are found.

• If no emojis are found, charSequence given as the input is returned without any changes. i.e. charSequence is a String, and no emojis are found, the same String is returned.
• If the given input is not a Spannable (such as String), and at least one emoji is found a new Spannable instance is returned.
• If the given input is a Spannable, the same instance is returned.

process

CharSequence process (CharSequence charSequence, 
                int start, 
                int end, 
                int maxEmojiCount)

Checks a given CharSequence for emojis, and adds EmojiSpans if any emojis are found.

• If no emojis are found, charSequence given as the input is returned without any changes. i.e. charSequence is a String, and no emojis are found, the same String is returned.
• If the given input is not a Spannable (such as String), and at least one emoji is found a new Spannable instance is returned.
• If the given input is a Spannable, the same instance is returned.

process

CharSequence process (CharSequence charSequence, 
                int start, 
                int end)

Checks a given CharSequence for emojis, and adds EmojiSpans if any emojis are found.

• If no emojis are found, charSequence given as the input is returned without any changes. i.e. charSequence is a String, and no emojis are found, the same String is returned.
• If the given input is not a Spannable (such as String), and at least one emoji is found a new Spannable instance is returned.
• If the given input is a Spannable, the same instance is returned.

registerInitCallback

void registerInitCallback (EmojiCompat.InitCallback initCallback)

Registers an initialization callback. If the initialization is already completed by the time the listener is added, the callback functions are called immediately. Callbacks are called on the main looper.

When used on devices running API 18 or below, onInitialized() is called without loading any metadata. In such cases onFailed(Throwable) is never called.

unregisterInitCallback

void unregisterInitCallback (EmojiCompat.InitCallback initCallback)

Unregisters a callback that was added before.