تغييرات على أنواع الخدمات التي تعمل في المقدّمة لنظام التشغيل Android 15

We are making the following changes to foreground service types with Android 15.

جارٍ معالجة الوسائط

نوع الخدمة التي تعمل في المقدّمة المطلوب تقديم بيان عنها في البيان ضمن

android:foregroundServiceType

mediaProcessing

الإذن المطلوب تضمينه في بيان التطبيق

FOREGROUND_SERVICE_MEDIA_PROCESSING

ثابت يتم تمريره إلى startForeground()

FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING

المتطلبات الأساسية لوقت التشغيل

بدون

الوصف

خدمة لتنفيذ عمليات تستغرق وقتًا طويلاً على مواد عرض الوسائط، مثل تحويل الوسائط إلى تنسيقات مختلفة يسمح النظام لهذه الخدمة بوقت محدود للعمل. وفي الظروف العادية، يكون هذا الحدّ الزمني 6 ساعات من كل 24 ساعة. (تتم مشاركة هذا الحدّ بين جميع خدمات mediaProcessing التي تعمل في المقدّمة في التطبيق).

يجب أن يوقف تطبيقك يدويًا خدمة معالجة الوسائط في السيناريو التالي:

• عند اكتمال عملية تحويل الترميز أو وصولها إلى حالة تعذُّر، اطلب من العميل الاتصال بخدمة Service.stopForeground() وService.stopSelf() لإيقاف الخدمة بالكامل.

في حال بلوغ فترة المهلة، يستدعي النظام طريقة Service.onTimeout(int, int) في الخدمة. في هذه اللحظة، تتوفّر للخدمة بضع ثواني للاتصال بالرقم Service.stopSelf(). إذا لم تطلب الخدمة Service.stopSelf()، سيحدث خطأ ANR مع ظهور رسالة الخطأ التالية: "لم يتم إيقاف الخدمة التي تعمل في المقدّمة من النوع <fgs_type> خلال مهلة الانتظار: <component_name>".

ملاحظة: لا تتوفّر Service.onTimeout(int, int) على الإصدار 14 من نظام التشغيل Android أو الإصدارات الأقدم. على الأجهزة التي تعمل بالإصدارات السابقة، إذا انتهت مهلة خدمة معالجة الوسائط، يُخزِّن النظام التطبيق في ذاكرة التخزين المؤقت على الفور. لهذا السبب، يجب ألا ينتظر تطبيقك تلقّي إشعار بانتهاء المهلة. بدلاً من ذلك، يجب إنهاء الخدمة التي تعمل في المقدّمة أو تغييرها إلى خدمة تعمل في الخلفية في أقرب وقت ممكن.

الكاميرا

Apps that target Android 15 or higher are not allowed to launch a camera foreground service from a BOOT_COMPLETED broadcast receiver. For more information, see Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services.

مزامنة البيانات

لا يُسمح للتطبيقات التي تستهدف الإصدار Android 15 أو الإصدارات الأحدث بتشغيل خدمة مزامنة بيانات تعمل في المقدّمة من مستقبل بث BOOT_COMPLETED. لمزيد من المعلومات، يُرجى الاطّلاع على القيود المفروضة على BOOT_COMPLETED أجهزة استقبال البث التي تبدأ خدمات في المقدّمة.

تشغيل الوسائط

Apps that target Android 15 or higher are not allowed to launch a media playback foreground service from a BOOT_COMPLETED broadcast receiver. For more information, see Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services.

عرض الوسائط

لا يُسمح للتطبيقات التي تستهدف الإصدار Android 15 أو الإصدارات الأحدث بتشغيل خدمة بث الوسائط التي تعمل في المقدّمة من خلال مستقبل بث BOOT_COMPLETED. لمزيد من المعلومات، يُرجى الاطّلاع على القيود المفروضة على BOOT_COMPLETED أجهزة استقبال البث التي تبدأ خدمات في المقدّمة.

الميكروفون

لا يُسمح للتطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث بتشغيل خدمة تعمل في المقدّمة للميكروفون من مستقبل بث BOOT_COMPLETED. لمزيد من المعلومات، يُرجى الاطّلاع على القيود المفروضة على BOOT_COMPLETED خدمات البث التي تبدأ خدمات في المقدّمة.

المكالمات الهاتفية

لا يُسمح للتطبيقات التي تستهدف الإصدار 15 من نظام التشغيل Android أو الإصدارات الأحدث بتشغيل خدمة تعمل في المقدّمة للمكالمات الهاتفية من مستقبل بث BOOT_COMPLETED. لمزيد من المعلومات، يُرجى الاطّلاع على القيود المفروضة على BOOT_COMPLETED أجهزة استقبال البث التي تبدأ خدمات في المقدّمة.