Włączanie i dostosowywanie przenoszenia między urządzeniami

Funkcja Kontynuuj na wprowadza nowe metody i klasy, które pozwalają wskazać obsługę tej funkcji i podać niezbędne dane, które są przekazywane. Dzięki temu możesz prawidłowo wznowić działanie aplikacji na urządzeniu odbierającym.

Włącz obsługę

Obsługę funkcji Kontynuacja (domyślnie wyłączonej) należy wdrożyć dla każdej aktywności. Aby włączyć tę funkcję, wywołaj setHandoffEnabled, aby oznaczyć bieżącą aktywność jako gotową do przekazania. Po wywołaniu setHandoffEnabled(true, null) przekazanie może nastąpić w dowolnym momencie aktywności, dlatego wywołuj tę metodę tylko wtedy, gdy aktywność jest gotowa do przekazania.

Możesz sprawdzić, czy aktywność ma włączoną funkcję Kontynuacja, klikając isHandoffEnabled. Jeśli aktywność ma włączone przekazywanie, musi też implementować onHandoffActivityDataRequested, aby zwracać niepustą wartość HandoffActivityData, ponieważ nie jest zaimplementowane żadne działanie domyślne.

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

Obiekt HandoffActivityData konfigurujesz za pomocą odpowiednich dodatków i zastępczego identyfikatora URI, aby poinformować Continue On, jak ma przekazać dane do urządzenia odbierającego.

Te dane są potrzebne systemowi w 2 sytuacjach:

  • Aktywność przechodzi w tło i należy zapisać odpowiednie dane.
  • Aktywność jest na pierwszym planie i poproszono o przekazanie. Możesz sprawdzić stan prośby o przekazanie.

Sprawdź stan

Klasa HandoffActivityDataRequestInfo dostarcza informacji o bieżącym żądaniu przekazania aktywności. Użyj isActiveRequest, aby określić, czy żądanie jest obecnie aktywne. Jeśli metoda zwraca

  • true, bieżąca aktywność jest na pierwszym planie, a użytkownik poprosił o kontynuowanie na innym urządzeniu. Jeśli jednak
  • false – aktywność została zatrzymana i jest w tle, ale użytkownik może w przyszłości poprosić o przekazanie.

Jeśli na urządzeniu wysyłającym chcesz wyświetlić interfejs informujący użytkownika o tym, że przekazanie zostało wykonane lub jest w toku, możesz sprawdzić isActiveRequest pod kątem aktywnego żądania. Nie wykonuj jednak tego kodu synchronicznie w ramach onHandoffActivityDataRequested. Zamiast tego umieść kod w kolejce, aby uruchomić go asynchronicznie i nie blokować ani nie opóźniać przekazywania.

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

Tworzenie danych przekazywania

Aby mieć pewność, że podczas przekazywania za pomocą funkcji Kontynuuj na przekazywane są wszystkie istotne i niezbędne dane, musisz uwzględnić je w obiekcie HandoffActivityData.

Klasa HandoffActivityData reprezentuje dane przekazywania powiązane z aktywnością. HandoffActivityData informuje funkcję Kontynuuj na o tym, jak obsługiwać i odtwarzać aktywność na urządzeniu odbierającym. Dane przekazywania obejmują:

  • Nazwa komponentu (wymagana): ComponentName odpowiedniej aktywności, która ma zostać uruchomiona na urządzeniu odbierającym, aby wznowić działanie użytkownika po przekazaniu. W większości przypadków i w celu dokładnego odtworzenia aktywności będzie to nazwa komponentu dla tej samej aktywności, która tworzy HandoffActivityData.
  • Dodatki (opcjonalnie): możesz określić dodatki, które zostaną uwzględnione w Intent aktywności. Jest to PersistableBundle, który może służyć do przekazywania dodatkowych informacji do komponentu. Dodatki muszą mieć mniej niż 50 KB.

Aby utworzyć obiekty HandoffActivityData, użyj klasy kreatora HandoffActivityData.Builder. Utwórz nowy obiekt budujący, przekazując ComponentName aktywności, która powinna otrzymać przekazanie (np. this.getComponentName dla bieżącego Activity lub jawny ComponentName(this, TargetActivity::class.java)). Następnie użyj metody setExtras, aby opcjonalnie określić dodatkowe elementy. Na koniec wywołaj build, aby utworzyć obiekt 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()
}

Ustawianie opcji kreacji zastępczej w internecie

Jeśli określonej aktywności nie można uruchomić na urządzeniu odbierającym, możesz dodatkowo użyć setFallbackUri, aby opcjonalnie ustawić zastępczy adres URL, który zostanie otwarty na urządzeniu w przeglądarce domyślnej użytkownika.

Aby umożliwić wyświetlanie sugestii „Kontynuuj na” na urządzeniach odbierających, na których nie jest zainstalowana Twoja aplikacja, podczas wywoływania setHandoffEnabled przekaż instancję HandoffActivityParams z setAllowHandoffWithoutPackageInstalled ustawionym na true:

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

Następnie dodaj zastępczy adres URL do pliku HandoffActivityData:

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

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

Wdrażanie bezpośrednio w internecie

Możesz też wdrożyć przekazywanie bezpośrednio do internetu, przekazując HandoffActivityParams z setAllowHandoffWithoutPackageInstalled(true) do setHandoffEnabled i używając metody HandoffActivityData.createWebHandoff do wygenerowania HandoffActivityData:

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

val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)

Odbieranie i obsługiwanie intencji przekazania

Na urządzeniu odbierającym aplikacja musi obsłużyć przekazanie i odtworzyć stan z urządzenia wysyłającego. W aktywności określonej w obiekcie HandoffActivityData zwracanym przez metodę onHandoffActivityDataRequested musisz obsłużyć intencję i pobrać dodatkowe informacje o tym, jak prawidłowo odtworzyć aktywność.

Jeśli określasz przekazanie do tej samej aktywności, możesz otrzymać intencję w metodzie onCreate aktywności, aby dane mogły zostać pobrane i odpowiednio wstępnie wypełnione dla użytkownika.

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