An object representing options that can be passed to a Cast-enabled application via a deep-link URL.
The source app encodes the Cast-specific options (including the unique ID of the device to cast to, and optionally the session ID of a specific Cast session to join) in a query parameter of the application URL using asURLQueryItem (GCKOpenURLOptions), and then opens the URL using UIApplication's
-[openURL:options:completionHandler:] method. The target app extracts the Cast-specific options from the URL it receives in its UIApplicationDelegate's
-[application:openURL:options:] method by calling openURLOptionsFromURL: (GCKOpenURLOptions). It then starts or joins a Cast session by passing these options to startSessionWithOpenURLOptions:sessionOptions: (GCKSessionManager).
Inherits NSObject, <NSCopying>, and <NSSecureCoding>.
Instance Method Summary
|(NSURLQueryItem *)||- asURLQueryItem|
|Converts the options into a URL query item. More...|
Class Method Summary
|(nullable GCKOpenURLOptions *)||+ openURLOptionsFromURL:|
|Extracts the Cast-specific options from the specified URL. More...|
|The unique ID of the device to connect to. More...|
|The friendly name of the device to connect to. More...|
|The session ID of the Cast session to join. More...|
|+ (nullable GCKOpenURLOptions *) openURLOptionsFromURL:||(NSURL *)||url|
Extracts the Cast-specific options from the specified URL.
- The extracted options, or
nilif the URL did not contain any Cast-specific options.
|- (NSURLQueryItem *) asURLQueryItem|
Converts the options into a URL query item.
- The options as an NSURLQueryItem.
The unique ID of the device to connect to.
The friendly name of the device to connect to.
Optional. This value is not used by the GoogleCast framework, but may be of interest to the receiving application.
The session ID of the Cast session to join.
Optional. A value of
nil indicates that any currently active session should be joined, or if there is none, that a new one should be created.