سازگاری 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 و 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"
   }
   

   کاتلین

         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 با پیکربندی فونت همراه، باید وابستگی های مسیر کلاس پروژه برنامه خود را در محیط توسعه خود تغییر دهید.

برای افزودن یک کتابخانه پشتیبانی به پروژه برنامه خود:

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. برای مقداردهی اولیه EmojiCompat و ارسال نمونه BundledEmojiCompatConfig متد init() را فراخوانی کنید.

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 به نمونه های Spanned با EmojiSpans ارائه می دهد. با استفاده از این روش، می‌توانید نمونه‌های پردازش‌شده را به‌جای رشته خام پردازش و ذخیره کنید، که باعث بهبود عملکرد برنامه شما می‌شود.

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 از یک ایموجی را می گیرد و اگر EmojiCompat بتواند ایموجی را شناسایی و رندر کند، true را برمی گرداند.

صفحه‌کلید همچنین می‌تواند نسخه کتابخانه پشتیبانی 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 نمونه

کاتلین

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)
    }
}

جاوا

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() {
       ...
   }
}

ویرایش متن نمونه

کاتلین

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
    }
}

جاوا

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 مقداردهی اولیه شود.

• کتابخانه EmojiCompat از چه مقدار حافظه استفاده می کند؟

در حال حاضر، ساختار داده برای یافتن ایموجی در حافظه برنامه بارگذاری شده است و از حدود 200 کیلوبایت استفاده می کند.

• آیا می توانم از EmojiCompat برای TextView سفارشی استفاده کنم؟

بله EmojiCompat کلاس های کمکی را برای ویجت های سفارشی ارائه می دهد. همچنین امکان پیش پردازش یک رشته داده شده و تبدیل آن به Spanned وجود دارد. برای اطلاعات بیشتر در مورد کلاس های کمکی ویجت، به بخش استفاده از EmojiCompat با ابزارک های سفارشی مراجعه کنید.

• اگر ویجت‌ها را در طرح‌بندی XML در دستگاه‌هایی که دارای Android نسخه 4.4 (سطح API 19) یا پایین‌تر هستند، اضافه کنم، چه اتفاقی می‌افتد؟

می‌توانید کتابخانه پشتیبانی EmojiCompat یا ویجت‌های آن را در برنامه‌های خود قرار دهید که از دستگاه‌های دارای Android 4.4 (سطح API 19) یا پایین‌تر پشتیبانی می‌کنند. با این حال، اگر دستگاهی بر روی نسخه اندرویدی قبل از سطح API 19 اجرا شود، EmojiCompat و ویجت‌های آن در حالت "بدون عملیات" هستند. این بدان معنی است که EmojiTextView دقیقاً مانند یک TextView معمولی رفتار می کند. نمونه EmojiCompat ؛ هنگامی که متد init() را فراخوانی می کنید، بلافاصله به حالت LOAD_STATE_SUCCEEDED می رسد.

منابع اضافی

برای اطلاعات بیشتر در مورد استفاده از کتابخانه EmojiCompat ، EmojiCompat را تماشا کنید.