অন্যান্য অ্যাপকে আপনার অ্যাক্টিভিটি শুরু করতে দিন

আপনার অ্যাপ যদি এমন কোনও অ্যাকশন পারফর্ম করতে পারে যা অন্য অ্যাপের জন্য উপযোগী হতে পারে, তাহলে আপনার অ্যাক্টিভিটিতে উপযুক্ত ইনটেন্ট ফিল্টার নির্দিষ্ট করে অ্যাকশন অনুরোধের উত্তর দেওয়ার জন্য এটি প্রস্তুত করুন।

যেমন, আপনি যদি এমন কোনও সোশ্যাল অ্যাপ তৈরি করেন যা ব্যবহারকারীর বন্ধুদের সাথে মেসেজ বা ফটো শেয়ার করতে পারে, তাহলে ACTION_SEND ইনটেন্টকে সাপোর্ট করুন। তারপর, ব্যবহারকারী অন্য কোনও অ্যাপ থেকে "শেয়ার" অ্যাকশন শুরু করলে, আপনার অ্যাপটি বেছে নেওয়ার ডায়ালগে (দ্ব্যর্থতা নিরসন ডায়ালগ নামেও পরিচিত) একটি বিকল্প হিসেবে দেখানো হয়, যেমনটি চিত্র ১-এ দেখানো হয়েছে।

ছবি ১. বেছে নেওয়ার ডায়ালগ।

অন্যান্য অ্যাপকে এইভাবে আপনার অ্যাক্টিভিটি শুরু করার অনুমতি দিতে, সংশ্লিষ্ট <activity> এলিমেন্টের জন্য আপনার ম্যানিফেস্ট ফাইলে একটি <intent-filter> এলিমেন্ট যোগ করতে হবে।

কোনও ডিভাইসে আপনার অ্যাপ ইনস্টল করা হলে, সিস্টেম আপনার ইনটেন্ট ফিল্টার শনাক্ত করে এবং ইনস্টল করা সব অ্যাপের মাধ্যমে কাজ করে এমন ইনটেন্টের ইন্টার্নাল ক্যাটালগে তথ্য যোগ করে। কোনও অ্যাপ ইমপ্লিসিট ইনটেন্ট সহ startActivity() বা startActivityForResult() কল করলে, সিস্টেম এমন অ্যাক্টিভিটি চেক করে যা ইনটেন্টের উত্তর দিতে পারে।

ইনটেন্ট ফিল্টার যোগ করা

আপনার অ্যাক্টিভিটি কোন ইনটেন্ট ম্যানেজ করতে পারে তা সঠিকভাবে নির্ধারণ করতে, অ্যাক্টিভিটি যে ধরনের অ্যাকশন ও ডেটা গ্রহণ করে তার ভিত্তিতে আপনার যোগ করা প্রতিটি ইনটেন্ট ফিল্টারকে যতটা সম্ভব নির্দিষ্ট করুন।

সিস্টেম কোনও অ্যাক্টিভিটিতে প্রদত্ত Intent পাঠাতে পারে যদি সেই অ্যাক্টিভিটিতে একটি ইনটেন্ট ফিল্টার থাকে যা Intent অবজেক্টের নিম্নলিখিত মানদণ্ড পূরণ করে:

অ্যাকশন
অ্যাকশনের নাম সহ স্ট্রিং। সাধারণত প্ল্যাটফর্ম-নির্ধারিত ভ্যালুগুলির মধ্যে একটি, যেমন ACTION_SEND বা ACTION_VIEW।

<action> এলিমেন্টের মাধ্যমে আপনার ইনটেন্ট ফিল্টারে এটি উল্লেখ করুন। এই এলিমেন্টে আপনি যে ভ্যালু উল্লেখ করবেন সেটি অবশ্যই অ্যাকশনের সম্পূর্ণ স্ট্রিং নাম হতে হবে, API কনস্ট্যান্ট নয়, যেমন এই পৃষ্ঠার উদাহরণে দেখানো হয়েছে।

ডেটা
ইনটেন্টের সাথে যুক্ত ডেটার বিবরণ।

<data> এলিমেন্টের মাধ্যমে আপনার ইনটেন্ট ফিল্টারে এটি উল্লেখ করুন। এই এলিমেন্টে এক বা একাধিক অ্যাট্রিবিউট ব্যবহার করে, আপনি MIME-এর প্রকার, URI প্রিফিক্স, URI স্কিম বা এগুলির এবং অন্যান্য অ্যাট্রিবিউটের কম্বিনেশন নির্দিষ্ট করতে পারেন যা গৃহীত ডেটার ধরন নির্দেশ করে।

মনে রাখবেন: ডেটা সম্পর্কে নির্দিষ্ট তথ্য ঘোষণা করার প্রয়োজন না হলে Uri, যেমন আপনার অ্যাক্টিভিটি যখন অন্য ধরনের "অতিরিক্ত" ডেটা ম্যানেজ করে, তখন URI-এর পরিবর্তে, আপনার অ্যাক্টিভিটি যে ধরনের ডেটা ম্যানেজ করে তা ঘোষণা করতে শুধু android:mimeType অ্যাট্রিবিউট নির্দিষ্ট করুন, যেমন text/plain বা image/jpeg।

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

<category> এলিমেন্ট সহ আপনার ইনটেন্ট ফিল্টারে এটি উল্লেখ করুন।

আপনার ইনটেন্ট ফিল্টারে, আপনার অ্যাক্টিভিটি কোন কোন শর্ত গ্রহণ করে তা আপনি ঘোষণা করতে পারেন <intent-filter> এলিমেন্টে নেস্ট করা সংশ্লিষ্ট XML এলিমেন্টের সাথে সেগুলির প্রতিটি ঘোষণা করার মাধ্যমে।

যেমন, এখানে একটি অ্যাক্টিভিটি দেখানো হয়েছে যেখানে ইনটেন্ট ফিল্টার ব্যবহার করা হয়েছে। ডেটার ধরন টেক্সট বা ছবি হলে এটি ACTION_SEND ইনটেন্ট ম্যানেজ করে:

<activity android:name="ShareActivity">
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
        <data android:mimeType="image/*"/>
    </intent-filter>
</activity>

পরামর্শ: আপনি যদি চান যে, আপনার অ্যাক্টিভিটির ডিফল্ট আইকন থেকে বেছে নেওয়ার ডায়ালগের আইকন আলাদা হোক, তাহলে <intent-filter> এলিমেন্টে android:icon যোগ করুন।

প্রতিটি ইনকামিং ইনটেন্ট শুধুমাত্র একটি অ্যাকশন এবং একটি ডেটার ধরন নির্দিষ্ট করে, তবে প্রতিটি <intent-filter>-এ <action>, <category> এবং <data> এলিমেন্টের একাধিক ইনস্ট্যান্স ঘোষণা করা যেতে পারে।

অ্যাকশন ও ডেটার যেকোনও দুটি পেয়ারের আচরণ যদি একে অপরের থেকে আলাদা হয়, তাহলে কোন ডেটার ধরনের সাথে কোন অ্যাকশন গ্রহণযোগ্য তা নির্দিষ্ট করতে আলাদা ইনটেন্ট ফিল্টার তৈরি করুন।

যেমন, ধরুন আপনার অ্যাক্টিভিটি ACTION_SEND এবং ACTION_SENDTO ইনটেন্ট, দুটির জন্যই টেক্সট ও ছবি ম্যানেজ করে। এই ক্ষেত্রে, আপনাকে দুটি অ্যাকশনের জন্য দুটি আলাদা ইনটেন্ট ফিল্টার নির্ধারণ করতে হবে, কারণ ACTION_SENDTO ইনটেন্টকে অবশ্যই Uri ডেটা ব্যবহার করতে হবে যাতে send বা sendto URI স্কিম ব্যবহার করে প্রাপকের ঠিকানা নির্দিষ্ট করা যায়। এটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

<activity android:name="ShareActivity">
    <!-- Filter for sending text; accepts SENDTO action with sms URI schemes -->
    <intent-filter>
        <action android:name="android.intent.action.SENDTO"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="sms" />
        <data android:scheme="smsto" />
    </intent-filter>
    <!-- Filter for sending text or images; accepts SEND action and text or image data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

মনে রাখবেন: ইমপ্লিসিট ইনটেন্ট পেতে, আপনাকে ইনটেন্ট ফিল্টারে CATEGORY_DEFAULT বিভাগ অন্তর্ভুক্ত করতে হবে। startActivity() এবং startActivityForResult() পদ্ধতি সব ইনটেন্টকে এমনভাবে বিবেচনা করে যেন সেগুলি CATEGORY_DEFAULT ক্যাটেগরি ঘোষণা করেছে। আপনি ইনটেন্ট ফিল্টারে এটি ঘোষণা না করলে, কোনও ইমপ্লিসিট ইনটেন্ট আপনার অ্যাক্টিভিটি সমাধান করে না।

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

আপনার অ্যাক্টিভিটিতে ইনটেন্ট ম্যানেজ করুন

আপনার অ্যাক্টিভিটিতে কী অ্যাকশন নিতে হবে তা সিদ্ধান্ত নিতে, Intent পড়ুন যা এটি শুরু করতে ব্যবহার করা হয়।

আপনার অ্যাক্টিভিটি শুরু হওয়ার সাথে সাথে, অ্যাক্টিভিটি শুরু করা Intent ফিরিয়ে আনতে getIntent()-এ কল করুন। অ্যাক্টিভিটির লাইফসাইকেলের যেকোনও সময় আপনি এটি করতে পারেন, তবে সাধারণত onCreate() বা onStart()-এর মতো প্রাথমিক কলব্যাকের সময় এটি করা হয়।

এটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    setContentView(R.layout.main)

    val data: Uri? = intent?.data

    // Figure out what to do based on the intent type
    if (intent?.type?.startsWith("image/") == true) {
        // Handle intents with image data
    } else if (intent?.type == "text/plain") {
        // Handle intents with text
    }
}

জাভা

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    setContentView(R.layout.main);

    // Get the intent that started this activity
    Intent intent = getIntent();
    Uri data = intent.getData();

    // Figure out what to do based on the intent type
    if (intent.getType().indexOf("image/") != -1) {
        // Handle intents with image data
    } else if (intent.getType().equals("text/plain")) {
        // Handle intents with text
    }
}

ফলাফল ফিরিয়ে দিন

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

Kotlin

// Create intent to deliver some kind of result data
Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result ->
    setResult(Activity.RESULT_OK, result)
}
finish()

জাভা

// Create intent to deliver some kind of result data
Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri"));
setResult(Activity.RESULT_OK, result);
finish();

আপনাকে সবসময় ফলাফলের সাথে ফলাফল কোড উল্লেখ করতে হবে। সাধারণত, এটি হয় RESULT_OK অথবা RESULT_CANCELED। তারপর আপনি প্রয়োজন অনুযায়ী Intent-এর মাধ্যমে অতিরিক্ত ডেটা প্রদান করতে পারবেন।

মনে রাখবেন: ডিফল্ট হিসেবে ফলাফল RESULT_CANCELED -এ সেট করা থাকে। তাই, ব্যবহারকারী অ্যাকশন সম্পূর্ণ করার আগে এবং আপনি ফলাফল সেট করার আগে 'ফিরে যান' বোতামে ট্যাপ করলে, আসল অ্যাক্টিভিটি "বাতিল করা হয়েছে" ফলাফল পায়।

আপনাকে যদি শুধু এমন একটি পূর্ণসংখ্যা রিটার্ন করতে হয় যা একাধিক ফলাফল বিকল্পের মধ্যে একটিকে নির্দেশ করে, তাহলে আপনি ফলাফল কোডটি ০-এর বেশি যেকোনও মানে সেট করতে পারেন। আপনি যদি কোনও পূর্ণসংখ্যা ডেলিভার করার জন্য ফলাফল কোড ব্যবহার করেন এবং আপনার Intent অন্তর্ভুক্ত করার প্রয়োজন না হয়, তাহলে আপনি setResult() কল করতে পারেন এবং শুধুমাত্র একটি ফলাফল কোড পাস করতে পারেন:

Kotlin

setResult(RESULT_COLOR_RED)
finish()

জাভা

setResult(RESULT_COLOR_RED);
finish();

এই ক্ষেত্রে, শুধুমাত্র কয়েকটি সম্ভাব্য ফলাফল থাকতে পারে, তাই ফলাফল কোডটি স্থানীয়ভাবে সংজ্ঞায়িত পূর্ণসংখ্যা (০-এর বেশি)। আপনার নিজের অ্যাপে কোনও অ্যাক্টিভিটিতে ফলাফল রিটার্ন করার সময় এটি ভালভাবে কাজ করে, কারণ যে অ্যাক্টিভিটি ফলাফল পায় সেটি ফলাফল কোডের ভ্যালু নির্ধারণ করার জন্য পাবলিক কনস্ট্যান্টকে রেফারেন্স হিসেবে ব্যবহার করতে পারে।

মনে রাখবেন: আপনার অ্যাক্টিভিটি startActivity() বা startActivityForResult() দিয়ে শুরু হয়েছে কিনা তা চেক করার প্রয়োজন নেই। আপনার অ্যাক্টিভিটি শুরু করা ইনটেন্ট কোনও ফলাফল আশা করলে, শুধু setResult() কল করুন। যদি startActivityForResult()-এর মাধ্যমে অ্যাক্টিভিটি শুরু হয়, তাহলে সিস্টেম setResult()-এ আপনার দেওয়া ফলাফল ডেলিভার করে; অন্যথায়, ফলাফল উপেক্ষা করা হয়।