Tổng quan

Một bộ điều khiển cho thiết bị truyền.

Lớp này có thể gửi thông báo đến, nhận thông báo từ, khởi chạy và đóng các ứng dụng đang chạy trên thiết bị truyền.

Phiên bản GCKDeviceManager phải nằm trong phạm vi miễn là kết nối với thiết bị truyền được thiết lập hoặc đang trong quá trình tạo hoặc huỷ. Bạn có thể giải phóng đối tượng trước khi kết nối được bắt đầu bằng connect (GCKDeviceManager) hoặc sau khi lệnh gọi lại uỷ quyền deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) hoặc deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) được gọi.

Deprecated:: Dùng GCKSessionManager và GCKCastSession để tương tác với các thiết bị nhận Cast.

Kế thừa NSObject.

Tóm tắt phương thức của thực thể
(instancetype)	- initWithDevice:clientPackageName:
	Tạo một GCKDeviceManager mới bằng thiết bị đã cho. Tuỳ chọn khác...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Trình khởi tạo được chỉ định. Tuỳ chọn khác...

(void)	- connect
	Kết nối với thiết bị. Tuỳ chọn khác...

(void)	- disconnect
	Ngắt kết nối khỏi thiết bị. Tuỳ chọn khác...

(void)	- disconnectWithLeave:
	Ngắt kết nối khỏi thiết bị. Tuỳ chọn khác...

(BOOL)	- addChannel:
	Thêm một kênh có thể gửi và nhận thông báo cho thiết bị này trên một không gian tên cụ thể. Tuỳ chọn khác...

(BOOL)	- removeChannel:
	Xoá một kênh đã thêm trước đó. Tuỳ chọn khác...

(NSInteger)	- launchApplication:
	Khởi chạy một ứng dụng. Tuỳ chọn khác...

(NSInteger)	- launchApplication:withLaunchOptions:
	Khởi chạy một ứng dụng bằng các lựa chọn khởi chạy đã cho. Tuỳ chọn khác...

(NSInteger)	- launchApplication:relaunchIfRunning:
	Khởi chạy một ứng dụng, có thể khởi chạy lại ứng dụng nếu ứng dụng đang chạy. Tuỳ chọn khác...

(NSInteger)	- joinApplication:
	Tham gia một ứng dụng. Tuỳ chọn khác...

(NSInteger)	- joinApplication:sessionID:
	Liên kết một ứng dụng với một mã phiên ứng dụng cụ thể. Tuỳ chọn khác...

(BOOL)	- leaveApplication
	Thoát ứng dụng hiện tại. Tuỳ chọn khác...

(NSInteger)	- stopApplication
	Dừng mọi ứng dụng đang chạy. Tuỳ chọn khác...

(NSInteger)	- stopApplicationWithSessionID:
	Dừng ứng dụng có mã phiên ứng dụng đã cho. Tuỳ chọn khác...

(NSInteger)	- setVolume:
	Đặt âm lượng hệ thống. Tuỳ chọn khác...

(NSInteger)	- setMuted:
	Bật hoặc tắt chế độ tắt tiếng. Tuỳ chọn khác...

(NSInteger)	- requestDeviceStatus
	Yêu cầu trạng thái hiện tại của thiết bị. Tuỳ chọn khác...

Tóm tắt về tài sản
BOOL	ignoreAppStateNotifications
	Liệu đối tượng này có theo dõi thông báo về trạng thái ứng dụng hay không. Tuỳ chọn khác...

GCKConnectionState	connectionState
	Trạng thái kết nối hiện tại của trình quản lý thiết bị. Tuỳ chọn khác...

GCKConnectionState	applicationConnectionState
	Trạng thái kết nối ứng dụng hiện tại của trình quản lý thiết bị. Tuỳ chọn khác...

BOOL	isConnected
	True nếu trình quản lý thiết bị đã thiết lập kết nối với thiết bị. Tuỳ chọn khác...

BOOL	isConnectedToApp
	True nếu trình quản lý thiết bị đã thiết lập kết nối với một ứng dụng trên thiết bị. Tuỳ chọn khác...

BOOL	isReconnecting
	True nếu trình quản lý thiết bị bị ngắt kết nối do một sự kiện có thể tạm thời (ví dụ: ứng dụng ở chế độ nền hoặc xảy ra lỗi mạng có thể giải quyết bằng cách kết nối lại). Tuỳ chọn khác...

NSTimeInterval	reconnectTimeout
	Hệ thống sẽ cố gắng kết nối lại trong khoảng thời gian này trong trường hợp ổ cắm bị ngắt kết nối do lỗi có thể chỉ là tạm thời. Tuỳ chọn khác...

GCKDevice *	device
	Thiết bị đang được GCKDeviceManager này kiểm soát. Tuỳ chọn khác...

id< GCKDeviceManagerDelegate >	delegate
	Uỷ quyền nhận thông báo từ GCKDeviceManager. Tuỳ chọn khác...

float	deviceVolume
	Âm lượng hiện tại của thiết bị trong phạm vi [0.0, 1.0], nếu đã biết; nếu không thì là 0. Tuỳ chọn khác...

BOOL	deviceMuted
	Trạng thái tắt tiếng hiện tại của thiết bị (nếu có); nếu không thì là `NO`. Tuỳ chọn khác...

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

GCKStandbyStatus	standbyStatus
	Trạng thái "chờ" hiện tại của thiết bị. Tuỳ chọn khác...

NSString *	applicationSessionID
	Mã phiên ứng dụng cho ứng dụng nhận hiện đang kết nối (nếu có); nếu không, hãy dùng `nil`. Tuỳ chọn khác...

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, hãy dùng `nil`. Tuỳ chọn khác...

NSString *	applicationStatusText
	Văn bản trạng thái được báo cáo gần đây nhất từ ứng dụng receiver đang chạy (nếu có); nếu không, giá trị sẽ là `nil`. Tuỳ chọn khác...

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

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

Tạo một GCKDeviceManager mới bằng thiết bị đã cho.

Đối tượng này sẽ lắng nghe thông báo về trạng thái ứng dụng và tự động ngắt kết nối với thiết bị khi ứng dụng chuyển sang chạy ở chế độ nền, đồng thời cố gắng kết nối lại với thiết bị khi ứng dụng quay lại chạy ở chế độ nền trước.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	(GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

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

Tạo một GCKDeviceManager mới để kiểm soát thiết bị đã cho.

Nếu ignoreAppStateNotifications là NO, thì đối tượng sẽ theo dõi các thay đổi đối với trạng thái ứng dụng và tự động ngắt kết nối với thiết bị khi ứng dụng chuyển sang chạy ở chế độ nền, đồng thời cố gắng kết nối lại với thiết bị khi ứng dụng chuyển sang chạy ở chế độ nền trước.

Nếu ignoreAppStateNotifications là YES, thì đối tượng sẽ không theo dõi những thông báo này và ứng dụng sẽ chịu trách nhiệm quản lý vòng đời kết nối. Xin lưu ý rằng nói chung, một ứng dụng iOS ở chế độ nền không thể tiếp tục chạy vô thời hạn và các kết nối mạng đang hoạt động của ứng dụng này sẽ bị hệ điều hành đóng.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

Kết nối với thiết bị.

- (void) disconnect

Ngắt kết nối khỏi thiết bị.

Đây là một thao tác ngắt kết nối rõ ràng.

Một trong các phương thức ngắt kết nối phải được gọi tại một thời điểm nào đó sau khi connect được gọi và trước khi đối tượng này được chủ sở hữu phát hành.

- (void) disconnectWithLeave: (BOOL) leaveApplication

Ngắt kết nối khỏi thiết bị.

Một trong các phương thức ngắt kết nối phải được gọi tại một thời điểm nào đó sau khi connect được gọi và trước khi đối tượng này được chủ sở hữu phát hành.

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: (GCKCastChannel *) channel

Thêm một kênh có thể gửi và nhận thông báo cho thiết bị này trên một không gian tên cụ thể.

Parameters

channel The channel.

Giá trị trả về: YES nếu kênh đã được thêm, NO nếu kênh chưa được thêm vì đã có một kênh được đính kèm cho không gian tên đó.

- (BOOL) removeChannel: (GCKCastChannel *) channel

Xoá một kênh đã thêm trước đó.

Parameters

channel The channel.

Giá trị trả về: YES nếu kênh đã bị xoá, NO nếu kênh không bị xoá vì kênh đó chưa được đính kèm trước đó.

- (NSInteger) launchApplication: (NSString *) applicationID

Khởi chạy một ứng dụng.

Parameters

applicationID The application ID.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	(GCKLaunchOptions *__nullable)	launchOptions

Khởi chạy một ứng dụng bằng các lựa chọn khởi chạy đã cho.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil`, defaults will be used.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

Khởi chạy một ứng dụng, có thể khởi chạy lại ứng dụng nếu ứng dụng đang chạy.

Deprecated:: Hãy sử dụng launchApplication:withLaunchOptions:.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES`, relaunches the application if it is already running instead of joining the running application.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

Tham gia một ứng dụng.

Parameters

applicationID The application ID. If nil, attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

Liên kết một ứng dụng với một mã phiên ứng dụng cụ thể.

Yêu cầu sẽ không thành công nếu mã phiên đã cho không còn hoạt động trên thiết bị nhận.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (BOOL) leaveApplication

Thoát ứng dụng hiện tại.

Giá trị trả về: NO nếu không gửi được tin nhắn.

- (NSInteger) stopApplication

Dừng mọi ứng dụng đang chạy.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

Dừng ứng dụng có mã phiên ứng dụng đã cho.

Yêu cầu sẽ không thành công nếu mã phiên đã cho không còn hoạt động trên thiết bị nhận.

Parameters

sessionID The application session ID, which may not be nil.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) setVolume: (float) volume

Đặt âm lượng hệ thống.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) setMuted: (BOOL) muted

Bật hoặc tắt chế độ tắt tiếng.

Parameters

muted Whether audio should be muted or unmuted.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

- (NSInteger) requestDeviceStatus

Yêu cầu trạng thái hiện tại của thiết bị.

Thao tác này sẽ dẫn đến việc tất cả các lệnh gọi lại cập nhật trạng thái uỷ quyền được gọi một lần sau khi nhận được thông tin trạng thái đã cập nhật.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được yêu cầu.

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

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Liệu đối tượng này có theo dõi thông báo về trạng thái ứng dụng hay không.

Bạn có thể chỉ định cờ này trong trình khởi tạo. Giá trị mặc định là NO.

- (GCKConnectionState) connectionState

readnonatomicassign

Trạng thái kết nối hiện tại của trình quản lý thiết bị.

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

Trạng thái kết nối ứng dụng hiện tại của trình quản lý thiết bị.

- (BOOL) isConnected

readnonatomicassign

True nếu trình quản lý thiết bị đã thiết lập kết nối với thiết bị.

Deprecated:: Sử dụng connectionState.

- (BOOL) isConnectedToApp

readnonatomicassign

True nếu trình quản lý thiết bị đã thiết lập kết nối với một ứng dụng trên thiết bị.

Deprecated:: Sử dụng applicationConnectionState.

- (BOOL) isReconnecting

readnonatomicassign

True nếu trình quản lý thiết bị bị ngắt kết nối do một sự kiện có thể tạm thời (ví dụ: ứng dụng ở chế độ nền hoặc xảy ra lỗi mạng có thể giải quyết bằng cách kết nối lại).

Xin lưu ý rằng các lệnh gọi lại ngắt kết nối/kết nối sẽ không được gọi trong khi trình quản lý thiết bị cố gắng kết nối lại sau một sự kiện có thể chỉ diễn ra trong thời gian ngắn, nhưng các thuộc tính sẽ luôn phản ánh trạng thái hiện tại thực tế và có thể được quan sát.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

Hệ thống sẽ cố gắng kết nối lại trong khoảng thời gian này trong trường hợp ổ cắm bị ngắt kết nối do lỗi có thể chỉ là tạm thời.

Thời gian chờ mặc định là 15 giây.

- (GCKDevice*) device

readnonatomicassign

Thiết bị đang được GCKDeviceManager này kiểm soát.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Uỷ quyền nhận thông báo từ GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

Âm lượng hiện tại của thiết bị trong phạm vi [0.0, 1.0], nếu đã biết; nếu không thì là 0.

- (BOOL) deviceMuted

readnonatomicassign

Trạng thái tắt tiếng hiện tại của thiết bị (nếu có); nếu không thì là NO.

- (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ờ" hiện tại của thiết bị.

- (NSString*) applicationSessionID

readnonatomiccopy

Mã phiên ứng dụng cho ứng dụng nhận hiện đang kết nối (nếu có); nếu không, hãy dùng nil.

Mã phiên mới, riêng biệt sẽ được tạo mỗi khi ứng dụng nhận được khởi chạy (kể cả khi ứng dụng đó được khởi chạy lại) và vẫn có hiệu lực miễn là ứng dụng nhận vẫn tiếp tục chạy.

- (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, hãy dùng nil.

- (NSString*) applicationStatusText

readnonatomiccopy

Văn bản trạng thái được báo cáo gần đây nhất từ ứng dụng receiver đang chạy (nếu có); nếu không, giá trị sẽ là nil.

Lớp GCKDeviceManager Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

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

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

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

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

Lớp GCKDeviceManager