คลาส GCKSessionManager

การอ้างอิงคลาส GCKSessionManager

ภาพรวม

คลาสที่จัดการเซสชัน

ระบบจะใช้วิธีการ startSessionWithDevice: (GCKSessionManager) เพื่อสร้างเซสชันใหม่ด้วย GCKDevice ที่ระบุ เครื่องมือจัดการเซสชันจะใช้ GCKDeviceProvider สำหรับอุปกรณ์ประเภทนั้นเพื่อสร้างออบเจ็กต์ GCKSession ใหม่ จากนั้นจะมอบหมายคำขอเซสชันทั้งหมดไปยังออบเจ็กต์ดังกล่าว

GCKSessionManager จัดการการกลับมาทำงานต่อโดยอัตโนมัติของเซสชันที่ถูกระงับ (นั่นคือ การกลับมาทำงานต่อของเซสชันที่สิ้นสุดลงเมื่อแอปพลิเคชันไปทำงานเบื้องหลัง หรือในกรณีที่แอปพลิเคชันขัดข้องหรือผู้ใช้ปิดแอปพลิเคชันโดยบังคับ) เมื่อแอปพลิเคชันกลับมาทำงานต่อหรือรีสตาร์ท ตัวจัดการเซสชันจะรอสักครู่เพื่อให้ผู้ให้บริการอุปกรณ์ของเซสชันที่ถูกระงับค้นพบอุปกรณ์นั้นอีกครั้ง และหากค้นพบ ตัวจัดการเซสชันจะพยายามเชื่อมต่อกับอุปกรณ์นั้นอีกครั้งและสร้างเซสชันใหม่โดยอัตโนมัติ

หากแอปพลิเคชันสร้าง GCKUICastButton โดยไม่ได้ระบุเป้าหมายและตัวเลือก เมื่อผู้ใช้แตะปุ่มดังกล่าว ระบบจะแสดงกล่องโต้ตอบ Cast เริ่มต้น และจะเริ่มและหยุดเซสชันโดยอัตโนมัติตามการเลือกของผู้ใช้หรือการยกเลิกการเชื่อมต่ออุปกรณ์ อย่างไรก็ตาม หากแอปพลิเคชันมี UI กล่องโต้ตอบการเลือก/ควบคุมอุปกรณ์ของตัวเอง ก็ควรใช้ GCKSessionManager โดยตรงเพื่อสร้างและควบคุมเซสชัน

ไม่ว่าแอปพลิเคชันจะใช้ GCKSessionManager เพื่อควบคุมเซสชันหรือไม่ก็ตาม แอปพลิเคชันสามารถแนบ GCKSessionManagerListener เพื่อรับการแจ้งเตือนเหตุการณ์เซสชัน และยังใช้ KVO เพื่อตรวจสอบพร็อพเพอร์ตี้ connectionState เพื่อติดตามสถานะวงจรเซสชันปัจจุบันได้ด้วย

Since
3.0

รับค่า NSObject

สรุปวิธีการของอินสแตนซ์

(instancetype) - init
 ตัวเริ่มต้นเริ่มต้นไม่พร้อมใช้งาน เพิ่มเติม...
 
(BOOL) - startSessionWithDevice:
 เริ่มเซสชันใหม่ด้วยอุปกรณ์ที่ระบุ เพิ่มเติม...
 
(BOOL) - suspendSessionWithReason:
 ระงับเซสชันปัจจุบัน เพิ่มเติม...
 
(BOOL) - endSession
 สิ้นสุดเซสชันปัจจุบัน เพิ่มเติม...
 
(BOOL) - endSessionAndStopCasting:
 สิ้นสุดเซสชันปัจจุบันและหยุดการแคสต์ (หากต้องการ) เพิ่มเติม...
 
(BOOL) - hasConnectedSession
 ทดสอบว่าเซสชันนี้ได้รับการจัดการโดยเครื่องมือจัดการเซสชันนี้และเชื่อมต่ออยู่หรือไม่ เพิ่มเติม...
 
(BOOL) - hasConnectedCastSession
 ทดสอบว่าเซสชัน Cast กำลังได้รับการจัดการโดยเครื่องมือจัดการเซสชันนี้และเชื่อมต่ออยู่หรือไม่ เพิ่มเติม...
 
(void) - addListener:
 เพิ่ม Listener สำหรับรับการแจ้งเตือน เพิ่มเติม...
 
(void) - removeListener:
 นำ Listener ที่เพิ่มไว้ก่อนหน้านี้ด้วย addListener: ออก เพิ่มเติม...
 

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

GCKSessioncurrentSession
 เซสชันปัจจุบัน (หากมี) เพิ่มเติม...
 
GCKCastSessioncurrentCastSession
 เซสชันการแคสต์ปัจจุบัน (หากมี) เพิ่มเติม...
 
GCKConnectionState connectionState
 สถานะการเชื่อมต่อเซสชันปัจจุบัน เพิ่มเติม...
 

รายละเอียดวิธีการ

- (instancetype) init

ตัวเริ่มต้นเริ่มต้นไม่พร้อมใช้งาน

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

เริ่มเซสชันใหม่ด้วยอุปกรณ์ที่ระบุ

นี่เป็นการดำเนินการแบบไม่พร้อมกัน

Parameters
deviceThe device to use for this session.
การคืนสินค้า
YES หากเริ่มการดำเนินการสำเร็จ NO หากมีเซสชันที่สร้างขึ้นในปัจจุบันหรือหากเริ่มการดำเนินการไม่ได้
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

ระงับเซสชันปัจจุบัน

นี่เป็นการดำเนินการแบบไม่พร้อมกัน

Parameters
reasonThe reason for the suspension.
การคืนสินค้า
YES หากการดำเนินการเริ่มต้นสำเร็จ NO หากไม่มีเซสชันที่สร้างขึ้นในขณะนี้หรือหากเริ่มต้นการดำเนินการไม่ได้
- (BOOL) endSession

สิ้นสุดเซสชันปัจจุบัน

นี่เป็นการดำเนินการแบบไม่พร้อมกัน

การคืนสินค้า
YES หากการดำเนินการเริ่มต้นสำเร็จ NO หากไม่มีเซสชันที่สร้างขึ้นในขณะนี้หรือหากเริ่มต้นการดำเนินการไม่ได้
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

สิ้นสุดเซสชันปัจจุบันและหยุดการแคสต์ (หากต้องการ)

นี่เป็นการดำเนินการแบบไม่พร้อมกัน

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
การคืนสินค้า
YES หากการดำเนินการเริ่มต้นสำเร็จ NO หากไม่มีเซสชันที่สร้างขึ้นในขณะนี้หรือหากเริ่มต้นการดำเนินการไม่ได้
- (BOOL) hasConnectedSession

ทดสอบว่าเซสชันนี้ได้รับการจัดการโดยเครื่องมือจัดการเซสชันนี้และเชื่อมต่ออยู่หรือไม่

ค่านี้จะเป็น YES หากสถานะเซสชันเป็น GCKConnectionStateConnected

- (BOOL) hasConnectedCastSession

ทดสอบว่าเซสชัน Cast กำลังได้รับการจัดการโดยเครื่องมือจัดการเซสชันนี้และเชื่อมต่ออยู่หรือไม่

ค่าจะเป็น YES หากสถานะเซสชันเป็น GCKConnectionStateConnected และเซสชันเป็นเซสชันการแคสต์

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

เพิ่ม Listener สำหรับรับการแจ้งเตือน

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

นำ Listener ที่เพิ่มไว้ก่อนหน้านี้ด้วย addListener: ออก

Parameters
listenerThe listener to remove.

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

- (GCKSession*) currentSession
readnonatomicstrong

เซสชันปัจจุบัน (หากมี)

- (GCKCastSession*) currentCastSession
readnonatomicstrong

เซสชันการแคสต์ปัจจุบัน (หากมี)

- (GCKConnectionState) connectionState
readnonatomicassign

สถานะการเชื่อมต่อเซสชันปัจจุบัน