คลาส GCKSession

เมธอดอินสแตนซ์ | พร็อพเพอร์ตี้

ข้อมูลอ้างอิงเกี่ยวกับคลาส GCKSession

ภาพรวม

คลาสฐานแบบนามธรรมที่แสดงเซสชันกับอุปกรณ์ตัวรับ

คลาสย่อยต้องใช้เมธอด start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) และ resume (GCKSession(Protected)) และต้องเรียกใช้เมธอด Notifier ที่เหมาะสม (เช่น notifyDidStartWithSessionID: (GCKSession(Protected))) เพื่อระบุการเปลี่ยนแปลงที่เกี่ยวข้องในสถานะเซสชัน นอกจากนี้ คลาสย่อยยังอาจใช้ setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) และ remoteMediaClient หากอุปกรณ์รองรับการดำเนินการดังกล่าว

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

Since

3.0

รับค่า NSObject

รับค่าจาก GCKCastSession

สรุปวิธีการของอินสแตนซ์
(instancetype)	- initWithDevice:traits:sessionID:
	เริ่มต้นออบเจ็กต์เซสชันใหม่สำหรับอุปกรณ์ที่ระบุ เพิ่มเติม...
(GCKRequest *)	- setDeviceVolume:
	ตั้งค่าระดับเสียงของอุปกรณ์ เพิ่มเติม...
(GCKRequest *)	- setDeviceMuted:
	ตั้งค่าสถานะปิดเสียงของอุปกรณ์ เพิ่มเติม...
(void)	- start
	เริ่มเซสชัน เพิ่มเติม...
(void)	- endAndStopCasting:
	สิ้นสุดเซสชัน เพิ่มเติม...
(void)	- suspendWithReason:
	ระงับเซสชันด้วยเหตุผลที่ระบุ เพิ่มเติม...
(void)	- resume
	ดำเนินการเซสชันต่อ เพิ่มเติม...
(void)	- notifyDidStartWithSessionID:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันเริ่มต้นแล้ว เพิ่มเติม...
(void)	- notifyDidFailToStartWithError:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันเริ่มไม่สำเร็จ เพิ่มเติม...
(void)	- notifyDidResume
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันกลับมาทำงานต่อแล้ว เพิ่มเติม...
(void)	- notifyDidSuspendWithReason:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันถูกระงับแล้ว เพิ่มเติม...
(void)	- notifyDidEndWithError:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันสิ้นสุดแล้ว เพิ่มเติม...
(void)	- notifyDidReceiveDeviceVolume:muted:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าได้รับระดับเสียงและสถานะปิดเสียงที่อัปเดตแล้วจากอุปกรณ์ เพิ่มเติม...
(void)	- notifyDidReceiveDeviceStatus:
	เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าได้รับสถานะที่อัปเดตจากอุปกรณ์แล้ว เพิ่มเติม...

สรุปพร็อพเพอร์ตี้
GCKDevice *	device
	อุปกรณ์ที่เซสชันนี้เชื่อมโยงอยู่ เพิ่มเติม...
NSString *	sessionID
	รหัสเซสชันปัจจุบัน (หากมี) เพิ่มเติม...
GCKConnectionState	connectionState
	สถานะการเชื่อมต่อเซสชันปัจจุบัน เพิ่มเติม...
BOOL	suspended
	แฟล็กที่ระบุว่าเซสชันถูกระงับอยู่หรือไม่ เพิ่มเติม...
NSString *	deviceStatusText
	ข้อความสถานะปัจจุบันของอุปกรณ์ เพิ่มเติม...
GCKSessionTraits *	traits
	ลักษณะของเซสชัน เพิ่มเติม...
float	currentDeviceVolume
	ระดับเสียงปัจจุบันของอุปกรณ์ในช่วง [0.0, 1.0] เพิ่มเติม...
BOOL	currentDeviceMuted
	สถานะปิดเสียงของอุปกรณ์ปัจจุบัน เพิ่มเติม...
GCKRemoteMediaClient *	remoteMediaClient
	ออบเจ็กต์ GCKRemoteMediaClient ที่ใช้ควบคุมการเล่นสื่อในเซสชันนี้ได้ เพิ่มเติม...
GCKMediaMetadata *	mediaMetadata
	ข้อมูลเมตาของสื่อปัจจุบัน (หากมี) เพิ่มเติม...

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

- (instancetype) initWithDevice:		(GCKDevice *)	device
traits:		(GCKSessionTraits *)	traits
sessionID:		(NSString *__nullable)	sessionID

เริ่มต้นออบเจ็กต์เซสชันใหม่สำหรับอุปกรณ์ที่ระบุ

Parameters

device	The device.
traits	The session traits.
sessionID	The session ID of an existing session, if this object will be used to resume a session; otherwise nil if it will be used to start a new session.

- (GCKRequest *) setDeviceVolume:

(float)

volume

ตั้งค่าระดับเสียงของอุปกรณ์

นี่เป็นการดำเนินการแบบไม่พร้อมกัน การติดตั้งใช้งานเริ่มต้นคือการดำเนินการที่ไม่ทำอะไรเลยซึ่งทำให้คำขอล้มเหลวโดยมีข้อผิดพลาด GCKErrorCodeUnsupportedFeature

Parameters

volume

The new volume.

การคืนสินค้า

ออบเจ็กต์ GCKRequest สำหรับติดตามคำขอ

Since

3.4; ในเฟรมเวิร์กเวอร์ชันก่อนหน้า เมธอดนี้จะแสดงผล void

- (GCKRequest *) setDeviceMuted:

(BOOL)

muted

ตั้งค่าสถานะปิดเสียงของอุปกรณ์

นี่เป็นการดำเนินการแบบไม่พร้อมกัน การติดตั้งใช้งานเริ่มต้นคือการดำเนินการที่ไม่ทำอะไรเลยซึ่งทำให้คำขอล้มเหลวโดยมีข้อผิดพลาด GCKErrorCodeUnsupportedFeature

Parameters

muted

The new mute state.

การคืนสินค้า

ออบเจ็กต์ GCKRequest สำหรับติดตามคำขอ

Since

3.4; ในเฟรมเวิร์กเวอร์ชันก่อนหน้า เมธอดนี้จะแสดงผล void

- (void) start

เริ่มเซสชัน

นี่เป็นการดำเนินการแบบไม่พร้อมกัน ต้องลบล้างโดยคลาสย่อย

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) endAndStopCasting:

(BOOL)

stopCasting

สิ้นสุดเซสชัน

นี่เป็นการดำเนินการแบบไม่พร้อมกัน ต้องลบล้างโดยคลาสย่อย

Parameters

stopCasting

Whether to stop casting content to the receiver.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) suspendWithReason:

(GCKConnectionSuspendReason)

reason

ระงับเซสชันด้วยเหตุผลที่ระบุ

นี่เป็นการดำเนินการแบบไม่พร้อมกัน ต้องลบล้างโดยคลาสย่อย

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) resume

ดำเนินการเซสชันต่อ

นี่เป็นการดำเนินการแบบไม่พร้อมกัน ต้องลบล้างโดยคลาสย่อย

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidStartWithSessionID:

(NSString *)

sessionID

เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันเริ่มต้นแล้ว

Parameters

sessionID

The session's unique ID.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidFailToStartWithError:

(NSError *)

error

เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันเริ่มไม่สำเร็จ

Parameters

error

The error that occurred.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidResume

เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันกลับมาทำงานต่อแล้ว

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidSuspendWithReason:

(GCKConnectionSuspendReason)

reason

เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันถูกระงับแล้ว

Parameters

reason

The reason for the suspension.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidEndWithError:

(NSError *__nullable)

error

เรียกใช้โดยคลาสย่อยเพื่อแจ้งให้เฟรมเวิร์กทราบว่าเซสชันสิ้นสุดแล้ว

Parameters

error

The error that caused the session to end, if any. Should be nil if the session was ended intentionally.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidReceiveDeviceVolume:		(float)	volume
muted:		(BOOL)	muted

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

Parameters

volume	The device's current volume. Must be in the range [0, 1.0];
muted	The device's current mute state.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

- (void) notifyDidReceiveDeviceStatus:

(NSString *__nullable)

statusText

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

Parameters

statusText

The new status.

ให้บริการโดยหมวดหมู่ GCKSession(Protected)

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

- (GCKDevice*) device

readnonatomicstrong

อุปกรณ์ที่เซสชันนี้เชื่อมโยงอยู่

- (NSString*) sessionID

readnonatomiccopy

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

- (GCKConnectionState) connectionState

readnonatomicassign

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

- (BOOL) suspended

readnonatomicassign

แฟล็กที่ระบุว่าเซสชันถูกระงับอยู่หรือไม่

- (NSString*) deviceStatusText

readnonatomiccopy

ข้อความสถานะปัจจุบันของอุปกรณ์

- (GCKSessionTraits*) traits

readnonatomiccopy

ลักษณะของเซสชัน

- (float) currentDeviceVolume

readnonatomicassign

ระดับเสียงปัจจุบันของอุปกรณ์ในช่วง [0.0, 1.0]

- (BOOL) currentDeviceMuted

readnonatomicassign

สถานะปิดเสียงของอุปกรณ์ปัจจุบัน

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstrong

ออบเจ็กต์ GCKRemoteMediaClient ที่ใช้ควบคุมการเล่นสื่อในเซสชันนี้ได้

nil ก่อนที่เซสชันจะเริ่มขึ้น หรือหากเซสชันไม่รองรับ API ของ GCKRemoteMediaClient คลาสย่อยที่ให้อินเทอร์เฟซ GCKRemoteMediaClient ต้องลบล้างเมธอด Getter

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

ข้อมูลเมตาของสื่อปัจจุบัน (หากมี)

จะเป็น nil หากเซสชันไม่รองรับเนมสเปซสื่อ หรือหากไม่มีการโหลดสื่อบนตัวรับในขณะนี้