ภาพรวม
คลาสที่จัดการเซสชัน
ระบบจะใช้วิธีการ 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: ออก เพิ่มเติม... | |
สรุปพร็อพเพอร์ตี้ | |
GCKSession * | currentSession |
เซสชันปัจจุบัน (หากมี) เพิ่มเติม... | |
GCKCastSession * | currentCastSession |
เซสชันการแคสต์ปัจจุบัน (หากมี) เพิ่มเติม... | |
GCKConnectionState | connectionState |
สถานะการเชื่อมต่อเซสชันปัจจุบัน เพิ่มเติม... | |
รายละเอียดวิธีการ
- (instancetype) init |
ตัวเริ่มต้นเริ่มต้นไม่พร้อมใช้งาน
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
เริ่มเซสชันใหม่ด้วยอุปกรณ์ที่ระบุ
นี่เป็นการดำเนินการแบบไม่พร้อมกัน
- Parameters
-
device The device to use for this session.
- การคืนสินค้า
YES
หากเริ่มการดำเนินการสำเร็จNO
หากมีเซสชันที่สร้างขึ้นในปัจจุบันหรือหากเริ่มการดำเนินการไม่ได้
- (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
ระงับเซสชันปัจจุบัน
นี่เป็นการดำเนินการแบบไม่พร้อมกัน
- Parameters
-
reason The reason for the suspension.
- การคืนสินค้า
YES
หากการดำเนินการเริ่มต้นสำเร็จNO
หากไม่มีเซสชันที่สร้างขึ้นในขณะนี้หรือหากเริ่มต้นการดำเนินการไม่ได้
- (BOOL) endSession |
สิ้นสุดเซสชันปัจจุบัน
นี่เป็นการดำเนินการแบบไม่พร้อมกัน
- การคืนสินค้า
YES
หากการดำเนินการเริ่มต้นสำเร็จNO
หากไม่มีเซสชันที่สร้างขึ้นในขณะนี้หรือหากเริ่มต้นการดำเนินการไม่ได้
- (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
สิ้นสุดเซสชันปัจจุบันและหยุดการแคสต์ (หากต้องการ)
นี่เป็นการดำเนินการแบบไม่พร้อมกัน
- Parameters
-
stopCasting Whether 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
-
listener The listener to add.
- (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
นำ Listener ที่เพิ่มไว้ก่อนหน้านี้ด้วย addListener: ออก
- Parameters
-
listener The listener to remove.
รายละเอียดพร็อพเพอร์ตี้
|
readnonatomicstrong |
เซสชันปัจจุบัน (หากมี)
|
readnonatomicstrong |
เซสชันการแคสต์ปัจจุบัน (หากมี)
|
readnonatomicassign |
สถานะการเชื่อมต่อเซสชันปัจจุบัน