সিঙ্ক অ্যাডাপ্টার রান করা

মনে রাখবেন: ব্যাকগ্রাউন্ড প্রসেসিংয়ের বেশিরভাগ ব্যবহারের ক্ষেত্রে আমরা WorkManager ব্যবহার করার সাজেশন দিই। কোন সমাধান আপনার জন্য সবচেয়ে ভালো কাজ করে তা জানতে ব্যাকগ্রাউন্ড প্রসেসিং গাইড দেখুন।

এই ক্লাসের আগের পাঠে, আপনি শিখেছেন কীভাবে একটি সিঙ্ক অ্যাডাপ্টার কম্পোনেন্ট তৈরি করতে হয় যা ডেটা ট্রান্সফার কোড এনক্যাপসুলেট করে এবং কীভাবে অতিরিক্ত কম্পোনেন্ট যোগ করতে হয় যা আপনাকে সিস্টেমে সিঙ্ক অ্যাডাপ্টার প্লাগ করতে দেয়। সিঙ্ক অ্যাডাপ্টার অন্তর্ভুক্ত করে এমন অ্যাপ ইনস্টল করার জন্য আপনার কাছে এখন সবকিছু আছে, কিন্তু আপনি যে কোড দেখেছেন তার কোনওটিই আসলে সিঙ্ক অ্যাডাপ্টার রান করে না।

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

আপনার সিঙ্ক অ্যাডাপ্টার চালানোর জন্য আপনার কাছে নিম্নলিখিত বিকল্পগুলি রয়েছে:

সার্ভার ডেটা পরিবর্তন হলে
সার্ভার থেকে পাওয়া মেসেজের উত্তরে সিঙ্ক অ্যাডাপ্টার রান করুন, যা ইঙ্গিত করে যে সার্ভার-ভিত্তিক ডেটা পরিবর্তন হয়েছে। এই বিকল্পের সাহায্যে আপনি সার্ভার থেকে ডিভাইসে ডেটা রিফ্রেশ করতে পারবেন। এর ফলে পারফর্ম্যান্স খারাপ হবে না বা সার্ভার পোলিংয়ের মাধ্যমে ব্যাটারির চার্জ নষ্ট হবে না।
ডিভাইসের ডেটা পরিবর্তন হলে
ডিভাইসে ডেটা পরিবর্তন হলে সিঙ্ক অ্যাডাপ্টার রান করুন। এই বিকল্প আপনাকে ডিভাইস থেকে সার্ভারে পরিবর্তিত ডেটা পাঠাতে দেয় এবং এটি বিশেষভাবে উপযোগী যদি আপনাকে নিশ্চিত করতে হয় যে সার্ভারে সবসময় লেটেস্ট ডিভাইস ডেটা আছে। আপনার কন্টেন্ট প্রোভাইডারে ডেটা স্টোর করলে, এই বিকল্পটি প্রয়োগ করা সহজ। আপনি স্টাব কন্টেন্ট প্রোভাইডার ব্যবহার করলে, ডেটার পরিবর্তন শনাক্ত করা আরও কঠিন হতে পারে।
নিয়মিত বিরতিতে
আপনার বেছে নেওয়া ইন্টারভাল শেষ হওয়ার পরে সিঙ্ক অ্যাডাপ্টার রান করুন অথবা প্রতিদিন নির্দিষ্ট সময়ে এটি রান করুন।
অন ডিমান্ড
ব্যবহারকারীর অ্যাকশনের উত্তরে সিঙ্ক অ্যাডাপ্টার রান করুন। তবে, ব্যবহারকারীকে সবচেয়ে ভালো অভিজ্ঞতা প্রদান করতে, আপনাকে প্রাথমিকভাবে আরও অটোমেটেড বিকল্পের মধ্যে একটির উপর নির্ভর করতে হবে। অটোমেটেড বিকল্প ব্যবহার করে, আপনি ব্যাটারি ও নেটওয়ার্ক রিসোর্স সাশ্রয় করতে পারবেন।

এই পাঠের বাকি অংশে প্রতিটি বিকল্প সম্পর্কে আরও বিস্তারিতভাবে বর্ণনা করা হয়েছে।

সার্ভার ডেটা পরিবর্তন হলে সিঙ্ক অ্যাডাপ্টার রান করুন

আপনার অ্যাপ যদি কোনও সার্ভার থেকে ডেটা ট্রান্সফার করে এবং সার্ভারের ডেটা ঘনঘন পরিবর্তিত হয়, তাহলে ডেটা পরিবর্তনের প্রতিক্রিয়ায় ডাউনলোড করার জন্য আপনি সিঙ্ক অ্যাডাপ্টার ব্যবহার করতে পারেন। সিঙ্ক অ্যাডাপ্টার রান করতে, সার্ভারকে আপনার অ্যাপের BroadcastReceiver-এ একটি বিশেষ মেসেজ পাঠাতে বলুন। এই মেসেজের উত্তরে, আপনার সিঙ্ক অ্যাডাপ্টার রান করার জন্য সিঙ্ক অ্যাডাপ্টার ফ্রেমওয়ার্ককে সিগন্যাল দিতে ContentResolver.requestSync() কল করুন।

এই মেসেজিং সিস্টেম কাজ করানোর জন্য আপনার প্রয়োজনীয় সার্ভার ও ডিভাইস কম্পোনেন্ট, Google Cloud Messaging (GCM) প্রদান করে। ট্রান্সফার ট্রিগার করার জন্য GCM ব্যবহার করা স্ট্যাটাসের জন্য সার্ভার পোল করার চেয়ে বেশি নির্ভরযোগ্য ও দক্ষ। পোলিংয়ের জন্য এমন একটি Service প্রয়োজন যা সবসময় অ্যাক্টিভ থাকে, GCM এমন একটি BroadcastReceiver ব্যবহার করে যা মেসেজ এলে অ্যাক্টিভেট হয়। নিয়মিত বিরতিতে পোলিং করলে, কোনও আপডেট উপলভ্য না থাকলেও ব্যাটারির চার্জ খরচ হয়, কিন্তু GCM শুধুমাত্র প্রয়োজন হলেই মেসেজ পাঠায়।

মনে রাখবেন: আপনার অ্যাপ ইনস্টল করা আছে এমন সব ডিভাইসে ব্রডকাস্টের মাধ্যমে সিঙ্ক অ্যাডাপ্টার ট্রিগার করার জন্য GCM ব্যবহার করলে, মনে রাখবেন যে তারা প্রায় একই সময়ে আপনার মেসেজ পাবে। এই পরিস্থিতিতে আপনার সিঙ্ক অ্যাডাপ্টারের একাধিক ইনস্ট্যান্স একই সময়ে রান করতে পারে, যার ফলে সার্ভার ও নেটওয়ার্ক ওভারলোড হয়ে যেতে পারে। সব ডিভাইসে ব্রডকাস্টের জন্য এই পরিস্থিতি এড়াতে, আপনাকে প্রতিটি ডিভাইসের জন্য অনন্য একটি সময়ের জন্য সিঙ্ক অ্যাডাপ্টার শুরু করার বিষয়টি স্থগিত করার কথা বিবেচনা করা উচিত।

নিম্নলিখিত কোড স্নিপেট থেকে আপনি জানতে পারবেন যে ইনকামিং GCM মেসেজের উত্তরে requestSync() কীভাবে রান করতে হয়:

Kotlin

...
// Constants
// Content provider authority
const val AUTHORITY = "com.example.android.datasync.provider"
// Account type
const val ACCOUNT_TYPE = "com.example.android.datasync"
// Account
const val ACCOUNT = "default_account"
// Incoming Intent key for extended data
const val KEY_SYNC_REQUEST = "com.example.android.datasync.KEY_SYNC_REQUEST"
...
class GcmBroadcastReceiver : BroadcastReceiver() {
    ...
    override fun onReceive(context: Context, intent: Intent) {
        // Get a GCM object instance
        val gcm: GoogleCloudMessaging = GoogleCloudMessaging.getInstance(context)
        // Get the type of GCM message
        val messageType: String? = gcm.getMessageType(intent)
        /*
         * Test the message type and examine the message contents.
         * Since GCM is a general-purpose messaging system, you
         * may receive normal messages that don't require a sync
         * adapter run.
         * The following code tests for a a boolean flag indicating
         * that the message is requesting a transfer from the device.
         */
        if (GoogleCloudMessaging.MESSAGE_TYPE_MESSAGE == messageType
            && intent.getBooleanExtra(KEY_SYNC_REQUEST, false)) {
            /*
             * Signal the framework to run your sync adapter. Assume that
             * app initialization has already created the account.
             */
            ContentResolver.requestSync(mAccount, AUTHORITY, null)
            ...
        }
        ...
    }
    ...
}

জাভা

public class GcmBroadcastReceiver extends BroadcastReceiver {
    ...
    // Constants
    // Content provider authority
    public static final String AUTHORITY = "com.example.android.datasync.provider";
    // Account type
    public static final String ACCOUNT_TYPE = "com.example.android.datasync";
    // Account
    public static final String ACCOUNT = "default_account";
    // Incoming Intent key for extended data
    public static final String KEY_SYNC_REQUEST =
            "com.example.android.datasync.KEY_SYNC_REQUEST";
    ...
    @Override
    public void onReceive(Context context, Intent intent) {
        // Get a GCM object instance
        GoogleCloudMessaging gcm =
                GoogleCloudMessaging.getInstance(context);
        // Get the type of GCM message
        String messageType = gcm.getMessageType(intent);
        /*
         * Test the message type and examine the message contents.
         * Since GCM is a general-purpose messaging system, you
         * may receive normal messages that don't require a sync
         * adapter run.
         * The following code tests for a a boolean flag indicating
         * that the message is requesting a transfer from the device.
         */
        if (GoogleCloudMessaging.MESSAGE_TYPE_MESSAGE.equals(messageType)
            &&
            intent.getBooleanExtra(KEY_SYNC_REQUEST)) {
            /*
             * Signal the framework to run your sync adapter. Assume that
             * app initialization has already created the account.
             */
            ContentResolver.requestSync(mAccount, AUTHORITY, null);
            ...
        }
        ...
    }
    ...
}

কন্টেন্ট প্রোভাইডারের ডেটা পরিবর্তন হলে সিঙ্ক অ্যাডাপ্টার রান করুন

আপনার অ্যাপ যদি কোনও কন্টেন্ট প্রোভাইডারে ডেটা সংগ্রহ করে এবং আপনি যখনই প্রোভাইডার আপডেট করেন তখনই সার্ভার আপডেট করতে চান, তাহলে আপনার সিঙ্ক অ্যাডাপ্টার অটোমেটিক চালানোর জন্য আপনার অ্যাপ সেট-আপ করতে পারেন। এটি করতে, আপনি কন্টেন্ট প্রোভাইডারের জন্য একজন পর্যবেক্ষককে রেজিস্টার করেন। আপনার কন্টেন্ট প্রোভাইডারের ডেটা পরিবর্তন হলে, কন্টেন্ট প্রোভাইডার ফ্রেমওয়ার্ক অবজারভারকে কল করে। অবজারভারে, requestSync() কল করুন যাতে ফ্রেমওয়ার্ককে আপনার সিঙ্ক অ্যাডাপ্টার রান করতে বলা যায়।

মনে রাখবেন: আপনি স্টাব কন্টেন্ট প্রোভাইডার ব্যবহার করলে, কন্টেন্ট প্রোভাইডারে আপনার কোনও ডেটা থাকে না এবং onChange() কখনও কল করা হয় না। এই ক্ষেত্রে, ডিভাইস ডেটায় পরিবর্তন শনাক্ত করার জন্য আপনাকে নিজস্ব মেকানিজম প্রদান করতে হবে। ডেটা পরিবর্তন হলে requestSync() কল করার জন্যও এই মেকানিজম দায়ী।

আপনার কন্টেন্ট প্রোভাইডারের জন্য অবজারভার তৈরি করতে, ক্লাসটি এক্সটেন্ড করুন ContentObserver এবং এর উভয় ফর্মের onChange() পদ্ধতি প্রয়োগ করুন। onChange()-এ, সিঙ্ক অ্যাডাপ্টার চালু করতে requestSync()-এ কল করুন।

পর্যবেক্ষক রেজিস্টার করতে, registerContentObserver()-এ কল করার সময় এটিকে আর্গুমেন্ট হিসেবে পাস করুন। এই কলে, আপনি যে ডেটা দেখতে চান তার জন্য আপনাকে একটি কন্টেন্ট URI পাস করতে হবে। কন্টেন্ট প্রোভাইডার ফ্রেমওয়ার্ক এই ওয়াচ URI-কে কন্টেন্ট URI-এর সাথে তুলনা করে যা ContentResolver পদ্ধতিতে আর্গুমেন্ট হিসেবে পাস করা হয় এবং আপনার প্রোভাইডারকে পরিবর্তন করে, যেমন ContentResolver.insert()। যদি কোনও মিল থাকে, তাহলে আপনার ContentObserver.onChange()-এর ইমপ্লিমেন্টেশন কল করা হয়।

নিম্নলিখিত কোড স্নিপেট থেকে আপনি জানতে পারবেন যে কীভাবে একটি ContentObserver সংজ্ঞায়িত করতে হয় যা একটি টেবিল পরিবর্তন হলে requestSync() কল করে:

Kotlin

// Constants
// Content provider scheme
const val SCHEME = "content://"
// Content provider authority
const val AUTHORITY = "com.example.android.datasync.provider"
// Path for the content provider table
const val TABLE_PATH = "data_table"
...
class MainActivity : FragmentActivity() {
    ...
    // A content URI for the content provider's data table
    private lateinit var uri: Uri
    // A content resolver for accessing the provider
    private lateinit var mResolver: ContentResolver
    ...
    inner class TableObserver(...) : ContentObserver(...) {
        /*
         * Define a method that's called when data in the
         * observed content provider changes.
         * This method signature is provided for compatibility with
         * older platforms.
         */
        override fun onChange(selfChange: Boolean) {
            /*
             * Invoke the method signature available as of
             * Android platform version 4.1, with a null URI.
             */
            onChange(selfChange, null)
        }

        /*
         * Define a method that's called when data in the
         * observed content provider changes.
         */
        override fun onChange(selfChange: Boolean, changeUri: Uri?) {
            /*
             * Ask the framework to run your sync adapter.
             * To maintain backward compatibility, assume that
             * changeUri is null.
             */
            ContentResolver.requestSync(account, AUTHORITY, null)
        }
        ...
    }
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
        // Get the content resolver object for your app
        mResolver = contentResolver
        // Construct a URI that points to the content provider data table
        uri = Uri.Builder()
                .scheme(SCHEME)
                .authority(AUTHORITY)
                .path(TABLE_PATH)
                .build()
        /*
         * Create a content observer object.
         * Its code does not mutate the provider, so set
         * selfChange to "false"
         */
        val observer = TableObserver(false)
        /*
         * Register the observer for the data table. The table's path
         * and any of its subpaths trigger the observer.
         */
        mResolver.registerContentObserver(uri, true, observer)
        ...
    }
    ...
}

জাভা

public class MainActivity extends FragmentActivity {
    ...
    // Constants
    // Content provider scheme
    public static final String SCHEME = "content://";
    // Content provider authority
    public static final String AUTHORITY = "com.example.android.datasync.provider";
    // Path for the content provider table
    public static final String TABLE_PATH = "data_table";
    // Account
    public static final String ACCOUNT = "default_account";
    // Global variables
    // A content URI for the content provider's data table
    Uri uri;
    // A content resolver for accessing the provider
    ContentResolver mResolver;
    ...
    public class TableObserver extends ContentObserver {
        /*
         * Define a method that's called when data in the
         * observed content provider changes.
         * This method signature is provided for compatibility with
         * older platforms.
         */
        @Override
        public void onChange(boolean selfChange) {
            /*
             * Invoke the method signature available as of
             * Android platform version 4.1, with a null URI.
             */
            onChange(selfChange, null);
        }
        /*
         * Define a method that's called when data in the
         * observed content provider changes.
         */
        @Override
        public void onChange(boolean selfChange, Uri changeUri) {
            /*
             * Ask the framework to run your sync adapter.
             * To maintain backward compatibility, assume that
             * changeUri is null.
             */
            ContentResolver.requestSync(mAccount, AUTHORITY, null);
        }
        ...
    }
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        // Get the content resolver object for your app
        mResolver = getContentResolver();
        // Construct a URI that points to the content provider data table
        uri = new Uri.Builder()
                  .scheme(SCHEME)
                  .authority(AUTHORITY)
                  .path(TABLE_PATH)
                  .build();
        /*
         * Create a content observer object.
         * Its code does not mutate the provider, so set
         * selfChange to "false"
         */
        TableObserver observer = new TableObserver(false);
        /*
         * Register the observer for the data table. The table's path
         * and any of its subpaths trigger the observer.
         */
        mResolver.registerContentObserver(uri, true, observer);
        ...
    }
    ...
}

কিছু সময় পরপর সিঙ্ক অ্যাডাপ্টার রান করুন

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

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

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

নিয়মিত বিরতিতে আপনার সিঙ্ক অ্যাডাপ্টার চালাতে, addPeriodicSync() কল করুন। এটি নির্দিষ্ট সময় অতিবাহিত হওয়ার পরে আপনার সিঙ্ক অ্যাডাপ্টার রান করার জন্য শিডিউল করে। যেহেতু সিঙ্ক অ্যাডাপ্টার ফ্রেমওয়ার্ককে অন্যান্য সিঙ্ক অ্যাডাপ্টার এক্সিকিউশনকে বিবেচনা করতে হয় এবং ব্যাটারির কার্যকারিতা সর্বাধিক করার চেষ্টা করে, তাই অতিক্রান্ত সময় কয়েক সেকেন্ডের জন্য পরিবর্তিত হতে পারে। এছাড়াও, নেটওয়ার্ক উপলভ্য না থাকলে ফ্রেমওয়ার্ক আপনার সিঙ্ক অ্যাডাপ্টার রান করবে না।

লক্ষ্য করুন যে addPeriodicSync() দিনের কোনও নির্দিষ্ট সময়ে সিঙ্ক অ্যাডাপ্টার চালায় না। প্রতিদিন প্রায় একই সময়ে আপনার সিঙ্ক অ্যাডাপ্টার রান করতে, ট্রিগার হিসেবে রিপিটিং অ্যালার্ম ব্যবহার করুন। AlarmManager-এর জন্য রেফারেন্স ডকুমেন্টেশনে রিপিট হওয়া অ্যালার্ম সম্পর্কে আরও বিস্তারিত বিবরণ দেওয়া আছে। আপনি যদি setInexactRepeating() পদ্ধতি ব্যবহার করে দিনের-সময় ট্রিগার সেট করেন যাতে কিছু পরিবর্তন থাকে, তাহলে আপনাকে এখনও শুরুর সময় র‍্যান্ডমাইজ করতে হবে যাতে নিশ্চিত করা যায় যে বিভিন্ন ডিভাইস থেকে সিঙ্ক অ্যাডাপ্টার রান করার সময় স্ট্যাগার করা হয়েছে।

addPeriodicSync() পদ্ধতি setSyncAutomatically() বন্ধ করে না, তাই আপনি তুলনামূলকভাবে অল্প সময়ের মধ্যে একাধিক সিঙ্ক রান পেতে পারেন। এছাড়াও, addPeriodicSync()-এ কল করার সময় শুধুমাত্র কয়েকটি সিঙ্ক অ্যাডাপ্টার কন্ট্রোল ফ্ল্যাগ ব্যবহার করার অনুমতি দেওয়া হয়; যেসব ফ্ল্যাগ ব্যবহার করার অনুমতি দেওয়া হয় না, সেগুলি addPeriodicSync()-এর জন্য রেফারেন্স ডকুমেন্টেশনে বর্ণনা করা হয়েছে।

নিম্নলিখিত কোড স্নিপেট থেকে আপনি জানতে পারবেন যে কীভাবে নির্দিষ্ট সময় অন্তর সিঙ্ক অ্যাডাপ্টার রান করার শিডিউল করতে হয়:

Kotlin

// Content provider authority
const val AUTHORITY = "com.example.android.datasync.provider"
// Account
const val ACCOUNT = "default_account"
// Sync interval constants
const val SECONDS_PER_MINUTE = 60L
const val SYNC_INTERVAL_IN_MINUTES = 60L
const val SYNC_INTERVAL = SYNC_INTERVAL_IN_MINUTES * SECONDS_PER_MINUTE
...
class MainActivity : FragmentActivity() {
    ...
    // A content resolver for accessing the provider
    private lateinit var mResolver: ContentResolver

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
        // Get the content resolver for your app
        mResolver = contentResolver
        /*
         * Turn on periodic syncing
         */
        ContentResolver.addPeriodicSync(
                mAccount,
                AUTHORITY,
                Bundle.EMPTY,
                SYNC_INTERVAL)
        ...
    }
    ...
}

জাভা

public class MainActivity extends FragmentActivity {
    ...
    // Constants
    // Content provider authority
    public static final String AUTHORITY = "com.example.android.datasync.provider";
    // Account
    public static final String ACCOUNT = "default_account";
    // Sync interval constants
    public static final long SECONDS_PER_MINUTE = 60L;
    public static final long SYNC_INTERVAL_IN_MINUTES = 60L;
    public static final long SYNC_INTERVAL =
            SYNC_INTERVAL_IN_MINUTES *
            SECONDS_PER_MINUTE;
    // Global variables
    // A content resolver for accessing the provider
    ContentResolver mResolver;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        // Get the content resolver for your app
        mResolver = getContentResolver();
        /*
         * Turn on periodic syncing
         */
        ContentResolver.addPeriodicSync(
                mAccount,
                AUTHORITY,
                Bundle.EMPTY,
                SYNC_INTERVAL);
        ...
    }
    ...
}

চাহিদা অনুযায়ী সিঙ্ক অ্যাডাপ্টার রান করুন

ব্যবহারকারীর অনুরোধের উত্তরে সিঙ্ক অ্যাডাপ্টার চালানো হল সিঙ্ক অ্যাডাপ্টার চালানোর জন্য সবচেয়ে কম পছন্দের কৌশল। ফ্রেমওয়ার্কটি বিশেষভাবে ব্যাটারির পাওয়ার সাশ্রয় করার জন্য ডিজাইন করা হয়েছে যখন এটি শিডিউল অনুযায়ী সিঙ্ক অ্যাডাপ্টার চালায়। ডেটা পরিবর্তনের উত্তরে সিঙ্ক রান করে এমন বিকল্প ব্যাটারির পাওয়ার কার্যকরভাবে ব্যবহার করে, কারণ নতুন ডেটা প্রদান করতে পাওয়ার ব্যবহার করা হয়।

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

তবে, আপনি যদি এখনও চাহিদা অনুযায়ী সিঙ্ক অ্যাডাপ্টার চালাতে চান, তাহলে ম্যানুয়ালি সিঙ্ক অ্যাডাপ্টার চালানোর জন্য সিঙ্ক অ্যাডাপ্টার ফ্ল্যাগ সেট করুন, তারপর ContentResolver.requestSync() কল করুন।

নিম্নলিখিত ফ্ল্যাগ সহ চাহিদা অনুযায়ী ট্রান্সফার রান করুন:

SYNC_EXTRAS_MANUAL
ম্যানুয়ালি সিঙ্ক করতে বাধ্য করে। সিঙ্ক অ্যাডাপ্টার ফ্রেমওয়ার্ক আগে থেকে থাকা সেটিংসকে উপেক্ষা করে, যেমন setSyncAutomatically()-এর মাধ্যমে সেট করা ফ্ল্যাগ।
SYNC_EXTRAS_EXPEDITED
সিঙ্ক অবিলম্বে শুরু করতে বাধ্য করে। আপনি এটি সেট না করলে, সিঙ্ক করার অনুরোধ রান করার আগে সিস্টেমকে কয়েক সেকেন্ড অপেক্ষা করতে হতে পারে, কারণ এটি অল্প সময়ের মধ্যে অনেক অনুরোধ শিডিউল করে ব্যাটারির ব্যবহার অপ্টিমাইজ করার চেষ্টা করে।

নিম্নলিখিত কোড স্নিপেট আপনাকে দেখায় যে কীভাবে requestSync()-কে কল করতে হয়, কোনও বোতামে ক্লিক করার উত্তরে:

Kotlin

// Constants
// Content provider authority
val AUTHORITY = "com.example.android.datasync.provider"
// Account type
val ACCOUNT_TYPE = "com.example.android.datasync"
// Account
val ACCOUNT = "default_account"
...
class MainActivity : FragmentActivity() {
    ...
    // Instance fields
    private lateinit var mAccount: Account
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...
        /*
         * Create the placeholder account. The code for CreateSyncAccount
         * is listed in the lesson Creating a Sync Adapter
         */

        mAccount = createSyncAccount()
        ...
    }

    /**
     * Respond to a button click by calling requestSync(). This is an
     * asynchronous operation.
     *
     * This method is attached to the refresh button in the layout
     * XML file
     *
     * @param v The View associated with the method call,
     * in this case a Button
     */
    fun onRefreshButtonClick(v: View) {
        // Pass the settings flags by inserting them in a bundle
        val settingsBundle = Bundle().apply {
            putBoolean(ContentResolver.SYNC_EXTRAS_MANUAL, true)
            putBoolean(ContentResolver.SYNC_EXTRAS_EXPEDITED, true)
        }
        /*
         * Request the sync for the default account, authority, and
         * manual sync settings
         */
        ContentResolver.requestSync(mAccount, AUTHORITY, settingsBundle)
    }

জাভা

public class MainActivity extends FragmentActivity {
    ...
    // Constants
    // Content provider authority
    public static final String AUTHORITY =
            "com.example.android.datasync.provider";
    // Account type
    public static final String ACCOUNT_TYPE = "com.example.android.datasync";
    // Account
    public static final String ACCOUNT = "default_account";
    // Instance fields
    Account mAccount;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        /*
         * Create the placeholder account. The code for CreateSyncAccount
         * is listed in the lesson Creating a Sync Adapter
         */

        mAccount = CreateSyncAccount(this);
        ...
    }
    /**
     * Respond to a button click by calling requestSync(). This is an
     * asynchronous operation.
     *
     * This method is attached to the refresh button in the layout
     * XML file
     *
     * @param v The View associated with the method call,
     * in this case a Button
     */
    public void onRefreshButtonClick(View v) {
        // Pass the settings flags by inserting them in a bundle
        Bundle settingsBundle = new Bundle();
        settingsBundle.putBoolean(
                ContentResolver.SYNC_EXTRAS_MANUAL, true);
        settingsBundle.putBoolean(
                ContentResolver.SYNC_EXTRAS_EXPEDITED, true);
        /*
         * Request the sync for the default account, authority, and
         * manual sync settings
         */
        ContentResolver.requestSync(mAccount, AUTHORITY, settingsBundle);
    }