Tổng quan

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 trong 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 đó.

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

Since: 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 động một đối tượng phiên mới cho thiết bị cụ thể. Thêm...

(GCKRequest *)	- setDeviceVolume:
	Đặt âm lượng của thiết bị. Thêm...

(GCKRequest *)	- setDeviceMuted:
	Đặt trạng thái tắt tiếng của thiết bị. Thêm...

(void)	- start
	Bắt đầu phiên. Thêm...

(void)	- endAndStopCasting:
	Phiên kết thúc. Thêm...

(void)	- suspendWithReason:
	Tạm ngưng phiên vì lý do đã nêu. Thêm...

(void)	- resume
	Tiếp tục phiên này. Thêm...

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

(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. Thêm...

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

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

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

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

(void)	- notifyDidReceiveDeviceStatus:
	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 cập nhật. Thêm...

Tóm tắt thuộc tính
GCKDevice *	device
	Thiết bị liên kết với phiên này. Thêm...

NSString *	sessionID
	Mã phiên hiện tại, nếu có. Thêm...

GCKConnectionState	connectionState
	Trạng thái kết nối phiên hiện tại. Thêm...

BOOL	suspended
	Cờ cho biết liệu phiên hiện có bị tạm ngưng hay không. Thêm...

NSString *	deviceStatusText
	Văn bản trạng thái thiết bị hiện tại. Thêm...

GCKSessionTraits *	traits
	Đặc điểm của phiên. Thêm...

float	currentDeviceVolume
	Âm lượng thiết bị hiện tại, trong phạm vi [0,0, 1,0]. Thêm...

BOOL	currentDeviceMuted
	Trạng thái tắt tiếng thiết bị hiện tại. Thêm...

GCKRemoteMediaClient *	remoteMediaClient
	Đối tượng GCKRemoteMediaClient có thể dùng để điều khiển chế độ phát nội dung đa phương tiện trong phiên này. Thêm...

GCKMediaMetadata *	mediaMetadata
	Siêu dữ liệu phương tiện hiện tại, nếu có. Thêm...

Chi tiết phương thức

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

Khởi động một đối tượng phiên mới cho thiết bị cụ thể.

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 phép toán không đồng bộ. Cách triển khai mặc định là không hoạt động, không thực hiện được yêu cầu có lỗi GCKErrorCodeSupportFeature.

Parameters

volume The new volume.

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

Since: 3.4; trong các phiên bản khung trước, 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 phép toán không đồng bộ. Cách triển khai mặc định là không hoạt động, không thực hiện được yêu cầu có lỗi GCKErrorCodeSupportFeature.

Parameters

muted The new mute state.

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

Since: 3.4; trong các phiên bản khung trước, phương thức này trả về void.

- (void) start

Bắt đầu phiên.

Đây là một phép toán không đồng bộ. Phải bị lớp con ghi đè.

Được cung cấp theo danh mục GCKSession(Protected).

- (void) endAndStopCasting: (BOOL) stopCasting

Phiên kết thúc.

Đây là một phép toán không đồng bộ. Phải bị lớp con ghi đè.

Parameters

stopCasting Whether to stop casting content to the receiver.

Được cung cấp theo danh mục GCKSession(Protected).

- (void) suspendWithReason: (GCKConnectionSuspendReason) reason

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

Đây là một phép toán không đồng bộ. Phải bị lớp con ghi đè.

Được cung cấp theo danh mục GCKSession(Protected).

- (void) resume

Tiếp tục phiên này.

Đây là một phép toán không đồng bộ. Phải bị lớp con ghi đè.

Được cung cấp theo danh mục GCKSession(Protected).

- (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.

Được cung cấp theo danh mục GCKSession(Protected).

- (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.

Được cung cấp theo danh mục GCKSession(Protected).

- (void) notifyDidResume

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

Được cung cấp theo danh mục GCKSession(Protected).

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

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.

Được cung cấp theo danh mục GCKSession(Protected).

- (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.

Được cung cấp theo danh mục GCKSession(Protected).

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

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

Parameters

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

Được cung cấp theo danh mục GCKSession(Protected).

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

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 cập nhật.

Parameters

statusText The new status.

Được cung cấp theo danh mục GCKSession(Protected).

Chi tiết thuộc tính

- (GCKDevice*) device

readnonatomicstrong

Thiết bị 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 phiên hiện tại.

- (BOOL) suspended

readnonatomicassign

Cờ cho biết liệu phiên hiện có bị tạm ngưng hay không.

- (NSString*) deviceStatusText

readnonatomiccopy

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

- (GCKSessionTraits*) traits

readnonatomiccopy

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

- (float) currentDeviceVolume

readnonatomicassign

Âm lượng thiết bị hiện tại, trong phạm vi [0,0, 1,0].

- (BOOL) currentDeviceMuted

readnonatomicassign

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

- (GCKRemoteMediaClient*) remoteMediaClient

readnonatomicstrong

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

Phiên hoạt động sẽ diễn ra nil trước khi phiên hoạt động bắt đầu hoặc nếu phiên hoạt động 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 phương tiệ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 không có nội dung nghe nhìn nào được tải trên broadcast receiver.

Lớp GCKSession

Tổng quan

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

Tóm tắt thuộc tính

Chi tiết phương thức

Chi tiết thuộc tính