Tính năng Tiếp tục trên thiết bị khác giới thiệu các phương thức và lớp mới để bạn cho biết khả năng hỗ trợ tính năng này và cung cấp dữ liệu cần thiết được truyền đi. Điều này cho phép bạn tiếp tục trải nghiệm người dùng một cách chính xác trên thiết bị nhận.
Bật chế độ hỗ trợ
Bạn phải triển khai tính năng hỗ trợ cho Continue On (tắt theo mặc định) trên cơ sở từng hoạt động. Để bật tính năng này, hãy gọi setHandoffEnabled để biểu thị hoạt động hiện tại là đã sẵn sàng chuyển giao. Sau khi setHandoffEnabled(true, null) được gọi, quá trình chuyển giao có thể diễn ra tại bất kỳ thời điểm nào cho hoạt động, vì vậy, chỉ gọi phương thức này khi hoạt động đã sẵn sàng để chuyển giao.
Bạn có thể kiểm tra xem hoạt động đã bật tính năng Tiếp tục trên bằng isHandoffEnabled hay chưa. Nếu một hoạt động đã bật tính năng chuyển giao, thì hoạt động đó cũng phải triển khai onHandoffActivityDataRequested để đảm bảo trả về một HandoffActivityData không rỗng, vì không có hành vi mặc định nào được triển khai.
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
}
}
Bạn định cấu hình đối tượng HandoffActivityData bằng mọi dữ liệu bổ sung có liên quan và một URI dự phòng để thông báo cho tính năng Tiếp tục trên về cách thực hiện chuyển giao cho thiết bị nhận.
Có hai trường hợp mà hệ thống cần dữ liệu này:
- Hoạt động đang chuyển sang chế độ nền và dữ liệu liên quan phải được lưu.
- Hoạt động đang diễn ra ở nền trước và đã có yêu cầu chuyển giao. Bạn có thể kiểm tra trạng thái của yêu cầu chuyển giao.
Kiểm tra trạng thái
Lớp HandoffActivityDataRequestInfo cung cấp thông tin về yêu cầu hiện tại để chuyển giao một hoạt động. Sử dụng isActiveRequest để xác định xem yêu cầu hiện có đang hoạt động hay không. Nếu phương thức trả về
- true, hoạt động hiện tại đang chạy trên nền trước và người dùng đã yêu cầu Tiếp tục trên một thiết bị khác, tuy nhiên nếu
- false, hoạt động đã dừng và đang ở chế độ nền, nhưng người dùng có thể yêu cầu chuyển giao trong tương lai.
Trên thiết bị gửi, nếu muốn hiển thị giao diện người dùng để cho người dùng biết rằng quá trình chuyển giao đã xảy ra hoặc đang diễn ra, bạn có thể kiểm tra isActiveRequest để biết yêu cầu đang hoạt động. Tuy nhiên, đừng thực thi mã này một cách đồng bộ trong onHandoffActivityDataRequested. Thay vào đó, hãy đưa mọi mã vào hàng đợi để chạy không đồng bộ nhằm không chặn hoặc trì hoãn quá trình chuyển giao.
// 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
}
Tạo dữ liệu chuyển giao
Để đảm bảo tất cả dữ liệu liên quan và cần thiết được truyền trong quá trình chuyển giao bằng tính năng Tiếp tục trên, bạn phải đưa dữ liệu vào đối tượng HandoffActivityData.
Lớp HandoffActivityData đại diện cho dữ liệu chuyển giao liên kết với một hoạt động. HandoffActivityData thông báo cho tính năng Tiếp tục trên về cách xử lý và tạo lại một hoạt động trên thiết bị nhận. Dữ liệu chuyển giao bao gồm:
- Tên thành phần (bắt buộc):
ComponentNamecủa một hoạt động tương ứng để chạy trên thiết bị nhận nhằm tiếp tục hành trình của người dùng sau khi chuyển giao. Trong hầu hết các trường hợp và để sao chép chính xác hoạt động, đây sẽ là tên thành phần cho cùng một hoạt động tạoHandoffActivityData. - Extras (không bắt buộc): Bạn có thể chỉ định các thuộc tính bổ sung sẽ được đưa vào
Intentbắt đầu của hoạt động. Đây là mộtPersistableBundlecó thể dùng để cung cấp thêm thông tin cho thành phần. Extras must be less than 50KB.
Để tạo đối tượng HandoffActivityData, hãy sử dụng lớp trình tạo HandoffActivityData.Builder. Tạo một trình tạo mới bằng cách truyền ComponentName của hoạt động sẽ nhận chuyển giao (ví dụ: this.getComponentName cho Activity hiện tại hoặc ComponentName(this, TargetActivity::class.java) rõ ràng). Sau đó, hãy sử dụng phương thức setExtras để chỉ định các thành phần bổ sung (không bắt buộc). Cuối cùng, hãy gọi build để tạo đối tượng 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()
}
Đặt lựa chọn dự phòng trên web
Trong trường hợp không thể bắt đầu hoạt động được chỉ định trên thiết bị nhận, bạn có thể sử dụng thêm setFallbackUri để tuỳ ý đặt URL dự phòng được mở trên thiết bị trong trình duyệt mặc định của người dùng.
Để cho phép đề xuất Tiếp tục trên xuất hiện trên các thiết bị nhận chưa cài đặt ứng dụng của bạn, hãy truyền một thực thể HandoffActivityParams có setAllowHandoffWithoutPackageInstalled được đặt thành true khi gọi setHandoffEnabled:
setHandoffEnabled(
true,
HandoffActivityParams.Builder()
.setAllowHandoffWithoutPackageInstalled(true)
.build()
)
Sau đó, hãy thêm URL dự phòng vào HandoffActivityData:
val fallbackWebLink: Uri = Uri.parse("https://myapp.com/fallback?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.Builder(getComponentName())
.setExtras(extras)
.setFallbackUri(fallbackWebLink)
.build()
Triển khai trực tiếp lên web
Ngoài ra, để triển khai tính năng chuyển giao trực tiếp đến web, hãy truyền HandoffActivityParams
bằng setAllowHandoffWithoutPackageInstalled(true) đến setHandoffEnabled,
rồi sử dụng phương thức HandoffActivityData.createWebHandoff để tạo
HandoffActivityData:
val webHandoffLink: Uri = Uri.parse("https://myapp.com/handoff?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)
Nhận và xử lý ý định chuyển giao
Trên thiết bị nhận, ứng dụng của bạn phải xử lý việc chuyển giao và tạo lại trải nghiệm của người dùng từ thiết bị gửi. Cụ thể, trong hoạt động mà bạn đã chỉ định trong HandoffActivityData do onHandoffActivityDataRequested trả về, bạn cần xử lý ý định và truy xuất các thành phần bổ sung có thông tin về cách tạo lại hoạt động một cách phù hợp.
Nếu đang chỉ định chuyển giao cho cùng một hoạt động, bạn có thể nhận ý định trong phương thức onCreate của hoạt động để có thể truy xuất dữ liệu và điền sẵn dữ liệu phù hợp cho người dùng.
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
...
}
}
}
}