Mengaktifkan dan menyesuaikan pengalihan lintas perangkat

Lanjutkan memperkenalkan metode dan class baru bagi Anda untuk menunjukkan dukungan terhadap fitur tersebut dan memberikan data yang diperlukan yang akan diteruskan. Hal ini memungkinkan Anda melanjutkan pengalaman pengguna dengan benar di perangkat penerima.

Mengaktifkan dukungan

Dukungan untuk Lanjutkan Di (nonaktif secara default) harus diterapkan per aktivitas. Untuk mengaktifkan fitur ini, panggil setHandoffEnabled untuk menunjukkan aktivitas saat ini sebagai siap ditransfer. Setelah setHandoffEnabled(true, null) dipanggil, handoff dapat terjadi kapan saja untuk aktivitas, jadi panggil hanya saat aktivitas siap untuk diserahkan.

Anda dapat memeriksa apakah aktivitas telah mengaktifkan Lanjutkan Di dengan isHandoffEnabled. Jika aktivitas telah mengaktifkan handoff, aktivitas tersebut juga harus mengimplementasikan onHandoffActivityDataRequested untuk memastikan aktivitas tersebut menampilkan HandoffActivityData non-null, karena tidak ada perilaku default yang diimplementasikan.

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
  }
}

Anda mengonfigurasi objek HandoffActivityData dengan tambahan yang relevan dan URI penggantian untuk memberi tahu Continue On tentang cara melakukan handoff ke perangkat penerima.

Ada dua situasi saat data ini diperlukan oleh sistem:

  • Aktivitas akan berjalan di latar belakang, dan data yang relevan harus disimpan.
  • Aktivitas berada di latar depan, dan handoff telah diminta. Anda dapat memeriksa status permintaan pengalihan.

Periksa status

Class HandoffActivityDataRequestInfo memberikan informasi tentang permintaan saat ini untuk menyerahkan aktivitas. Gunakan isActiveRequest untuk menentukan apakah permintaan saat ini aktif. Jika metode menampilkan

  • true, aktivitas saat ini berada di latar depan dan pengguna telah meminta untuk Melanjutkan di perangkat lain, tetapi jika
  • false, aktivitas telah berhenti dan berada di latar belakang, tetapi pengguna dapat meminta handoff pada masa mendatang.

Di perangkat pengirim, jika Anda ingin menampilkan UI untuk menunjukkan kepada pengguna bahwa handoff telah terjadi atau sedang berlangsung, Anda dapat memeriksa isActiveRequest untuk permintaan aktif. Namun, jangan jalankan kode ini secara sinkron sebagai bagian dari onHandoffActivityDataRequested. Sebagai gantinya, antrekan kode apa pun untuk dijalankan secara asinkron agar tidak memblokir atau menunda penyerahan.

// 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
}

Membuat data serah terima

Untuk memastikan semua data yang relevan dan diperlukan diteruskan selama pengalihan dengan fitur Lanjutkan Di, Anda harus menyertakan data dalam objek HandoffActivityData.

Class HandoffActivityData mewakili data handoff yang terkait dengan aktivitas. HandoffActivityData memberi tahu Lanjutkan Di tentang cara menangani dan membuat ulang aktivitas di perangkat penerima. Data serah terima mencakup:

  • Nama komponen (wajib): ComponentName aktivitas yang sesuai untuk diluncurkan di perangkat penerima guna melanjutkan perjalanan pengguna setelah handoff. Dalam sebagian besar kasus dan untuk replikasi aktivitas yang sama, ini akan menjadi nama komponen untuk aktivitas yang sama yang membuat HandoffActivityData.
  • Tambahan (opsional): Anda dapat menentukan tambahan yang akan disertakan dalam Intent awal aktivitas. Ini adalah PersistableBundle yang dapat digunakan untuk memberikan informasi tambahan ke komponen. Tambahan harus berukuran kurang dari 50 KB.

Untuk membuat objek HandoffActivityData, gunakan class builder, HandoffActivityData.Builder. Buat builder baru dengan meneruskan ComponentName aktivitas yang akan menerima handoff (misalnya, this.getComponentName untuk Activity saat ini, atau ComponentName(this, TargetActivity::class.java) eksplisit). Kemudian, gunakan metode setExtras untuk menentukan tambahan secara opsional. Terakhir, panggil build untuk membuat objek HandoffActivityData.

// 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()
}

Menetapkan opsi penggantian web

Jika aktivitas yang ditentukan tidak dapat dimulai di perangkat penerima, Anda juga dapat menggunakan setFallbackUri untuk menetapkan URL pengganti opsional yang dibuka di perangkat di browser default pengguna.

Untuk mengizinkan saran Lanjutkan Di muncul di perangkat penerima tempat aplikasi Anda tidak diinstal, teruskan instance HandoffActivityParams dengan setAllowHandoffWithoutPackageInstalled ditetapkan ke true saat memanggil setHandoffEnabled:

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

Kemudian, sertakan URL pengganti di HandoffActivityData Anda:

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

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

Menerapkan langsung ke web

Atau, untuk menerapkan handoff langsung ke web, teruskan HandoffActivityParams dengan setAllowHandoffWithoutPackageInstalled(true) ke setHandoffEnabled, dan gunakan metode HandoffActivityData.createWebHandoff untuk membuat HandoffActivityData:

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

val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)

Menerima dan menangani intent pengalihan

Di perangkat penerima, aplikasi Anda harus menangani pengalihan dan membuat ulang pengalaman pengguna dari perangkat pengirim. Secara khusus, dalam aktivitas yang Anda tentukan di HandoffActivityData yang ditampilkan oleh onHandoffActivityDataRequested, Anda perlu menangani intent dan mengambil tambahan yang memiliki informasi tentang cara membuat ulang aktivitas dengan tepat.

Jika Anda menentukan handoff ke aktivitas yang sama, Anda dapat menerima intent dalam metode onCreate aktivitas sehingga data dapat diambil dan diisi otomatis dengan tepat untuk pengguna.

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
        ...
      }
    }
  }
}