GCKFilterCriteria 類別

GCKFilterCriteria 類別參考資料

總覽

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

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

  • 根據接收器應用程式 ID。結果只會列出支援指定接收器應用程式的裝置。這是最常用的條件;傳送者應用程式只希望找到實際支援對應的接收器應用程式的裝置。尤其在具有不同硬體功能的裝置中,尤其重要;舉例來說,影片播放器應用程式不應將內容投放到純音訊的投放裝置。

  • 透過支援的命名空間。搜尋結果所列出的接收器應用程式必須搭載支援特定通訊協定命名空間的裝置,才會列入搜尋結果。舉例來說,一般遙控器應用程式會使用這類條件搭配任何支援媒體命名空間的接收器應用程式。
Deprecated:
初始化 GCKCastContext 時,請使用 GCKCastOptions 指定探索條件。

沿用 NSObject、<NSCopy> 和 <NSCoding> 的 NSObject。

類別方法摘要

(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.