startWithCompletionHandler:

Declaration

- (void) startWithCompletionHandler:(void (^)(NSError *launchError, AVSystemRouteMediaSession *mediaSession)) completionHandler;

Parameters

• completionHandler:

  A completion handler called when the launch operation completes. The handler receives two parameters: - launchError: An error object if the launch failed, or nil on success. - mediaSession: A media session object for communicating with the remote device. Access its Datachannel property to send and receive data between your app and the remote application. Access its Playbackcontrol property to send and receive playback commands between your app and the remote application. For Player, Datachannel is nil.

Discussion

Call this method to begin the playback session after adding it to an AVSystemRoute. The session uses the URL and launch mode specified during initialization to start playback on the remote device.

When using AVSystemRouteLaunchMode.application, your app must declare supported protocol identifiers in the MDESupportedProtocols key in your Info.plist file. These identifiers enable the system to establish communication between your app and its counterpart on the remote device.

After a successful launch with AVSystemRouteLaunchMode.application, the returned AVSystemRouteMediaSession provides access to a dataChannel and a playbackControl. Use these objects to send playback commands, state updates, or custom messages between your app and the remote application.

Report playback metadata to MPNowPlayingInfoCenter to ensure the system displays accurate information about the current media across a person’s devices.