เปิดใช้และปรับแต่งการส่งต่อข้ามอุปกรณ์

ฟีเจอร์ "ดำเนินการต่อใน" จะเปิดตัวเมธอดและคลาสใหม่เพื่อให้คุณระบุการรองรับฟีเจอร์นี้และให้ข้อมูลที่จำเป็นซึ่งจะส่งต่อมาด้วย ซึ่งจะช่วยให้คุณกลับมาแสดงประสบการณ์ของผู้ใช้ในอุปกรณ์ที่รับได้อย่างเหมาะสม

เปิดใช้การรองรับ

ต้องใช้การรองรับฟีเจอร์ "ดำเนินการต่อ" (ปิดอยู่โดยค่าเริ่มต้น) ในแต่ละกิจกรรม หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เรียกใช้ 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
        ...
      }
    }
  }
}