ฟีเจอร์ "ดำเนินการต่อใน" จะเปิดตัวเมธอดและคลาสใหม่เพื่อให้คุณระบุการรองรับฟีเจอร์นี้และให้ข้อมูลที่จำเป็นซึ่งจะส่งต่อมาด้วย ซึ่งจะช่วยให้คุณกลับมาแสดงประสบการณ์ของผู้ใช้ในอุปกรณ์ที่รับได้อย่างเหมาะสม
เปิดใช้การรองรับ
ต้องใช้การรองรับฟีเจอร์ "ดำเนินการต่อ" (ปิดอยู่โดยค่าเริ่มต้น) ในแต่ละกิจกรรม หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เรียกใช้ setHandoffEnabled เพื่อระบุว่ากิจกรรมปัจจุบันพร้อมสำหรับการส่งต่อแล้ว เมื่อเรียกใช้ setHandoffEnabled(true, null) แล้ว การส่งต่อจะเกิดขึ้นได้ทุกเมื่อสำหรับกิจกรรม ดังนั้นให้เรียกใช้เมื่อกิจกรรมพร้อมที่จะส่งต่อเท่านั้น
คุณตรวจสอบได้ว่ากิจกรรมเปิดใช้ "ทำต่อใน" หรือไม่โดยใช้ isHandoffEnabled หากกิจกรรมเปิดใช้การส่งต่อ ก็ต้องใช้ onHandoffActivityDataRequested ด้วยเพื่อให้มั่นใจว่าจะแสดงผล HandoffActivityData ที่ไม่ใช่ค่า Null เนื่องจากไม่มีการใช้ลักษณะการทำงานเริ่มต้น
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 สำรองเพื่อแจ้งให้ "ดำเนินการต่อใน" ทราบถึงวิธีส่งต่อไปยังอุปกรณ์ที่รับ
ระบบต้องการข้อมูลนี้ใน 2 สถานการณ์ต่อไปนี้
- กิจกรรมกำลังจะทำงานในเบื้องหลัง และต้องบันทึกข้อมูลที่เกี่ยวข้อง
- กิจกรรมอยู่เบื้องหน้า และมีการขอส่งต่อ คุณสามารถตรวจสอบสถานะของคำขอส่งต่อได้
ตรวจสอบสถานะ
คลาส HandoffActivityDataRequestInfo จะให้ข้อมูลเกี่ยวกับคำขอปัจจุบันเพื่อส่งต่อกิจกรรม ใช้ isActiveRequest เพื่อพิจารณาว่าคำขอทำงานอยู่หรือไม่ หากเมธอดแสดงผล
- เป็นจริง กิจกรรมปัจจุบันจะอยู่เบื้องหน้าและผู้ใช้ได้ขอให้ "เล่นต่อในอุปกรณ์อื่น" อย่างไรก็ตาม หาก
- 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 จะแจ้งให้ "ทำต่อใน" ทราบเกี่ยวกับวิธีจัดการและสร้างกิจกรรมอีกครั้งในอุปกรณ์ที่รับ ข้อมูลการส่งต่อประกอบด้วยข้อมูลต่อไปนี้
- ชื่อคอมโพเนนต์ (ต้องระบุ):
ComponentNameของกิจกรรมที่เกี่ยวข้องที่จะเปิดในอุปกรณ์รับเพื่อกลับมาดำเนินการต่อในเส้นทางของผู้ใช้หลังจากการส่งต่อ ในกรณีส่วนใหญ่และสำหรับการจำลองกิจกรรมที่เหมือนกันทุกประการ นี่จะเป็นชื่อคอมโพเนนต์สำหรับกิจกรรมเดียวกันที่สร้างHandoffActivityData - Extras (ไม่บังคับ): คุณสามารถระบุข้อมูลเพิ่มเติมที่จะรวมไว้ใน
Intentของกิจกรรมได้ นี่คือPersistableBundleที่ใช้เพื่อระบุข้อมูลเพิ่มเติมให้กับคอมโพเนนต์ได้ ส่วนเสริมต้องมีขนาดไม่เกิน 50 KB
หากต้องการสร้างออบเจ็กต์ HandoffActivityData ให้ใช้คลาส Builder HandoffActivityData.Builder สร้าง Builder ใหม่โดยส่ง ComponentName ของกิจกรรมที่ควรได้รับการส่งต่อ (เช่น this.getComponentName สำหรับ Activity ปัจจุบัน หรือ ComponentName(this, TargetActivity::class.java) ที่ชัดเจน) จากนั้นใช้เมธอด setExtras เพื่อระบุข้อมูลเพิ่มเติม (ไม่บังคับ) สุดท้าย ให้เรียกใช้ build เพื่อสร้างออบเจ็กต์ 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()
}
ตั้งค่าตัวเลือกสำรองสำหรับเว็บ
ในกรณีที่ไม่สามารถเริ่มกิจกรรมที่ระบุในอุปกรณ์ที่รับ คุณสามารถใช้ setFallbackUri เพิ่มเติมเพื่อตั้งค่า URL สำรอง (ไม่บังคับ) ที่เปิดในอุปกรณ์ในเบราว์เซอร์เริ่มต้นของผู้ใช้
หากต้องการอนุญาตให้คำแนะนำ "ดำเนินการต่อใน" ปรากฏในอุปกรณ์ที่รับซึ่งไม่ได้ติดตั้งแอปของคุณ ให้ส่งอินสแตนซ์ HandoffActivityParams โดยตั้งค่า setAllowHandoffWithoutPackageInstalled เป็น true เมื่อเรียกใช้ setHandoffEnabled:
setHandoffEnabled(
true,
HandoffActivityParams.Builder()
.setAllowHandoffWithoutPackageInstalled(true)
.build()
)
จากนั้นใส่ URL สำรองใน HandoffActivityData ดังนี้
val fallbackWebLink: Uri = Uri.parse("https://myapp.com/fallback?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.Builder(getComponentName())
.setExtras(extras)
.setFallbackUri(fallbackWebLink)
.build()
ติดตั้งใช้งาน Direct to Web
หรือหากต้องการใช้การส่งต่อจากแอปไปยังเว็บโดยตรง ให้ส่ง HandoffActivityParams พร้อม setAllowHandoffWithoutPackageInstalled(true) ไปยัง setHandoffEnabled และใช้เมธอด HandoffActivityData.createWebHandoff เพื่อสร้าง HandoffActivityData ดังนี้
val webHandoffLink: Uri = Uri.parse("https://myapp.com/handoff?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)
รับและจัดการ Intent การส่งต่อ
ในอุปกรณ์ที่รับ แอปของคุณต้องจัดการการส่งต่อและสร้างประสบการณ์การใช้งานของผู้ใช้จากอุปกรณ์ที่ส่งขึ้นมาใหม่ กล่าวคือ ในกิจกรรมที่คุณระบุใน HandoffActivityData ที่ onHandoffActivityDataRequested แสดงผล คุณต้องจัดการ Intent และดึงข้อมูลเพิ่มเติมที่มีข้อมูลเกี่ยวกับวิธีสร้างกิจกรรมอีกครั้งอย่างเหมาะสม
หากคุณระบุการส่งต่อไปยังกิจกรรมเดียวกัน คุณจะรับ Intent ได้ในเมธอด 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
...
}
}
}
}