คลาส 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:
 ทดสอบว่าการค้นหาใช้งานได้หรือไม่สำหรับหมวดหมู่อุปกรณ์ที่ระบุ เพิ่มเติม...
 
(GCKDevice *) - deviceAtIndex:
 แสดงผลอุปกรณ์ตามดัชนีที่ระบุในรายการอุปกรณ์ที่ค้นพบของผู้จัดการ เพิ่มเติม...
 
(nullable GCKDevice *) - deviceWithUniqueID:
 แสดงอุปกรณ์ที่มีรหัสที่ไม่ซ้ำกันตามที่ระบุในรายการอุปกรณ์ที่ค้นพบของผู้จัดการ เพิ่มเติม...
 
(void) - findDeviceWithUniqueID:timeout:completion:
 รอให้ระบบค้นพบอุปกรณ์ที่มีรหัสที่ไม่ซ้ำกันที่กำหนด แล้วเรียกใช้บล็อกการเสร็จสมบูรณ์ เพิ่มเติม...
 
(void) - cancelFindOperation
 ยกเลิกการดำเนินการค้นหาที่อยู่ระหว่างดำเนินการที่เริ่มต้นโดย findDeviceWithUniqueID:timeout:completion: เพิ่มเติม...
 

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

GCKDiscoveryState discoveryState
 สถานะการค้นพบปัจจุบัน เพิ่มเติม...
 
BOOL hasDiscoveredDevices
 ธงที่บ่งชี้ว่ามีการค้นพบอุปกรณ์โดยผู้ให้บริการการค้นพบที่ออบเจ็กต์นี้จัดการหรือไม่ เพิ่มเติม...
 
BOOL passiveScan
 ธงที่บ่งชี้ว่าการค้นพบควรใช้การสแกน "แฝง" หรือไม่ เพิ่มเติม...
 
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

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

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

ธงที่บ่งชี้ว่าการค้นพบควรใช้การสแกน "แฝง" หรือไม่

การสแกนแบบแพสซีฟจะใช้ทรัพยากรน้อยกว่า แต่ไม่ได้ให้ผลลัพธ์ที่ใหม่เท่ากับการสแกนที่ทำงานอยู่

- (BOOL) discoveryActive
readnonatomicassign

ธงที่บ่งชี้ว่าการค้นพบทำงานอยู่หรือไม่

Since
3.4
- (NSUInteger) deviceCount
readnonatomicassign

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