Questa pagina è stata tradotta dall'API Cloud Translation.

Identificare la lingua del testo con ML Kit su Android

Puoi utilizzare il ML Kit per identificare la lingua di una stringa di testo. Puoi visualizzare la lingua più probabile della stringa e punteggi di affidabilità per tutte le lingue possibili della stringa.

ML Kit riconosce il testo in oltre 100 lingue diverse negli script nativi. Inoltre, il testo romanizzato può essere riconosciuto per arabo, bulgaro, cinese, greco, hindi, giapponese e russo. Consulta l'elenco completo degli script e delle lingue supportati.

	In bundle	Non in bundle
Nome libreria	`com.google.mlkit:language-id`	`com.google.android.gms:play-services-mlkit-language-id`
Implementazione	Il modello è collegato in modo statico alla tua app al momento della creazione.	Il modello viene scaricato dinamicamente tramite Google Play Services.
Impatto sulle dimensioni dell'app	Aumento di circa 900 kB.	Aumento di circa 200 kB.
Data/ora di inizializzazione	Il modello è disponibile immediatamente.	Potrebbe essere necessario attendere il download del modello prima del primo utilizzo.

Prova

Prova l'app di esempio per un esempio di utilizzo di questa API.

Prima di iniziare

Questa API richiede il livello API 19 o successivo per Android. Assicurati che il file di build dell'app utilizzi un valore minSdkVersion pari o superiore a 19.

Nel file build.gradle a livello di progetto, assicurati di includere il repository Maven di Google nelle sezioni buildscript e allprojects.

Aggiungi le dipendenze per le librerie Android di ML Kit al file Gradle a livello di app del modulo, che in genere è app/build.gradle. Scegli una delle seguenti dipendenze in base alle tue esigenze:

Per raggruppare il modello con l'app:

dependencies {
  // ...
  // Use this dependency to bundle the model with your app
  implementation 'com.google.mlkit:language-id:17.0.4'
}

Per l'utilizzo del modello in Google Play Services:

dependencies {
  // ...
  // Use this dependency to use the dynamically downloaded model in Google Play Services
  implementation 'com.google.android.gms:play-services-mlkit-language-id:17.0.0'
}

Se scegli di utilizzare il modello in Google Play Services, puoi configurare la tua app per scaricarlo automaticamente sul dispositivo dopo l'installazione dal Play Store. Per farlo, aggiungi la seguente dichiarazione al file AndroidManifest.xml della tua app:
```
<application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="langid" >
      
</application>
```
Puoi anche controllare esplicitamente la disponibilità del modello e richiedere il download tramite l'API ModuleInstallClient di Google Play Services.

Se non abiliti i download dei modelli al momento dell'installazione o richiedi un download esplicito, il modello verrà scaricato la prima volta che esegui l'identificatore. Le richieste effettuate prima del completamento del download non generano risultati.

Identificare la lingua di una stringa

Per identificare il linguaggio di una stringa, chiama LanguageIdentification.getClient() per ottenere un'istanza di LanguageIdentifier, quindi passa la stringa al metodo identifyLanguage() di LanguageIdentifier.

Ad esempio:

Kotlin

val languageIdentifier = LanguageIdentification.getClient()
languageIdentifier.identifyLanguage(text)
        .addOnSuccessListener { languageCode ->
            if (languageCode == "und") {
                Log.i(TAG, "Can't identify language.")
            } else {
                Log.i(TAG, "Language: $languageCode")
            }
        }
        .addOnFailureListener {
            // Model couldn’t be loaded or other internal error.
            // ...
        }LanguageIdentificationActivity.kt

Java

LanguageIdentifier languageIdentifier =
        LanguageIdentification.getClient();
languageIdentifier.identifyLanguage(text)
        .addOnSuccessListener(
                new OnSuccessListener<String>() {
                    @Override
                    public void onSuccess(@Nullable String languageCode) {
                        if (languageCode.equals("und")) {
                            Log.i(TAG, "Can't identify language.");
                        } else {
                            Log.i(TAG, "Language: " + languageCode);
                        }
                    }
                })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // Model couldn’t be loaded or other internal error.
                        // ...
                    }
                });LanguageIdentificationActivity.java

Se la chiamata ha esito positivo, il codice lingua BCP-47 viene trasmesso al listener di successo, a indicare la lingua del testo. Se non viene rilevata una lingua, il codice und (non determinato) viene trasmesso.

Per impostazione predefinita, il kit ML restituisce un valore diverso da und solo quando identifica la lingua con un valore di affidabilità di almeno 0,5. Puoi modificare questa soglia passando un oggetto LanguageIdentificationOptions a getClient():

Kotlin

val languageIdentifier = LanguageIdentification
        .getClient(LanguageIdentificationOptions.Builder()
                .setConfidenceThreshold(0.34f)
                .build())LanguageIdentificationActivity.kt

Java

LanguageIdentifier languageIdentifier = LanguageIdentification.getClient(
        new LanguageIdentificationOptions.Builder()
                .setConfidenceThreshold(0.34f)
                .build());LanguageIdentificationActivity.java

Conoscere le possibili lingue di una stringa

Per ottenere i valori di affidabilità delle lingue più probabili di una stringa, recupera un'istanza di LanguageIdentifier e poi passa la stringa al metodo identifyPossibleLanguages().

Ad esempio:

Kotlin

val languageIdentifier = LanguageIdentification.getClient()
languageIdentifier.identifyPossibleLanguages(text)
        .addOnSuccessListener { identifiedLanguages ->
            for (identifiedLanguage in identifiedLanguages) {
                val language = identifiedLanguage.languageTag
                val confidence = identifiedLanguage.confidence
                Log.i(TAG, "$language $confidence")
            }
        }
        .addOnFailureListener {
            // Model couldn’t be loaded or other internal error.
            // ...
        }LanguageIdentificationActivity.kt

Java

LanguageIdentifier languageIdentifier =
        LanguageIdentification.getClient();
languageIdentifier.identifyPossibleLanguages(text)
        .addOnSuccessListener(new OnSuccessListener<List<IdentifiedLanguage>>() {
            @Override
            public void onSuccess(List<IdentifiedLanguage> identifiedLanguages) {
                for (IdentifiedLanguage identifiedLanguage : identifiedLanguages) {
                    String language = identifiedLanguage.getLanguageTag();
                    float confidence = identifiedLanguage.getConfidence();
                    Log.i(TAG, language + " (" + confidence + ")");
                }
            }
        })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // Model couldn’t be loaded or other internal error.
                        // ...
                    }
                });LanguageIdentificationActivity.java

Se la chiamata riesce, l'elenco di oggetti IdentifiedLanguage viene passato al listener riuscito. Da ogni oggetto, puoi ottenere il codice BCP-47 della lingua e la certezza che la stringa sia in quella lingua. Ricorda che questi valori indicano la certezza che l'intera stringa sia nella lingua specificata; ML Kit non identifica più lingue in una singola stringa.

Per impostazione predefinita, ML Kit restituisce solo le lingue con valori di affidabilità di almeno 0,01. Puoi modificare questa soglia passando un oggetto LanguageIdentificationOptions a getClient():

Kotlin

val languageIdentifier = LanguageIdentification
      .getClient(LanguageIdentificationOptions.Builder()
              .setConfidenceThreshold(0.5f)
              .build())

Java

LanguageIdentifier languageIdentifier = LanguageIdentification.getClient(
      new LanguageIdentificationOptions.Builder()
              .setConfidenceThreshold(0.5f)
              .build());

Se nessuna lingua soddisfa questa soglia, l'elenco contiene un elemento, con il valore und.