Instance Method

handleStartAudioCall:completion:

Called when it is time for you to hand off the call to your app.

Required.

Declaration

- (void)handleStartAudioCall:(INStartAudioCallIntent *)intent completion:(void (^)(INStartAudioCallIntentResponse *response))completion;

Parameters

intent

The intent object containing details about the user’s request. The information in this object has already been resolved and confirmed by the user.

completion

The handler block to execute with your response. You must execute this handler at some point during your implementation of this method. This handler has no return value and takes the following parameter:

response

The INStartAudioCallIntentResponse object containing the status of the request. This parameter must not be nil.

Discussion

Use this method to turn control of the call over to your app. Perform any final checks and create a response object with the information needed to initiate the call in your app. Do not try to initiate the call directly from this method. When your response object contains the INStartAudioCallIntentResponseCodeContinueInApp code, Siri automatically launches your app and passes it the NSUserActivity object from your response object.