এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ফোরগ্রাউন্ড পরিষেবার প্রকারগুলি প্রয়োজন৷

To help developers be more intentional with defining user-facing foreground services, Android 10 introduced the android:foregroundServiceType attribute within the <service> element.

If your app targets Android 14, it must specify appropriate foreground service types. As in previous versions of Android, multiple types can be combined. This list shows the foreground service types to choose from:

If a use case in your app isn't associated with any of these types, we strongly recommend that you migrate your logic to use WorkManager or user-initiated data transfer jobs.

The health, remoteMessaging, shortService, specialUse, and systemExempted types are new in Android 14.

The following code snippet provides an example of a foreground service type declaration in the manifest:

<manifest ...>
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
    <application ...>
      <service
          android:name=".MyMediaPlaybackService"
          android:foregroundServiceType="mediaPlayback"
          android:exported="false">
      </service>
    </application>
</manifest>

If an app that targets Android 14 doesn't define types for a given service in the manifest, then the system will raise MissingForegroundServiceTypeException upon calling startForeground() for that service.

ফোরগ্রাউন্ড পরিষেবার প্রকারগুলি ব্যবহার করার জন্য নতুন অনুমতি ঘোষণা করুন৷

如果以 Android 14 为目标平台的应用使用前台服务，则必须根据前台服务类型声明 Android 14 中引入的特定权限。这些权限显示在本页每种前台服务类型的预期用例和强制执行部分中标记为“您必须在清单文件中声明的权限”的部分。

所有这些权限都定义为一般权限，并默认授予。用户无法撤消这些权限。

রানটাইমে অগ্রভাগের পরিষেবার ধরন অন্তর্ভুক্ত করুন

ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করার অ্যাপ্লিকেশনগুলির জন্য সর্বোত্তম অনুশীলন হল startForeground() (androidx-core 1.12 এবং উচ্চতর সংস্করণে উপলব্ধ) এর ServiceCompat সংস্করণটি ব্যবহার করা যেখানে আপনি ফোরগ্রাউন্ড পরিষেবার প্রকারগুলির একটি বিটওয়াইজ পূর্ণসংখ্যাতে পাস করেন৷ আপনি এক বা একাধিক টাইপ মান পাস করতে বেছে নিতে পারেন।

সাধারণত, আপনি শুধুমাত্র একটি নির্দিষ্ট ব্যবহারের ক্ষেত্রে প্রয়োজনীয় ধরনের ঘোষণা করা উচিত. এটি প্রতিটি অগ্রভাগের পরিষেবা প্রকারের জন্য সিস্টেমের প্রত্যাশা পূরণ করা সহজ করে তোলে৷ যে ক্ষেত্রে একটি ফোরগ্রাউন্ড পরিষেবা একাধিক প্রকারের সাথে শুরু করা হয়, সেক্ষেত্রে ফোরগ্রাউন্ড পরিষেবাটিকে অবশ্যই সমস্ত ধরণের প্ল্যাটফর্ম প্রয়োগের প্রয়োজনীয়তা মেনে চলতে হবে।

ServiceCompat.startForeground(0, notification, FOREGROUND_SERVICE_TYPE_LOCATION)

যদি ফোরগ্রাউন্ড পরিষেবার ধরনটি কলে নির্দিষ্ট করা না থাকে, তাহলে টাইপটি ম্যানিফেস্টে সংজ্ঞায়িত মানগুলিতে ডিফল্ট হয়৷ আপনি যদি ম্যানিফেস্টে পরিষেবার ধরণটি নির্দিষ্ট না করে থাকেন, তাহলে সিস্টেমটি MissingForegroundServiceTypeException নিক্ষেপ করে।

ফোরগ্রাউন্ড পরিষেবাটি চালু করার পরে নতুন অনুমতির প্রয়োজন হলে, আপনাকে আবার startForeground() কল করতে হবে এবং নতুন পরিষেবার প্রকারগুলি যোগ করতে হবে। উদাহরণস্বরূপ, ধরুন একটি ফিটনেস অ্যাপ একটি চলমান-ট্র্যাকার পরিষেবা চালায় যার সর্বদা location তথ্য প্রয়োজন, কিন্তু media অনুমতির প্রয়োজন হতে পারে বা নাও হতে পারে। আপনাকে ম্যানিফেস্টে location এবং mediaPlayback উভয়ই ঘোষণা করতে হবে। যদি একজন ব্যবহারকারী একটি দৌড় শুরু করে এবং শুধুমাত্র তাদের অবস্থান ট্র্যাক করতে চায়, তাহলে আপনার অ্যাপকে startForeground() কল করা উচিত এবং শুধুমাত্র location পরিষেবার ধরণটি পাস করা উচিত। তারপর, ব্যবহারকারী যদি অডিও বাজানো শুরু করতে চান, তাহলে startForeground() আবার কল করুন এবং location|mediaPlayback পাস করুন।

সিস্টেম রানটাইম চেক

সিস্টেমটি ফোরগ্রাউন্ড পরিষেবার ধরনগুলির সঠিক ব্যবহারের জন্য পরীক্ষা করে এবং নিশ্চিত করে যে অ্যাপটি সঠিক রানটাইম অনুমতির জন্য অনুরোধ করেছে বা প্রয়োজনীয় API ব্যবহার করেছে৷ উদাহরণস্বরূপ, সিস্টেম আশা করে যে অ্যাপগুলি ফোরগ্রাউন্ড পরিষেবার প্রকার FOREGROUND_SERVICE_TYPE_LOCATION ব্যবহার করে ACCESS_COARSE_LOCATION বা ACCESS_FINE_LOCATION এর জন্য অনুরোধ করবে৷

এটি বোঝায় যে ব্যবহারকারীর কাছ থেকে অনুমতির অনুরোধ করার সময় এবং ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করার সময় অ্যাপগুলিকে অবশ্যই একটি নির্দিষ্ট ক্রিয়াকলাপ অনুসরণ করতে হবে৷ অ্যাপটি startForeground() কে কল করার চেষ্টা করার আগে অনুমতির অনুরোধ করতে হবে এবং মঞ্জুর করতে হবে। যে অ্যাপগুলি ফোরগ্রাউন্ড পরিষেবা শুরু হওয়ার পরে উপযুক্ত অনুমতিগুলির জন্য অনুরোধ করে তাদের অবশ্যই এই ক্রিয়াকলাপের ক্রম পরিবর্তন করতে হবে এবং ফোরগ্রাউন্ড পরিষেবা শুরু করার আগে অনুমতির অনুরোধ করতে হবে৷

সতর্কতা: যদি আপনার অ্যাপ একটি ফোরগ্রাউন্ড পরিষেবা শুরু করার জন্য সমস্ত রানটাইম প্রয়োজনীয়তা পূরণ না করে, তাহলে আপনি সেই পরিষেবাটির জন্য startForeground() কল করার পরে সিস্টেমটি একটি SecurityException নিক্ষেপ করে৷ এটি ফোরগ্রাউন্ড পরিষেবাটিকে শুরু হতে বাধা দেয়, একটি চলমান ফোরগ্রাউন্ড পরিষেবাকে ফোরগ্রাউন্ড প্রক্রিয়া অবস্থা থেকে সরানো হতে পারে এবং আপনার অ্যাপ ক্র্যাশ হতে পারে৷

প্ল্যাটফর্ম প্রয়োগের সুনির্দিষ্ট বৈশিষ্ট্যগুলি এই পৃষ্ঠার প্রতিটি ফোরগ্রাউন্ড পরিষেবা প্রকার বিভাগের জন্য উদ্দেশ্যমূলক ব্যবহারের ক্ষেত্রে এবং প্রয়োগের ক্ষেত্রে "রানটাইম প্রয়োজনীয়তা" লেবেলযুক্ত বিভাগগুলিতে প্রদর্শিত হয়।

প্রতিটি ফোরগ্রাউন্ড পরিষেবার প্রকারের জন্য উদ্দেশ্যযুক্ত ব্যবহারের ক্ষেত্রে এবং প্রয়োগ

In order to use a given foreground service type, you must declare a particular permission in your manifest file, you must fulfill specific runtime requirements, and your app must fulfill one of the intended sets of use cases for that type. The following sections explain the permission that you must declare, the runtime prerequisites, and the intended use cases for each type.

ক্যামেরা

android:foregroundServiceType অধীনে ম্যানিফেস্টে ঘোষণা করার জন্য ফোরগ্রাউন্ড পরিষেবার ধরন

camera

আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি

FOREGROUND_SERVICE_CAMERA

startForeground() এ পাস করার জন্য ধ্রুবক

FOREGROUND_SERVICE_TYPE_CAMERA

রানটাইম পূর্বশর্ত

অনুরোধ করুন এবং CAMERA রানটাইম অনুমতি মঞ্জুর করুন৷

দ্রষ্টব্য: CAMERA রানটাইম অনুমতি ব্যবহারের সময় বিধিনিষেধ সাপেক্ষে। এই কারণে, কিছু ব্যতিক্রম ছাড়া আপনার অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন আপনি একটি camera ফোরগ্রাউন্ড পরিষেবা তৈরি করতে পারবেন না৷ আরও তথ্যের জন্য, ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করার বিধিনিষেধগুলি দেখুন যার ব্যবহারের সময় অনুমতি প্রয়োজন ৷

বর্ণনা

পটভূমি থেকে ক্যামেরা অ্যাক্সেস করা চালিয়ে যান, যেমন ভিডিও চ্যাট অ্যাপ যা মাল্টিটাস্কিংয়ের অনুমতি দেয়।

সংযুক্ত ডিভাইস

ফোরগ্রাউন্ড সার্ভিস টাইপ যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে

android:foregroundServiceType

connectedDevice

আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি

FOREGROUND_SERVICE_CONNECTED_DEVICE

startForeground() এ পাস করার জন্য ধ্রুবক

FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE

রানটাইম পূর্বশর্ত

নিম্নলিখিত শর্তগুলির মধ্যে অন্তত একটি সত্য হতে হবে:

আপনার ম্যানিফেস্টে নিম্নলিখিত অনুমতিগুলির মধ্যে অন্তত একটি ঘোষণা করুন:
অনুরোধ করুন এবং নিম্নলিখিত রানটাইম অনুমতিগুলির মধ্যে অন্তত একটি মঞ্জুর করুন:
কল UsbManager.requestPermission()

বর্ণনা

ব্লুটুথ, এনএফসি, আইআর, ইউএসবি বা নেটওয়ার্ক সংযোগের প্রয়োজন বাহ্যিক ডিভাইসগুলির সাথে মিথস্ক্রিয়া।

বিকল্প

যদি আপনার অ্যাপটিকে একটি বাহ্যিক ডিভাইসে ক্রমাগত ডেটা স্থানান্তর করতে হয়, তবে পরিবর্তে সহচর ডিভাইস ম্যানেজার ব্যবহার করার কথা বিবেচনা করুন। সহচর ডিভাইসের পরিসরে থাকাকালীন আপনার অ্যাপটি চলমান থাকতে সাহায্য করার জন্য সহচর ডিভাইস উপস্থিতি API ব্যবহার করুন৷

আপনার অ্যাপটিকে ব্লুটুথ ডিভাইসের জন্য স্ক্যান করার প্রয়োজন হলে, পরিবর্তে ব্লুটুথ স্ক্যান API ব্যবহার করার কথা বিবেচনা করুন।

ডেটা সিঙ্ক

ফোরগ্রাউন্ড সার্ভিস টাইপ যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে

android:foregroundServiceType

dataSync

আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি

FOREGROUND_SERVICE_DATA_SYNC

startForeground() এ পাস করার জন্য ধ্রুবক

FOREGROUND_SERVICE_TYPE_DATA_SYNC

রানটাইম পূর্বশর্ত

কোনোটিই নয়

বর্ণনা

ডেটা ট্রান্সফার অপারেশন, যেমন নিম্নলিখিত:

ডেটা আপলোড বা ডাউনলোড
ব্যাকআপ এবং পুনরুদ্ধার অপারেশন
আমদানি বা রপ্তানি কার্যক্রম
ডেটা আনুন
স্থানীয় ফাইল প্রক্রিয়াকরণ
একটি নেটওয়ার্কের মাধ্যমে একটি ডিভাইস এবং ক্লাউডের মধ্যে ডেটা স্থানান্তর করুন

বিকল্প

বিস্তারিত তথ্যের জন্য ডেটা সিঙ্ক ফোরগ্রাউন্ড পরিষেবাগুলির বিকল্পগুলি দেখুন৷

ফোরগ্রাউন্ড সার্ভিস টাইপ যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে

android:foregroundServiceType

dataSync

আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি

FOREGROUND_SERVICE_DATA_SYNC

startForeground() এ পাস করার জন্য ধ্রুবক

FOREGROUND_SERVICE_TYPE_DATA_SYNC

রানটাইম পূর্বশর্ত

কোনোটিই নয়

বর্ণনা

ডেটা ট্রান্সফার অপারেশন, যেমন নিম্নলিখিত:

ডেটা আপলোড বা ডাউনলোড
ব্যাকআপ এবং পুনরুদ্ধার অপারেশন
আমদানি বা রপ্তানি কার্যক্রম
ডেটা আনুন
স্থানীয় ফাইল প্রক্রিয়াকরণ
একটি নেটওয়ার্কের মাধ্যমে একটি ডিভাইস এবং ক্লাউডের মধ্যে ডেটা স্থানান্তর করুন

বিকল্প

ফোরগ্রাউন্ড সার্ভিস টাইপ যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে

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 অনুমতি ঘোষণা করুন৷
অনুরোধ করুন এবং নিম্নলিখিত রানটাইম অনুমতিগুলির মধ্যে অন্তত একটি মঞ্জুর করুন:
- BODY_SENSORS API স্তর 35 এবং তার নিচের
- READ_HEART_RATE
- READ_SKIN_TEMPERATURE
- READ_OXYGEN_SATURATION
- ACTIVITY_RECOGNITION

দ্রষ্টব্য: BODY_SENSORS এবং সেন্সর-ভিত্তিক READ রানটাইম অনুমতিগুলি ব্যবহারের সময় সীমাবদ্ধতার বিষয়। এই কারণে, আপনি এমন কোনও health অগ্রভাগ পরিষেবা তৈরি করতে পারবেন না যা আপনার অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন বডি সেন্সর ব্যবহার করে যদি না আপনাকে BODY_SENSORS_BACKGROUND (API স্তর 33 থেকে 35) বা READ_HEALTH_DATA_IN_BACKGROUND (API স্তর 36 এবং উচ্চতর) অনুমতি না দেওয়া হয়৷ আরও তথ্যের জন্য, ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করার বিধিনিষেধগুলি দেখুন যার ব্যবহারের সময় অনুমতি প্রয়োজন ৷

বর্ণনা

ব্যায়াম ট্র্যাকারের মতো ফিটনেস বিভাগে অ্যাপগুলিকে সমর্থন করার জন্য যেকোন দীর্ঘস্থায়ী ব্যবহারের ক্ষেত্রে।

অবস্থান

ফোরগ্রাউন্ড সার্ভিস টাইপ যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে

android:foregroundServiceType

location

আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি

FOREGROUND_SERVICE_LOCATION

startForeground() এ পাস করার জন্য ধ্রুবক

FOREGROUND_SERVICE_TYPE_LOCATION

রানটাইম পূর্বশর্ত

ব্যবহারকারীর অবশ্যই লোকেশন পরিষেবা সক্রিয় থাকতে হবে এবং অ্যাপটিকে অবশ্যই নিম্নলিখিত রানটাইম অনুমতিগুলির মধ্যে অন্তত একটি মঞ্জুর করতে হবে:

দ্রষ্টব্য: ব্যবহারকারী লোকেশন পরিষেবাগুলি সক্ষম করেছে এবং রানটাইম অনুমতিগুলিতে অ্যাক্সেস মঞ্জুর করেছে তা পরীক্ষা করার জন্য, PermissionChecker#checkSelfPermission() ব্যবহার করুন

দ্রষ্টব্য: অবস্থানের রানটাইম অনুমতিগুলি ব্যবহারের সময় বিধিনিষেধ সাপেক্ষে। এই কারণে, আপনার অ্যাপটি ব্যাকগ্রাউন্ডে থাকাকালীন আপনি একটি location ফোরগ্রাউন্ড পরিষেবা তৈরি করতে পারবেন না, যদি না আপনাকে ACCESS_BACKGROUND_LOCATION রানটাইম অনুমতি দেওয়া হয়৷ আরও তথ্যের জন্য, ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করার বিধিনিষেধগুলি দেখুন যার ব্যবহারের সময় অনুমতি প্রয়োজন ৷

বর্ণনা

দীর্ঘস্থায়ী ব্যবহারের ক্ষেত্রে যেখানে অবস্থান অ্যাক্সেসের প্রয়োজন হয়, যেমন নেভিগেশন এবং অবস্থান ভাগ করে নেওয়া।

বিকল্প

ব্যবহারকারী নির্দিষ্ট অবস্থানে পৌঁছালে আপনার অ্যাপটিকে ট্রিগার করার প্রয়োজন হলে, পরিবর্তে জিওফেন্স API ব্যবহার করার কথা বিবেচনা করুন।

মিডিয়া

要在清单中的以下位置声明的前台服务类型
android:foregroundServiceType: mediaPlayback
在清单中声明的权限: FOREGROUND_SERVICE_MEDIA_PLAYBACK
要传递给 startForeground() 的常量: FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
运行时前提条件: 无
说明: 在后台继续播放音频或视频。在 Android TV 上支持数字视频录制 (DVR) 功能。
替代方案: 如果您要显示画中画视频，请使用画中画模式。

মিডিয়া অভিক্ষেপ

ফোরগ্রাউন্ড পরিষেবার ধরন যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে
android:foregroundServiceType: mediaProjection
আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি: FOREGROUND_SERVICE_MEDIA_PROJECTION
startForeground() এ পাস করার জন্য ধ্রুবক: FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
রানটাইম পূর্বশর্ত: ফোরগ্রাউন্ড পরিষেবা শুরু করার আগে createScreenCaptureIntent() পদ্ধতিতে কল করুন। এটি করা ব্যবহারকারীকে একটি অনুমতি বিজ্ঞপ্তি দেখায়; আপনি পরিষেবা তৈরি করার আগে ব্যবহারকারীকে অবশ্যই অনুমতি দিতে হবে।; আপনি ফোরগ্রাউন্ড পরিষেবা তৈরি করার পরে, আপনি MediaProjectionManager.getMediaProjection() কল করতে পারেন।
বর্ণনা: MediaProjection APIs ব্যবহার করে নন-প্রাথমিক ডিসপ্লে বা বাহ্যিক ডিভাইসে প্রজেক্ট কন্টেন্ট। এই বিষয়বস্তু একচেটিয়াভাবে মিডিয়া বিষয়বস্তু হতে হবে না.
বিকল্প: অন্য ডিভাইসে মিডিয়া স্ট্রিম করতে, Google Cast SDK ব্যবহার করুন৷

ফোরগ্রাউন্ড পরিষেবার ধরন যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে
android:foregroundServiceType: mediaProjection
আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি: FOREGROUND_SERVICE_MEDIA_PROJECTION
startForeground() এ পাস করার জন্য ধ্রুবক: FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
রানটাইম পূর্বশর্ত: ফোরগ্রাউন্ড পরিষেবা শুরু করার আগে createScreenCaptureIntent() পদ্ধতিতে কল করুন। এটি করা ব্যবহারকারীকে একটি অনুমতি বিজ্ঞপ্তি দেখায়; আপনি পরিষেবা তৈরি করার আগে ব্যবহারকারীকে অবশ্যই অনুমতি দিতে হবে।; আপনি ফোরগ্রাউন্ড পরিষেবা তৈরি করার পরে, আপনি MediaProjectionManager.getMediaProjection() কল করতে পারেন।
বর্ণনা: MediaProjection APIs ব্যবহার করে নন-প্রাথমিক ডিসপ্লে বা বাহ্যিক ডিভাইসে প্রজেক্ট কন্টেন্ট। এই বিষয়বস্তু একচেটিয়াভাবে মিডিয়া বিষয়বস্তু হতে হবে না.
বিকল্প: অন্য ডিভাইসে মিডিয়া স্ট্রিম করতে, Google Cast SDK ব্যবহার করুন৷

ফোরগ্রাউন্ড পরিষেবার ধরন যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে
android:foregroundServiceType: mediaProjection
আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি: FOREGROUND_SERVICE_MEDIA_PROJECTION
startForeground() এ পাস করার জন্য ধ্রুবক: FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
রানটাইম পূর্বশর্ত: ফোরগ্রাউন্ড পরিষেবা শুরু করার আগে createScreenCaptureIntent() পদ্ধতিতে কল করুন। এটি করা ব্যবহারকারীকে একটি অনুমতি বিজ্ঞপ্তি দেখায়; আপনি পরিষেবা তৈরি করার আগে ব্যবহারকারীকে অবশ্যই অনুমতি দিতে হবে।; আপনি ফোরগ্রাউন্ড পরিষেবা তৈরি করার পরে, আপনি MediaProjectionManager.getMediaProjection() কল করতে পারেন।
বর্ণনা: MediaProjection APIs ব্যবহার করে নন-প্রাথমিক ডিসপ্লে বা বাহ্যিক ডিভাইসে প্রজেক্ট কন্টেন্ট। এই বিষয়বস্তু একচেটিয়াভাবে মিডিয়া বিষয়বস্তু হতে হবে না.
বিকল্প: অন্য ডিভাইসে মিডিয়া স্ট্রিম করতে, Google Cast SDK ব্যবহার করুন৷

ফোরগ্রাউন্ড পরিষেবার ধরন যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে
android:foregroundServiceType: mediaProjection
আপনার ম্যানিফেস্টে ঘোষণা করার অনুমতি: FOREGROUND_SERVICE_MEDIA_PROJECTION
startForeground() এ পাস করার জন্য ধ্রুবক: FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
রানটাইম পূর্বশর্ত: ফোরগ্রাউন্ড পরিষেবা শুরু করার আগে createScreenCaptureIntent() পদ্ধতিতে কল করুন। এটি করা ব্যবহারকারীকে একটি অনুমতি বিজ্ঞপ্তি দেখায়; আপনি পরিষেবা তৈরি করার আগে ব্যবহারকারীকে অবশ্যই অনুমতি দিতে হবে।; আপনি ফোরগ্রাউন্ড পরিষেবা তৈরি করার পরে, আপনি MediaProjectionManager.getMediaProjection() কল করতে পারেন।
বর্ণনা: MediaProjection APIs ব্যবহার করে নন-প্রাথমিক ডিসপ্লে বা বাহ্যিক ডিভাইসে প্রজেক্ট কন্টেন্ট। এই বিষয়বস্তু একচেটিয়াভাবে মিডিয়া বিষয়বস্তু হতে হবে না.
বিকল্প: অন্য ডিভাইসে মিডিয়া স্ট্রিম করতে, 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.

Note: The RECORD_AUDIO runtime permission is subject to while-in-use restrictions. For this reason, you cannot create a microphone foreground service while your app is in the background, with a few exceptions. For more information, see Restrictions on starting foreground services that need while-in-use permissions.

Description

Continue microphone capture from the background, such as voice recorders or communication apps.

ফোন কল

Foreground service type to declare in manifest under

android:foregroundServiceType

phoneCall

Permission to declare in your manifest

FOREGROUND_SERVICE_PHONE_CALL

Constant to pass to startForeground()

FOREGROUND_SERVICE_TYPE_PHONE_CALL

Runtime prerequisites

At least one of these conditions must be true:

App has declared the MANAGE_OWN_CALLS permission in its manifest file.

App is the default dialer app through the ROLE_DIALER role.

Description

Continue an ongoing call using the ConnectionService APIs.

Alternatives

If you need to make phone, video, or VoIP calls, consider using the android.telecom library.

Consider using CallScreeningService to screen calls.

রিমোট মেসেজিং

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 前台服务类型之外，开发者还应在清单中声明用例。为此，他们会在 <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

রানটাইম পূর্বশর্ত

কোনোটিই নয়

বর্ণনা

ফোরগ্রাউন্ড পরিষেবাগুলি ব্যবহার করা চালিয়ে যাওয়ার জন্য সিস্টেম অ্যাপ্লিকেশন এবং নির্দিষ্ট সিস্টেম ইন্টিগ্রেশনের জন্য সংরক্ষিত।

এই ধরনের ব্যবহার করার জন্য, একটি অ্যাপকে অবশ্যই নিম্নলিখিত মানদণ্ডগুলির মধ্যে একটি পূরণ করতে হবে:

ডিভাইস ডেমো মোড অবস্থায় আছে
অ্যাপটি একটি ডিভাইসের মালিক
অ্যাপ একজন প্রোফাইলার মালিক
ROLE_EMERGENCY ভূমিকা আছে এমন নিরাপত্তা অ্যাপ
ডিভাইস অ্যাডমিন অ্যাপস
SCHEDULE_EXACT_ALARM বা USE_EXACT_ALARM অনুমতি ধারণ করা অ্যাপগুলি এবং পটভূমিতে অ্যালার্ম চালিয়ে যেতে ফোরগ্রাউন্ড পরিষেবা ব্যবহার করছে, যার মধ্যে হ্যাপটিক্স-শুধু অ্যালার্ম রয়েছে৷
ভিপিএন অ্যাপস ( সেটিংস > নেটওয়ার্ক এবং ইন্টারনেট > ভিপিএন ব্যবহার করে কনফিগার করা হয়েছে)
অন্যথায়, এই ধরনের ঘোষণা করার ফলে সিস্টেম একটি ForegroundServiceTypeNotAllowedException নিক্ষেপ করে।

ফোরগ্রাউন্ড পরিষেবার প্রকারগুলি ব্যবহার করার জন্য Google Play নীতি প্রয়োগ

যদি আপনার অ্যাপটি Android 14 বা তার উচ্চতরকে টার্গেট করে, তাহলে আপনাকে Play Console-এর অ্যাপ কন্টেন্ট পৃষ্ঠায় ( নীতি > অ্যাপ সামগ্রী ) আপনার অ্যাপের ফোরগ্রাউন্ড পরিষেবার ধরন ঘোষণা করতে হবে। Play Console-এ আপনার ফোরগ্রাউন্ড পরিষেবার প্রকারগুলি কীভাবে ঘোষণা করবেন সে সম্পর্কে আরও তথ্যের জন্য, ফোরগ্রাউন্ড পরিষেবা এবং পূর্ণ-স্ক্রীনের অভিপ্রায়ের প্রয়োজনীয়তা বোঝা দেখুন।