ความเข้ากันได้ของอีโมจิ

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

การเพิ่ม Listener การเริ่มต้น

EmojiCompat และ EmojiCompat ชั้นเรียน ระบุ registerInitCallback() และ unregisterInitCallback() เมธอดในการลงทะเบียน Callback ของการเริ่มต้น หากต้องการใช้วิธีการเหล่านี้ ให้สร้าง ตัวอย่างของ 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. เพิ่มไลบรารีการสนับสนุนลงในส่วนทรัพยากร Dependency

   ดึงดูด

   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 เพื่อโหลดข้อมูลเมตา และแบบอักษร

หมายเหตุ: ขนาดของแบบอักษรมีหน่วยเป็น เมกะไบต์

การเพิ่มทรัพยากร Dependency ของไลบรารีการสนับสนุน

วิธีใช้ไลบรารีการสนับสนุน EmojiCompat เมื่อใช้การกำหนดค่าแบบอักษรเป็นกลุ่ม คุณจะต้องแก้ไขโปรเจ็กต์แอป ทรัพยากร Dependency ของคลาสพาธภายในสภาพแวดล้อมการพัฒนาซอฟต์แวร์

วิธีเพิ่มไลบรารีการสนับสนุนลงในโปรเจ็กต์แอปพลิเคชัน

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 สำหรับ 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, เพื่อตรวจสอบว่าแอปแสดงอีโมจิที่เจาะจงได้ไหม

การใช้ 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() {
       ...
   }
}

คำถามที่พบบ่อย

• ฉันจะเริ่มดาวน์โหลดแบบอักษรได้อย่างไร

แบบอักษรอีโมจิจะดาวน์โหลดตามคำขอครั้งแรก หากยังไม่มี ในอุปกรณ์ การตั้งเวลาดาวน์โหลดมีความโปร่งใสสำหรับแอป

• การเริ่มต้นใช้เวลานานเท่าใด

หลังจากดาวน์โหลดแบบอักษรแล้ว จะใช้เวลาประมาณ 150 มิลลิวินาที เพื่อเริ่มต้น EmojiCompat

• EmojiCompat รองรับไลบรารีได้เท่าไร

ในปัจจุบัน โครงสร้างข้อมูลในการค้นหาอีโมจินั้นโหลดอยู่ใน และใช้หน่วยความจำประมาณ 200 KB

• ฉันจะใช้ EmojiCompat กับ TextView ที่กำหนดเองได้ไหม

ได้ EmojiCompat มีคลาสตัวช่วยสำหรับวิดเจ็ตที่กำหนดเอง และยัง ประมวลผลสตริงที่ระบุล่วงหน้าและแปลงเป็น Spanned สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวช่วยวิดเจ็ต โปรดดู การใช้ EmojiCompat กับวิดเจ็ตที่กำหนดเอง

• จะเกิดอะไรขึ้นหากฉันเพิ่มวิดเจ็ตใน XML เลย์เอาต์บนอุปกรณ์ที่ ทำงานใน Android 4.4 (API ระดับ 19) หรือต่ำกว่านั้นไหม

คุณสามารถใส่ EmojiCompat สนับสนุนไลบรารีหรือวิดเจ็ตของไลบรารีในแอปพลิเคชันที่รองรับอุปกรณ์ ที่ใช้ Android 4.4 (API ระดับ 19) หรือต่ำกว่า แต่หากอุปกรณ์เรียกใช้ ใน Android เวอร์ชันก่อน API ระดับ 19 EmojiCompat และวิดเจ็ตภายใน "ไม่มีการดำเนินการ" ซึ่งหมายความว่า EmojiTextView ทำงานถูกต้อง เหมือนTextViewปกติ อินสแตนซ์ EmojiCompat รายการ ทันที ได้เข้าสู่ วันที่ LOAD_STATE_SUCCEEDED เมื่อคุณเรียกใช้ฟังก์ชัน init()

แหล่งข้อมูลเพิ่มเติม

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ EmojiCompat ดู EmojiCompat