คลาส GCKSessionManager

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

ภาพรวม

ชั้นเรียนที่จัดการเซสชัน

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

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

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

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

Since
3.0

รับค่า NSObject

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

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

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

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

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

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

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

นําผู้ฟังที่เพิ่มด้วย addListener: ไว้ก่อนหน้านี้ออก

Parameters
listenerThe listener to remove.

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

- (GCKSession*) currentSession
readnonatomicstrong

เซสชันปัจจุบัน (ถ้ามี)

- (GCKCastSession*) currentCastSession
readnonatomicstrong

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

- (GCKConnectionState) connectionState
readnonatomicassign

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