Tổng quan

Một lớp cơ sở trừu tượng đại diện cho một phiên có thiết bị nhận.

Các lớp con phải triển khai các phương thức start (GCKSession(Protected)), endAndStopCasting: (GCKSession(Protected)), suspendWithReason: (GCKSession(Protected)) và resume (GCKSession(Protected)), đồng thời phải gọi các phương thức trình thông báo thích hợp (ví dụ: notifyDidStartWithSessionID: (GCKSession(Protected))) để cho biết các thay đổi tương ứng về trạng thái phiên. Các lớp con cũng có thể triển khai setDeviceVolume: (GCKSession), setDeviceMuted: (GCKSession) và remoteMediaClient nếu thiết bị hỗ trợ các thao tác như vậy.

Một phiên được tạo và kiểm soát bằng các phương thức phiên trong GCKSessionManager. Phương thức này dùng GCKDeviceProvider thích hợp để tạo phiên, sau đó uỷ quyền các yêu cầu về phiên cho đối tượng GCKSession đó.

Năm thành lập: 3.0

Kế thừa NSObject.

Kế thừa từ GCKCastSession.

Tóm tắt phương thức của thực thể
(instancetype)	- initWithDevice:traits:sessionID:
	Khởi tạo một đối tượng phiên mới cho thiết bị đã cho. Tuỳ chọn khác...

(GCKRequest *)	- setDeviceVolume:
	Đặt âm lượng của thiết bị. Tuỳ chọn khác...

(GCKRequest *)	- setDeviceMuted:
	Đặt trạng thái tắt tiếng của thiết bị. Tuỳ chọn khác...

(void)	- start
	Bắt đầu phiên. Tuỳ chọn khác...

(void)	- endAndStopCasting:
	Kết thúc phiên. Tuỳ chọn khác...

(void)	- suspendWithReason:
	Tạm ngưng phiên vì lý do đã cho. Tuỳ chọn khác...

(void)	- resume
	Tiếp tục phiên. Tuỳ chọn khác...

(void)	- notifyDidStartWithSessionID:
	Được các lớp con gọi để thông báo cho khung rằng phiên đã bắt đầu. Tuỳ chọn khác...

(void)	- notifyDidFailToStartWithError:
	Được các lớp con gọi để thông báo cho khung rằng phiên không bắt đầu được. Tuỳ chọn khác...

(void)	- notifyDidResume
	Được các lớp con gọi để thông báo cho khung rằng phiên đã được tiếp tục. Tuỳ chọn khác...

(void)	- notifyDidSuspendWithReason:
	Được các lớp con gọi để thông báo cho khung rằng phiên đã bị tạm ngưng. Tuỳ chọn khác...

(void)	- notifyDidEndWithError:
	Được các lớp con gọi để thông báo cho khung rằng phiên đã kết thúc. Tuỳ chọn khác...

(void)	- notifyDidReceiveDeviceVolume:muted:
	Được các lớp con gọi để thông báo cho khung rằng thiết bị đã nhận được trạng thái âm lượng và trạng thái tắt tiếng mới. Tuỳ chọn khác...

(void)	- notifyDidReceiveDeviceStatus:
	Được các lớp con gọi để thông báo cho khung rằng trạng thái đã cập nhật đã được nhận từ thiết bị. Tuỳ chọn khác...

Tóm tắt về tài sản
GCKDevice *	device
	Thiết bị được liên kết với phiên này. Tuỳ chọn khác...

NSString *	sessionID
	Mã phiên hiện tại (nếu có). Tuỳ chọn khác...

GCKConnectionState	connectionState
	Trạng thái kết nối của phiên hiện tại. Tuỳ chọn khác...

BOOL	suspended
	Một cờ cho biết liệu phiên có đang bị tạm ngưng hay không. Tuỳ chọn khác...

NSString *	deviceStatusText
	Văn bản trạng thái hiện tại của thiết bị. Tuỳ chọn khác...

GCKSessionTraits *	traits
	Đặc điểm của phiên. Tuỳ chọn khác...

float	currentDeviceVolume
	Âm lượng hiện tại của thiết bị, trong phạm vi [0.0, 1.0]. Tuỳ chọn khác...

BOOL	currentDeviceMuted
	Trạng thái tắt tiếng hiện tại của thiết bị. Tuỳ chọn khác...

GCKRemoteMediaClient *	remoteMediaClient
	Đối tượng GCKRemoteMediaClient có thể dùng để điều khiển chế độ phát nội dung nghe nhìn trong phiên này. Tuỳ chọn khác...

GCKMediaMetadata *	mediaMetadata
	Siêu dữ liệu nội dung nghe nhìn hiện tại (nếu có). Tuỳ chọn khác...

Thông tin chi tiết về phương thức

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

Khởi tạo một đối tượng phiên mới cho thiết bị đã cho.

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

Đặt âm lượng của thiết bị.

Đây là một thao tác không đồng bộ. Phương thức triển khai mặc định là không hoạt động, khiến yêu cầu không thành công với lỗi GCKErrorCodeUnsupportedFeature.

Parameters

volume The new volume.

Giá trị trả về: Đối tượng GCKRequest để theo dõi yêu cầu.

Năm thành lập: 3.4; trong các phiên bản trước của khung, phương thức này trả về void.

- (GCKRequest *) setDeviceMuted: (BOOL) muted

Đặt trạng thái tắt tiếng của thiết bị.

Đây là một thao tác không đồng bộ. Phương thức triển khai mặc định là không hoạt động, khiến yêu cầu không thành công với lỗi GCKErrorCodeUnsupportedFeature.

Parameters

muted The new mute state.

Giá trị trả về: Đối tượng GCKRequest để theo dõi yêu cầu.

Năm thành lập: 3.4; trong các phiên bản trước của khung, phương thức này trả về void.

- (void) start

Bắt đầu phiên.

Đây là một thao tác không đồng bộ. Phải được các lớp con ghi đè.

Do danh mục GCKSession(Protected) cung cấp.

- (void) endAndStopCasting: (BOOL) stopCasting

Kết thúc phiên.

Đây là một thao tác không đồng bộ. Phải được các lớp con ghi đè.

Parameters

stopCasting Whether to stop casting content to the receiver.

Do danh mục GCKSession(Protected) cung cấp.

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

Tạm ngưng phiên vì lý do đã cho.

Đây là một thao tác không đồng bộ. Phải được các lớp con ghi đè.

Do danh mục GCKSession(Protected) cung cấp.

- (void) resume

Tiếp tục phiên.

Đây là một thao tác không đồng bộ. Phải được các lớp con ghi đè.

Do danh mục GCKSession(Protected) cung cấp.

- (void) notifyDidStartWithSessionID: (NSString *) sessionID

Được các lớp con gọi để thông báo cho khung rằng phiên đã bắt đầu.

Parameters

sessionID The session's unique ID.

Do danh mục GCKSession(Protected) cung cấp.

- (void) notifyDidFailToStartWithError: (NSError *) error

Được các lớp con gọi để thông báo cho khung rằng phiên không bắt đầu được.

Parameters

error The error that occurred.

Do danh mục GCKSession(Protected) cung cấp.

- (void) notifyDidResume

Được các lớp con gọi để thông báo cho khung rằng phiên đã được tiếp tục.

Do danh mục GCKSession(Protected) cung cấp.

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

Được các lớp con gọi để thông báo cho khung rằng phiên đã bị tạm ngưng.

Parameters

reason The reason for the suspension.

Do danh mục GCKSession(Protected) cung cấp.

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

Được các lớp con gọi để thông báo cho khung rằng phiên đã kết thúc.

Parameters

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

Do danh mục GCKSession(Protected) cung cấp.

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

Được các lớp con gọi để thông báo cho khung rằng thiết bị đã nhận được trạng thái âm lượng và trạng thái tắt tiếng mới.

Parameters

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

Do danh mục GCKSession(Protected) cung cấp.

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

Được các lớp con gọi để thông báo cho khung rằng trạng thái đã cập nhật đã được nhận từ thiết bị.

Parameters

statusText The new status.

Do danh mục GCKSession(Protected) cung cấp.

Thông tin chi tiết về cơ sở lưu trú

- (GCKDevice*) device

readnonatomicstrong

Thiết bị được liên kết với phiên này.

- (NSString*) sessionID

readnonatomiccopy

Mã phiên hiện tại (nếu có).

- (GCKConnectionState) connectionState

readnonatomicassign

Trạng thái kết nối của phiên hiện tại.

- (BOOL) suspended

readnonatomicassign

Một cờ cho biết liệu phiên có đang bị tạm ngưng hay không.

- (NSString*) deviceStatusText

readnonatomiccopy

Văn bản trạng thái hiện tại của thiết bị.

- (GCKSessionTraits*) traits

readnonatomiccopy

Đặc điểm của phiên.

- (float) currentDeviceVolume

readnonatomicassign

Âm lượng hiện tại của thiết bị, trong phạm vi [0.0, 1.0].

- (BOOL) currentDeviceMuted

readnonatomicassign

Trạng thái tắt tiếng hiện tại của thiết bị.

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstrong

Đối tượng GCKRemoteMediaClient có thể dùng để điều khiển chế độ phát nội dung nghe nhìn trong phiên này.

Đó là nil trước khi phiên bắt đầu hoặc nếu phiên không hỗ trợ API GCKRemoteMediaClient. Các lớp con cung cấp giao diện GCKRemoteMediaClient phải ghi đè phương thức getter.

- (GCKMediaMetadata*) mediaMetadata

readnonatomicstrong

Siêu dữ liệu nội dung nghe nhìn hiện tại (nếu có).

Sẽ là nil nếu phiên không hỗ trợ không gian tên nội dung nghe nhìn hoặc nếu hiện không có nội dung nghe nhìn nào được tải trên bộ nhận.

Lớp GCKSession Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

Tóm tắt phương thức của thực thể

Tóm tắt về tài sản

Thông tin chi tiết về phương thức

Thông tin chi tiết về cơ sở lưu trú

Lớp GCKSession