GCKFilterCriteria 類別

GCKFilterCriteria 類別參考資料

總覽

要套用至裝置探索結果的篩選條件。

這項條件用於限制 GCKDeviceScanner 發布的探索裝置。您可以透過下列兩種方式篩選裝置探索掃描結果:

  • 依接收端應用程式 ID。結果只會顯示支援指定接收端應用程式的裝置。這是最常用的條件,因為傳送端應用程式只會想探索實際支援對應接收端應用程式的裝置。如果裝置的硬體功能各不相同,這點就特別重要。舉例來說,影片播放器應用程式不應投放至僅支援音訊的 Cast 裝置。

  • 支援的命名空間。結果只會顯示目前執行接收器應用程式的裝置,且這些應用程式必須支援指定的通訊協定命名空間。舉例來說,如果是一般遙控器傳送端應用程式,這類條件就會派上用場,因為這類應用程式可搭配支援媒體命名空間的任何接收端應用程式使用。
Deprecated:
初始化 GCKCastContext 時,請使用 GCKCastOptions 指定探索條件。

繼承 NSObject、<NSCopying> 和 <NSCoding>。

類別方法摘要

(instancetype) + criteriaForAvailableApplicationWithID:
 可在裝置上啟動應用程式的條件。更多...
 
(instancetype) + criteriaForRunningApplicationWithID:supportedNamespaces:
 目前在裝置上執行的應用程式,且支援所有指定命名空間 (也可選擇指定應用程式 ID) 的條件。更多...
 
(instancetype) + criteriaForRunningApplicationWithSupportedNamespaces:
 條件:應用程式目前在裝置上執行,且支援所有指定的命名空間。更多...
 

方法詳細資料

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

可在裝置上啟動應用程式的條件。

應用程式不需目前正在執行。

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

目前在裝置上執行的應用程式,且支援所有指定命名空間 (也可選擇指定應用程式 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:
不支援依執行中的應用程式 ID 篩選。呼叫這個方法會忽略 applicationID 參數,並直接委派給 criteriaForRunningApplicationWithSupportedNamespaces:
+ (instancetype) criteriaForRunningApplicationWithSupportedNamespaces: (NSArray< NSString * > *)  supportedNamespaces

應用程式目前在裝置上執行,且支援所有指定的命名空間。

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