फ़ोरग्राउंड सेवा के टाइप

Android 14 (एपीआई लेवल 34) से, आपको हर फ़ोरग्राउंड सेवा के लिए, सेवा के सही टाइप का एलान करना होगा. इसका मतलब है कि आपको अपने ऐप्लिकेशन मेनिफ़ेस्ट में सेवा के टाइप के बारे में बताना होगा. साथ ही, उस टाइप के लिए फ़ोरग्राउंड सेवा की सही अनुमति का अनुरोध करना होगा. इसके अलावा, आपको FOREGROUND_SERVICE अनुमति का अनुरोध भी करना होगा. इसके अलावा, फ़ोरग्राउंड सेवा के टाइप के आधार पर, आपको सेवा लॉन्च करने से पहले रनटाइम की अनुमतियों का अनुरोध करना पड़ सकता है.

ध्यान दें: कई मामलों में, किसी खास तरह की फ़ोरग्राउंड सेवा बनाने के बजाय, खास मकसद के लिए बनाए गए एपीआई इस्तेमाल किए जा सकते हैं. जब किसी खास मकसद के लिए बनाए गए एपीआई उपलब्ध होते हैं, तो आम तौर पर फ़ोरग्राउंड सेवा बनाने के बजाय उनका इस्तेमाल करना बेहतर विकल्प होता है. इन एपीआई को फ़ोरग्राउंड सेवा के सही टाइप के हिसाब से, विकल्प सेक्शन में लिस्ट किया गया है.

कैमरा

android:foregroundServiceType के तहत, मेनिफ़ेस्ट में फ़ोरग्राउंड सेवा के टाइप की जानकारी दें

camera

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_CAMERA

startForeground() को पास करने के लिए कॉन्सटेंट

FOREGROUND_SERVICE_TYPE_CAMERA

रनटाइम की ज़रूरी शर्तें

CAMERA रनटाइम की अनुमति का अनुरोध करना और उसे पाना

ध्यान दें: CAMERA रनटाइम की अनुमति, इस्तेमाल के दौरान लागू होने वाली पाबंदियों के दायरे में आती है. इस वजह से, ऐप्लिकेशन के बैकग्राउंड में होने पर, camera फ़ोरग्राउंड सेवा नहीं बनाई जा सकती. साथ ही, BOOT_COMPLETED रिसीवर से camera फ़ोरग्राउंड सेवा लॉन्च नहीं की जा सकती. हालांकि, कुछ मामलों में ऐसा किया जा सकता है. ज़्यादा जानकारी के लिए, इस्तेमाल के दौरान अनुमतियों की ज़रूरत वाली फ़ोरग्राउंड सेवाओं को शुरू करने से जुड़ी पाबंदियां लेख पढ़ें.

ब्यौरा

इसका इस्तेमाल करके, बैकग्राउंड में कैमरे को ऐक्सेस करना जारी रखा जा सकता है. जैसे, ऐसे वीडियो चैट ऐप्लिकेशन जो मल्टीटास्किंग (एक साथ कई काम करना) की सुविधा देते हैं.

कनेक्ट किया गया डिवाइस

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

connectedDevice

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_CONNECTED_DEVICE

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE

रनटाइम की ज़रूरी शर्तें

इनमें से कम से कम एक शर्त पूरी होनी चाहिए:

• अपने मेनिफ़ेस्ट में, इनमें से कम से कम एक अनुमति का एलान करें:

  • CHANGE_NETWORK_STATE
  • CHANGE_WIFI_STATE
  • CHANGE_WIFI_MULTICAST_STATE
  • NFC
  • TRANSMIT_IR

• इनमें से कम से कम एक रनटाइम अनुमति का अनुरोध करें और उसे मंज़ूरी पाएं:

  • BLUETOOTH_CONNECT
  • BLUETOOTH_ADVERTISE
  • BLUETOOTH_SCAN
  • UWB_RANGING

• UsbManager.requestPermission() को कॉल करें

ब्यौरा

बाहरी डिवाइसों के साथ इंटरैक्शन, जिनके लिए ब्लूटूथ, एनएफ़सी, आईआर, यूएसबी या इंटरनेट की ज़रूरत होती है.

ध्यान दें: अगर आपका ऐप्लिकेशन प्रोजेक्शन या रिमोट मैसेजिंग की सुविधा देता है, तो इसके लिए मीडिया प्रोजेक्शन या रिमोट मैसेजिंग टाइप का इस्तेमाल करें.

विकल्प

अगर आपके ऐप्लिकेशन को किसी बाहरी डिवाइस पर लगातार डेटा ट्रांसफ़र करना है, तो इसके बजाय साथी डिवाइस मैनेजर का इस्तेमाल करें. साथी डिवाइस के मौजूद होने की जानकारी देने वाले एपीआई का इस्तेमाल करें, ताकि साथी डिवाइस की रेंज में रहने पर आपका ऐप्लिकेशन चालू रहे.

अगर आपके ऐप्लिकेशन को ब्लूटूथ डिवाइसों को स्कैन करना है, तो इसके बजाय ब्लूटूथ स्कैन एपीआई का इस्तेमाल करें.

डेटा सिंक करना

मेनिफ़ेस्ट में, फ़ोरग्राउंड सेवा के टाइप का एलान करने के लिए, इस एट्रिब्यूट का इस्तेमाल करें

android:foregroundServiceType

dataSync

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_DATA_SYNC

startForeground() को पास करने के लिए कॉन्सटेंट

FOREGROUND_SERVICE_TYPE_DATA_SYNC

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

डेटा ट्रांसफ़र करने से जुड़े ऑपरेशन, जैसे कि:

• डेटा अपलोड या डाउनलोड करना
• बैकअप लेने और डेटा वापस पाने की कार्रवाइयां
• इंपोर्ट या एक्सपोर्ट से जुड़े काम
• डेटा फ़ेच करना
• फ़ाइल को स्थानीय तौर पर प्रोसेस करना
• किसी नेटवर्क पर, डिवाइस और क्लाउड के बीच डेटा ट्रांसफ़र करना

ध्यान दें: Android 15 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन, BOOT_COMPLETED ब्रॉडकास्ट रिसीवर से डेटा सिंक करने वाली फ़ोरग्राउंड सेवा लॉन्च नहीं कर सकते. ज़्यादा जानकारी के लिए, फ़ोरग्राउंड सेवाओं को लॉन्च करने वाले BOOT_COMPLETED ब्रॉडकास्ट रिसीवर पर पाबंदियां लेख पढ़ें.

विकल्प

ज़्यादा जानकारी के लिए, डेटा सिंक करने वाली फ़ोरग्राउंड सेवाओं के विकल्प देखें.

स्वास्थ्य

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

health

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_HEALTH

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_HEALTH

रनटाइम की ज़रूरी शर्तें

इनमें से कम से कम एक शर्त पूरी होनी चाहिए:

• अपने मेनिफ़ेस्ट में HIGH_SAMPLING_RATE_SENSORS की अनुमति का एलान करें.

• इनमें से कम से कम एक रनटाइम अनुमति का अनुरोध करें और उसे मंज़ूरी पाएं:

  • एपीआई 35 और इससे पहले के वर्शन पर BODY_SENSORS
  • READ_HEART_RATE
  • READ_SKIN_TEMPERATURE
  • READ_OXYGEN_SATURATION
  • ACTIVITY_RECOGNITION

ध्यान दें: BODY_SENSORS और सेंसर पर आधारित, पढ़ने की रनटाइम अनुमतियों पर, इस्तेमाल के दौरान लागू होने वाली पाबंदियां लागू होती हैं. इस वजह से, जब आपका ऐप्लिकेशन बैकग्राउंड में हो, तब health फ़ोरग्राउंड सेवा का इस्तेमाल नहीं किया जा सकता. ऐसा तब तक नहीं किया जा सकता, जब तक आपको BODY_SENSORS_BACKGROUND (एपीआई लेवल 33 से एपीआई लेवल 35 के बीच) या READ_HEALTH_DATA_IN_BACKGROUND (एपीआई लेवल 36) की अनुमतियां नहीं मिल जातीं. ज़्यादा जानकारी के लिए, ऐसी फ़ोरग्राउंड सेवाएं शुरू करने पर लगी पाबंदियां जिनके लिए इस्तेमाल के दौरान अनुमतियों की ज़रूरत होती है देखें.

ब्यौरा

फ़िटनेस कैटगरी के ऐप्लिकेशन के साथ काम करने के लिए, लंबे समय से इस्तेमाल किए जा रहे उदाहरण. जैसे, कसरत ट्रैकर.

जगह

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

location

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_LOCATION

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_LOCATION

रनटाइम की ज़रूरी शर्तें

उपयोगकर्ता ने जगह की जानकारी की सेवाएं चालू की हों और ऐप्लिकेशन को इनमें से कम से कम एक रनटाइम अनुमति दी गई हो:

• ACCESS_COARSE_LOCATION
• ACCESS_FINE_LOCATION

ध्यान दें: यह देखने के लिए कि उपयोगकर्ता ने जगह की जानकारी की सेवाओं को चालू किया है या नहीं और साथ ही, रनटाइम की अनुमतियों का ऐक्सेस दिया है या नहीं, PermissionChecker#checkSelfPermission() का इस्तेमाल करें

ध्यान दें: जगह की जानकारी की रनटाइम अनुमतियां, इस्तेमाल के दौरान लागू होने वाली पाबंदियों के दायरे में आती हैं. इस वजह से, जब आपका ऐप्लिकेशन बैकग्राउंड में हो, तब location फ़ोरग्राउंड सेवा नहीं बनाई जा सकती. ऐसा तब तक नहीं किया जा सकता, जब तक आपको ACCESS_BACKGROUND_LOCATION रनटाइम की अनुमति न मिल जाए. ज़्यादा जानकारी के लिए, ऐसी फ़ोरग्राउंड सेवाओं को शुरू करने से जुड़ी पाबंदियां जिनके लिए इस्तेमाल के दौरान अनुमतियों की ज़रूरत होती है देखें.

ब्यौरा

लंबे समय तक चलने वाले ऐसे इस्तेमाल के उदाहरण जिनके लिए जगह की जानकारी का ऐक्सेस ज़रूरी है. जैसे, नेविगेशन और जगह की जानकारी शेयर करना.

विकल्प

अगर उपयोगकर्ता किसी खास जगह पर पहुंचने पर आपके ऐप्लिकेशन को ट्रिगर करना है, तो इसके बजाय geofence API का इस्तेमाल करें.

मीडिया

मेनिफ़ेस्ट में, फ़ोरग्राउंड सेवा के टाइप का एलान करने के लिए, इस एट्रिब्यूट का इस्तेमाल करें

android:foregroundServiceType

mediaPlayback

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_MEDIA_PLAYBACK

startForeground() को पास करने के लिए कॉन्सटेंट

FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

इसका इस्तेमाल करके, कोई भी ऑडियो या वीडियो बैकग्राउंड में चलाया जा सकता है. Android TV पर डिजिटल वीडियो रिकॉर्डिंग (डीवीआर) की सुविधा उपलब्ध कराना.

ध्यान दें: Android 15 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन, BOOT_COMPLETED ब्रॉडकास्ट रिसीवर से मीडिया प्लेबैक की फ़ोरग्राउंड सेवा लॉन्च नहीं कर सकते. ज़्यादा जानकारी के लिए, फ़ोरग्राउंड सेवाओं को लॉन्च करने वाले BOOT_COMPLETED ब्रॉडकास्ट रिसीवर पर पाबंदियां लेख पढ़ें.

विकल्प

अगर आपको पिक्चर में पिक्चर वीडियो दिखाना है, तो पिक्चर में पिक्चर मोड का इस्तेमाल करें.

मीडिया प्रोसेस करना

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

mediaProcessing

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_MEDIA_PROCESSING

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

मीडिया ऐसेट पर ज़्यादा समय लेने वाले काम करने की सेवा. जैसे, मीडिया को अलग-अलग फ़ॉर्मैट में बदलना. सिस्टम इस सेवा को सीमित समय के लिए चलाने की अनुमति देता है. आम तौर पर, यह समयसीमा हर 24 घंटे में 6 घंटे की होती है. (यह सीमा, ऐप्लिकेशन की सभी mediaProcessing फ़ोरग्राउंड सेवाओं के लिए लागू होती है.)

आपके ऐप्लिकेशन को मीडिया प्रोसेसिंग सेवा को मैन्युअल तरीके से बंद करना चाहिए, अगर:

• ट्रांसकोडिंग की प्रोसेस पूरी होने या गड़बड़ी की स्थिति में पहुंचने पर, सेवा को पूरी तरह से बंद करने के लिए, सेवा को Service.stopForeground() और Service.stopSelf() पर कॉल करने दें.

टाइम आउट की अवधि खत्म होने पर, सिस्टम सेवा के Service.onTimeout(int, int) तरीके को कॉल करता है. इस समय, सेवा के पास Service.stopSelf() को कॉल करने के लिए कुछ सेकंड होते हैं. अगर सेवा Service.stopSelf() को कॉल नहीं करती है, तो इस गड़बड़ी के मैसेज के साथ ANR होगा: "<fgs_type> की फ़ोरग्राउंड सेवा, तय समयसीमा में नहीं रुकी: <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 将内容投影到非主要显示屏或外部设备。这些内容不必全都为媒体内容。

注意： 以 Android 15 或更高版本为目标平台的应用不得从 BOOT_COMPLETED 广播接收器启动媒体投影前台服务。如需了解详情，请参阅关于 BOOT_COMPLETED 广播接收器启动前台服务的限制。

替代方案

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

माइक्रोफ़ोन

मेनिफ़ेस्ट में, फ़ोरग्राउंड सेवा के टाइप का एलान करने के लिए, इस एट्रिब्यूट का इस्तेमाल करें

android:foregroundServiceType

microphone

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_MICROPHONE

startForeground() को पास करने के लिए कॉन्सटेंट

FOREGROUND_SERVICE_TYPE_MICROPHONE

रनटाइम की ज़रूरी शर्तें

RECORD_AUDIO रनटाइम की अनुमति का अनुरोध करना और उसे पाना.

ध्यान दें: RECORD_AUDIO रनटाइम की अनुमति, इस्तेमाल के दौरान लागू होने वाली पाबंदियों के दायरे में आती है. इस वजह से, ऐप्लिकेशन के बैकग्राउंड में होने पर, microphone फ़ोरग्राउंड सेवा नहीं बनाई जा सकती. साथ ही, BOOT_COMPLETED रिसीवर से microphone फ़ोरग्राउंड सेवा लॉन्च नहीं की जा सकती. हालांकि, कुछ मामलों में ऐसा किया जा सकता है. ज़्यादा जानकारी के लिए, इस्तेमाल के दौरान अनुमतियों की ज़रूरत वाली फ़ोरग्राउंड सेवाओं को शुरू करने से जुड़ी पाबंदियां लेख पढ़ें.

ब्यौरा

इसका इस्तेमाल करके, बैकग्राउंड में माइक्रोफ़ोन से ऑडियो कैप्चर करना जारी रखा जा सकता है. जैसे, आवाज़ की रिकॉर्डिंग या बातचीत के लिए इस्तेमाल होने वाले ऐप्लिकेशन.

फ़ोन कॉल

मेनिफ़ेस्ट में, फ़ोरग्राउंड सेवा के टाइप का एलान करने के लिए, इस एट्रिब्यूट का इस्तेमाल करें

android:foregroundServiceType

phoneCall

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_PHONE_CALL

startForeground() को पास करने के लिए कॉन्सटेंट

FOREGROUND_SERVICE_TYPE_PHONE_CALL

रनटाइम की ज़रूरी शर्तें

इनमें से कम से कम एक शर्त पूरी होनी चाहिए:

• ऐप्लिकेशन ने अपनी मेनिफ़ेस्ट फ़ाइल में, MANAGE_OWN_CALLS अनुमति का एलान किया है.

• ऐप्लिकेशन, ROLE_DIALER भूमिका के ज़रिए डिफ़ॉल्ट डायलर ऐप्लिकेशन के तौर पर सेट है.

ध्यान दें: Android 15 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन, BOOT_COMPLETED ब्रॉडकास्ट रिसीवर से फ़ोन कॉल की फ़ोरग्राउंड सेवा लॉन्च नहीं कर सकते. ज़्यादा जानकारी के लिए, फ़ोरग्राउंड सेवाओं को लॉन्च करने वाले BOOT_COMPLETED ब्रॉडकास्ट रिसीवर पर पाबंदियां लेख पढ़ें.

ब्यौरा

ConnectionService एपीआई का इस्तेमाल करके, चल रहे कॉल को जारी रखना.

विकल्प

अगर आपको फ़ोन, वीडियो या वीओआईपी कॉल करने हैं, तो android.telecom लाइब्रेरी का इस्तेमाल करें.

कॉल स्क्रीन करने के लिए, CallScreeningService का इस्तेमाल करें.

रिमोट मैसेज सेवा

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

remoteMessaging

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

FOREGROUND_SERVICE_REMOTE_MESSAGING

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

मैसेज को एक डिवाइस से दूसरे डिवाइस पर ट्रांसफ़र करना. जब उपयोगकर्ता एक डिवाइस पर किसी बातचीत को अधूरा छोड़कर किसी अन्य डिवाइस से मैसेज करने लगता है, तो इस सेवा की मदद से बातचीत वहीं से शुरू की जा सकती है जहां पर उपयोगकर्ता ने छोड़ी थी.

कम समय में होने वाली सेवा

मेनिफ़ेस्ट में जाकर, फ़ोरग्राउंड सेवा के टाइप की जानकारी दें. इसके लिए,

android:foregroundServiceType

shortService

अपने मेनिफ़ेस्ट में एलान करने की अनुमति

कोई नहीं

startForeground() को पास करने के लिए कॉन्स्टेंट

FOREGROUND_SERVICE_TYPE_SHORT_SERVICE

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

ज़रूरी काम को जल्दी से पूरा करना, जिसमें रुकावट नहीं आनी चाहिए या जिसे बाद में नहीं किया जा सकता.

इस टाइप की कुछ खास विशेषताएं हैं:

• यह सिर्फ़ कुछ समय (लगभग तीन मिनट) के लिए चल सकता है.
• स्टिकी फ़ोरग्राउंड सेवाओं के साथ काम नहीं करता.
• अन्य फ़ोरग्राउंड सेवाएं शुरू नहीं की जा सकतीं.
• इसके लिए, टाइप के हिसाब से अनुमति की ज़रूरत नहीं होती. हालांकि, इसके लिए 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() कॉलबैक को लागू करना सबसे सही तरीका माना जाता है.

Service.onTimeout() कॉलबैक की सुविधा, Android 13 और इससे पहले के वर्शन पर उपलब्ध नहीं है. अगर यही सेवा ऐसे डिवाइसों पर चलती है, तो उसे टाइम आउट नहीं मिलता और न ही ANR होता है. पक्का करें कि प्रोसेस करने का टास्क पूरा होने के बाद, आपकी सेवा बंद हो जाए. भले ही, उसे अब तक Service.onTimeout() कॉलबैक न मिला हो.

यह ध्यान रखना ज़रूरी है कि अगर shortService के टाइम आउट का पालन नहीं किया जाता है, तो ऐप्लिकेशन में ANR की गड़बड़ी दिखेगी. भले ही, उसमें कोई दूसरी मान्य फ़ोरग्राउंड सेवाएं या ऐप्लिकेशन लाइफ़साइकल की अन्य प्रोसेस चल रही हों.

अगर कोई ऐप्लिकेशन उपयोगकर्ता को दिख रहा है या वह छूट की उन शर्तों में से किसी एक को पूरा करता है जिनकी वजह से फ़ोरग्राउंड सेवाओं को बैकग्राउंड से शुरू किया जा सकता है, तो FOREGROUND_SERVICE_TYPE_SHORT_SERVICE पैरामीटर के साथ फिर से Service.StartForeground() को कॉल करने पर, टाइम आउट को तीन मिनट और बढ़ा दिया जाता है. अगर ऐप्लिकेशन, उपयोगकर्ता को नहीं दिख रहा है और वह छूट की किसी शर्त को पूरा नहीं करता है, तो किसी भी तरह की फ़ोरग्राउंड सेवा शुरू करने की कोशिश करने पर, 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> एलिमेंट. ये वैल्यू और उनके इस्तेमाल के उदाहरण ये हैं की समीक्षा की जाती है. इस्तेमाल आपकी ओर से दिए जाने वाले केस फ़्री-फ़ॉर्म हैं. साथ ही, आपको यह पक्का करना चाहिए कि जानकारी दें, ताकि समीक्षक यह देख सकें कि आपको 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

रनटाइम की ज़रूरी शर्तें

कोई नहीं

ब्यौरा

यह सिस्टम ऐप्लिकेशन और सिस्टम के कुछ इंटिग्रेशन के लिए रिज़र्व है, ताकि वे फ़ोरग्राउंड सेवाओं का इस्तेमाल जारी रख सकें.

इस टाइप का इस्तेमाल करने के लिए, ऐप्लिकेशन को इनमें से कम से कम एक शर्त पूरी करनी होगी:

• डिवाइस डेमो मोड में है
• ऐप्लिकेशन, डिवाइस का मालिक है
• ऐप्लिकेशन, प्रोफ़ाइलर का मालिक है
• ROLE_EMERGENCY की भूमिका वाले Safety ऐप्लिकेशन
• डिवाइस एडमिन ऐप्लिकेशन
• SCHEDULE_EXACT_ALARM या USE_EXACT_ALARM अनुमति वाले ऐप्लिकेशन

• वीपीएन ऐप्लिकेशन (सेटिंग > नेटवर्क और इंटरनेट > वीपीएन का इस्तेमाल करके कॉन्फ़िगर किए गए)

  ऐसा न करने पर, सिस्टम ForegroundServiceTypeNotAllowedException दिखाएगा.

फ़ोरग्राउंड सेवाओं के टाइप इस्तेमाल करने के लिए, Google Play की नीति लागू करना

अगर आपका ऐप्लिकेशन Android 14 या उसके बाद के वर्शन को टारगेट करता है, तो आपको Play Console के ऐप्लिकेशन कॉन्टेंट पेज (नीति > ऐप्लिकेशन कॉन्टेंट) पर, अपने ऐप्लिकेशन की फ़ोरग्राउंड सेवाओं के टाइप का एलान करना होगा. Play Console में फ़ोरग्राउंड सेवा के टाइप की जानकारी देने के तरीके के बारे में ज़्यादा जानने के लिए, फ़ोरग्राउंड सेवा और फ़ुल-स्क्रीन इंटेंट की ज़रूरी शर्तों के बारे में जानकारी देखें.