החל מ-Android 14 (רמת API 34), צריך להצהיר על סוג שירות מתאים לכל שירות שפועל בחזית. כלומר, צריך להצהיר על סוג השירות במניפסט של האפליקציה, וגם לבקש את ההרשאה המתאימה לשירות שפועל בחזית לסוג הזה (בנוסף לבקשת ההרשאה FOREGROUND_SERVICE
). בנוסף, בהתאם לסוג השירות שפועל בחזית, יכול להיות שתצטרכו לבקש הרשאות בסביבת זמן הריצה לפני שתפעילו את השירות.
מצלמה
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
camera
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_CAMERA
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_CAMERA
- דרישות מוקדמות בסביבת זמן הריצה
מבקשים את הרשאת זמן הריצה
CAMERA
ומקבלים אותה- תיאור
להמשיך לגשת למצלמה מהרקע, למשל באפליקציות של וידאו צ'אט שמאפשרות לבצע כמה משימות בו-זמנית.
המכשיר המחובר
- 要在其清单中声明的前台服务类型
android:foregroundServiceType
connectedDevice
- 在清单中声明的权限
FOREGROUND_SERVICE_CONNECTED_DEVICE
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
- 运行时前提条件
必须至少满足以下其中一个条件:
在清单中至少声明以下其中一项权限:
请求并获得以下至少一项运行时权限:
- 说明
与需要蓝牙、NFC、IR、USB 或网络连接的外部设备进行互动。
- 替代方案
如果您的应用需要持续将数据传输到外部设备,请考虑改用配套设备管理器。使用配套设备在线状态 API 帮助您的应用在配套设备在范围内时保持运行。
如果您的应用需要扫描蓝牙设备,请考虑改用 Bluetooth Scanner API。
סנכרון נתונים
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
dataSync
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_DATA_SYNC
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_DATA_SYNC
- דרישות מוקדמות בסביבת זמן הריצה
- ללא
- תיאור
פעולות העברת נתונים, כמו:
- העלאה או הורדה של נתונים
- פעולות גיבוי ושחזור
- פעולות ייבוא או ייצוא
- אחזור נתונים
- עיבוד קבצים מקומי
- העברת נתונים בין מכשיר לענן דרך רשת
- אפשרויות אחרות
מידע מפורט זמין במאמר חלופות לשירותי חזית לסנכרון נתונים.
בריאות
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
health
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_HEALTH
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_HEALTH
- דרישות מוקדמות בסביבת זמן הריצה
לפחות אחד מהתנאים הבאים חייב להתקיים:
מצהירים על ההרשאה
HIGH_SAMPLING_RATE_SENSORS
במניפסט.צריך לבקש לפחות אחת מההרשאות הבאות בסביבת זמן הריצה, ולקבל אותה:
- תיאור
תרחישים לדוגמה לטווח ארוך לתמיכה באפליקציות בקטגוריית הכושר, כמו מכשירי מעקב אחר אימונים.
מיקום
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
location
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_LOCATION
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_LOCATION
- דרישות מוקדמות בסביבת זמן הריצה
המשתמש צריך להפעיל את שירותי המיקום, והאפליקציה צריכה לקבל לפחות אחת מההרשאות הבאות בסביבת זמן הריצה:
- תיאור
תרחישים לדוגמה לטווח ארוך שדורשים גישה למיקום, כמו ניווט ושיתוף מיקום.
- אפשרויות אחרות
אם אתם רוצים שהאפליקציה תופעל כשהמשתמש מגיע למיקומים ספציפיים, מומלץ להשתמש ב-Geofence API במקום ב-Location API.
מדיה
- 要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType
mediaPlayback
- 在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- 运行时前提条件
- 无
- 说明
在后台继续播放音频或视频。在 Android TV 上支持数字视频录制 (DVR) 功能。
- 替代方案
如果您要显示画中画视频,请使用画中画模式。
המדיה נמצאת בעיבוד
- Foreground service type to declare in manifest under
android:foregroundServiceType
mediaProcessing
- Permission to declare in your manifest
FOREGROUND_SERVICE_MEDIA_PROCESSING
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING
- Runtime prerequisites
- None
- Description
Service for performing time-consuming operations on media assets, like converting media to different formats. The system allows this service a limited time to run; under normal circumstances, this time limit would be 6 hours out of every 24. (This limit is shared by all of an app's
mediaProcessing
foreground services.)Your app should manually stop the media processing service in the following scenario:
- When the transcoding operation finishes or reaches a failure state, have the
service call
Service.stopForeground()
andService.stopSelf()
to stop the service completely.
- When the transcoding operation finishes or reaches a failure state, have the
service call
If the timeout period is reached, the system calls the service's
Service.onTimeout(int, int)
method. At this time, the service has a few seconds to callService.stopSelf()
. If the service does not callService.stopSelf()
, an ANR will occur with this error message: "A foreground service of <fgs_type> did not stop within its timeout: <component_name>".Note:
Service.onTimeout(int, int)
is not available on Android 14 or lower. On devices running those versions, if a media processing service reaches the timeout period, the system immediately caches the app. For this reason, your app shouldn't wait to get a timeout notification. Instead, it should terminate the foreground service or change it to a background service as soon as appropriate.
הקרנת מדיה
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
mediaProjection
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_MEDIA_PROJECTION
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
- דרישות מוקדמות בסביבת זמן הריצה
צריך לקרוא ל-method
createScreenCaptureIntent()
לפני שמפעילים את השירות שפועל בחזית. הפעולה הזו תציג למשתמש התראה על הרשאה, והמשתמש יצטרך להעניק את ההרשאה כדי שתוכלו ליצור את השירות.אחרי שיוצרים את שירות החזית, אפשר להפעיל את השיטה
MediaProjectionManager.getMediaProjection()
.- תיאור
הקרנת תוכן למסך לא ראשי או למכשיר חיצוני באמצעות ממשקי ה-API של
MediaProjection
. התוכן הזה לא חייב להיות תוכן מדיה בלבד.- אפשרויות אחרות
כדי להעביר מדיה בסטרימינג למכשיר אחר, משתמשים ב-Google Cast SDK.
מיקרופון
- Foreground service type to declare in manifest under
android:foregroundServiceType
microphone
- Permission to declare in your manifest
FOREGROUND_SERVICE_MICROPHONE
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_MICROPHONE
- Runtime prerequisites
Request and be granted the
RECORD_AUDIO
runtime permission.- Description
Continue microphone capture from the background, such as voice recorders or communication apps.
שיחת טלפון
- סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
phoneCall
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_PHONE_CALL
- קבוע להעברה אל
startForeground()
FOREGROUND_SERVICE_TYPE_PHONE_CALL
- דרישות מוקדמות בסביבת זמן הריצה
לפחות אחד מהתנאים הבאים חייב להתקיים:
- האפליקציה הצהירה על ההרשאה
MANAGE_OWN_CALLS
בקובץ המניפסט שלה.
- האפליקציה הצהירה על ההרשאה
- App היא אפליקציית החיוג שמוגדרת כברירת מחדל דרך התפקיד
ROLE_DIALER
.
- App היא אפליקציית החיוג שמוגדרת כברירת מחדל דרך התפקיד
- תיאור
המשך שיחה פעילה באמצעות ממשקי ה-API של
ConnectionService
.- אפשרויות אחרות
אם אתם צריכים להתקשר בטלפון, בשיחות וידאו או ב-VoIP, כדאי להשתמש בספרייה
android.telecom
.כדאי להשתמש ב-
CallScreeningService
כדי לסנן שיחות.
העברת הודעות מרחוק
- Foreground service type to declare in manifest under
android:foregroundServiceType
remoteMessaging
- Permission to declare in your manifest
FOREGROUND_SERVICE_REMOTE_MESSAGING
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
- Runtime prerequisites
- None
- Description
- Transfer text messages from one device to another. Assists with continuity of a user's messaging tasks when they switch devices.
שירות קצר
- 要在其清单中声明的前台服务类型
android:foregroundServiceType
shortService
- 在清单中声明的权限
- 无
- 要传递给
startForeground()
的常量 FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
- 运行时前提条件
- 无
- 说明
快速完成不可中断或推迟的关键工作。
这种类型有一些独特的特征:
- 只能持续运行一小段时间(大约 3 分钟)。
- 不支持粘性前台服务。
- 无法启动其他前台服务。
- 不需要类型专用权限,不过它仍需要
FOREGROUND_SERVICE
权限。 - 只有当应用当前有资格启动新的前台服务时,
shortService
才能更改为另一种服务类型。 - 前台服务可以随时将其类型更改为
shortService
,届时超时期限将开始。
shortService 的超时时间从调用
Service.startForeground()
开始算起。应用应在发生超时之前调用Service.stopSelf()
或Service.stopForeground()
。否则,系统会调用新的Service.onTimeout()
,让应用有机会调用stopSelf()
或stopForeground()
来停止其服务。调用
Service.onTimeout()
后的短时间内,应用会进入缓存状态,并且不再被视为处于前台,除非用户正在主动与应用互动。应用缓存一小段时间后,服务还未停止,该应用会收到 ANR 消息。ANR 消息提及FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
。出于这些原因,实现Service.onTimeout()
回调被视为一种最佳实践。Android 13 及更低版本中不存在
Service.onTimeout()
回调。如果同一服务在此类设备上运行,则不会出现超时,也不会发生 ANR。确保您的服务在完成处理任务后立即停止,即使它尚未收到Service.onTimeout()
回调也是如此。请务必注意,如果未遵循
shortService
的超时设置,即使应用还有其他有效的前台服务或其他应用生命周期进程,应用也会遇到 ANR。如果应用对用户可见,或满足允许从后台启动前台服务的某一豁免条件,则使用
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
参数再次调用Service.StartForeground()
会将超时时间再延长 3 分钟。如果应用对用户不可见且不满足其中一个豁免条件,则尝试启动其他前台服务(无论其类型如何)都会导致ForegroundServiceStartNotAllowedException
。即使用户为您的应用停用电池优化功能,仍然会受到 shortService FGS 的影响。
如果您启动包含
shortService
类型和另一个前台服务类型的前台服务,系统会忽略shortService
类型声明。不过,该服务仍必须遵守其他声明类型的前提条件。如需了解详情,请参阅前台服务文档。
שימוש מיוחד
- סוג השירות שפועל בחזית שיש להצהיר במניפסט שלו
android:foregroundServiceType
specialUse
- הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_SPECIAL_USE
- אני רוצה להעביר אל
startForeground()
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
- דרישות מוקדמות לסביבת זמן ריצה
- ללא
- תיאור
רלוונטי לכל תרחישי השימוש החוקיים בשירות שפועל בחזית, שלא נכללים על ידי הצד השני סוגי השירותים שפועלים בחזית.
בנוסף להצהרה על
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
בסוג השירות שפועל בחזית, מפתחים צריכים להצהיר על תרחישים לדוגמה . כדי לעשות זאת, הן מציינות את הרכיב<property>
שבתוך רכיב<service>
. הערכים האלה והתרחישים לדוגמה התואמים הם נבדקות כששולחים את האפליקציה אל Google Play Console. השימוש הבקשות שאתם מספקים מתבטאות בחופשיות, וצריך להקפיד לספק מספיק מידע שיאפשר לבודק לראות למה צריך להשתמש בspecialUse
מהסוג הזה.<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="explanation_for_special_use"/> </service>
פטור ממערכת
- Foreground service type to declare in manifest under
android:foregroundServiceType
systemExempted
- Permission to declare in your manifest
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
- Runtime prerequisites
- None
- Description
Reserved for system applications and specific system integrations, to continue to use foreground services.
To use this type, an app must meet at least one of the following criteria:
- Device is in demo mode state
- App is a Device Owner
- App is a Profiler Owner
- Safety Apps that have the
ROLE_EMERGENCY
role - Device Admin apps
- Apps holding
SCHEDULE_EXACT_ALARM
orUSE_EXACT_ALARM
permission VPN apps (configured using Settings > Network & Internet > VPN)
Otherwise, declaring this type causes the system to throw a
ForegroundServiceTypeNotAllowedException
.
אכיפת המדיניות של Google Play בנושא שימוש בסוגי שירותים שפועלים בחזית
אם האפליקציה שלכם מטרגטת את Android מגרסה 14 ואילך, תצטרכו להצהיר על סוגי השירותים של האפליקציה בחזית בדף 'תוכן האפליקציה' ב-Play Console (Policy (מדיניות) > App content (תוכן האפליקציה)). מידע נוסף על הצהרת סוגי השירותים שפועלים בחזית ב-Play Console זמין במאמר הסבר על שירותים שפועלים בחזית ועל הדרישות לגבי כוונות במסך מלא.