סוגי השירותים שפועלים בחזית

החל מ-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
דרישות מוקדמות בסביבת זמן הריצה

לפחות אחד מהתנאים הבאים חייב להתקיים:

תיאור

אינטראקציות עם מכשירים חיצוניים שדורשים חיבור Bluetooth,‏ NFC,‏ IR,‏ USB או חיבור לרשת.

אפשרויות אחרות

אם באפליקציה שלכם יש צורך לבצע העברה רציפה של נתונים למכשיר חיצוני, כדאי להשתמש במקום זאת במנהל המכשיר הנלווה. אתם יכולים להשתמש ב-companion device presence API כדי לעזור לאפליקציה להמשיך לפעול בזמן שהמכשיר הנלווה נמצא בטווח.

אם האפליקציה שלכם צריכה לסרוק מכשירי Bluetooth, כדאי להשתמש ב-Bluetooth scan 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
דרישות מוקדמות בסביבת זמן הריצה

לפחות אחד מהתנאים הבאים חייב להתקיים:

תיאור

תרחישים לדוגמה לטווח ארוך לתמיכה באפליקציות בקטגוריית הכושר, כמו מכשירי מעקב אחר אימונים.

מיקום

要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType
location
在清单中声明的权限
FOREGROUND_SERVICE_LOCATION
要传递给 startForeground() 的常量
FOREGROUND_SERVICE_TYPE_LOCATION
运行时前提条件

用户必须已启用位置信息服务，并且应用必须至少获得以下一项运行时权限：

说明

需要位置信息使用权的长时间运行的用例，例如导航和位置信息分享。

替代方案

如果您的应用需要在用户到达特定位置时触发，请考虑改用 Geofence API。

מדיה

在清单中声明的前台服务类型
android:foregroundServiceType
mediaPlayback
要在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PLAYBACK
要传递给 startForeground() 的常量
FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
运行时前提条件
无
说明

在后台继续播放音频或视频。在 Android TV 上支持数字视频录制 (DVR) 功能。

替代方案

如果您要显示画中画视频，请使用画中画模式。

המדיה נמצאת בעיבוד

סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
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 עם הודעת השגיאה הבאה: "A foreground service of <fgs_type> did not stop within its timeout: <component_name>".

הערה: השדה Service.onTimeout(int, int) לא זמין ב-Android מגרסה 14 ומטה. במכשירים עם הגרסאות האלה, אם שירות עיבוד מדיה מגיע למועד הקצוב לתפוגה, המערכת מאחסנת את האפליקציה במטמון באופן מיידי. לכן, האפליקציה לא צריכה להמתין לקבלת התראה על תפוגת הזמן. במקום זאת, היא צריכה לסיים את השירות שפועל בחזית או לשנות אותו לשירות שפועל ברקע בהקדם האפשרי.

הקרנת מדיה

在清单中声明的前台服务类型
android:foregroundServiceType
mediaProjection
要在清单中声明的权限
FOREGROUND_SERVICE_MEDIA_PROJECTION
要传递给 startForeground() 的常量
FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
运行时前提条件

在启动前台服务之前，调用 createScreenCaptureIntent() 方法。这样做会向用户显示权限通知；用户必须先授予权限，然后您才能创建服务。

创建前台服务后，您可以调用 MediaProjectionManager.getMediaProjection()。

说明

使用 MediaProjection API 将内容投影到非主要显示屏或外部设备。这些内容不必全都为媒体内容。

替代方案

如需将媒体内容流式传输到其他设备，请使用 Google Cast SDK。

מיקרופון

סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
microphone
הרשאה להצהיר במניפסט
FOREGROUND_SERVICE_MICROPHONE
קבוע שצריך להעביר אל startForeground()
FOREGROUND_SERVICE_TYPE_MICROPHONE
דרישות מוקדמות לסביבת זמן הריצה

לבקש ולקבל את ההרשאה בתחילת ההפעלה RECORD_AUDIO.

תיאור

להמשיך להקליט מהמיקרופון ברקע, למשל באפליקציות להקלטת קול או באפליקציות תקשורת.

שיחת טלפון

סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
phoneCall
הרשאה להצהיר במניפסט
FOREGROUND_SERVICE_PHONE_CALL
קבוע שצריך להעביר אל startForeground()
FOREGROUND_SERVICE_TYPE_PHONE_CALL
דרישות מוקדמות לסביבת זמן הריצה

לפחות אחד מהתנאים הבאים חייב להתקיים:

  • האפליקציה הצהירה על ההרשאה MANAGE_OWN_CALLS בקובץ המניפסט שלה.
  • האפליקציה היא חייגן ברירת המחדל באמצעות התפקיד ROLE_DIALER.
תיאור

להמשיך שיחה פעילה באמצעות ממשקי ה-API של ConnectionService.

אפשרויות אחרות

אם אתם צריכים לבצע שיחות טלפון, שיחות וידאו או שיחות VoIP, כדאי להשתמש בספרייה android.telecom.

כדאי להשתמש ב-CallScreeningService כדי לסנן שיחות.

העברת הודעות מרחוק

סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
android:foregroundServiceType
remoteMessaging
הרשאה להצהרה במניפסט
FOREGROUND_SERVICE_REMOTE_MESSAGING
קבוע להעברה אל startForeground()
FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
דרישות מוקדמות בסביבת זמן הריצה
ללא
תיאור
העברת הודעות טקסט ממכשיר אחד למכשיר אחר. מאפשרת למשתמשים להמשיך את משימות ההודעות שלהם כשהם עוברים בין מכשירים.

סרטון Shorts קצר

סוג השירות שפועל בחזית שצריך להצהיר עליו במניפסט בקטע
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. לכן, מומלץ להטמיע את פונקציית ה-callback‏ Service.onTimeout().

קריאת החזרה (call back) Service.onTimeout() לא קיימת ב-Android מגרסה 13 ומטה. אם אותו שירות פועל במכשירים כאלה, הוא לא מקבל זמן קצוב לתפוגה ולא מתרחשת בו בעיה מסוג ANR. חשוב לוודא שהשירות יפסיק לפעול ברגע שהוא יסיים את משימת העיבוד, גם אם הוא עדיין לא קיבל את הקריאה החוזרת (callback) של Service.onTimeout().

חשוב לציין שאם לא יתקיים הזמן הקצוב לתפוגה של shortService, תופיע באפליקציה שגיאת ANR גם אם פועלות בה שירותים חוקיים אחרים בחזית או תהליכים אחרים במחזור החיים של האפליקציה.

אם אפליקציה גלויה למשתמש או עומדת באחד מההחרגות שמאפשרות להפעיל שירותים שפועלים בחזית מהרקע, קריאה חוזרת ל-Service.StartForeground() עם הפרמטר FOREGROUND_SERVICE_TYPE_SHORT_SERVICE מאריכה את הזמן הקצוב לתפוגה ב-3 דקות נוספות. אם האפליקציה לא גלויה למשתמש ולא עומדת באחד מההחרגות, כל ניסיון להפעיל שירות נוסף שפועל בחזית, ללא קשר לסוג שלו, יגרום לForegroundServiceStartNotAllowedException.

אם משתמש משבית את אופטימיזציית הסוללה באפליקציה, היא עדיין מושפעת מזמן הקצאת הזמן הקצוב לתפוגה של shortService FGS.

אם מפעילים שירות שפועל בחזית שכולל את הסוג shortService וגם סוג אחר של שירות שפועל בחזית, המערכת מתעלמת מהצהרת הסוג shortService. עם זאת, השירות עדיין צריך לעמוד בדרישות המוקדמות של הסוגים האחרים שצוינו. מידע נוסף זמין במסמכי העזרה של שירותי חזית.

שימוש מיוחד

要在清单中声明的前台服务类型
android:foregroundServiceType
specialUse
在清单中声明的权限
FOREGROUND_SERVICE_SPECIAL_USE
要传递给 startForeground() 的常量
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
运行时前提条件
无
说明

涵盖其他前台服务类型未涵盖的所有有效前台服务用例。

除了声明 FOREGROUND_SERVICE_TYPE_SPECIAL_USE 前台服务类型之外，开发者还应在清单中声明用例。为此，他们会在 <service> 元素内指定 <property> 元素。这些值和相应的应用场景 。用途 您提供的案例均为自由形式，因此，您应确保提供足够的 相关信息，让审核人员了解您为何需要使用 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>

פטור על ידי המערכת

要在其清单中声明的前台服务类型
android:foregroundServiceType
systemExempted
在清单中声明的权限
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
要传递给 startForeground() 的常量
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
运行时前提条件
无
说明

为系统应用和特定系统集成预留，以便继续使用前台服务。

如需使用此类型，应用必须至少满足以下条件之一：

אכיפת המדיניות של Google Play לגבי שימוש בסוגי שירותים שפועלים בחזית

אם האפליקציה שלכם מטרגטת את Android מגרסה 14 ואילך, תצטרכו להצהיר על סוגי השירותים של האפליקציה בחזית בדף 'תוכן האפליקציה' ב-Play Console (Policy (מדיניות) > App content (תוכן האפליקציה)). מידע נוסף על הצהרת סוגי השירותים שפועלים בחזית ב-Play Console זמין במאמר הסבר על שירותים שפועלים בחזית ועל הדרישות לגבי כוונות במסך מלא.