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 endWithAction: (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:sessionOptions:castOptions: |
| Tạo một phiên Truyền mới với các tuỳ chọn Truyền đã cho. 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 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 | |
| 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... | |
| GCKApplicationMetadata * | applicationMetadata |
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... | |
| 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 | |
| sessionID: | (nullable NSString *) | sessionID | |
| sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
| castOptions: | (GCKCastOptions *) | castOptions | |
Tạo một phiên Truyền mới với các tuỳ chọn Truyền đã cho.
- Parameters
-
device The receiver device. sessionID The session ID, if resuming; otherwise nil.sessionOptions The session options, if any; otherwise nil.castOptions The Cast options.
- Năm thành lập
- 4
| - (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
-
channel The channel to register.
- Trả bóng
YESnế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
-
channel The channel to unregister.
- Trả bóng
YESnếu bạn huỷ đăng ký kênh thành công, nếu không huỷ, bạn sẽ nhận đượcNO.
| - (void) addDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
Thêm GCKCastDeviceStatusListener vào danh sách trình nghe của đối tượng này.
Trình nghe đã thêm sẽ bị giữ ở mức yếu, và nên được giữ lại để tránh việc xử lý ngoài dự kiến.
- Parameters
-
listener The 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
-
listener The 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
-
volume The new volume, in the range [0.0, 1.0]. device The 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
-
muted The new muted state. device The 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: | (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 nilif 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 nilif 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 nilif 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ú
|
readnonatomicassign |
Trạng thái "đầu vào đang hoạt động" hiện tại của thiết bị.
|
readnonatomicassign |
Trạng thái "chế độ chờ" hiện tại của thiết bị.
|
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.
|
readnonatomicstronginherited |
Thiết bị liên kết với phiên này.
|
readnonatomiccopyinherited |
Mã phiên hiện tại, nếu có.
|
readnonatomicstronginherited |
Tuỳ chọn phiên, nếu có.
- Năm thành lập
- 4
|
readnonatomicassigninherited |
Trạng thái kết nối hiện tại của phiên.
|
readnonatomicassigninherited |
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.
|
readnonatomiccopyinherited |
Văn bản về trạng thái hiện tại của thiết bị.
|
readnonatomiccopyinherited |
Trait của phiên.
|
readnonatomicassigninherited |
Âm lượng hiện tại của thiết bị, trong khoảng [0,0, 1,0].
|
readnonatomicassigninherited |
Trạng thái tắt tiếng hiện tại của thiết bị.
|
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.
|
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.