returnToCall(requestID:)

Declaration

@MainActor static func returnToCall(requestID: UUID)

Discussion

Use this method when the framework launches your app in order to satisfy a request from your extension for the person using the app to sign in or provide other information. After your app collects the needed information, call this method from inside the onContinueUserActivity(_:perform:) (SwiftUI) or application(_:continue:restorationHandler:) (UIKit) method where you handle the activity type containerAppLaunchActivityType. For the parameter requestID, fetch the value of containerAppLaunchRequestIDKey from the userInfo dictionary of the NSUserActivity sent to the launch method.

This method returns immediately. After you call it, the system foregrounds the FaceTime call and invokes the extension’s resumeRequest(_:) to indicate that the container app has finished its work and the extension can continue setting up live assistance.

If the system doesn’t recognize requestID — possibly because the call ended or the person canceled the request — the framework silently ignores returnToCall(_:). The container app doesn’t need to perform any clean-up work in this situation.