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

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

مصادر إضافية

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