توافق الرموز التعبيرية

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.

استخدام EmojiCompat مع تطبيقات 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 في ملفات XML الخاصة بتنسيق الصفحة.

<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 مكتبة الدعم مع إعدادات الخطوط المجمّعة، يجب تعديل ملف Classpath لمشروع تطبيقك في بيئة التطوير.

لإضافة مكتبة دعم إلى مشروع تطبيقك:

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 معيّن إلى مثيلات Spanned باستخدام EmojiSpans. توفّر فئة EmojiCompat طريقة ل تحويل CharSequences إلى مثيلات Spanned باستخدام EmojiSpans. باستخدام هذه الطريقة، يمكنك معالجة النماذج التي تمت معالجتها وتخزينها مؤقتًا بدلاً من السلسلة الأولية، ما يؤدي إلى تحسين أداء تطبيقك.

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

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

استخدام EmojiCompat مع أنظمة الكتابة

باستخدام مكتبة دعم EmojiCompat، يمكن للوحات المفاتيح عرض الرموز التعبيرية المتوافقة مع التطبيق الذي تتفاعل معه. يمكن أن تستخدم أنظمة IME الطريقة hasEmojiGlyph() للتحقّق مما إذا كان EmojiCompat قادرًا على عرض رمز تعبيري. تأخذ هذه الطريقة CharSequence من رمز تعبيري وتُعرِض true إذا كان EmojiCompat يمكنه رصد رمز تعبيري وعرضه.

يمكن للوحة المفاتيح أيضًا التحقّق من إصدار EmojiCompat مكتبة الدعم التي يتوافق معها التطبيق لتحديد الرموز التعبيرية التي سيتم عرضها في لوحة الألوان. للتحقّق من إصدار حزمة EditorInfo.extras ، إذا كان متوفّرًا، يجب أن تتحقّق لوحة المفاتيح مما إذا كانت مفاتيح 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؟

في الوقت الحالي، يتم تحميل بنية البيانات للعثور على الرمز التعبيري في ذاكرة التطبيق وتستهلك هذه البنية حوالي 200 كيلوبايت.

• هل يمكنني استخدام EmojiCompat لعرض نص مخصّص في TextView؟

نعم. توفّر EmojiCompat فئات مساعدة للتطبيقات المصغّرة المخصّصة. من الممكن أيضًا إجراء معالجة مسبقة لسلسلة معيّنة وتحويلها إلى Spanned. لمزيد من المعلومات حول فئات تطبيقات الأدوات المساعدة، ارجع إلى القسم استخدام EmojiCompat مع التطبيقات المصغّرة المخصّصة.

• ماذا يحدث إذا أضفت تطبيقات مصغّرة في ملفات XML الخاصة بتنسيقات التخطيط على الأجهزة التي تعمل بالإصدار 4.4 من نظام التشغيل Android (المستوى 19 لواجهة برمجة التطبيقات) أو إصدار أقدم؟

يمكنك تضمين مكتبة دعم EmojiCompat أو التطبيقات المصغّرة الخاصة بها في تطبيقاتك التي تتوافق مع الأجهزة التي تعمل بالإصدار 4.4 من نظام التشغيل Android (المستوى 19 من واجهة برمجة التطبيقات) أو الإصدارات الأقدم. ومع ذلك، إذا كان الجهاز يعمل بإصدار Android أقدم من المستوى 19 من واجهة برمجة التطبيقات، EmojiCompat تكون التطبيقات المصغّرة فيه في حالة "بدون عملية". وهذا يعني أنّ السمة EmojiTextView تعمل تمامًا مثل TextView العادية. EmojiCompat: يدخل فورًا في حالة LOAD_STATE_SUCCEEDED عند استدعاء الطريقة init().

مصادر إضافية

للحصول على معلومات إضافية عن استخدام مكتبة EmojiCompat ، يمكنك مشاهدة EmojiCompat.