คุณใช้ ML Kit เพื่อระบุภาษาของสตริงข้อความได้ คุณดูภาษาที่มีแนวโน้มมากที่สุดของสตริง รวมถึงคะแนนความเชื่อมั่นสำหรับภาษาที่เป็นไปได้ทั้งหมดของสตริงได้
ML Kit จดจำข้อความได้มากกว่า 100 ภาษาในสคริปต์ท้องถิ่น นอกจากนี้ ระบบยังอนุญาตให้ใช้ข้อความแบบโรมันในภาษาอาหรับ บัลแกเรีย จีน กรีก ฮินดี ญี่ปุ่น และรัสเซีย ดูรายการทั้งหมดของภาษาและสคริปต์ที่รองรับ
รวมกลุ่ม | ไม่ได้จัดกลุ่ม | |
---|---|---|
ชื่อไลบรารี | com.google.mlkit:language-id | com.google.android.gms:play-services-mlkit-language-id |
การใช้งาน | โมเดลจะลิงก์แบบคงที่กับแอปของคุณ ณ เวลาบิลด์ | ระบบจะดาวน์โหลดโมเดลแบบไดนามิกผ่านบริการ Google Play |
ผลกระทบของขนาดแอป | เพิ่มขนาดได้ประมาณ 900 KB | เพิ่มขนาดได้ประมาณ 200 KB |
เวลาเริ่มต้น | โมเดลจะพร้อมใช้งานทันที | อาจต้องรอดาวน์โหลดโมเดลก่อนใช้งานครั้งแรก |
ลองเลย
- ลองใช้แอปตัวอย่างเพื่อดูตัวอย่างการใช้งาน API นี้
ก่อนเริ่มต้น
ในไฟล์
build.gradle
ระดับโปรเจ็กต์ ให้ตรวจสอบว่ามีที่เก็บ Maven ของ Google ไว้ในส่วนbuildscript
และallprojects
เพิ่มทรัพยากร Dependency สำหรับไลบรารี Android ของ ML Kit ไปยังไฟล์ Gradle ระดับแอปของโมดูล ซึ่งปกติจะอยู่ที่
app/build.gradle
เลือกทรัพยากร Dependency รายการใดรายการหนึ่งต่อไปนี้ตามความต้องการของคุณสำหรับการรวมโมเดลกับแอป ให้ทำดังนี้
dependencies { // ... // Use this dependency to bundle the model with your app implementation 'com.google.mlkit:language-id:17.0.5' }
สำหรับการใช้โมเดลในบริการ Google Play
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' }
หากเลือกใช้โมเดลในบริการ Google Play คุณสามารถกำหนดค่าแอปให้ดาวน์โหลดโมเดลลงในอุปกรณ์โดยอัตโนมัติหลังจากที่ติดตั้งแอปจาก Play Store แล้ว ในการดำเนินการดังกล่าว ให้เพิ่มการประกาศต่อไปนี้ลงในไฟล์
AndroidManifest.xml
ของแอป<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="langid" > <!-- To use multiple models: android:value="langid,model2,model3" --> </application>
นอกจากนี้คุณยังตรวจสอบความพร้อมใช้งานของโมเดลอย่างชัดแจ้งและขอการดาวน์โหลดผ่านบริการ Google Play ได้ ModuleInstallClient API
หากคุณไม่เปิดใช้การดาวน์โหลดโมเดลเวลาติดตั้งหรือขอดาวน์โหลดอย่างชัดแจ้ง ระบบจะดาวน์โหลดโมเดลในครั้งแรกที่คุณเรียกใช้ตัวระบุ คำขอที่คุณส่งก่อนการดาวน์โหลดเสร็จสมบูรณ์จะไม่มีผลลัพธ์ใดๆ
ระบุภาษาของสตริง
หากต้องการระบุภาษาของสตริง ให้เรียก LanguageIdentification.getClient()
เพื่อรับอินสแตนซ์ของ LanguageIdentifier
จากนั้นส่งสตริงไปยังเมธอด identifyLanguage()
ของ LanguageIdentifier
เช่น
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. // ... }
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. // ... } });
หากการโทรสำเร็จ ระบบจะส่งรหัสภาษา BCP-47 ไปยัง Listener ที่สำเร็จ ซึ่งแสดงถึงภาษาของข้อความ หากตรวจไม่พบภาษาใดอย่างมั่นใจ ระบบจะส่งผ่านโค้ด und
(ไม่กำหนด)
โดยค่าเริ่มต้น ML Kit จะแสดงผลค่าอื่นที่ไม่ใช่ und
เฉพาะเมื่อระบุภาษาที่มีค่าความเชื่อมั่นอย่างน้อย 0.5 คุณเปลี่ยนเกณฑ์นี้ได้โดยการส่งออบเจ็กต์ LanguageIdentificationOptions
ไปยัง getClient()
Kotlin
val languageIdentifier = LanguageIdentification .getClient(LanguageIdentificationOptions.Builder() .setConfidenceThreshold(0.34f) .build())
Java
LanguageIdentifier languageIdentifier = LanguageIdentification.getClient( new LanguageIdentificationOptions.Builder() .setConfidenceThreshold(0.34f) .build());
รับภาษาที่เป็นไปได้ของสตริง
หากต้องการหาค่าความเชื่อมั่นของภาษาที่มีแนวโน้มมากที่สุดของสตริง ให้รับอินสแตนซ์ LanguageIdentifier
จากนั้นส่งสตริงไปยังเมธอด identifyPossibleLanguages()
เช่น
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. // ... }
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. // ... } });
หากเรียกสำเร็จ ระบบจะส่งรายการออบเจ็กต์ IdentifiedLanguage
รายการไปยัง Listener ที่ประสบความสำเร็จ จากออบเจ็กต์แต่ละรายการ คุณสามารถดูรหัส BCP-47 ของภาษาและความเชื่อมั่นว่าสตริงอยู่ในภาษานั้น โปรดทราบว่าค่าเหล่านี้บ่งบอกถึงความมั่นใจว่าสตริงทั้งหมดอยู่ในภาษาที่ระบุ ML Kit ไม่ได้ระบุหลายภาษาในสตริงเดียว
โดยค่าเริ่มต้น ML Kit จะแสดงผลเฉพาะภาษาที่มีค่าความเชื่อมั่นอย่างน้อย 0.01 คุณเปลี่ยนเกณฑ์นี้ได้โดยการส่งออบเจ็กต์ LanguageIdentificationOptions
ไปยัง getClient()
:
Kotlin
val languageIdentifier = LanguageIdentification .getClient(LanguageIdentificationOptions.Builder() .setConfidenceThreshold(0.5f) .build())
Java
LanguageIdentifier languageIdentifier = LanguageIdentification.getClient( new LanguageIdentificationOptions.Builder() .setConfidenceThreshold(0.5f) .build());
หากไม่มีภาษาที่ตรงกับเกณฑ์นี้ รายการจะมี 1 รายการที่มีค่า und