GCKCastOptions Class
Stay organized with collections
Save and categorize content based on your preferences.
Options that affect the discovery of Cast devices and the behavior of Cast sessions.
Writable properties must be set before passing this object to the GCKCastContext.
- Since
- 3.0
Inherits NSObject, <NSCopying>, and <NSSecureCoding>.
Constructs a new GCKCastOptions object with the specified discovery criteria.
- Parameters
-
| discoveryCriteria | The discovery criteria to apply to discovered Cast devices. Only those devices that satisfy the criteria will be made available to the application. |
- Since
- 4.0
| - (instancetype) initWithReceiverApplicationID: |
|
(NSString *) |
applicationID |
|
Constructs a new GCKCastOptions object with the specified receiver application ID.
- Parameters
-
| applicationID | The ID of the receiver application which must be supported by discovered Cast devices, and which will be launched when starting a new Cast session. |
- Deprecated:
- Use initWithDiscoveryCriteria:.
| - (instancetype) initWithSupportedNamespaces: |
|
(NSArray< NSString * > *) |
namespaces |
|
Constructs a new GCKCastOptions object with the specified list of namespaces.
- Parameters
-
| namespaces | A list of namespaces which must be supported by the currently running receiver application on each discovered Cast device. |
- Deprecated:
- Use initWithDiscoveryCriteria:.
| - (BOOL) physicalVolumeButtonsWillControlDeviceVolume |
|
readwritenonatomicassign |
A flag indicating whether the sender device's physical volume buttons should control the session's volume.
| - (BOOL) disableDiscoveryAutostart |
|
readwritenonatomicassign |
| - (BOOL) disableAnalyticsLogging |
|
readwritenonatomicassign |
A flag which is used to disable or enable collection of diagnostic data to improve the reliability of Cast device discovery.
The default value is NO (enabled); it may be disabled by setting the value to YES.
- Since
- 4.0
The receiver launch options to use when starting a Cast session.
| - (NSString*) sharedContainerIdentifier |
|
readwritenonatomiccopy |
The shared container identifier to use for background HTTP downloads that are performed by the framework.
- Since
- 3.2
| - (BOOL) suspendSessionsWhenBackgrounded |
|
readwritenonatomicassign |
Whether sessions should be suspended when the sender application goes into the background (and resumed when it returns to the foreground).
By default this option is set to YES. It is appropriate to set this to NO in applications that are able to maintain network connections indefinitely while in the background.
- Since
- 3.4
| - (BOOL) stopReceiverApplicationWhenEndingSession |
|
readwritenonatomicassign |
Whether the receiver application should be terminated when the user ends the session via the "Stop Casting" button.
By default this option is set to NO.
- Since
- 4.0
| - (BOOL) startDiscoveryAfterFirstTapOnCastButton |
|
readwritenonatomicassign |
Whether cast devices discovery start only after a user taps on the GCKUICastButton the first time.
If set to YES, GCKUICastButton is displayed until a user taps on the cast button the first time. On the first tap, an interstitial is presented to explain why local network access permission is required for the cast to work. Discovery starts once the interstitial is dismissed. The cast button is shown again only when the device is connected to a Wi-Fi network. When a Wi-Fi network connection is not present, the cast button is hidden. If set to NO, discovery starts based on the flag disableDiscoveryAutoStart. This flag comes into effect only on iOS 14 and above if the flag disableDiscoveryAutoStart is set to NO. Default value is YES.
- Since
- 4.5.3
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["GCKCastOptions manages the discovery of Cast devices and Cast session behavior, with writable properties needing configuration before use."],["It offers various options, including controlling session volume with device buttons, managing discovery timing, and handling session suspension and receiver application termination."],["Developers can specify discovery criteria, receiver application ID, and supported namespaces to refine the Cast device selection process."],["GCKCastOptions also allows customization of launch options, background downloads, and the behavior of the Cast button on iOS 14 and above."],["It's worth noting that some initialization methods using receiver application ID or supported namespaces are deprecated in favor of using discovery criteria for more flexibility."]]],[]]