ক্রস-ডিভাইস হ্যান্ডঅফ চালু ও কাস্টমাইজ করা

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

সহায়তা চালু করুন

'চালিয়ে যান' (ডিফল্ট হিসেবে বন্ধ থাকে) ফিচারের জন্য সহায়তা প্রতিটি অ্যাক্টিভিটির ভিত্তিতে প্রয়োগ করতে হবে। ফিচারটি চালু করতে, বর্তমান অ্যাক্টিভিটি হ্যান্ডঅফের জন্য প্রস্তুত হিসেবে চিহ্নিত করতে setHandoffEnabled কল করুন। setHandoffEnabled(true, null) কল করা হলে, অ্যাক্টিভিটির জন্য যেকোনও সময় হ্যান্ডঅফ করা যেতে পারে, তাই অ্যাক্টিভিটি হ্যান্ডঅফ করার জন্য রেডি হলে তবেই কল করুন।

আপনি চেক করে দেখতে পারেন যে অ্যাক্টিভিটি isHandoffEnabled-এর সাথে চালিয়ে যান বিকল্প চালু করেছে কিনা। কোনও অ্যাক্টিভিটিতে হ্যান্ডঅফ চালু করা থাকলে, এটি অবশ্যই onHandoffActivityDataRequested প্রয়োগ করবে যাতে এটি একটি নন-নাল HandoffActivityData ফিরিয়ে দেয়, কারণ কোনও ডিফল্ট অ্যাকশন প্রয়োগ করা হয় না।

class MyHandoffActivity : Activity() {

    ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // Do stuff
    ...
    // Enable handoff
    setHandoffEnabled(true, null)
  }

  // Override and implement onHandoffActivityDataRequested
  override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {
    // Create and return handoff data
  }
}

আপনি HandoffActivityData অবজেক্টকে যেকোনও প্রাসঙ্গিক অতিরিক্ত তথ্য এবং একটি ফলব্যাক URI সহ কনফিগার করেন যাতে Continue On-কে জানানো যায় যে কীভাবে রিসিভ করা ডিভাইসে হ্যান্ডঅফ করতে হবে।

দুটি পরিস্থিতিতে সিস্টেমের এই ডেটা প্রয়োজন হয়:

  • অ্যাক্টিভিটি ব্যাকগ্রাউন্ডে চলে যাচ্ছে এবং প্রাসঙ্গিক ডেটা সেভ করতে হবে।
  • অ্যাক্টিভিটি ফোরগ্রাউন্ডে আছে এবং হ্যান্ডঅফের জন্য অনুরোধ করা হয়েছে। আপনি হ্যান্ডঅফ অনুরোধের স্ট্যাটাস চেক করতে পারবেন।

স্ট্যাটাস চেক করুন

HandoffActivityDataRequestInfo ক্লাস, কোনও অ্যাক্টিভিটি হ্যান্ড অফ করার জন্য বর্তমান অনুরোধ সম্পর্কে তথ্য প্রদান করে। অনুরোধটি বর্তমানে অ্যাক্টিভ আছে কিনা তা নির্ধারণ করতে isActiveRequest ব্যবহার করুন। মেথডটি যদি রিটার্ন করে

  • true, the current activity is in the foreground and the user has requested to Continue On another device, however if
  • false, অ্যাক্টিভিটি বন্ধ হয়ে গেছে এবং ব্যাকগ্রাউন্ডে চলছে, তবে ব্যবহারকারী ভবিষ্যতে হ্যান্ডঅফের অনুরোধ করতে পারেন।

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

// Override and implement onHandoffActivityDataRequested
override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {

  // Check whether the handoff request is active
  if (handoffRequestInfo.isActiveRequest()) {
    // Asynchronously show UI to let users know a handoff is in progress
  }

  // Create and return handoff data
}

হ্যান্ডঅফ ডেটা তৈরি করুন

'চালিয়ে যান' ফিচারের মাধ্যমে হ্যান্ডঅফ করার সময় সব প্রাসঙ্গিক ও প্রয়োজনীয় ডেটা পাস করা হয়েছে কিনা তা নিশ্চিত করতে, আপনাকে অবশ্যই HandoffActivityData অবজেক্টে ডেটা অন্তর্ভুক্ত করতে হবে।

HandoffActivityData ক্লাসটি কোনও অ্যাক্টিভিটির সাথে সম্পর্কিত হ্যান্ডঅফ ডেটা দেখায়। HandoffActivityData, Continue On-কে জানায় যে কীভাবে রিসিভ করা ডিভাইসে অ্যাক্টিভিটি ম্যানেজ ও আবার তৈরি করতে হবে। হ্যান্ডঅফ ডেটাতে এগুলি অন্তর্ভুক্ত থাকে:

  • কম্পোনেন্টের নাম (প্রয়োজনীয়): হ্যান্ডঅফের পরে ব্যবহারকারীর জার্নি আবার শুরু করার জন্য রিসিভ করা ডিভাইসে লঞ্চ করার জন্য সংশ্লিষ্ট অ্যাক্টিভিটির ComponentName। বেশিরভাগ ক্ষেত্রে এবং সঠিক অ্যাক্টিভিটি রেপ্লিকেশনের জন্য, এটি একই অ্যাক্টিভিটির জন্য কম্পোনেন্টের নাম হবে যা HandoffActivityData তৈরি করে।
  • অতিরিক্ত (ঐচ্ছিক): আপনি অতিরিক্ত তথ্য উল্লেখ করতে পারেন যা অ্যাক্টিভিটির শুরুতে Intent অন্তর্ভুক্ত করা হবে। এটি হল একটি PersistableBundle যা কম্পোনেন্টকে অতিরিক্ত তথ্য প্রদান করতে ব্যবহার করা যেতে পারে। এক্সট্রা অবশ্যই ৫০ কেবির কম হতে হবে।

HandoffActivityData অবজেক্ট তৈরি করতে, বিল্ডার ক্লাস ব্যবহার করুন, HandoffActivityData.Builder. অ্যাক্টিভিটির ComponentName পাস করে নতুন বিল্ডার তৈরি করুন যা হ্যান্ডঅফ পাবে (যেমন, বর্তমান Activity-এর জন্য this.getComponentName, অথবা একটি নির্দিষ্ট ComponentName(this, TargetActivity::class.java))। তারপর, ঐচ্ছিকভাবে অতিরিক্ত তথ্য নির্দিষ্ট করতে setExtras পদ্ধতি ব্যবহার করুন। শেষে, HandoffActivityData অবজেক্ট তৈরি করতে build কল করুন।

// Override and implement onHandoffActivityDataRequested
override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {

  // Check whether the handoff request is active
  if (handoffRequestInfo.isActiveRequest()) {
    // Asynchronously show UI to let users know a handoff is in progress
  }

  val extras: PersistableBundle = PersistableBundle()
  // Put relevant and necessary values into extras (e.g. scroll position)
  extras.putString("data_id", getDataId())
  extras.putInt("scroll_position", getScrollPosition())

  // Create and return handoff data
  return HandoffActivityData.Builder(getComponentName()) // Designate handoff to the same activity
    .setExtras(extras)
    .build()
}

ওয়েব ফলব্যাক বিকল্প সেট করুন

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

যেসব রিসিভিং ডিভাইসে আপনার অ্যাপ ইনস্টল করা নেই, সেখানে 'এতে চালিয়ে যান' সাজেশন দেখানোর অনুমতি দিতে, setHandoffEnabled কল করার সময় setAllowHandoffWithoutPackageInstalled-কে true-এ সেট করে HandoffActivityParams ইনস্ট্যান্স পাস করুন:

setHandoffEnabled(
  true,
  HandoffActivityParams.Builder()
    .setAllowHandoffWithoutPackageInstalled(true)
    .build()
)

তারপর আপনার HandoffActivityData-এ ফলব্যাক URL যোগ করুন:

val fallbackWebLink: Uri = Uri.parse("https://myapp.com/fallback?query=" + paramVal)

val handoffData: HandoffActivityData = HandoffActivityData.Builder(getComponentName())
  .setExtras(extras)
  .setFallbackUri(fallbackWebLink)
  .build()

সরাসরি ওয়েবে প্রয়োগ করুন

বিকল্প হিসেবে, ডাইরেক্ট-টু-ওয়েব হ্যান্ডঅফ প্রয়োগ করতে, HandoffActivityParams setAllowHandoffWithoutPackageInstalled(true)-এর সাথে setHandoffEnabled-এ পাস করুন, এবং HandoffActivityData জেনারেট করতে HandoffActivityData.createWebHandoff পদ্ধতি ব্যবহার করুন:

val webHandoffLink: Uri = Uri.parse("https://myapp.com/handoff?query=" + paramVal)

val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)

হ্যান্ডঅফ ইনটেন্ট রিসিভ ও ম্যানেজ করা

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

আপনি যদি একই অ্যাক্টিভিটিতে হ্যান্ডঅফ নির্দিষ্ট করেন, তাহলে আপনি অ্যাক্টিভিটির onCreate পদ্ধতিতে ইনটেন্ট পেতে পারেন যাতে ডেটা ফিরিয়ে আনা যায় এবং ব্যবহারকারীর জন্য যথাযথভাবে অটো-ফিল করা যায়।

class MyHandoffActivity : Activity() {

    ...

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

    // Get the launch intent and retrieve extras
    val intent: Intent = getIntent()
    if (intent != null && intent.hasExtra("data_id")) {
      val dataID: String = intent.getStringExtra("data_id")
      // Retrieve the data that corresponds to the data ID
      ...
      // Populate activity UI with relevant data
      ...

      if (intent.hasExtra("scroll_position")) {
        val scrollPosition: Int = intent.getIntExtra("scroll_position", 0)
        // Move the page to the scroll position
        ...
      }
    }
  }
}