ইমোজি সামঞ্জস্য

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 উইজেটগুলির সাথে EmojiCompat ব্যবহার করা

আপনি যদি 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. লেআউট XML-এ 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 কনফিগার করতে বান্ডিল ফন্ট ব্যবহার করে

EmojiCompat কনফিগার করতে বান্ডিল ফন্ট ব্যবহার করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. EmojiCompat এর একটি উদাহরণ তৈরি করতে BundledEmojiCompatConfig ব্যবহার করুন এবং Context একটি উদাহরণ প্রদান করুন।
2. EmojiCompat শুরু করতে init() পদ্ধতিতে কল করুন এবং 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 EmojiSpans সাথে Spanned ইনস্ট্যান্সে রূপান্তর করতে হবে। EmojiCompat ক্লাস EmojiSpans সাহায্যে CharSequences Spanned ইনস্ট্যান্সে রূপান্তর করার একটি পদ্ধতি প্রদান করে। এই পদ্ধতিটি ব্যবহার করে, আপনি কাঁচা স্ট্রিংয়ের পরিবর্তে প্রক্রিয়াকৃত দৃষ্টান্তগুলিকে প্রক্রিয়া এবং ক্যাশে করতে পারেন, যা আপনার অ্যাপ্লিকেশনের কার্যকারিতা উন্নত করে।

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

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

IME এর জন্য EmojiCompat ব্যবহার করা

EmojiCompat সমর্থন লাইব্রেরি ব্যবহার করে, কীবোর্ডগুলি তারা যে অ্যাপ্লিকেশনটির সাথে ইন্টারঅ্যাক্ট করছে তার দ্বারা সমর্থিত ইমোজি রেন্ডার করতে পারে। IMEs 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 এর মান, অ্যাপটি একটি নির্দিষ্ট ইমোজি রেন্ডার করতে পারে কিনা তা পরীক্ষা করতে।

কাস্টম উইজেটগুলির সাথে ইমোজিকম্প্যাট ব্যবহার করা

আপনি সর্বদা আপনার অ্যাপে CharSequence প্রিপ্রসেস করার জন্য process() পদ্ধতি ব্যবহার করতে পারেন এবং এটিকে যেকোন উইজেটে যোগ করতে পারেন যা Spanned ইনস্ট্যান্স রেন্ডার করতে পারে; উদাহরণস্বরূপ, TextView । এছাড়াও, EmojiCompat আপনাকে ন্যূনতম প্রচেষ্টার সাথে ইমোজি সমর্থন সহ আপনার কাস্টম উইজেটগুলিকে সমৃদ্ধ করতে নিম্নলিখিত উইজেট সহায়ক ক্লাসগুলি সরবরাহ করে।

• EmojiTextViewHelper
• EmojiEditTextHelper

নমুনা টেক্সটভিউ

কোটলিন

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

প্রায়শই জিজ্ঞাসিত প্রশ্ন

• আমি কিভাবে ফন্ট ডাউনলোড শুরু করব?

ইমোজি ফন্টগুলি প্রথম অনুরোধে ডাউনলোড করা হয়, যদি সেগুলি ডিভাইসে বিদ্যমান না থাকে। ডাউনলোডের সময়সূচী অ্যাপটিতে স্বচ্ছ।

• আরম্ভ করতে কত সময় লাগে?

ফন্টটি ডাউনলোড হওয়ার পরে, EmojiCompat শুরু করতে প্রায় 150 মিলিসেকেন্ড সময় লাগে।

• EmojiCompat সমর্থন লাইব্রেরি কত মেমরি ব্যবহার করে?

বর্তমানে, ইমোজি খুঁজে পাওয়ার জন্য ডেটা স্ট্রাকচার অ্যাপের মেমরিতে লোড করা হয়েছে এবং প্রায় 200KB ব্যবহার করে।

• আমি একটি কাস্টম TextView জন্য EmojiCompat ব্যবহার করতে পারি?

হ্যাঁ। EmojiCompat কাস্টম উইজেটগুলির জন্য সহায়ক ক্লাস প্রদান করে। একটি প্রদত্ত স্ট্রিং প্রিপ্রসেস করা এবং এটিকে Spanned এ রূপান্তর করাও সম্ভব। উইজেট হেল্পার ক্লাস সম্পর্কে আরও তথ্যের জন্য, কাস্টম উইজেটগুলির সাথে ইমোজিকম্প্যাট ব্যবহার করা বিভাগটি পড়ুন।

• অ্যান্ড্রয়েড 4.4 (API লেভেল 19) বা তার নিচের ডিভাইসগুলিতে আমি লেআউট XML-এ উইজেট যোগ করলে কী হবে?

আপনি Android 4.4 (API লেভেল 19) বা তার কম চলমান ডিভাইসগুলিকে সমর্থন করে এমন আপনার অ্যাপ্লিকেশনগুলিতে EmojiCompat সমর্থন লাইব্রেরি বা এর উইজেটগুলি অন্তর্ভুক্ত করতে পারেন৷ যাইহোক, যদি কোনো ডিভাইস এপিআই লেভেল 19-এর আগে অ্যান্ড্রয়েড সংস্করণে চলে, তাহলে EmojiCompat এবং এর উইজেটগুলি "নো অপারেশন" অবস্থায় থাকে। এর মানে হল EmojiTextView একটি নিয়মিত TextView মত আচরণ করে। EmojiCompat উদাহরণ; আপনি init() পদ্ধতিতে কল করলে এটি অবিলম্বে একটি LOAD_STATE_SUCCEEDED অবস্থায় চলে যায়।

অতিরিক্ত সম্পদ

EmojiCompat লাইব্রেরি ব্যবহার করার বিষয়ে অতিরিক্ত তথ্যের জন্য, EmojiCompat দেখুন।