কাজের অবস্থা রিপোর্ট করুন

এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে একটি ব্যাকগ্রাউন্ড পরিষেবাতে চালিত কাজের অনুরোধের স্থিতি রিপোর্ট করা যায় সেই উপাদানটিতে যেটি অনুরোধ পাঠিয়েছে। এটি আপনাকে, উদাহরণস্বরূপ, একটি Activity অবজেক্টের UI-তে অনুরোধের স্থিতি রিপোর্ট করতে দেয়। স্ট্যাটাস পাঠানো এবং গ্রহণ করার প্রস্তাবিত উপায় হল একটি LocalBroadcastManager ব্যবহার করা, যা আপনার নিজের অ্যাপের উপাদানগুলিতে সম্প্রচারের Intent বস্তুগুলিকে সীমাবদ্ধ করে৷

একটি JobIntentService থেকে স্ট্যাটাস রিপোর্ট করুন

একটি JobIntentService এ কাজের অনুরোধের স্ট্যাটাস অন্যান্য উপাদানে পাঠাতে, প্রথমে একটি Intent তৈরি করুন যাতে তার বর্ধিত ডেটাতে স্ট্যাটাস থাকে। একটি বিকল্প হিসাবে, আপনি এই Intent একটি কর্ম এবং ডেটা URI যোগ করতে পারেন।

এরপরে, LocalBroadcastManager.sendBroadcast() কল করে Intent পাঠান। এটি আপনার অ্যাপ্লিকেশানের যে কোনও উপাদানে Intent পাঠায় যা এটি পাওয়ার জন্য নিবন্ধিত হয়েছে। LocalBroadcastManager এর একটি উদাহরণ পেতে, getInstance() কল করুন।

যেমন:

...
// Defines a custom Intent action
const val BROADCAST_ACTION = "com.example.android.threadsample.BROADCAST"
...
// Defines the key for the status "extra" in an Intent
const val EXTENDED_DATA_STATUS = "com.example.android.threadsample.STATUS"
...
class RSSPullService : JobIntentService() {
    ...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    val localIntent = Intent(BROADCAST_ACTION).apply {
        // Puts the status into the Intent
        putExtra(EXTENDED_DATA_STATUS, status)
    }
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent)
    ...
}

public final class Constants {
    ...
    // Defines a custom Intent action
    public static final String BROADCAST_ACTION =
        "com.example.android.threadsample.BROADCAST";
    ...
    // Defines the key for the status "extra" in an Intent
    public static final String EXTENDED_DATA_STATUS =
        "com.example.android.threadsample.STATUS";
    ...
}
public class RSSPullService extends JobIntentService {
...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    Intent localIntent =
            new Intent(Constants.BROADCAST_ACTION)
            // Puts the status into the Intent
            .putExtra(Constants.EXTENDED_DATA_STATUS, status);
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent);
...
}

পরবর্তী পদক্ষেপটি হল মূল কাজের অনুরোধ পাঠানো উপাদানটিতে ইনকামিং ব্রডকাস্ট Intent অবজেক্টগুলি পরিচালনা করা।

একটি JobIntentService থেকে স্ট্যাটাস সম্প্রচার গ্রহণ করুন

ব্রডকাস্ট Intent অবজেক্টগুলি পেতে, BroadcastReceiver এর একটি সাবক্লাস ব্যবহার করুন। সাবক্লাসে, BroadcastReceiver.onReceive() কলব্যাক পদ্ধতিটি প্রয়োগ করুন, যেটি LocalBroadcastManager একটি Intent গ্রহণ করার সময় আহ্বান করে। LocalBroadcastManager BroadcastReceiver.onReceive() এ আগত Intent পাস করে।

যেমন:

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        ...
        /*
         * Handle Intents here.
         */
        ...
    }
}

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver extends BroadcastReceiver
{
    // Called when the BroadcastReceiver gets an Intent it's registered to receive
    @Override
    public void onReceive(Context context, Intent intent) {
...
        /*
         * Handle Intents here.
         */
...
    }
}

একবার আপনি BroadcastReceiver সংজ্ঞায়িত করলে, আপনি এটির জন্য ফিল্টার সংজ্ঞায়িত করতে পারেন যা নির্দিষ্ট ক্রিয়া, বিভাগ এবং ডেটার সাথে মেলে। এটি করার জন্য, একটি IntentFilter তৈরি করুন। এই প্রথম স্নিপেট দেখায় কিভাবে ফিল্টার সংজ্ঞায়িত করতে হয়:

// Class that displays photos
class DisplayActivity : FragmentActivity() {
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        super.onCreate(savedInstanceState)
        ...
        // The filter's action is BROADCAST_ACTION
        var statusIntentFilter = IntentFilter(BROADCAST_ACTION).apply {
            // Adds a data filter for the HTTP scheme
            addDataScheme("http")
        }
        ...

// Class that displays photos
public class DisplayActivity extends FragmentActivity {
    ...
    public void onCreate(Bundle stateBundle) {
        ...
        super.onCreate(stateBundle);
        ...
        // The filter's action is BROADCAST_ACTION
        IntentFilter statusIntentFilter = new IntentFilter(
                Constants.BROADCAST_ACTION);

        // Adds a data filter for the HTTP scheme
        statusIntentFilter.addDataScheme("http");
        ...

সিস্টেমের সাথে BroadcastReceiver এবং IntentFilter নিবন্ধন করতে, LocalBroadcastManager এর একটি উদাহরণ পান এবং এর registerReceiver() পদ্ধতিতে কল করুন। এই পরবর্তী স্নিপেটটি দেখায় কিভাবে BroadcastReceiver এবং এর IntentFilter নিবন্ধন করতে হয়:

        // Instantiates a new DownloadStateReceiver
        val downloadStateReceiver = DownloadStateReceiver()
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)
        ...

        // Instantiates a new DownloadStateReceiver
        DownloadStateReceiver downloadStateReceiver =
                new DownloadStateReceiver();
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);
        ...

একটি একক BroadcastReceiver একাধিক ধরণের ব্রডকাস্ট Intent অবজেক্ট পরিচালনা করতে পারে, প্রতিটি তার নিজস্ব ক্রিয়া সহ। এই বৈশিষ্ট্যটি আপনাকে প্রতিটি ক্রিয়াকলাপের জন্য একটি পৃথক BroadcastReceiver সংজ্ঞায়িত না করেই প্রতিটি ক্রিয়াকলাপের জন্য আলাদা কোড চালানোর অনুমতি দেয়৷ একই BroadcastReceiver এর জন্য অন্য IntentFilter সংজ্ঞায়িত করতে, IntentFilter তৈরি করুন এবং registerReceiver() এ কলটি পুনরাবৃত্তি করুন। যেমন:

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = IntentFilter(ACTION_ZOOM_IMAGE)
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = new IntentFilter(Constants.ACTION_ZOOM_IMAGE);
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);

একটি সম্প্রচার Intent পাঠানো একটি Activity শুরু বা পুনরায় শুরু করে না৷ একটি Activity জন্য BroadcastReceiver আপনার অ্যাপ ব্যাকগ্রাউন্ডে থাকা অবস্থায়ও Intent অবজেক্টগুলি গ্রহণ করে এবং প্রক্রিয়া করে, কিন্তু আপনার অ্যাপটিকে অগ্রভাগে জোর করে না। আপনি যদি ব্যাকগ্রাউন্ডে ঘটে যাওয়া একটি ইভেন্ট সম্পর্কে ব্যবহারকারীকে অবহিত করতে চান যখন আপনার অ্যাপটি দৃশ্যমান ছিল না, একটি Notification ব্যবহার করুন৷ একটি ইনকামিং সম্প্রচার Intent প্রতিক্রিয়া হিসাবে একটি Activity শুরু করবেন না .