Emoji Uyumluluğu

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

İlk kullanıma hazırlama işleyicileri ekleme

EmojiCompat ve EmojiCompat sınıf sağlamak registerInitCallback() ve unregisterInitCallback() ilk kullanıma hazırlama geri çağırması kullanma yöntemleri vardır. Bu yöntemleri kullanmak için örneğinin EmojiCompat.InitCallback sınıf. Telefonla arama ve örnek iletinizin örneğini EmojiCompat.InitCallback sınıf. EmojiCompat desteğinin başlatılması başarılı olursa EmojiCompat sınıfın onInitialized() yöntemidir. Kitaplık başlatılamıyor, EmojiCompat sınıfın onFailed() yöntemidir.

Başlatma durumunu istediğiniz zaman kontrol etmek için şunu arayın: getLoadState(). yöntemidir. Aşağıdaki değerlerden birini döndürür: LOAD_STATE_LOADING, LOAD_STATE_SUCCEEDED, veya LOAD_STATE_FAILED.

EmojiCompat'ı AppCompat widget'larıyla kullanma

AppCompat widgets kullanıyorsanız EmojiCompat widget'ları kullanabilir başlangıç fiyatı: AppCompat widgets.

1. Bağımlılıklar bölümüne destek kitaplığını ekleyin.

   Eski

   dependencies {
       ...
       implementation "androidx.emoji:emoji-bundled:$version"
   }
   

   Kotlin

         dependencies {
             implementation("androidx.emoji:emoji-appcompat:$version")
         }
         

   Eski

         dependencies {
             implementation "androidx.emoji:emoji-appcompat:$version"
         }
         

2. EmojiCompat hesabını kullan Düzende AppCompat Widget widget XML'ler.

<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"/>

Gruplandırılmış yazı tiplerini yapılandırma

EmojiCompat destek kitaplığı da yazı tipi sürümü olarak sunulur. Bu pakette meta verileri bulabilirsiniz. Pakette ayrıca bir BundledEmojiCompatConfig. Meta verileri yüklemek için AssetManager kullanan kullanabilirsiniz.

Not: Yazı tipi boyutu birden çok megabayt.

Destek kitaplığı bağımlılığı ekleme

EmojiCompat destek kitaplığını kullanmak için paket halinde sunulan yazı tipi yapılandırmasında, uygulama projenizin bağımlılıklarını nasıl ortaya koyabileceğinizi açıklayacağız.

Uygulama projenize destek kitaplığı eklemek için:

1. Uygulamanızın build.gradle dosyasını açın.
2. dependencies bölümüne destek kitaplığını ekleyin.

dependencies {
    ...
    implementation "androidx.emoji:emoji:28.0.0"
}

dependencies {
    ...
    implementation("androidx.emoji:emoji:28.0.0")
}

EmojiCompat'ı yapılandırmak için gruplandırılmış yazı tiplerini kullanma

Toplu yazı tiplerini kullanarak EmojiCompat, aşağıdaki adımları uygulayın:

1. BundledEmojiCompatConfig hesabını kullan (EmojiCompat öğesinin bir örneğini oluşturmak için) ve Context örneğini sağlayın.
2. Şunu çağırın: init(). ilk kullanıma hazırlama yöntemi EmojiCompat ve 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'ı widget'lar olmadan kullanma

EmojiCompat kullanımları Doğru resimleri oluşturmak için EmojiSpan. Dolayısıyla, belirli bir CharSequence öğesini Şunlarla Spanned örnek: EmojiSpans. İlgili içeriği oluşturmak için kullanılan EmojiCompat sınıfı, CharSequences şuna dönüştür: Spanned örnek ve EmojiSpans. Bu yöntem kullanıldığında ham dize yerine işlenen örnekleri işleyip önbelleğe alabilirsiniz Bu da uygulamanızın performansını artırır.

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

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

IME'ler için EmojiCompat'ı kullanma

EmojiCompat destek kitaplığını kullanarak klavyeler, kullandıkları uygulama tarafından desteklenen emojiyi yardımcı olur. IME'ler hasEmojiGlyph(). EmojiCompat adlı özelliğin uygun olup olmadığını kontrol etme yöntemi gösteriliyor. Bu yöntemle CharSequence bir emojiyi verir ve true EmojiCompat, emoji'ye dokunun.

Klavye, uygulamanızın sürümünü EmojiCompat, uygulamanın desteklediği kitaplığı Palette hangi emojinin oluşturulacağını belirlemeyi destekler. Kontrol etmek için sürümü varsa, klavyenin aşağıdaki anahtarın bulunduğu EditorInfo.extras. grup:

• EDITOR_INFO_METAVERSION_KEY

Anahtar pakette yer alıyorsa değer Bu sürüm, uygulamanın kullandığı emoji meta verileridir. Bu anahtar uygulama EmojiCompat kullanmıyor.

• EDITOR_INFO_REPLACE_ALL_KEY

Anahtar varsa ve true değerine ayarlanmışsa bu durum uygulama SetReplaceAll() yöntemidir. Daha fazla bilgi için EmojiCompat yapılandırması, Yapılandırma seçeneklerine bakın bölümüne bakın.

Anahtarları aldıktan sonra EditorInfo.extras paketi, klavye, hasEmojiGlyph() yöntemidir; burada metadataVersion değeri EDITOR_INFO_METAVERSION_KEY, uygulamanın belirli bir emoji oluşturup oluşturamayacağını kontrol etmek için.

EmojiCompat'ı özel widget'larla kullanma

Dilediğiniz zaman process() uygulamasını kullanabilirsiniz yönteminde CharSequence değerini uygulamanızda ön işleme Spanned örneklerini oluşturabilen herhangi bir widget'a ekler; şunun için: örnek, TextView. Ayrıca, EmojiCompat şu widget'ı sağlar: özel widget'larınızı emoji desteğiyle zenginleştirmenizi sağlayan özel ortaya çıkarmasını sağlamaya yardımcı olur.

• EmojiTextViewHelper
• EmojiEditTextHelper

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

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

Sık sorulan sorular

• Yazı tipi indirme işlemini nasıl başlatabilirim?

Emoji yazı tipleri (mevcut değilse) ilk istekte indirilir cihaz üzerinde. İndirme planlaması uygulama için şeffaftır.

• İlk kullanıma hazırlama işlemi ne kadar sürer? 'nı inceleyin.

Yazı tipi indirildikten sonra yaklaşık 150 milisaniye EmojiCompat ilk kullanıma hazırlanır.

• EmojiCompat destek kitaplığı ne kadar bellek kullanıyor?

Şu anda, emojileri bulmak için kullanılan veri yapısı, uygulamanın belleğe sahiptir ve yaklaşık 200 KB kullanır.

• EmojiCompat'ı özel bir TextView için kullanabilir miyim?

Evet. EmojiCompat, özel widget'lar için yardımcı sınıflar sağlar. Aynı zamanda belirli bir dizeyi önceden işlemek ve Spanned Widget yardımcısı hakkında daha fazla bilgi için daha fazla bilgi edinmek için EmojiCompat'ı özel widget'larla kullanma bölümüne bakın.

• Şu cihazlarda düzen XML'lerine widget eklersem ne olur? Android 4.4 (API düzeyi 19) veya önceki sürümlerde çalışırsanız ne olur?

EmojiCompat dahil edebilirsiniz cihazları destekleyen uygulamalarınızda kitaplığı veya widget'larını destekleyin Android 4.4 (API düzeyi 19) veya önceki sürümleri çalıştıranlar. Ancak, bir cihaz API düzeyi 19'dan önceki bir Android sürümünde EmojiCompat ve widget'ları bir "işlem yok" durumu. Bunun anlamı, EmojiTextView tam olarak davranıyor normal bir TextView gibi. EmojiCompat örneği; hemen alır LOAD_STATE_SUCCEEDED init() yöntemidir.

Ek kaynaklar

EmojiCompat. kitaplıksa EmojiCompat adlı videoları izleyin.