এই গাইডে, Unity অ্যাপ্লিকেশন থেকে প্রাইভেট প্রসেসে Android পারসেপ্টিবল সার্ভিস (ফোরগ্রাউন্ড সার্ভিস বা FGS) চালানোর জন্য প্রয়োজনীয় কনফিগারেশন ও ইমপ্লিমেন্টেশন কভার করা হয়েছে।
১. অনুভবযোগ্য-পরিষেবা সহায়তা কনফিগার করুন
এই বিভাগটি ব্যাখ্যা করে যে কীভাবে প্রয়োজনীয় অনুমতি সেট-আপ করতে হয় এবং আপনার প্রোজেক্টের ম্যানিফেস্টে পরিষেবাটি ঘোষণা করতে হয়।
১.১ অনুমতি ও পরিষেবা সংক্রান্ত ঘোষণা
কাস্টম
Assets/Plugins/Android/AndroidManifest.xml
-এ অবশ্যই লঞ্চার অ্যাক্টিভিটি, পারসেপ্টিবল-সার্ভিস সংক্রান্ত অনুমতি,
বিজ্ঞপ্তির অনুমতি, নেটওয়ার্ক সংক্রান্ত অনুমতি এবং পরিষেবা ঘোষণা করতে হবে:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.INTERNET" />
<application>
<activity
android:name="com.unity3d.player.UnityPlayerActivity"
android:theme="@style/UnityThemeSelector"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<meta-data android:name="unityplayer.UnityActivity" android:value="true" />
</activity>
<service
android:name="com.sample.fgs.DownloadService"
android:process=":downloader"
android:exported="false"
android:stopWithTask="false"
android:foregroundServiceType="dataSync" />
</application>
</manifest>
foregroundServiceType
অবশ্যই আসল কাজের সাথে মিলতে হবে: ট্রান্সফারের জন্য dataSync,
প্লেব্যাকের জন্য mediaPlayback, লোকেশন ট্র্যাকিংয়ের জন্য location। এটি অবশ্যই সংশ্লিষ্ট FOREGROUND_SERVICE_<TYPE> অনুমতি এবং startForeground কলের সাথে সামঞ্জস্যপূর্ণ হতে হবে — তিনটিই সামঞ্জস্যপূর্ণ হতে হবে, অন্যথায় পরিষেবা স্টার্টআপ ব্যর্থ হবে।
১.২ ইউনিটি প্রোজেক্টে service-process Java যোগ করুন
FGS পরিষেবা প্রসেস Java রান করে। পরিষেবা প্রয়োগের Java কোডকে একটি jar-এ প্যাকেজ করুন এবং এটিকে Assets/Plugins/Android/-এর অধীনে রাখুন। Unity অটোমেটিক সেই ডিরেক্টরির jar ফাইল Gradle-এর libs/ ইনপুটে অন্তর্ভুক্ত করে এবং APK-তে প্যাকেজ করে; রানটাইমে সার্ভিস প্রসেস এইসব ক্লাস লোড করে। Java বা Kotlin-এ কীভাবে পরিষেবা প্রয়োগ করতে হয় সেই সম্পর্কে আরও তথ্যের জন্য, Java প্রয়োগ দেখুন।
২. আলাদা প্রসেস কনফিগার করুন
প্রসেস বাউন্ডারি একটি ম্যানিফেস্ট অ্যাট্রিবিউট দ্বারা চালু করা হয়:
android:process=":downloader"
শুরুতে কোলন থাকলে, your.package.name:downloader নামের একটি অ্যাপ্লিকেশন-প্রাইভেট প্রসেস তৈরি হয়। এটির PID মূল প্রসেসের থেকে আলাদা
এবং মূল প্রসেস বন্ধ হয়ে যাওয়ার পরেও এটি চলতে পারে।
২.১ পরিষেবা প্রসেসে কোনও ইউনিটি নেই
পরিষেবা প্রসেসে Unity-র libunity.so, IL2CPP রানটাইম এবং এই ধরনের অন্যান্য জিনিস
আনা এড়াতে, পরিষেবা-সাইড Java-র কোনও Unity ক্লাস (UnityPlayer.currentActivity সহ)
ব্যবহার করা উচিত নয় এবং এটি শুধুমাত্র Android Context, Intent extras এবং
প্ল্যাটফর্ম API-এর উপর নির্ভর করা উচিত। Unity ইঞ্জিন রানটাইম শুধুমাত্র প্রধান প্রসেসের UnityPlayerActivity-এর মাধ্যমে লোড করা হয়; ব্যক্তিগত :downloader প্রসেস এই লাইব্রেরিগুলি লোড করে না, তাই পরিষেবা প্রসেসে Unity ক্লাস রেফারেন্স করা কাজ করে না।
২.২ প্রসেস স্টার্টআপ এন্ট্রি পয়েন্ট
মূল প্রসেস startForegroundService-কে কল করার পরে, সিস্টেম :downloader পরিষেবা প্রসেসকে
ফর্ক করে:
Applicationইনস্ট্যান্সিয়েট করে এবংApplication.onCreateকল করে — এটি প্রতিটি প্রসেসে রান করে, তাই সার্ভিস প্রসেসের জন্য প্রয়োজনীয় ইনিশিয়ালাইজেশন এখানে আবার করতে হবে। আরও তথ্যের জন্য, ২.৩ বিভাগ দেখুন।DownloadServiceতৈরি করে এবংonCreate-কে কল করে — এটি হল সার্ভিস-প্রসেস এন্ট্রি পয়েন্ট।- স্টার্টআপে তৈরি করা ইনটেন্টের মাধ্যমে
onStartCommand-এ কলব্যাক করে। পরিষেবাটি নিজেকে এখানে ফোরগ্রাউন্ডে প্রোমোট করে এবং কর্মী শুরু করে। আরও তথ্যের জন্য, ৩.১ বিভাগ দেখুন।
২.৩ প্রতিটি প্রসেসে একবার করে স্টেট থাকে
Dex কোড শুধুমাত্র পড়ার জন্য শেয়ার করা হয়, কিন্তু রানটাইম স্টেট নয়:
- অ্যাপ্লিকেশন কম্পোনেন্ট হোস্ট করে এমন প্রতিটি প্রসেসে
Application.attachBaseContextএবংApplication.onCreateরান করে। - প্রতিটি প্রসেসে স্ট্যাটিক ইনিশিয়ালাইজার ও স্ট্যাটিক ফিল্ড স্বাধীনভাবে থাকে। মূল প্রসেসে স্ট্যাটিক ফিল্ড অ্যাসাইন করলে তা পরিষেবার সাথে যোগাযোগ করে না।
- Unity, C# এবং অ্যাক্টিভিটি মূল প্রসেসে থাকে।
৩. জাভা প্রয়োগ করা
এই বিভাগে FGS মডিউলের জাভা সাইড কভার করা হয়েছে: ৩.১ এবং ৩.২ হল
DownloadService পরিষেবা প্রসেসে; ৩.৩ হল FgsBridge মূল
প্রসেসে (এন্ট্রি পয়েন্ট C# JNI ব্যবহার করে কল করে)।
৩.১ প্রথমে ফোরগ্রাউন্ডে প্রোমোট করুন
public class DownloadService extends Service {
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
try {
startForegroundCompat();
// Start the download thread; must come after promoting to foreground
// ...
} catch (Exception e) {
Log.e(TAG, "onStartCommand() failed [errorType="
+ e.getClass().getSimpleName() + "]: " + e.getMessage(), e);
stopSelf();
}
return START_NOT_STICKY;
}
private void startForegroundCompat() {
Notification notification = buildNotification(0L);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
startForeground(NOTIFICATION_ID, notification,
ServiceInfo.FOREGROUND_SERVICE_TYPE_DATA_SYNC);
} else {
startForeground(NOTIFICATION_ID, notification);
}
}
...
৩.২ বিজ্ঞপ্তি যোগ করুন
অগ্রগতি রিপোর্ট করার জন্য একটি লক্ষণীয় পরিষেবার একটি বিজ্ঞপ্তি চ্যানেলে একটি চলমান বিজ্ঞপ্তি প্রয়োজন। বিজ্ঞপ্তিতে একটি 'বন্ধ করুন' অ্যাকশন থাকে যা
PendingIntent.getService ব্যবহার করে পরিষেবাটি বন্ধ করার জন্য ACTION_STOP-কে পাঠায়।
private Notification buildNotification(long progressBytes) {
int progressMib = (int) (progressBytes / MIB);
Intent launchIntent = getPackageManager().getLaunchIntentForPackage(getPackageName());
PendingIntent contentIntent = launchIntent != null
? PendingIntent.getActivity(this, 0, launchIntent,
PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT)
: null;
Intent stopIntent = new Intent(this, DownloadService.class)
.setAction(ACTION_STOP);
PendingIntent stopPendingIntent = PendingIntent.getService(this, 0,
stopIntent, PendingIntent.FLAG_IMMUTABLE
| PendingIntent.FLAG_UPDATE_CURRENT);
Notification.Builder builder = new Notification.Builder(this,
CHANNEL_ID)
.setContentTitle("Download service")
.setContentText("Downloaded " + progressMib + " MB / " + TOTAL_MIB + " MB")
.setSmallIcon(android.R.drawable.stat_sys_download)
.setProgress(TOTAL_MIB, progressMib, false)
.setOngoing(true)
.setOnlyAlertOnce(true)
.addAction(new Notification.Action.Builder(null,
"Stop", stopPendingIntent).build());
if (contentIntent != null) {
builder.setContentIntent(contentIntent);
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
builder.setForegroundServiceBehavior(
Notification.FOREGROUND_SERVICE_IMMEDIATE);
}
return builder.build();
}
৩.৩ জাভা হোস্ট এন্ট্রি পয়েন্ট
FgsBridge হল জাভা এন্ট্রি পয়েন্ট যা FGS কন্ট্রোল করার জন্য প্রধান প্রসেস ব্যবহার করে
(এটি প্রধান প্রসেসে চলে, পরিষেবা প্রসেসে নয়)। পরিষেবা শুরু ও বন্ধ করতে এবং বিজ্ঞপ্তির অনুমতি ম্যানেজ করতে, JNI ব্যবহার করে C# এইসব স্ট্যাটিক
মেথড কল করে:
public class FgsBridge {
// Start the :downloader perceptible service and begin downloading
public static void startDownloadService(Context context) {
try {
context.startForegroundService(new Intent(context, DownloadService.class));
} catch (Exception e) {
Log.e(TAG, "startDownloadService() failed [errorType="
+ e.getClass().getSimpleName() + "]: " + e.getMessage(), e);
}
}
// Stop the service: sends a stop intent; the service removes its
// notification before exiting
public static void stopDownloadService(Context context) {
try {
context.startService(new Intent(context, DownloadService.class)
.setAction(ACTION_STOP));
} catch (Exception e) {
Log.e(TAG, "stopDownloadService() failed [errorType="
+ e.getClass().getSimpleName() + "]: " + e.getMessage(), e);
}
}
// Request notification permission (only needed on API 33+; if already
// granted, no dialog is shown and it returns immediately)
public static void requestNotificationPermission(Activity activity) {
if (Build.VERSION.SDK_INT < 33) {
return;
}
try {
activity.requestPermissions(
new String[] { POST_NOTIFICATIONS }, NOTIFICATION_PERMISSION_REQUEST);
} catch (Exception e) {
Log.e(TAG, "requestNotificationPermission() failed [errorType="
+ e.getClass().getSimpleName() + "]: " + e.getMessage(), e);
}
}
}
৪. Unity (C#) থেকে FGS চালু ও নিয়ন্ত্রণ করা
AndroidBridge হল C# র্যাপার যা JNI ব্যবহার করে FgsBridge-কে কল করে। তিনটি
পদ্ধতির ইমপ্লিমেন্টেশন:
public static void StartDownloadService()
{
#if UNITY_ANDROID && !UNITY_EDITOR
CallStatic("startDownloadService");
#else
Debug.Log("StartDownloadService() no-op outside Android");
#endif
}
public static void StopDownloadService()
{
#if UNITY_ANDROID && !UNITY_EDITOR
CallStatic("stopDownloadService");
#else
Debug.Log("StopDownloadService() no-op outside Android");
#endif
}
public static void RequestNotificationPermission()
{
#if UNITY_ANDROID && !UNITY_EDITOR
CallStatic("requestNotificationPermission");
#else
Debug.Log("RequestNotificationPermission() no-op outside Android");
#endif
}
CallStatic হল একটি ইন্টার্নাল JNI হেল্পার যা FgsBridge ক্লাস সমাধান করে এবং
সংশ্লিষ্ট Java স্ট্যাটিক মেথড কল করে। অ্যাপ্লিকেশন স্টার্টআপে RequestNotificationPermission
কল করা উচিত যাতে পরিষেবা প্রসেস শুরু হওয়ার সাথে সাথেই বিজ্ঞপ্তি
দেখা যায়।