หากแอปกำหนดเป้าหมายเป็น Android 15 ขึ้นไป ระบบจะจำกัดระยะเวลาที่อนุญาตให้บริการที่ทำงานอยู่เบื้องหน้าบางรายการทำงานขณะที่แอปทำงานอยู่เบื้องหลัง ปัจจุบันข้อจำกัดนี้มีผลกับบริการที่ทำงานอยู่เบื้องหน้าของ dataSync และmediaProcessing เท่านั้น shortService ประเภทบริการที่ทำงานอยู่เบื้องหน้ามีข้อจำกัดที่เข้มงวดกว่า ซึ่งจะกล่าวถึงในเอกสารประกอบของประเภทบริการนั้น
ลักษณะการหมดเวลา
ระบบอนุญาตให้บริการที่ทำงานอยู่เบื้องหน้า dataSync และ mediaProcessing ทำงานได้ทั้งหมด 6 ชั่วโมงในระยะเวลา 24 ชั่วโมง หลังจากนั้นระบบจะเรียกใช้เมธอด Service.onTimeout(int, int) ของบริการที่ทำงานอยู่ (เปิดตัวใน Android 15) (เพิ่มประเภทบริการที่ทำงานอยู่เบื้องหน้า mediaProcessing ใน Android 15) ขีดจำกัดเวลา 6 ชั่วโมงจะมีการติดตามแยกกันสำหรับ dataSync และ mediaProcessing บริการ ตัวอย่างเช่น หากบริการ dataSync ทำงานไปเพียง 1 ชั่วโมง แอปจะมีเวลาให้บริการ dataSync ที่ทำงานอยู่เบื้องหน้าเพียง 5 ชั่วโมง แต่จะมีเวลาให้บริการ dataSync เต็ม 6 ชั่วโมงmediaProcessing
เมื่อบริการที่ทำงานอยู่เบื้องหน้าถึงขีดจำกัด 6 ชั่วโมงแล้ว บริการจะมีเวลา 2-3 วินาทีในการเรียกใช้ Service.stopSelf() เมื่อระบบเรียกใช้ Service.onTimeout() ระบบจะไม่ถือว่าบริการเป็นบริการที่ทำงานอยู่เบื้องหน้าอีกต่อไป
หากบริการไม่ได้เรียก Service.stopSelf() ระบบจะแสดงข้อยกเว้นภายใน ระบบจะบันทึกข้อยกเว้นไว้ใน Logcat พร้อมข้อความต่อไปนี้
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type [service type] did not stop within its timeout: [component name]"
หากต้องการหลีกเลี่ยงปัญหาเกี่ยวกับการเปลี่ยนแปลงลักษณะการทํางานนี้ ให้ทําอย่างใดอย่างหนึ่งต่อไปนี้
- ขอให้บริการของคุณใช้วิธีการ
Service.onTimeout(int, int)ใหม่ เมื่อแอปได้รับการติดต่อกลับ โปรดโทรหาstopSelf()ภายในไม่กี่วินาที (หากคุณไม่หยุดแอปทันที ระบบจะสร้างสถานะ "ไม่สำเร็จ") - ตรวจสอบว่าบริการ
dataSyncและmediaProcessingของแอปทำงานไม่เกิน 6 ชั่วโมงโดยรวมในช่วง 24 ชั่วโมง (เว้นแต่ผู้ใช้จะโต้ตอบกับแอป ซึ่งจะเป็นการรีเซ็ตตัวจับเวลา) - เริ่มต้นบริการที่ทำงานอยู่เบื้องหน้า
dataSyncหรือmediaProcessingเท่านั้นจากการโต้ตอบของผู้ใช้โดยตรง เนื่องจากแอปทำงานอยู่ในเบื้องหน้าเมื่อบริการเริ่มต้นขึ้น บริการของคุณจะใช้งานได้ครบ 6 ชั่วโมงหลังจากแอปทำงานอยู่เบื้องหลัง - โปรดใช้ API อื่น เช่น WorkManager แทนบริการที่ทำงานอยู่เบื้องหน้าเหล่านี้ โดยเฉพาะอย่างยิ่ง แทนที่จะใช้บริการที่ทำงานอยู่เบื้องหน้า
dataSyncให้พิจารณาใช้ API ทางเลือก
หากบริการที่ทำงานอยู่เบื้องหน้า dataSync ของแอปทำงานเป็นเวลา 6 ชั่วโมงในช่วง 24 ชั่วโมงที่ผ่านมา คุณจะไม่สามารถเริ่มบริการที่ทำงานอยู่เบื้องหน้า dataSync อื่นได้เว้นแต่ผู้ใช้จะนำแอปของคุณไปไว้ที่เบื้องหน้า (ซึ่งจะรีเซ็ตตัวจับเวลา) หากคุณพยายามเริ่มdataSyncบริการที่ทำงานอยู่เบื้องหน้าอีกรายการ ระบบจะแสดงForegroundServiceStartNotAllowedExceptionพร้อมข้อความแสดงข้อผิดพลาด เช่น "บริการที่ทำงานอยู่เบื้องหน้าประเภท dataSync หมดเวลาแล้ว"
การทดสอบ
หากต้องการทดสอบลักษณะการทํางานของแอป คุณสามารถเปิดใช้การหมดเวลาการซิงค์ข้อมูลได้แม้ว่าแอปจะไม่กําหนดเป้าหมายเป็น Android 15 ก็ตาม (ตราบใดที่แอปทํางานบนอุปกรณ์ Android 15) หากต้องการเปิดใช้ระยะหมดเวลา ให้เรียกใช้คำสั่ง adb ต่อไปนี้
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
นอกจากนี้ คุณยังปรับระยะเวลาหมดเวลาเพื่อให้ทดสอบลักษณะการทํางานของแอปเมื่อถึงขีดจํากัดได้ง่ายขึ้นได้ด้วย หากต้องการตั้งค่าระยะเวลาหมดเวลาใหม่สําหรับdataSyncบริการที่ทำงานอยู่เบื้องหน้า ให้เรียกใช้คําสั่ง adb ต่อไปนี้
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
หากต้องการตั้งค่าระยะเวลาหมดเวลาใหม่สำหรับmediaProcessingบริการที่ทำงานอยู่เบื้องหน้า ให้เรียกใช้คำสั่งนี้
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds