GCKFilterCriteria Class

GCKFilterCriteria Class Reference

Overview

Filter criteria to be applied to the results of device discovery.

The criteria is used to restrict which discovered devices are published by the GCKDeviceScanner. There are two ways to filter the results of a device discovery scan:

  • By receiver application ID. Only those devices which support the given receiver application will be included in the results. This is the most commonly used criteria; a sender application will only want to discover those devices that actually support the corresponding receiver application. This is particularly important in the presence of devices with various hardware capabilities; for example, a video player application should not cast to an audio-only Cast device.

  • By supported namespaces. Only those devices which are currently running a receiver application that supports the given protocol namespaces will be included in the results. As an example, this type of criteria would be used by a generic remote-control sender application which can be used with any receiver application that supports the media namespace.
Deprecated:
Specify discovery criteria with GCKCastOptions when initializing the GCKCastContext.

Inherits NSObject, <NSCopying>, and <NSCoding>.

Class Method Summary

(instancetype) + criteriaForAvailableApplicationWithID:
 Criteria for an application which is available to be launched on a device. More...
 
(instancetype) + criteriaForRunningApplicationWithID:supportedNamespaces:
 Criteria for an application which is currently running on the device and supports all of the given namespaces, optionally also with a particular application ID. More...
 
(instancetype) + criteriaForRunningApplicationWithSupportedNamespaces:
 Criteria for an application which is currently running on the device and supports all of the given namespaces. More...
 

Method Detail

+ (instancetype) criteriaForAvailableApplicationWithID: (NSString *__nullable)  applicationID

Criteria for an application which is available to be launched on a device.

The application does not need to be currently running.

Parameters
applicationIDThe application ID. Must be non-nil.
+ (instancetype) criteriaForRunningApplicationWithID: (NSString *__nullable)  applicationID
supportedNamespaces: (NSArray< NSString * > *__nullable)  supportedNamespaces 

Criteria for an application which is currently running on the device and supports all of the given namespaces, optionally also with a particular application ID.

Parameters
applicationIDThe application ID. Optional; may be nil, in which case only the namespace will be used.
supportedNamespacesAn array of namespace strings. May not be nil.
Deprecated:
Filtering by running application ID is not supported. Calling this method will ignore the applicationID parameter and simply delegate to criteriaForRunningApplicationWithSupportedNamespaces:.
+ (instancetype) criteriaForRunningApplicationWithSupportedNamespaces: (NSArray< NSString * > *)  supportedNamespaces

Criteria for an application which is currently running on the device and supports all of the given namespaces.

Parameters
supportedNamespacesAn array of namespace strings. May not be nil.