इमोजी के साथ काम करने की सुविधा

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 और EmojiCompat क्लास उपलब्ध कराएँ registerInitCallback() और unregisterInitCallback() इनिशलाइज़ेशन कॉलबैक रजिस्टर करने के तरीके. इन तरीकों का इस्तेमाल करने के लिए, EmojiCompat.InitCallback क्लास. कॉल करें इन तरीकों का इस्तेमाल करें और EmojiCompat.InitCallback क्लास. जब EmojiCompat की सहायता शुरू करना लाइब्रेरी हो गई, EmojiCompat क्लास onInitialized() तरीका. अगर लाइब्रेरी शुरू नहीं हो पाता है, तो EmojiCompat क्लास onFailed() तरीका.

किसी भी समय प्रारंभ स्थिति की जांच करने के लिए, getLoadState() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है तरीका. यह इनमें से कोई एक वैल्यू दिखाता है: LOAD_STATE_LOADING, LOAD_STATE_SUCCEEDED, या LOAD_STATE_FAILED.

AppCompat विजेट के साथ इमोजी का इस्तेमाल करना

अगर आप AppCompat widgets का इस्तेमाल कर रहे हैं, तो एक्सटेंशन वाले EmojiCompat विजेट का इस्तेमाल कर सकता है AppCompat widgets से शुरू.

1. डिपेंडेंसी सेक्शन में सहायता लाइब्रेरी जोड़ें.

   ग्रूवी

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

   Kotlin

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

   ग्रूवी

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

2. EmojiCompat का इस्तेमाल करें लेआउट में AppCompat Widget विजेट एक्सएमएल.

<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, इन चरणों को पूरा करें:

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 का इस्तेमाल सही इमेज दिखाने के लिए EmojiSpan. इसलिए, इसे किसी भी CharSequence को Spanned इंस्टेंस के साथ EmojiSpans. कॉन्टेंट बनाने EmojiCompat क्लास इन कामों के लिए तरीका उपलब्ध कराती है CharSequences को इसमें बदलें Spanned इंस्टेंस के साथ EmojiSpans. इस तरीके का इस्तेमाल करके, रॉ स्ट्रिंग के बजाय, प्रोसेस किए गए इंस्टेंस को प्रोसेस और कैश मेमोरी में सेव किया जा सकता है, इससे आपके ऐप्लिकेशन की परफ़ॉर्मेंस बेहतर होती है.

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

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

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, का इस्तेमाल करके यह पता लगाया जा सकता है कि ऐप्लिकेशन किसी खास इमोजी को रेंडर कर सकता है या नहीं.

पसंद के मुताबिक विजेट के साथ इमोजी-कंपैट का इस्तेमाल करना

आप जब चाहें, 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() {
       ...
   }
}

अक्सर पूछे जाने वाले सवाल

• मैं फ़ॉन्ट डाउनलोड कैसे शुरू करूं?

इमोजी फ़ॉन्ट मौजूद न होने पर, पहली बार अनुरोध करने पर उन्हें डाउनलोड कर लिया जाता है डिवाइस पर. ऐप्लिकेशन को डाउनलोड शेड्यूल करने की जानकारी, पारदर्शी होती है.

• प्रोसेस शुरू होने में कितना समय लगता है?

फ़ॉन्ट डाउनलोड होने के बाद, इसमें करीब 150 मिलीसेकंड लगते हैं EmojiCompat शुरू करने के लिए.

• इमोजी कम्पैट, लाइब्रेरी के साथ काम करने वाली मेमोरी का कितना इस्तेमाल करता है?

फ़िलहाल, इमोजी को ढूंढने के लिए इस्तेमाल किया जाने वाला डेटा स्ट्रक्चर, ऐप्लिकेशन के मेमोरी और करीब 200 केबी का इस्तेमाल करती है.

• क्या पसंद के मुताबिक TextView के लिए इमोजीकॉम्पैट का इस्तेमाल किया जा सकता है?

हां. इमोजीकंपैट, कस्टम विजेट के लिए हेल्पर क्लास उपलब्ध कराता है. यह भी है दिए गए स्ट्रिंग को प्रीप्रोसेस और उसे Spanned. विजेट हेल्पर के बारे में ज़्यादा जानकारी क्लास का इस्तेमाल करते हैं, तो पसंद के मुताबिक बनाए गए विजेट के साथ इमोजी-कंपैट का इस्तेमाल करना सेक्शन में जाएं.

• अगर मैं उन डिवाइसों पर लेआउट एक्सएमएल में विजेट जोड़ दूं जो क्या ऐप्लिकेशन, Android 4.4 (एपीआई लेवल 19) या इससे पहले के वर्शन पर काम करते हैं?

EmojiCompat को शामिल किया जा सकता है लाइब्रेरी और इसके विजेट की सुविधा पाएं, जो डिवाइस पर काम करते हैं जो Android 4.4 (एपीआई लेवल 19) या इससे पहले के वर्शन पर काम करते हों. हालांकि, अगर कोई डिवाइस एपीआई लेवल 19 से पहले के Android वर्शन पर, EmojiCompat और इसके विजेट "कोई कार्रवाई नहीं" राज्य. इसका मतलब है कि EmojiTextView ठीक से काम करता है सामान्य TextView की तरह. EmojiCompat इंस्टेंस; इसे तुरंत LOAD_STATE_SUCCEEDED यह जानने के लिए कि आप init() तरीका.

अन्य संसाधन

इस बारे में अतिरिक्त जानकारी पाने के लिए, EmojiCompat अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है लाइब्रेरी में, EmojiCompat देखें.