ปัญหาที่ทราบ

ปัญหาเกี่ยวกับ Android

  • ใน com.google.mlkit:genai-prompt:1.0.0-beta3 และ com.google.mlkit:genai-prompt:1.0.0-beta4 การเรียกใช้การอนุมานด้วยการแคชคำนำหน้าจะล้มเหลวในโมเดล nano-v4 เมื่อตั้งค่า ModelConfig เป็น ModelPreference.FAST วิธีแก้ปัญหาเบื้องต้นคือละเว้นการตั้งค่า ModelConfig เพื่อใช้การกำหนดค่าเริ่มต้นจนกว่าเราจะเผยแพร่การแก้ไขในเวอร์ชันถัดไป
  • ใน com.google.mlkit:genai-prompt:1.0.0-beta3 การเรียก checkStatus() ในอุปกรณ์ที่ไม่ใช่ Pixel จะแสดง GenAiException ที่ไม่ได้จัดการ ให้ใช้เวอร์ชันที่ใหม่กว่า (com.google.mlkit:genai-prompt:1.0.0-beta4 ขึ้นไป)
  • สําหรับ Language ID ที่รวมไว้ แอปอาจหยุดทํางานเมื่ออัปเกรดเป็น AGP 7.0.0 ขึ้นไป หากต้องการหลีกเลี่ยงการหยุดทํางานใน com.google.mlkit:language-id:16.1.1 หรือเวอร์ชันก่อนหน้า ให้ใส่กฎด้านล่าง
    -keep class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni { *; }
    หากต้องการหลีกเลี่ยงการหยุดทํางานใน com.google.mlkit:language-id:17.0.0 หรือ com.google.mlkit:language-id:17.0.1 ให้ใส่กฎด้านล่าง
    -keep class com.google.mlkit.nl.languageid.internal.ThickLanguageIdentifier { *; }
  • InputImage ที่สร้างโดย Bitmap ที่มี rotationDegrees ที่ไม่ใช่ 0 จะทําให้เกิด MlKitException "การหมุนไม่ถูกต้อง" สําหรับ FaceDetection API ตั้งแต่ com.google.mlkit:face-detection:16.0.5 และ com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.4 โปรดใช้เวอร์ชันก่อนหน้าและรอเวอร์ชันถัดไปของเราซึ่งมีการแก้ไขปัญหานี้
  • BarcodeScanning SDK เวอร์ชันก่อน com.google.mlkit:barcode-scanning:16.1.0 และ com.google.android.gms:play-services-mlkit-barcode-scanning:16.1.3 จะไม่ทํางานในอุปกรณ์บางรุ่นที่ใช้ camera-camera2:1.0.0-beta08 ขึ้นไป คุณสามารถใช้ camera-camera2 เวอร์ชันก่อนหน้าเพื่อข้ามปัญหานี้ได้ เช่น

    implementation "androidx.camera:camera-core:1.0.0-beta07"
    implementation "androidx.camera:camera-camera2:1.0.0-beta07"
    implementation "androidx.camera:camera-view:1.0.0-alpha14"
    implementation "androidx.camera:camera-extensions:1.0.0-alpha14"
    implementation "androidx.camera:camera-lifecycle:1.0.0-beta07"

  • วิธีการดั้งเดิมอาจถูกทำให้สับสนโดยกฎที่กำหนดเองใน com.google.mlkit:language-id:16.1.1 หรือเวอร์ชันก่อนหน้า ใส่กฎต่อไปนี้เพื่อเก็บไว้หากพบข้อผิดพลาด เช่น java.lang.UnsatisfiedLinkError

    -keepclasseswithmembernames class com.google.mlkit.nl.languageid.internal.LanguageIdentificationJni {
      native <methods>;
    }

  • สําหรับ Text Recognition, Image Labeling และ Object Detection and Tracking API ประสิทธิภาพการทํางานกับ CameraX และ Camera2 ยังไม่เทียบเท่ากับ Camera1 เนื่องจากต้องใช้เวลามากขึ้นในการแปลงรูปแบบสําหรับรูปภาพจาก CameraX และ Camera2

  • การเรียกกลับของงาน อาจทํางานหลังจากที่ Activity หรือ Fragment ที่ลงทะเบียนไว้ถูกทําลายแล้ว ซึ่งอาจทําให้เกิดข้อยกเว้นหากการเรียกกลับพยายามเข้าถึงเครื่องตรวจจับที่ปิดไปแล้ว หากคุณ ใช้ ML Kit ใน Activity คุณสามารถลงทะเบียน Listener ที่มีขอบเขตเป็น Activity ซึ่งจะถูกนําออกโดยอัตโนมัติเมื่อ Activity หยุดทํางาน หากคุณใช้ ML Kit ใน Fragment หรือสภาพแวดล้อมอื่นๆ คุณสามารถระบุ Executor ที่กําหนดเองซึ่งจะหยุดการทํางานเมื่อ Fragment ถูกทําลาย ดูตัวอย่างได้ที่ ScopedExecutor.Java ใน Vision Quickstart

  • สําหรับ Image Labeling ที่มีรูปแบบรูปภาพนอกเหนือจาก Bitmap เวอร์ชันที่รวมไว้จะมีประสิทธิภาพดีกว่าเวอร์ชัน "บาง" ที่ขึ้นอยู่กับบริการ Google Play

  • สําหรับ Digital Ink com.google.mlkit:digital-ink-recognition:17.0.0 หรือเวอร์ชันก่อนหน้า และ Entity Extraction com.google.mlkit:entity-extraction:16.0.0-beta2 หรือเวอร์ชันก่อนหน้า คุณจะได้รับข้อยกเว้นรันไทม์ต่อไปนี้หากตั้งค่า targetSdkVersion เป็น 31 และเรียกใช้ใน Android S

    Targeting S+ (version 31 and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE be specified when creating a PendingIntent.
    AndroidRuntime: Strongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles.
    
    ปัญหานี้ได้รับการแก้ไขแล้วในเวอร์ชันล่าสุด

    หากต้องการใช้เวอร์ชันเก่า คุณสามารถตั้งค่า targetSdkVersion เป็นน้อยกว่า 31 หรือเพิ่มโค้ดต่อไปนี้ลงใน build.gradle เป็นวิธีแก้ปัญหาเบื้องต้น

    // For apps targeting Android S+, add the following
    constraints {
      implementation 'androidx.work:work-runtime:2.7.0-alpha04'
    }

ปัญหาเกี่ยวกับ iOS

  • ไม่รองรับโปรแกรมจำลองใน Mac ที่ใช้ M1
  • ไม่รองรับโปรแกรมจำลอง X86_64 สําหรับ Translation 'GoogleMLKit/Translate', '4.0.0' ขึ้นไป และ Smart Reply 'GoogleMLKit/SmartReply', '4.0.0' ขึ้นไป