Der Textklassifikator verwendet Techniken des maschinellen Lernens, um Entwicklern bei der Klassifizierung von Text zu helfen.
Textklassifikator in Android 11
In Android 11 wird im Modul „ExtServices“ eine aktualisierbare Standardimplementierung des Textklassifizierungsdiensts eingeführt. Auf Geräten mit Android 11 oder höher gibt die Methode
getTextClassifier()
diese Standardimplementierung im Modul „ExtServices“ zurück.
Geräteherstellern wird empfohlen, diese Implementierung von TextClassifierService
zu verwenden, da sie über Mainline-OTA-Updates aktualisiert werden kann.
Unter Android 11 wird außerdem die zuvor in
Android 8.1 eingeführte Standardimplementierung des lokalen Textklassifikators entfernt. Daher gibt
getLocalTextClassifier()
einen NO_OP
-Textklassifikator zurück. Verwenden Sie anstelle der lokalen Implementierung die Methode getDefaultTextClassifierImplementation()
.
Gerätehersteller, die eigene Textklassifizierungsalgorithmen verwenden möchten, können einen benutzerdefinierten Textklassifikatordienst implementieren. Dazu geben sie config_defaultTextClassifierPackage
in der Datei config.xml
an. Wenn diese Konfiguration nicht angegeben ist, wird die Standardsystemimplementierung verwendet. Benutzerdefinierte Implementierungen können eine Instanz der Standardimplementierung abrufen, indem sie
TextClassifierService.getDefaultTextClassifierImplementation(Context)
aufrufen.
Weitere Informationen finden Sie unter
Benutzerdefinierten Textklassifizierungsdienst implementieren.
Testen
Validieren Sie die Implementierung des Textklassifikatordienstes mit den CTS-Tests (Compatibility Test Suite) in
platform/cts/tests/tests/textclassifier/
.
Verbesserungen am Textklassifikator in Android 10
In Android 10 werden der TextClassifier API zwei Methoden hinzugefügt:
suggestConversationActions
und
detectLanguage
.
Die Methode suggestConversationActions
generiert vorgeschlagene Antworten und Aktionen aus einer bestimmten Unterhaltung und die Methode detectLanguage
erkennt die Sprache des Textes.
Die Modelldateien für diese Methoden sind unten aufgeführt und können unter
external/libtextclassifier/models/
gefunden werden.
suggestionConversationActions
:actions_suggestions.universal.model
detectLanguage
:lang_id.model
So veröffentlichen Sie ein Gerät mit den neuesten Modelldateien in Ihrem Werks-Image:
Rufen Sie die neuesten Modelldateien ab.
external/libtextclassifier/models/update.sh
- Benennen Sie die heruntergeladenen Dateien um, um die vorhandenen zu ersetzen.
- Überprüfen Sie die Einrichtung.
adb shell dumpsys textclassification
Hier ist ein Beispiel für die Ausgabe dieses Befehls.
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 }
Verbesserungen am Textklassifikator in Android 9
Android 9 hat das mit Android 8.1 eingeführte Framework für die Textklassifizierung um den neuen Textklassifikatordienst erweitert. Der Textklassifizierungsdienst ist die empfohlene Methode für OEMs, um Unterstützung für das Textklassifizierungssystem bereitzustellen. Der Textklassifizierungsdienst kann Teil eines beliebigen System-APKs sein und bei Bedarf aktualisiert werden.
Android 9 enthält eine Standardimplementierung des Textklassifikatordiensts (
TextClassifierImpl
), die verwendet wird, sofern Sie ihn nicht durch einen benutzerdefinierten Textklassifikatordienst ersetzen.
Benutzerdefinierten Dienst für Textklassifizierung implementieren
In den folgenden Abschnitten wird beschrieben, wie Sie einen von Ihnen entwickelten benutzerdefinierten Textklassifikatordienst implementieren.
android.service.textclassifier.TextClassifierService erweitern
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) { ... } ... }
Dienst im Android-Manifest definieren
[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>
Der Dienst muss die Berechtigung android.permission.BIND_TEXTCLASSIFIER_SERVICE
und die Intent-Aktion android.service.textclassifier.TextClassifierService
angeben.
Standard-Textklassifizierungsdienst des Systems im Konfigurations-Overlay festlegen
[config.xml]
<string name="config_defaultTextClassifierPackage" translatable="false">com.example.textclassifierservice</string>
Textklassifizierungsdienst in das System-Image einbinden
Ihr benutzerdefinierter Textklassifikatordienst kann ein eigenständiges APK sein, das in das System-Image oder als Teil eines anderen System-APKs integriert ist. Das System verwendet PackageManager.MATCH_SYSTEM_ONLY
, um den Dienst aufzulösen.
Testen
Führe Tests in android.view.textclassifier.cts
durch.
Weitere Änderungen bei der Textklassifizierung in Android 9
Weitere Informationen finden Sie unter Installierte Sprachmodule prüfen.
Android 9-Modelldateien sind nicht mit Android 8.x-Modelldateien kompatibel.
Modelldateien für Android 9 haben das Benennungsmuster texclassifier.[language-code].model
(z. B. textclassifier.en.model
) anstelle von textclassifier.smartselection.en.model
in Android 8.x.
Neueste Dateien des Textklassifizierungsmodells abrufen
Um die neuesten Modelle zu erhalten, kann das folgende Script ausgeführt werden, das die TextClassifier-Modelle im Quellbaum aktualisiert:
external/libtextclassifier/native/models/update.sh
Textklassifikator der Android-Version 8.1
Mit Android 8.1 wurde die TextClassifier API eingeführt, um die Textklassifizierung zu implementieren.
TextClassificationManager tcm = context.getSystemService(TextClassificationManager.class); TextClassifier classifier = tcm.getTextClassifier(); TextSelection selection = classifier.suggestSelection(...); TextClassification classification = classifier.classifyText(...);
Entwickler können einen benutzerdefinierten Textklassifikator festlegen:
tcm.setTextClassifier(customTextClassifier);
Wenn ein App-Entwickler den Textklassifikator jedoch auf null
festlegt, wird für getTextClassifier()
der standardmäßige Textklassifikator des Systems zurückgegeben.
android.view.textclassifier.TextClassifierImpl
ansehen.
TextView und WebView verwenden den TextClassifier für die intelligente Auswahl und die intelligente Freigabe von Text.
Neuronale Netzwerkmodelle für TextClassifier
Das Android Open Source Project (AOSP) bietet eine Reihe von neuronalen Netzwerkmodellen zur Textklassifizierung. Jede Modelldatei wird für eine einzelne Sprache trainiert. Sie können eine beliebige Kombination von Modellen installieren. Die Modelle sind in folgenden Dateien definiert:
external/libtextclassifier/Android.mk
Sprachmodelle auf Geräten vorinstallieren
Sie können ein Sprachmodell-Bundle angeben und auf einem Gerät installieren:
# ----------------------- # 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)
Beispiel: device/google/marlin/device-common.mk
.
# TextClassifier smart selection model files PRODUCT_PACKAGES += \ textclassifier.smartselection.bundle1
Installierte Sprachmodule prüfen
Verwenden Sie ADB, um die Dateien im Verzeichnis aufzulisten:
$ 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
Modellaktualisierungen
Modelle können entweder durch ein neues Modell im Rahmen eines System-Image-Updates oder dynamisch durch eine Systemkomponente aktualisiert werden, die ein Update über die System-API ACTION_UPDATE_SMART_SELECTION
-Intention auslöst. Durch das Senden dieser System-API-Intent kann das Framework das Sprachmodell der aktuell eingestellten Sprache aktualisieren. Die Modelle selbst enthalten die unterstützte Sprache und eine Versionsnummer, damit das jeweils neueste Modell verwendet wird.
Sie müssen also nicht alle Modelle für alle Sprachen vorab laden, da sie später hinzugefügt werden können. Wenn für die angegebene Sprache keine Modelldatei gefunden wird, gibt die Textklassifizierung Nullwerte zurück.
Compatibility Test Suite-Tests
Die zugehörigen CTS-Tests (Compatibility Test Suite) finden Sie hier:
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