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

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

ব্যবহারকারী-মুখী ফোরগ্রাউন্ড পরিষেবাগুলি সংজ্ঞায়িত করার সাথে বিকাশকারীদের আরও ইচ্ছাকৃত হতে সাহায্য করার জন্য, Android 10 <service> উপাদানের মধ্যে android:foregroundServiceType বৈশিষ্ট্যটি চালু করেছে।

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

যদি আপনার অ্যাপে ব্যবহারের ক্ষেত্রে এই ধরনের কোনোটির সাথে যুক্ত না থাকে, তাহলে আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি WorkManager বা ব্যবহারকারী-সূচিত ডেটা স্থানান্তর কাজগুলি ব্যবহার করতে আপনার যুক্তি স্থানান্তর করুন৷

health, remoteMessaging, shortService, specialUse এবং systemExempted প্রকারগুলি Android 14-এ নতুন।

নিম্নলিখিত কোড স্নিপেটটি ম্যানিফেস্টে একটি ফোরগ্রাউন্ড পরিষেবা প্রকার ঘোষণার একটি উদাহরণ প্রদান করে:

<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>

যদি Android 14 কে লক্ষ্য করে এমন একটি অ্যাপ ম্যানিফেস্টে একটি প্রদত্ত পরিষেবার প্রকারগুলিকে সংজ্ঞায়িত না করে, তাহলে সেই পরিষেবাটির জন্য startForeground() কল করার পরে সিস্টেমটি MissingForegroundServiceTypeException বাড়াবে৷

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

যদি 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 নিক্ষেপ করে৷ এটি ফোরগ্রাউন্ড পরিষেবাটিকে শুরু হতে বাধা দেয়, একটি চলমান ফোরগ্রাউন্ড পরিষেবাকে ফোরগ্রাউন্ড প্রক্রিয়া অবস্থা থেকে সরানো হতে পারে এবং আপনার অ্যাপ ক্র্যাশ হতে পারে৷

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

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

为了使用给定的前台服务类型，您必须在清单文件中声明特定权限，必须满足特定的运行时要求，并且应用必须满足该类型的其中一组预期用例。以下部分介绍了您必须声明的权限、运行时前提条件以及每种类型的预期用例。

ক্যামেরা

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()

注意：位置信息运行时权限受“使用期间”限制。因此，除非您已获得 ACCESS_BACKGROUND_LOCATION 运行时权限，否则无法在应用在后台运行时创建 location 前台服务。如需了解详情，请参阅与启动需要“使用时”权限的前台服务相关的限制。

说明

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

替代方案

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

মিডিয়া

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

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

ফোরগ্রাউন্ড পরিষেবার ধরন যা ম্যানিফেস্টের অধীনে ঘোষণা করতে হবে
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 ব্যবহার করুন৷

মাইক্রোফোন

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

android:foregroundServiceType

microphone

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

FOREGROUND_SERVICE_MICROPHONE

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

FOREGROUND_SERVICE_TYPE_MICROPHONE

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

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

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

বর্ণনা

পটভূমি থেকে মাইক্রোফোন ক্যাপচার চালিয়ে যান, যেমন ভয়েস রেকর্ডার বা যোগাযোগ অ্যাপ।

ফোন কল

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

android:foregroundServiceType

phoneCall

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

FOREGROUND_SERVICE_PHONE_CALL

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

FOREGROUND_SERVICE_TYPE_PHONE_CALL

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

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

অ্যাপ তার ম্যানিফেস্ট ফাইলে MANAGE_OWN_CALLS অনুমতি ঘোষণা করেছে।

অ্যাপ হল ROLE_DIALER ভূমিকার মাধ্যমে ডিফল্ট ডায়ালার অ্যাপ।

বর্ণনা

ConnectionService API ব্যবহার করে একটি চলমান কল চালিয়ে যান।

বিকল্প

আপনার যদি ফোন, ভিডিও বা ভিওআইপি কল করার প্রয়োজন হয়, তাহলে 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

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

কোনোটিই নয়

বর্ণনা

জটিল কাজ দ্রুত শেষ করুন যা বাধা বা স্থগিত করা যাবে না।

এই ধরনের কিছু অনন্য বৈশিষ্ট্য আছে:

শুধুমাত্র অল্প সময়ের জন্য চলতে পারে (প্রায় 3 মিনিট)।
স্টিকি ফোরগ্রাউন্ড পরিষেবাগুলির জন্য কোনও সমর্থন নেই।
অন্যান্য ফোরগ্রাউন্ড পরিষেবাগুলি শুরু করতে পারে না৷
টাইপ-নির্দিষ্ট অনুমতির প্রয়োজন হয় না, যদিও এটির জন্য এখনও FOREGROUND_SERVICE অনুমতি প্রয়োজন৷
একটি 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() কল করলে সময়সীমা আরও 3 মিনিট বৃদ্ধি করে৷ অ্যাপটি ব্যবহারকারীর কাছে দৃশ্যমান না হলে এবং ছাড়গুলির একটিকে সন্তুষ্ট না করলে, ধরন নির্বিশেষে অন্য ফোরগ্রাউন্ড পরিষেবা শুরু করার যে কোনও প্রচেষ্টা একটি ForegroundServiceStartNotAllowedException সৃষ্টি করে৷

যদি কোনও ব্যবহারকারী আপনার অ্যাপের জন্য ব্যাটারি অপ্টিমাইজেশান অক্ষম করে, তবে এটি এখনও শর্টসার্ভিস FGS-এর টাইমআউট দ্বারা প্রভাবিত হয়।

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

বিশেষ ব্যবহার

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

android:foregroundServiceType

specialUse

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

FOREGROUND_SERVICE_SPECIAL_USE

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

FOREGROUND_SERVICE_TYPE_SPECIAL_USE

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

কোনোটিই নয়

বর্ণনা

যেকোন বৈধ ফোরগ্রাউন্ড পরিষেবা ব্যবহারের ক্ষেত্রে কভার করে যা অন্যান্য ফোরগ্রাউন্ড পরিষেবার ধরন দ্বারা কভার করা হয় না।

FOREGROUND_SERVICE_TYPE_SPECIAL_USE ফোরগ্রাউন্ড পরিষেবার ধরন ঘোষণা করার পাশাপাশি, বিকাশকারীদের ম্যানিফেস্টে ব্যবহারের কেসগুলি ঘোষণা করা উচিত৷ এটি করার জন্য, তারা <service> উপাদানের মধ্যে <property> উপাদানটি নির্দিষ্ট করে। আপনি যখন 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>

সিস্টেম অব্যাহতি

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

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-এ আপনার ফোরগ্রাউন্ড পরিষেবার প্রকারগুলি কীভাবে ঘোষণা করবেন সে সম্পর্কে আরও তথ্যের জন্য, ফোরগ্রাউন্ড পরিষেবা এবং পূর্ণ-স্ক্রীনের অভিপ্রায়ের প্রয়োজনীয়তা বোঝা দেখুন।