Lớp GCKSessionManager

Phương thức của thực thể | Thuộc tính
Tài liệu tham khảo về lớp GCKSessionManager

Tổng quan

Một lớp quản lý các phiên.

Phương thức startSessionWithDevice: (GCKSessionManager) được dùng để tạo một phiên mới với GCKDevice nhất định. Trình quản lý phiên sử dụng GCKDeviceProvider cho loại thiết bị đó để tạo một đối tượng GCKSession mới, sau đó uỷ quyền tất cả các yêu cầu về phiên cho đối tượng này.

GCKSessionManager xử lý việc tự động tiếp tục các phiên bị tạm ngưng (tức là tiếp tục các phiên đã kết thúc khi ứng dụng chuyển sang chạy trong nền hoặc trong trường hợp ứng dụng gặp sự cố hoặc bị người dùng buộc chấm dứt). Khi ứng dụng tiếp tục hoặc khởi động lại, trình quản lý phiên sẽ đợi một khoảng thời gian ngắn để nhà cung cấp thiết bị của thiết bị trong phiên bị tạm ngưng phát hiện lại thiết bị đó. Nếu phát hiện được, trình quản lý phiên sẽ cố gắng kết nối lại với thiết bị đó và tự động thiết lập lại phiên.

Nếu ứng dụng đã tạo GCKUICastButton mà không cung cấp đích và bộ chọn, thì thao tác nhấn của người dùng vào nút này sẽ hiển thị hộp thoại Truyền mặc định và hộp thoại này sẽ tự động bắt đầu và dừng các phiên dựa trên lựa chọn của người dùng hoặc việc ngắt kết nối thiết bị. Tuy nhiên, nếu ứng dụng đang cung cấp giao diện người dùng hộp thoại chọn/điều khiển thiết bị riêng, thì ứng dụng đó phải sử dụng trực tiếp GCKSessionManager để tạo và kiểm soát các phiên.

Cho dù ứng dụng có dùng GCKSessionManager để kiểm soát các phiên hay không, ứng dụng vẫn có thể đính kèm một GCKSessionManagerListener để nhận thông báo về các sự kiện phiên, đồng thời có thể dùng KVO để theo dõi thuộc tính connectionState nhằm theo dõi trạng thái hiện tại của chu trình hoạt động của phiên.

Năm thành lập
3.0

Kế thừa NSObject.

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

(instancetype) - init
 Không có trình khởi tạo mặc định. Tuỳ chọn khác...
 
(BOOL) - startSessionWithDevice:
 Bắt đầu một phiên mới với thiết bị đã cho. Tuỳ chọn khác...
 
(BOOL) - suspendSessionWithReason:
 Tạm dừng phiên hiện tại. Tuỳ chọn khác...
 
(BOOL) - endSession
 Kết thúc phiên hiện tại. Tuỳ chọn khác...
 
(BOOL) - endSessionAndStopCasting:
 Kết thúc phiên hiện tại, bạn có thể chọn dừng truyền. Tuỳ chọn khác...
 
(BOOL) - hasConnectedSession
 Kiểm thử xem phiên hiện có đang được trình quản lý phiên này quản lý và hiện có được kết nối hay không. Tuỳ chọn khác...
 
(BOOL) - hasConnectedCastSession
 Kiểm tra xem phiên Truyền có đang được trình quản lý phiên này quản lý hay không và có đang kết nối hay không. Tuỳ chọn khác...
 
(void) - addListener:
 Thêm một trình nghe để nhận thông báo. Tuỳ chọn khác...
 
(void) - removeListener:
 Xoá một trình nghe đã được thêm trước đó bằng addListener:. Tuỳ chọn khác...
 

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

GCKSession * currentSession
 Phiên hiện tại (nếu có). Tuỳ chọn khác...
 
GCKCastSession * currentCastSession
 Phiên truyề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...
 

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

- (instancetype) init

Không có trình khởi tạo mặc định.

- (BOOL) startSessionWithDevice: (GCKDevice *)  device

Bắt đầu một phiên mới với thiết bị đã cho.

Đây là một thao tác không đồng bộ.

Parameters
deviceThe device to use for this session.
Giá trị trả về
YES nếu thao tác đã bắt đầu thành công, NO nếu có một phiên hiện đang được thiết lập hoặc nếu thao tác không thể bắt đầu.
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason)  reason

Tạm dừng phiên hiện tại.

Đây là một thao tác không đồng bộ.

Parameters
reasonThe reason for the suspension.
Giá trị trả về
YES nếu thao tác đã bắt đầu thành công, NO nếu hiện không có phiên nào được thiết lập hoặc nếu không thể bắt đầu thao tác.
- (BOOL) endSession

Kết thúc phiên hiện tại.

Đây là một thao tác không đồng bộ.

Giá trị trả về
YES nếu thao tác đã bắt đầu thành công, NO nếu hiện không có phiên nào được thiết lập hoặc nếu không thể bắt đầu thao tác.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Kết thúc phiên hiện tại, bạn có thể chọn dừng truyền.

Đây là một thao tác không đồng bộ.

Parameters
stopCastingWhether casting of content on the receiver should be stopped when the session is ended.
Giá trị trả về
YES nếu thao tác đã bắt đầu thành công, NO nếu hiện không có phiên nào được thiết lập hoặc nếu không thể bắt đầu thao tác.
- (BOOL) hasConnectedSession

Kiểm thử xem phiên hiện có đang được trình quản lý phiên này quản lý và hiện có được kết nối hay không.

Giá trị này sẽ là YES nếu trạng thái phiên là GCKConnectionStateConnected.

- (BOOL) hasConnectedCastSession

Kiểm tra xem phiên Truyền có đang được trình quản lý phiên này quản lý hay không và có đang kết nối hay không.

Tham số này sẽ là YES nếu trạng thái phiên là GCKConnectionStateConnected và phiên đó là phiên Truyền.

- (void) addListener: (id< GCKSessionManagerListener >)  listener

Thêm một trình nghe để nhận thông báo.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

Xoá một trình nghe đã được thêm trước đó bằng addListener:.

Parameters
listenerThe listener to remove.

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

- (GCKSession*) currentSession
readnonatomicstrong

Phiên hiện tại (nếu có).

- (GCKCastSession*) currentCastSession
readnonatomicstrong

Phiên truyề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.