Instance Method

getContinuationStreamsWithCompletionHandler:

Requests streams back to the originating app.

Declaration

- (void)getContinuationStreamsWithCompletionHandler:(void (^)(NSInputStream *inputStream, NSOutputStream *outputStream, NSError *error))completionHandler;

Parameters

completionHandler

The completion handler block that returns streams.

The block takes three arguments:

inputStream

The stream from which the continuing app can read data written by the originating app.

outputStream

The stream to which the continuing app writes data to be read by the originating app.

error

If successful, nil; if not successful, an NSError object that encapsulates the reason why the streams could not be created.

Discussion

When an app is launched for a continuation event, it can request streams back to the originating app. Streams can be successfully retrieved only from the NSUserActivity object in the NSApplication or UIApplication delegate that is called for a continuation event. The streams are provided by the completion handler in an unopened state, and the delegate should open them immediately to start communicating with the continuing side.

Continuation streams are an optional feature of Handoff, and most user activities do not need them for successful continuation. When streams are needed, a simple request from the continuing app accompanied by a response from the originating app is enough for most continuation events.

See Also

Working with Continuation Streams

supportsContinuationStreams

A Boolean value that determines whether the continuing app can request streams to be opened back to the originating app.