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):
ComponentNameaktivitas 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 membuatHandoffActivityData. - Tambahan (opsional): Anda dapat menentukan tambahan yang akan disertakan dalam
Intentawal aktivitas. Ini adalahPersistableBundleyang 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
...
}
}
}
}