Le classificateur de texte utilise des techniques d'apprentissage automatique pour aider les développeurs à classer le texte.
Classificateur de texte de la version Android 11
Android 11 introduit une implémentation par défaut pouvant être mise à jour du service de classification de texte dans le module ExtServices . Sur les appareils exécutant Android 11 ou version ultérieure, la méthode getTextClassifier()
renvoie cette implémentation par défaut dans le module ExtServices. Il est recommandé aux fabricants d'appareils d'utiliser cette implémentation de TextClassifierService
car elle peut être mise à jour via les mises à jour Mainline OTA.
Android 11 supprime également l'implémentation par défaut du classificateur de texte local précédemment introduite dans Android 8.1 . En conséquence, getLocalTextClassifier()
renvoie un classificateur de texte NO_OP
. Au lieu de l’implémentation locale, vous devez utiliser la méthode getDefaultTextClassifierImplementation()
.
Pour les fabricants d'appareils souhaitant utiliser leurs propres algorithmes de classification de texte, ils peuvent implémenter un service de classification de texte personnalisé en spécifiant config_defaultTextClassifierPackage
dans le fichier config.xml
. Si cette configuration n'est pas spécifiée, l'implémentation système par défaut est utilisée. Les implémentations personnalisées peuvent obtenir une instance de l'implémentation par défaut en appelant TextClassifierService.getDefaultTextClassifierImplementation(Context)
. Pour plus d'informations, consultez Implémentation d'un service de classification de texte personnalisé .
Essai
Pour valider votre implémentation du service de classification de texte, utilisez les tests CTS (Compatibility Test Suite) dans platform/cts/tests/tests/textclassifier/
.
Améliorations du classificateur de texte de la version Android 10
Android 10 introduit deux méthodes dans l'API TextClassifier : suggestConversationActions
et detectLanguage
. La méthode suggestConversationActions
génère des réponses et des actions suggérées à partir d'une conversation donnée et la méthode detectLanguage
détecte la langue du texte.
Les fichiers de modèle pour ces méthodes sont présentés ci-dessous et peuvent être trouvés dans external/libtextclassifier/models/
.
-
suggestionConversationActions
:actions_suggestions.universal.model
-
detectLanguage
:lang_id.model
Pour publier un appareil avec les derniers fichiers de modèle dans votre image d'usine, procédez comme suit :
Récupérez les derniers fichiers de modèle.
external/libtextclassifier/models/update.sh
- Renommez les fichiers téléchargés pour remplacer ceux existants.
- Vérifiez la configuration.
adb shell dumpsys textclassification
Ceci est un exemple du résultat de cette commande.
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 }
Améliorations du classificateur de texte de la version Android 9
Android 9 a étendu le cadre de classification de texte introduit dans Android 8.1 avec le nouveau service de classification de texte. Le service de classification de texte est le moyen recommandé par les OEM pour fournir une prise en charge du système de classification de texte. Le service de classification de texte peut faire partie de n’importe quel APK système et peut être mis à jour si nécessaire.
Android 9 inclut une implémentation de service de classification de texte par défaut ( TextClassifierImpl
) qui est utilisée sauf si vous la remplacez par une implémentation de service de classification de texte personnalisée.
Implémenter un service de classification de texte personnalisé
Les sections suivantes décrivent comment implémenter un service de classificateur de texte personnalisé que vous développez.
Étendre 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) { ... } ... }
Définir le service dans le manifeste 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>
Notez que le service doit nécessiter l'autorisation android.permission.BIND_TEXTCLASSIFIER_SERVICE
et doit spécifier l'action d'intention android.service.textclassifier.TextClassifierService
.
Définir un service de classification de texte par défaut du système dans la superposition de configuration
[ config.xml ]
<string name="config_defaultTextClassifierPackage" translatable="false">com.example.textclassifierservice</string>
Intégrez le service de classification de texte à l'image système
Votre service de classification de texte personnalisé peut être un APK autonome intégré à l’image système ou une partie d’un autre APK système. Le système utilise PackageManager.MATCH_SYSTEM_ONLY
pour résoudre le service.
Essai
Exécutez des tests dans android.view.textclassifier.cts
.
Autres changements de classification de texte dans Android 9
Reportez-vous à Inspection des modules de langue installés .
Les fichiers de modèle Android 9 sont incompatibles avec les fichiers de modèle Android 8.x.
Les fichiers de modèle Android 9 ont le modèle de dénomination : texclassifier.[language-code].model
(par exemple, textclassifier.en.model
) au lieu de textclassifier.smartselection.en.model
dans Android 8.x.
Obtenez les derniers fichiers de modèle de classification de texte
Pour obtenir les modèles les plus à jour, le script suivant peut être exécuté, qui met à jour les modèles TextClassifier dans l'arborescence source :
external/libtextclassifier/native/models/update.sh
Classificateur de texte Android version 8.1
Android 8.1 a introduit l'API TextClassfier pour implémenter la classification de texte.
TextClassificationManager tcm = context.getSystemService(TextClassificationManager.class); TextClassifier classifier = tcm.getTextClassifier(); TextSelection selection = classifier.suggestSelection(...); TextClassification classification = classifier.classifyText(...);
Les développeurs peuvent définir un classificateur de texte personnalisé :
tcm.setTextClassifier(customTextClassifier);
Mais si un développeur d'application définit le classificateur de texte sur null
, un classificateur de texte par défaut du système est renvoyé pour getTextClassifier()
.
Voir android.view.textclassifier.TextClassifierImpl
.
TextView et WebView utilisent TextClassifier pour les fonctionnalités de sélection intelligente et de partage de texte intelligent.
Modèles de réseaux neuronaux TextClassifier
Le projet Android Open Source (AOSP) propose un certain nombre de modèles de réseaux neuronaux pour classer le texte. Chaque fichier modèle est formé pour une seule langue. Vous pouvez installer n'importe quelle combinaison de modèles. Les modèles sont définis dans :
external/libtextclassifier/Android.mk
Préinstaller des modèles linguistiques sur les appareils
Vous pouvez spécifier un ensemble de modèles linguistiques et les installer sur un appareil :
# ----------------------- # 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)
Par exemple, dans device/google/marlin/device-common.mk
.
# TextClassifier smart selection model files PRODUCT_PACKAGES += \ textclassifier.smartselection.bundle1
Inspecter les modules de langue installés
Utilisez ADB pour lister les fichiers du répertoire :
$ 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
Mises à jour du modèle
Les modèles peuvent être mis à jour soit en incluant un nouveau modèle dans le cadre d'une mise à jour de l'image système, soit de manière dynamique en ayant un composant système qui déclenche une mise à jour via l'intention API ACTION_UPDATE_SMART_SELECTION
système. En diffusant cette intention d'API système, le framework est capable de mettre à jour le modèle de langage de la langue actuellement définie. Les modèles eux-mêmes contiennent la langue prise en charge et un numéro de version afin que le dernier modèle approprié soit utilisé.
Vous n'avez donc pas besoin de précharger les modèles pour toutes les langues, car ils peuvent être ajoutés ultérieurement. Si aucun fichier modèle n'est trouvé pour la langue spécifiée, la classification de texte renvoie des valeurs sans opération.
Tests de la suite de tests de compatibilité
Les tests CTS (Android Compatibility Test Suite) associés peuvent être trouvés dans :
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