คลาสเซสชันเนื้อหาที่ผู้ใช้สร้างขึ้น

ข้อมูลอ้างอิงคลาส GCKSession

ภาพรวม

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

คลาสย่อยต้องใช้เมธอด start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) และ resume (GCKSession(Protected)) และต้องเรียกใช้เมธอดตัวแจ้งเตือนที่เหมาะสม (เช่น 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:
 โทรหาคลาสย่อยเพื่อแจ้งเฟรมเวิร์กว่าได้รับสถานะที่อัปเดตแล้วจากอุปกรณ์ เพิ่มเติม...
 

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

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

รายละเอียดเมธอด

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

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

Parameters
deviceThe device.
traitsThe session traits.
sessionIDThe 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

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

การดําเนินการนี้เป็นการดําเนินการแบบไม่พร้อมกัน การติดตั้งใช้งานเริ่มต้นเป็นการดําเนินการที่ไม่สําเร็จซึ่งส่งคําขอไม่สําเร็จโดยมีข้อผิดพลาด GCKErrorCodeSupportedFeature

Parameters
volumeThe new volume.
การคืนสินค้า
ออบเจ็กต์ GCKRequest สําหรับการติดตามคําขอ
Since
3.4 ในเฟรมเวิร์กเวอร์ชันก่อนหน้านี้ เมธอดนี้แสดงผล void
- (GCKRequest *) setDeviceMuted: (BOOL)  muted

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

การดําเนินการนี้เป็นการดําเนินการแบบไม่พร้อมกัน การติดตั้งใช้งานเริ่มต้นเป็นการดําเนินการที่ไม่สําเร็จซึ่งส่งคําขอไม่สําเร็จโดยมีข้อผิดพลาด GCKErrorCodeSupportedFeature

Parameters
mutedThe new mute state.
การคืนสินค้า
ออบเจ็กต์ GCKRequest สําหรับการติดตามคําขอ
Since
3.4 ในเฟรมเวิร์กเวอร์ชันก่อนหน้านี้ เมธอดนี้แสดงผล void
- (void) start

เริ่มเซสชัน

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

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

- (void) endAndStopCasting: (BOOL)  stopCasting

จบเซสชัน

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

Parameters
stopCastingWhether to stop casting content to the receiver.

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

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

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

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

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

- (void) resume

กลับมาใช้เซสชันต่อ

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

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

- (void) notifyDidStartWithSessionID: (NSString *)  sessionID

ชั้นเรียนย่อยจะเรียกใช้เพื่อแจ้งกรอบการทํางานว่าเซสชันได้เริ่มขึ้นแล้ว

Parameters
sessionIDThe session's unique ID.

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

- (void) notifyDidFailToStartWithError: (NSError *)  error

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

Parameters
errorThe error that occurred.

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

- (void) notifyDidResume

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

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason reason

ชั้นเรียนย่อยโทรแจ้งกรอบการทํางานว่าเซสชันถูกระงับ

Parameters
reasonThe reason for the suspension.

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

- (void) notifyDidEndWithError: (NSError *__nullable)  error

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

Parameters
errorThe 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
volumeThe device's current volume. Must be in the range [0, 1.0];
mutedThe device's current mute state.

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

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable)  statusText

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

Parameters
statusTextThe 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 ก่อนที่เซสชันจะเริ่ม หรือหากเซสชันไม่รองรับ GCKRemoteMediaClient API คลาสย่อยที่มีอินเทอร์เฟซ GCKRemoteMediaClient ต้องลบล้างเมธอด Getter

- (GCKMediaMetadata*) mediaMetadata
readnonatomicstrong

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

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