Tổng quan

Lớp cơ sở trừu tượng biểu thị một phiên có thiết bị nhận.

Lớp con phải triển khai các phương thức start (GCKSession(Protected)) và endWithAction: (GCKSession(Protected)), đồng thời phải gọi các phương thức 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, trong đó sử dụng GCKDeviceProvider thích hợp để tạo phiên, sau đó uỷ quyền các yêu cầu phiên cho đối tượng GCKSession đó.

Năm thành lập: 3

Kế thừa NSObject.

Kế thừa từ GCKCastSession.

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

(instancetype)	- initWithDevice:traits:sessionID:sessionOptions:
	Khởi chạy một đối tượng phiên mới cho thiết bị đã cho. Xem thêm...

(GCKRequest *)	- setDeviceVolume:
	Đặt âm lượng cho thiết bị. Xem thêm...

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

(void)	- start
	Bắt đầu phiên truy cập. Xem thêm...

(void)	- endWithAction:
	Kết thúc phiên với hành động được chỉ định. Xem 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. Xem 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. Xem thêm...

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

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

(void)	- notifyDidReceiveDeviceStatus:
	Được các lớp con gọi để thông báo cho khung về việc đã nhận được trạng thái cập nhật từ thiết bị. Xem thêm...

(void)	- notifyDidSuspendWithReason:
	Không dùng nữa, không sử dụng – được triển khai dưới dạng không hoạt động. Xem thêm...

(void)	- notifyDidResume
	Không dùng nữa, không sử dụng – được triển khai dưới dạng không hoạt động. Xem thêm...

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

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

GCKSessionOptions *	sessionOptions
	Tuỳ chọn phiên, nếu có. Xem thêm...

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

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

NSString *	deviceStatusText
	Văn bản về trạng thái hiện tại của thiết bị. Xem thêm...

GCKSessionTraits *	traits
	Trait của phiên. Xem thêm...

float	currentDeviceVolume
	Âm lượng hiện tại của thiết bị, trong khoảng [0,0, 1,0]. Xem thêm...

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

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

GCKMediaMetadata *	mediaMetadata
	Siêu dữ liệu nội dung đa phương tiện hiện tại, nếu có. Xem thêm...

Chi tiết phương pháp

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

Khởi chạy một đối tượng phiên mới cho thiết bị đã cho với các tuỳ chọn mặc định.

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.

- (instancetype) initWithDevice:	(GCKDevice *)	device
traits:	(nullable GCKSessionTraits *)	traits
sessionID:	(nullable NSString *)	sessionID
sessionOptions:	(nullable GCKSessionOptions *)	sessionOptions

Khởi chạy 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.
sessionOptions	The session options, if any; otherwise `nil`.

Năm thành lập: 4

- (GCKRequest *) setDeviceVolume: (float) volume

Đặt âm lượng cho thiết bị.

Đây là hoạt động không đồng bộ. Cách triển khai mặc định là không hoạt động nên sẽ không thực hiện được yêu cầu với lỗi GCKErrorCodeSupportedFeature.

Parameters

volume The new volume.

Trả bóng: Đố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 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à hoạt động không đồng bộ. Cách triển khai mặc định là không hoạt động nên sẽ không thực hiện được yêu cầu với lỗi GCKErrorCodeSupportedFeature.

Parameters

muted The new mute state.

Trả bóng: Đố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 khung trước, phương thức này trả về void.

- (void) start

Bắt đầu phiên truy cập.

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

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

- (void) endWithAction: (GCKSessionEndAction) action

Kết thúc phiên với hành động được chỉ định.

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

Parameters

action The action to take when ending the session; see GCKSessionEndAction for more details.

Do danh mục cung cấp 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.

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

- (void) notifyDidFailToStartWithError: (GCKError *) 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 cung cấp GCKSession(Protected).

- (void) notifyDidEndWithError:	(nullable NSError *)	error
willTryToResume:	(BOOL)	willTryToResume

Đượ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.
willTryToResume	Whether the session will try to resume itself automatically.

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

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

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

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 cung cấp GCKSession(Protected).

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

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

Parameters

statusText The new status.

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

- (void) notifyDidSuspendWithReason: (GCKConnectionSuspendReason) reason

Không dùng nữa, không sử dụng – được triển khai dưới dạng không hoạt động.

Deprecated:: Không gọi điện.

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

- (void) notifyDidResume

Không dùng nữa, không sử dụng – được triển khai dưới dạng không hoạt động.

Deprecated:: Không gọi điện.

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

Chi tiết về cơ sở lưu trú

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

- (GCKSessionOptions*) sessionOptions

readnonatomicstrong

Tuỳ chọn phiên, nếu có.

Năm thành lập: 4

- (GCKConnectionState) connectionState

readnonatomicassign

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

- (BOOL) suspended

readnonatomicassign

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

Deprecated:: GCKSession không còn hỗ trợ việc ở trạng thái tạm ngưng. Nếu cần, hãy chuyển chức năng này sang một lớp con.

- (NSString*) deviceStatusText

readnonatomiccopy

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

- (GCKSessionTraits*) traits

readnonatomiccopy

Trait của phiên.

- (float) currentDeviceVolume

readnonatomicassign

Âm lượng hiện tại của thiết bị, trong khoảng [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

Có thể dùng đối tượng GCKRemoteMediaClient để đ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 đa 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 đa phương tiện hoặc nếu không có nội dung nghe nhìn nào được tải trên trình nhận.

Lớp GCKSession

Tổng quan

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

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

Chi tiết phương pháp

Chi tiết về cơ sở lưu trú