교차 기기 핸드오프 사용 설정 및 맞춤설정하기

'다른 기기에서 계속'은 이 기능에 대한 지원을 표시하고 전달되는 필수 데이터를 제공하는 새로운 메서드와 클래스를 도입합니다. 이렇게 하면 수신 기기에서 사용자 환경을 올바르게 재개할 수 있습니다.

지원 사용 설정

계속하기 (기본적으로 사용 중지됨) 지원은 활동별로 구현해야 합니다. 이 기능을 사용 설정하려면 setHandoffEnabled를 호출하여 현재 활동을 핸드오프 준비 상태로 표시합니다. setHandoffEnabled(true, null)가 호출되면 활동의 어느 시점에서든 핸드오프가 발생할 수 있으므로 활동을 핸드오프할 준비가 된 경우에만 호출하세요.

isHandoffEnabled를 사용하여 활동에서 다른 기기에서 계속을 사용 설정했는지 확인할 수 있습니다. 활동에서 핸드오프를 사용 설정한 경우 onHandoffActivityDataRequested도 구현하여 null이 아닌 HandoffActivityData를 반환하도록 해야 합니다. 기본 동작이 구현되지 않기 때문입니다.

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

관련 추가 항목과 대체 URI를 사용하여 HandoffActivityData 객체를 구성하여 수신 기기로의 핸드오프를 실행하는 방법을 Continue On에 알립니다.

시스템에서 이 데이터가 필요한 상황은 두 가지입니다.

  • 활동이 백그라운드로 전환되고 관련 데이터를 저장해야 합니다.
  • 활동이 포그라운드에 있고 핸드오프가 요청되었습니다. 핸드오프 요청 상태를 확인할 수 있습니다.

상태 확인

HandoffActivityDataRequestInfo 클래스는 활동을 핸드오프하는 현재 요청에 관한 정보를 제공합니다. isActiveRequest를 사용하여 요청이 현재 활성 상태인지 확인합니다. 메서드가 반환하는 경우

  • true인 경우 현재 활동이 포그라운드에 있고 사용자가 다른 기기에서 계속을 요청한 것입니다.
  • 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는 수신 기기에서 활동을 처리하고 다시 만드는 방법을 Continue On에 알립니다. 핸드오프 데이터에는 다음이 포함됩니다.

  • 구성요소 이름 (필수): 핸드오프 후 사용자의 여정을 재개하기 위해 수신 기기에서 실행할 해당 활동의 ComponentName입니다. 대부분의 경우 정확한 활동 복제를 위해 HandoffActivityData를 만드는 동일한 활동의 구성요소 이름입니다.
  • Extras (선택사항): 활동의 시작 Intent에 포함될 extras를 지정할 수 있습니다. 이는 구성요소에 추가 정보를 제공하는 데 사용할 수 있는 PersistableBundle입니다. 추가 항목은 50KB 미만이어야 합니다.

HandoffActivityData 객체를 만들려면 빌더 클래스 HandoffActivityData.Builder를 사용합니다. 핸드오프를 수신해야 하는 활동의 ComponentName(예: 현재 Activity의 this.getComponentName 또는 명시적 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을 선택적으로 설정할 수 있습니다.

앱이 설치되지 않은 수신 기기에 '다른 기기에서 계속' 추천이 표시되도록 하려면 setHandoffEnabled를 호출할 때 setAllowHandoffWithoutPackageInstalled가 true로 설정된 HandoffActivityParams 인스턴스를 전달합니다.

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

그런 다음 HandoffActivityData에 대체 URL을 포함합니다.

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

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

웹으로 바로 연결 구현

또는 웹으로 직접 전달을 구현하려면 HandoffActivityParams를 setAllowHandoffWithoutPackageInstalled(true)와 함께 setHandoffEnabled에 전달하고 HandoffActivityData.createWebHandoff 메서드를 사용하여 HandoffActivityData를 생성합니다.

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

val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)

핸드오프 인텐트 수신 및 처리

수신 기기에서 앱은 핸드오프를 처리하고 전송 기기에서 사용자 환경을 다시 만들어야 합니다. 구체적으로는 onHandoffActivityDataRequested에서 반환한 HandoffActivityData에 지정한 활동에서 인텐트를 처리하고 활동을 적절하게 다시 만드는 방법에 관한 정보가 있는 추가 항목을 가져와야 합니다.

동일한 활동으로의 핸드오프를 지정하는 경우 활동의 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
        ...
      }
    }
  }
}