Mengimplementasikan pengklasifikasi teks

Pengklasifikasi teks menggunakan teknik machine learning untuk membantu developer mengklasifikasikan teks.

Pengklasifikasi teks rilis Android 11

Android 11 memperkenalkan implementasi default yang dapat diupdate untuk layanan pengklasifikasi teks di modul ExtServices. Di perangkat yang menjalankan Android 11 atau yang lebih tinggi, metode getTextClassifier() menampilkan implementasi default ini di modul ExtServices. Produsen perangkat disarankan untuk menggunakan implementasi TextClassifierService ini karena dapat diupdate melalui update OTA Mainline.

Android 11 juga menghapus implementasi default pengklasifikasi teks lokal yang sebelumnya diperkenalkan di Android 8.1. Akibatnya, getLocalTextClassifier() menampilkan pengklasifikasi teks NO_OP. Daripada menerapkan secara lokal, Anda harus menggunakan metode getDefaultTextClassifierImplementation().

Untuk produsen perangkat yang mungkin ingin menggunakan algoritma klasifikasi teks mereka sendiri, mereka dapat menerapkan layanan pengklasifikasi teks kustom dengan menentukan config_defaultTextClassifierPackage di file config.xml. Jika konfigurasi ini tidak ditentukan, implementasi sistem default akan digunakan. Implementasi kustom dapat memperoleh instance implementasi default dengan memanggil TextClassifierService.getDefaultTextClassifierImplementation(Context). Untuk mengetahui informasi selengkapnya, lihat Menerapkan layanan pengklasifikasi teks kustom.

Pengujian

Untuk memvalidasi penerapan layanan pengklasifikasi teks, gunakan pengujian Compatibility Test Suite (CTS) di platform/cts/tests/tests/textclassifier/.

Rilis Android 10 menghadirkan peningkatan pada pengklasifikasi teks

Android 10 memperkenalkan dua metode ke TextClassifier API: suggestConversationActions dan detectLanguage. Metode suggestConversationActions menghasilkan saran balasan dan tindakan dari percakapan tertentu, serta metode detectLanguage mendeteksi bahasa teks.

File model untuk metode ini ditunjukkan di bawah dan dapat ditemukan di external/libtextclassifier/models/.

• suggestionConversationActions: actions_suggestions.universal.model
• detectLanguage: lang_id.model

Untuk merilis perangkat dengan file model terbaru di image pabrik Anda, lakukan hal berikut:

1. Ambil file model terbaru.

   external/libtextclassifier/models/update.sh
   

2. Ganti nama file yang didownload untuk menggantikan file yang ada.
3. Verifikasi penyiapan.

   adb shell dumpsys textclassification
   

   Berikut adalah contoh output dari perintah tersebut.

   TextClassifierImpl:
     Annotator model file(s):
       ModelFile { path=/etc/textclassifier/textclassifier.universal.model name=textclassifier.universal.model version=608 locales=und }
       ModelFile { path=/etc/textclassifier/textclassifier.en.model name=textclassifier.en.model version=608 locales=en }
     LangID model file(s):
       ModelFile { path=/etc/textclassifier/lang_id.model name=lang_id.model version=0 locales=und }
     Actions model file(s):
       ModelFile { path=/etc/textclassifier/actions_suggestions.universal.model name=actions_suggestions.universal.model version=0 locales=und }

Peningkatan pengklasifikasi teks rilis Android 9

Android 9 memperluas framework klasifikasi teks yang diperkenalkan di Android 8.1 dengan layanan pengklasifikasi teks baru. Layanan pengklasifikasi teks adalah cara yang direkomendasikan bagi OEM untuk menyediakan dukungan sistem klasifikasi teks. Layanan pengklasifikasi teks dapat menjadi bagian dari APK sistem apa pun dan dapat diupdate jika diperlukan.

Android 9 menyertakan penerapan layanan pengklasifikasi teks default ( TextClassifierImpl) yang digunakan kecuali jika Anda menggantinya dengan penerapan layanan pengklasifikasi teks kustom.

Menerapkan layanan pengklasifikasi teks kustom

Bagian berikut menjelaskan cara menerapkan layanan klasifikasi teks kustom yang Anda kembangkan.

Memperluas android.service.textclassifier.TextClassifierService

public final class TextClassifierServiceImpl
        extends TextClassifierService {

    // Returns TextClassifierImpl.
    private final TextClassifier tc = getLocalTextClassifier();

    @Override
    public void onSuggestSelection(
            @Nullable TextClassificationSessionId sessionId,
            @NonNull TextSelection.Request request,
            @NonNull CancellationSignal cancellationSignal,
            @NonNull Callback<TextSelection> callback) {
        CompletableFuture.supplyAsync(
                () -> tc.suggestSelection(request))
                .thenAccept(r -> callback.onSuccess(r));
    }

    @Override
    public void onClassifyText(
            @Nullable TextClassificationSessionId sessionId,
		@NonNull TextClassification.Request request,
		@NonNull CancellationSignal cancellationSignal,
		@NonNull Callback<TextClassification> callback) {
        ...
    }

    @Override
    public void onGenerateLinks(
            @Nullable TextClassificationSessionId sessionId,
            @NonNull TextLinks.Request request,
            @NonNull CancellationSignal cancellationSignal,
            @NonNull Callback<TextLinks> callback) {
        ...
    }
    ...
}

Menentukan layanan dalam manifes Android

[AndroidManifest.xml]

<service android:name=".TextClassifierServiceImpl"
  android:permission="android.permission.BIND_TEXTCLASSIFIER_SERVICE">
    <intent-filter>
      <action android:name=
        "android.service.textclassifier.TextClassifierService"/>
    </intent-filter>
</service>

Perhatikan bahwa layanan harus memerlukan izin android.permission.BIND_TEXTCLASSIFIER_SERVICE dan harus menentukan tindakan intent android.service.textclassifier.TextClassifierService.

Menetapkan layanan pengklasifikasi teks default sistem di overlay konfigurasi

[config.xml]

<string name="config_defaultTextClassifierPackage" translatable="false">com.example.textclassifierservice</string>

Membangun layanan pengklasifikasi teks ke dalam image sistem

Layanan klasifikasi teks kustom Anda dapat berupa APK mandiri yang di-build ke dalam image sistem atau bagian dari APK sistem lain. Sistem menggunakan PackageManager.MATCH_SYSTEM_ONLY untuk menyelesaikan layanan.

Pengujian

Jalankan pengujian di android.view.textclassifier.cts.

Perubahan klasifikasi teks lainnya di Android 9

Lihat Memeriksa modul bahasa yang terinstal.

File model Android 9 tidak kompatibel dengan file model Android 8.x.

File model Android 9 memiliki pola penamaan: texclassifier.[language-code].model (misalnya, textclassifier.en.model) bukan textclassifier.smartselection.en.model di Android 8.x.

Mendapatkan file model klasifikasi teks terbaru

Untuk mendapatkan model terbaru, skrip berikut dapat dijalankan, yang mengupdate model TextClassifier di hierarki sumber:

external/libtextclassifier/native/models/update.sh

Pengklasifikasi teks rilis Android 8.1

Android 8.1 memperkenalkan TextClassifier API untuk menerapkan klasifikasi teks.

TextClassificationManager tcm =
    context.getSystemService(TextClassificationManager.class);
TextClassifier classifier = tcm.getTextClassifier();
TextSelection selection = classifier.suggestSelection(...);
TextClassification classification = classifier.classifyText(...);

Developer dapat menetapkan pengklasifikasi teks kustom:

tcm.setTextClassifier(customTextClassifier);

Namun, jika developer aplikasi menyetel pengklasifikasi teks ke null, pengklasifikasi teks default sistem akan ditampilkan untuk getTextClassifier().

Lihat android.view.textclassifier.TextClassifierImpl.

TextView dan WebView menggunakan TextClassifier untuk fitur berbagi teks smart dan pemilihan smart.

Gambar 1. Penggunaan TextClassifier

Model jaringan saraf TextClassifier

Proyek Open Source Android (AOSP) menampilkan sejumlah model jaringan neural untuk mengklasifikasikan teks. Setiap file model dilatih untuk satu bahasa. Anda dapat menginstal kombinasi model apa pun. Model ditentukan dalam:

external/libtextclassifier/Android.mk

Menginstal model bahasa di perangkat sebelum digunakan

Anda dapat menentukan paket model bahasa dan menginstalnya di perangkat:

# -----------------------
# Smart Selection bundles
# -----------------------

include $(CLEAR_VARS)
LOCAL_MODULE           := textclassifier.smartselection.bundle1
LOCAL_REQUIRED_MODULES := textclassifier.smartselection.en.model
LOCAL_REQUIRED_MODULES += textclassifier.smartselection.es.model
LOCAL_REQUIRED_MODULES += textclassifier.smartselection.de.model
LOCAL_REQUIRED_MODULES += textclassifier.smartselection.fr.model
include $(BUILD_STATIC_LIBRARY)

Misalnya, di device/google/marlin/device-common.mk.

# TextClassifier smart selection model files
PRODUCT_PACKAGES += \
    textclassifier.smartselection.bundle1

Memeriksa modul bahasa yang diinstal

Gunakan ADB untuk mencantumkan file dalam direktori:

$ adb shell ls -l /etc/textclassifier
-rw-r--r-- 1 root root ... textclassifier.smartselection.de.model
-rw-r--r-- 1 root root ... textclassifier.smartselection.en.model
-rw-r--r-- 1 root root ... textclassifier.smartselection.es.model
-rw-r--r-- 1 root root ... textclassifier.smartselection.fr.model

Update model

Model dapat diupdate dengan menyertakan model baru sebagai bagian dari update image sistem, atau secara dinamis dengan memiliki komponen sistem yang memicu update melalui intent API ACTION_UPDATE_SMART_SELECTION sistem. Dengan menyiarkan maksud API sistem ini, framework dapat memperbarui model bahasa dari bahasa yang saat ini ditetapkan. Model itu sendiri berisi bahasa yang didukung dan nomor versi sehingga model terbaru yang sesuai digunakan.

Jadi, Anda tidak perlu memuat model terlebih dahulu untuk semua bahasa karena model dapat ditambahkan nanti. Jika tidak ada file model yang ditemukan untuk bahasa yang ditentukan, klasifikasi teks akan menampilkan nilai no-op.

Pengujian Compatibility Test Suite

Pengujian Android Compatibility Test Suite (CTS) terkait dapat ditemukan di:

cts/tests/tests/view/src/android/view/textclassifier/cts/TextClassificationManagerTest.java

cts/tests/tests/widget/src/android/widget/cts/TextViewTest.java

• testSmartSelection
• testSmartSelection_dragSelection
• testSmartSelection_resetSelection