คลาส GCKDiscoveryManager

ข้อมูลอ้างอิงคลาส GCKDiscoveryManager

ภาพรวม

ชั้นเรียนที่จัดการกระบวนการค้นพบอุปกรณ์

GCKDiscoveryManager จัดการคอลเล็กชัน GCKDeviceProvider ของคลาสย่อยของอินสแตนซ์ย่อย ซึ่งมีหน้าที่ค้นหาอุปกรณ์บางประเภท และยังเก็บรักษารายการตามลําดับของอุปกรณ์ที่พบได้ในปัจจุบันซึ่งเขียนด้วยตัวอักษรอีกด้วย

เฟรมเวิร์กจะเริ่มกระบวนการค้นหาโดยอัตโนมัติเมื่อแอปพลิเคชันย้ายไปยังเบื้องหน้า และระงับกระบวนการเมื่อแอปพลิเคชันย้ายไปทํางานเบื้องหลัง โดยทั่วไปแอปพลิเคชันไม่จําเป็นต้องโทรหา startDiscovery (GCKDiscoveryManager) และ stopDiscovery (GCKDiscoveryManager) ยกเว้นเป็นมาตรการเพิ่มประสิทธิภาพเพื่อลดการจราจรของข้อมูลในเครือข่ายและการใช้งาน CPU ในพื้นที่ของแอปพลิเคชันที่ไม่ได้ใช้ฟังก์ชันแคสต์

หากแอปพลิเคชันใช้กล่องโต้ตอบแคสต์ของเฟรมเวิร์ก ไม่ว่าจะโดย GCKUICastButton หรือด้วยการนําเสนอโดยตรง กล่องโต้ตอบดังกล่าวจะใช้ GCKDiscoveryManager เพื่อสร้างรายการอุปกรณ์ที่พร้อมใช้งาน หากแอปพลิเคชันมี UI กล่องโต้ตอบการเลือก/ควบคุมอุปกรณ์ของตนเอง แอปพลิเคชันดังกล่าวควรใช้ GCKDiscoveryManager และโปรโตคอล Listener ที่เกี่ยวข้อง GCKDiscoveryManagerListener เพื่อป้อนข้อมูลและอัปเดตรายชื่ออุปกรณ์ที่พร้อมใช้งาน

Since
3.0

รับค่า NSObject

สรุปเมธอดของอินสแตนซ์

(instancetype) - init
 เครื่องมือเริ่มต้นเริ่มต้นไม่พร้อมใช้งาน เพิ่มเติม...
 
(void) - addListener:
 เพิ่ม Listener ที่จะได้รับการแจ้งเตือนการค้นพบ เพิ่มเติม...
 
(void) - removeListener:
 นํา Listener ที่ลงทะเบียนก่อนหน้านี้ออก เพิ่มเติม...
 
(void) - startDiscovery
 เริ่มกระบวนการค้นหา เพิ่มเติม...
 
(void) - stopDiscovery
 หยุดกระบวนการค้นหา เพิ่มเติม...
 
(BOOL) - isDiscoveryActiveForDeviceCategory:
 ทดสอบว่าขณะนี้หมวดหมู่อุปกรณ์ที่ใช้งานอยู่ใช้งาน Discovery อยู่หรือไม่ เพิ่มเติม...
 
(GCKDevice *) - deviceAtIndex:
 แสดงผลอุปกรณ์ในดัชนีที่ระบุในรายการอุปกรณ์ที่พบของผู้จัดการ เพิ่มเติม...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 แสดงผลอุปกรณ์ที่มีรหัสที่ไม่ซ้ํากันในรายชื่ออุปกรณ์ที่พบของผู้จัดการ เพิ่มเติม...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 รอให้ระบบค้นพบอุปกรณ์ที่มีรหัสที่ไม่ซ้ํากัน แล้วเรียกใช้การบล็อกเวอร์ชันเสร็จสมบูรณ์ เพิ่มเติม...
 
(void) - cancelFindOperation
 ยกเลิกการดําเนินการค้นหาที่กําลังดําเนินการซึ่งเริ่มต้นโดย findDeviceWithUniqueID:timeout:completion: เพิ่มเติม...
 

สรุปพร็อพเพอร์ตี้

GCKDiscoveryState discoveryState
 สถานะการค้นพบปัจจุบัน เพิ่มเติม...
 
BOOL hasDiscoveredDevices
 การแจ้งที่บ่งชี้ว่ามีผู้ให้บริการรายใดค้นพบอุปกรณ์ที่จัดการโดยออบเจ็กต์นี้หรือไม่ เพิ่มเติม...
 
BOOL passiveScan
 แฟล็กที่ระบุว่าการค้นพบควรใช้การสแกน "Passive" เพิ่มเติม...
 
BOOL discoveryActive
 แฟล็กที่ระบุว่าการค้นหาทํางานอยู่หรือไม่ เพิ่มเติม...
 
NSUInteger deviceCount
 จํานวนอุปกรณ์ที่ค้นพบอยู่ในขณะนี้ เพิ่มเติม...
 

รายละเอียดเมธอด

- (instancetype) init

เครื่องมือเริ่มต้นเริ่มต้นไม่พร้อมใช้งาน

- (void) addListener: (id< GCKDiscoveryManagerListener >)  listener

เพิ่ม Listener ที่จะได้รับการแจ้งเตือนการค้นพบ

ฟัง Listener ที่เพิ่มเข้ามาโดยไม่รัดกุม และควรเก็บไว้เพื่อหลีกเลี่ยงดีลที่ไม่คาดคิด

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKDiscoveryManagerListener >)  listener

นํา Listener ที่ลงทะเบียนก่อนหน้านี้ออก

Parameters
listenerThe listener to remove.
- (void) startDiscovery

เริ่มกระบวนการค้นหา

- (void) stopDiscovery

หยุดกระบวนการค้นหา

- (BOOL) isDiscoveryActiveForDeviceCategory: (NSString *)  deviceCategory

ทดสอบว่าขณะนี้หมวดหมู่อุปกรณ์ที่ใช้งานอยู่ใช้งาน Discovery อยู่หรือไม่

- (GCKDevice *) deviceAtIndex: (NSUInteger)  index

แสดงผลอุปกรณ์ในดัชนีที่ระบุในรายการอุปกรณ์ที่พบของผู้จัดการ

- (nullable GCKDevice *) deviceWithUniqueID: (NSString *)  uniqueID

แสดงผลอุปกรณ์ที่มีรหัสที่ไม่ซ้ํากันในรายชื่ออุปกรณ์ที่พบของผู้จัดการ

Parameters
uniqueIDThe device's unique ID.
การคืนสินค้า
ออบเจ็กต์ GCKDevice ที่ตรงกัน หรือ nil หากไม่พบอุปกรณ์ที่ตรงกัน
- (void) findDeviceWithUniqueID: (NSString *)  uniqueID
timeout: (NSTimeInterval)  timeout
completion: (void(^)(GCKDevice *))  completion 

รอให้ระบบค้นพบอุปกรณ์ที่มีรหัสที่ไม่ซ้ํากัน แล้วเรียกใช้การบล็อกเวอร์ชันเสร็จสมบูรณ์

หากมีอุปกรณ์ที่ตรงกันอยู่ในรายการอุปกรณ์ที่พบอยู่แล้ว ระบบจะเรียกใช้การบล็อกให้เสร็จสมบูรณ์ทันที (แต่หลังจากที่วิธีนี้กลับมา) การดําเนินการค้นหาจะใช้งานได้ได้ครั้งละ 1 รายการเท่านั้น การเริ่มการค้นหาใหม่กําลังดําเนินการอย่างใดอย่างหนึ่งจะยกเลิกการดําเนินการปัจจุบัน

Parameters
uniqueIDThe unique ID of the device.
timeoutThe maximum amount of time to wait for the device to be discovered.
completionThe completion block to invoke when either the device is found or the timeout is reached. The device (if found) or nil (if not found) will be passed to the completion block.
Since
4.0
- (void) cancelFindOperation

ยกเลิกการดําเนินการค้นหาที่กําลังดําเนินการซึ่งเริ่มต้นโดย findDeviceWithUniqueID:timeout:completion:

Since
4.0

รายละเอียดพร็อพเพอร์ตี้

- (GCKDiscoveryState) discoveryState
readnonatomicassign

สถานะการค้นพบปัจจุบัน

- (BOOL) hasDiscoveredDevices
readnonatomicassign

การแจ้งที่บ่งชี้ว่ามีผู้ให้บริการรายใดค้นพบอุปกรณ์ที่จัดการโดยออบเจ็กต์นี้หรือไม่

- (BOOL) passiveScan
readwritenonatomicassign

แฟล็กที่ระบุว่าการค้นพบควรใช้การสแกน "Passive"

การสแกนแบบแพสซีฟไม่จําเป็นต้องใช้ทรัพยากรมาก แต่ไม่ได้ให้ผลการค้นหาที่สดเท่ากับการสแกนที่ทํางานอยู่

- (BOOL) discoveryActive
readnonatomicassign

แฟล็กที่ระบุว่าการค้นหาทํางานอยู่หรือไม่

Since
3.4
- (NSUInteger) deviceCount
readnonatomicassign

จํานวนอุปกรณ์ที่ค้นพบอยู่ในขณะนี้