Lớp GCKCastSession

Tài liệu tham khảo về lớp GCKCastSession

Tổng quan

Một lớp quản lý phiên truyền bằng thiết bị nhận.

Phiên hoạt động do GCKSessionManager tạo và quản lý tự động. Ứng dụng không được gọi trực tiếp các phương thức trong vòng đời của phiên hoạt động, chẳng hạn như start (GCKSession(Protected)) hoặc endAndStopCasting: (GCKSession(Protected)).

Năm thành lập
3

Kế thừa GCKSession.

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

(instancetype) - initWithDevice:sessionID:castOptions:
 Trình khởi tạo được chỉ định. Xem thêm...
 
(BOOL) - addChannel:
 Đăng ký một kênh tham gia phiên sự kiện. Xem thêm...
 
(BOOL) - removeChannel:
 Xoá kênh đã đăng ký trước đây khỏi phiên tham gia. Xem thêm...
 
(void) - addDeviceStatusListener:
 Thêm GCKCastDeviceStatusListener vào danh sách trình nghe của đối tượng này. Xem thêm...
 
(void) - removeDeviceStatusListener:
 Xoá GCKCastDeviceStatusListener khỏi danh sách trình nghe của đối tượng này. Xem thêm...
 
(GCKRequest *) - setDeviceVolume:forMultizoneDevice:
 Đặt âm lượng cho từng thiết bị trong một nhóm nhiều vùng. Xem thêm...
 
(GCKRequest *) - setDeviceMuted:forMultizoneDevice:
 Đặt trạng thái tắt tiếng của từng thiết bị trong một nhóm nhiều vùng. Xem thêm...
 
(GCKRequest *) - requestMultizoneStatus
 Yêu cầu trạng thái nhiều vùng từ một nhóm nhiều vùng. Xem thêm...
 
(instancetype) - initWithDevice:traits:sessionID:
 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) - endAndStopCasting:
 Kết thúc phiên. Xem thêm...
 
(void) - suspendWithReason:
 Tạm ngưng phiên truy cập vì lý do cụ thể. Xem thêm...
 
(void) - resume
 Tiếp tục phiên này. 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) - notifyDidResume
 Được các lớp con gọi để thông báo cho khung rằng phiên đã được tiếp tục. Xem thêm...
 
(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. Xem 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. 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...
 

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

GCKActiveInputStatus activeInputStatus
 Trạng thái "đầu vào đang hoạt động" hiện tại của thiết bị. Xem thêm...
 
GCKStandbyStatus standbyStatus
 Trạng thái "chế độ chờ" hiện tại của thiết bị. Xem thêm...
 
GCKApplicationMetadataapplicationMetadata
 Siêu dữ liệu cho ứng dụng nhận hiện đang chạy trên thiết bị nhận, nếu có; nếu không thì là nil. Xem thêm...
 
GCKDevicedevice
 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...
 
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...
 
GCKSessionTraitstraits
 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...
 
GCKRemoteMediaClientremoteMediaClient
 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...
 
GCKMediaMetadatamediaMetadata
 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
sessionID: (NSString *__nullable)  sessionID
castOptions: (GCKCastOptions *)  castOptions 

Trình khởi tạo được chỉ định.

Tạo một phiên Truyền mới với các tuỳ chọn Truyền đã cho.

Parameters
deviceThe receiver device.
sessionIDThe session ID, if resuming; otherwise nil.
castOptionsThe Cast options.
- (BOOL) addChannel: (GCKCastChannel *)  channel

Đăng ký một kênh tham gia phiên sự kiện.

Nếu phiên được kết nối và ứng dụng nhận hỗ trợ không gian tên của kênh, thì kênh này sẽ tự động được kết nối. Nếu phiên không được kết nối, kênh sẽ vẫn ở trạng thái ngắt kết nối cho đến khi phiên bắt đầu.

Parameters
channelThe channel to register.
Trả bóng
YES nếu kênh được đăng ký thành công, nếu không thì NO.
- (BOOL) removeChannel: (GCKCastChannel *)  channel

Xoá kênh đã đăng ký trước đây khỏi phiên tham gia.

Parameters
channelThe channel to unregister.
Trả bóng
YES nếu bạn huỷ đăng ký kênh thành công, nếu không huỷ, bạn sẽ nhận được NO.
- (void) addDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Thêm GCKCastDeviceStatusListener vào danh sách trình nghe của đối tượng này.

Parameters
listenerThe listener to add.
- (void) removeDeviceStatusListener: (id< GCKCastDeviceStatusListener >)  listener

Xoá GCKCastDeviceStatusListener khỏi danh sách trình nghe của đối tượng này.

Parameters
listenerThe listener to remove.
- (GCKRequest *) setDeviceVolume: (float)  volume
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Đặt âm lượng cho từng thiết bị trong một nhóm nhiều vùng.

Đây là hoạt động không đồng bộ.

Parameters
volumeThe new volume, in the range [0.0, 1.0].
deviceThe multizone device.
Trả bóng
Đối tượng GCKRequest để theo dõi yêu cầu.
- (GCKRequest *) setDeviceMuted: (BOOL)  muted
forMultizoneDevice: (GCKMultizoneDevice *)  device 

Đặt trạng thái tắt tiếng của từng thiết bị trong một nhóm nhiều vùng.

Đây là hoạt động không đồng bộ.

Parameters
mutedThe new muted state.
deviceThe multizone device.
Trả bóng
Đối tượng GCKRequest để theo dõi yêu cầu.
- (GCKRequest *) requestMultizoneStatus

Yêu cầu trạng thái nhiều vùng từ một nhóm nhiều vùng.

Đây là hoạt động không đồng bộ. Khi nhận được trạng thái nhiều vùng, phương thức uỷ quyền castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) sẽ được thông báo.

Trả bóng
Đối tượng GCKRequest để theo dõi yêu cầu.
- (instancetype) initWithDevice: (GCKDevice *)  device
traits: (GCKSessionTraits *)  traits
sessionID: (NSString *__nullable)  sessionID 

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

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

Đặ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
volumeThe 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
mutedThe 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) endAndStopCasting: (BOOL)  stopCasting

Kết thúc phiên.

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

Parameters
stopCastingWhether to stop casting content to the receiver.

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

- (void) suspendWithReason: (GCKConnectionSuspendReason reason

Tạm ngưng phiên truy cập vì lý do cụ thể.

Đâ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) resume

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

Đâ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) 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
sessionIDThe session's unique ID.

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

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

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

- (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
reasonThe reason for the suspension.

Do danh mục cung cấp 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
errorThe error that caused the session to end, if any. Should be nil if the session was ended intentionally.

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

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

- (void) notifyDidReceiveDeviceStatus: (NSString *__nullable)  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
statusTextThe new status.

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

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

- (GCKActiveInputStatus) activeInputStatus
readnonatomicassign

Trạng thái "đầu vào đang hoạt động" hiện tại của thiết bị.

- (GCKStandbyStatus) standbyStatus
readnonatomicassign

Trạng thái "chế độ chờ" hiện tại của thiết bị.

- (GCKApplicationMetadata*) applicationMetadata
readnonatomiccopy

Siêu dữ liệu cho ứng dụng nhận hiện đang chạy trên thiết bị nhận, nếu có; nếu không thì là nil.

- (GCKDevice*) device
readnonatomicstronginherited

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

- (NSString*) sessionID
readnonatomiccopyinherited

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

- (GCKConnectionState) connectionState
readnonatomicassigninherited

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

- (BOOL) suspended
readnonatomicassigninherited

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

- (NSString*) deviceStatusText
readnonatomiccopyinherited

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

- (GCKSessionTraits*) traits
readnonatomiccopyinherited

Trait của phiên.

- (float) currentDeviceVolume
readnonatomicassigninherited

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

- (BOOL) currentDeviceMuted
readnonatomicassigninherited

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

- (GCKRemoteMediaClient*) remoteMediaClient
readnonatomicstronginherited

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
readnonatomicstronginherited

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.