Tổng quan

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

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

Bản sao 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 được tạo hoặc gỡ bỏ. Bạn có thể yên tâm giải phóng đối tượng trước khi bắt đầu kết nối với connect (GCKDeviceManager), hoặc sau khi lệnh gọi lại ủy quyền deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) hoặc deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p).

Deprecated:: Sử dụng GCKSessionManager và GCKCastSession để tương tác với Bộ thu truyền.

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 với thiết bị đã cho. Thêm...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	Trình khởi tạo được chỉ định. Thêm...

(void)	- connect
	Kết nối với thiết bị. Thêm...

(void)	- disconnect
	Ngắt kết nối khỏi thiết bị. Thêm...

(void)	- disconnectWithLeave:
	Ngắt kết nối khỏi thiết bị. Thêm...

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

(BOOL)	- removeChannel:
	Xoá kênh đã thêm trước đó. Thêm...

(NSInteger)	- launchApplication:
	Khởi chạy một ứng dụng. Thêm...

(NSInteger)	- launchApplication:withLaunchOptions:
	Chạy một ứng dụng bằng các tuỳ chọn khởi chạy cụ thể. Thêm...

(NSInteger)	- launchApplication:relaunchIfRunning:
	Chạy một ứng dụng, không bắt buộc chạy lại ứng dụng đó nếu ứng dụng đang chạy. Thêm...

(NSInteger)	- joinApplication:
	Tham gia một ứng dụng. Thêm...

(NSInteger)	- joinApplication:sessionID:
	Tham gia một ứng dụng có một mã phiên ứng dụng cụ thể. Thêm...

(BOOL)	- leaveApplication
	Rời khỏi ứng dụng hiện tại. Thêm...

(NSInteger)	- stopApplication
	Dừng mọi ứng dụng đang chạy. Thêm...

(NSInteger)	- stopApplicationWithSessionID:
	Dừng ứng dụng có mã phiên ứng dụng đã cho. Thêm...

(NSInteger)	- setVolume:
	Đặt âm lượng hệ thống. Thêm...

(NSInteger)	- setMuted:
	Bật hoặc tắt tiếng. Thêm...

(NSInteger)	- requestDeviceStatus
	Yêu cầu trạng thái hiện tại của thiết bị. Thêm...

Tóm tắt thuộc tính
BOOL	ignoreAppStateNotifications
	Đối tượng này có nghe thông báo về trạng thái ứng dụng hay không. Thêm...

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

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ị. Thêm...

BOOL	isConnected
	Đúng nếu người quản lý thiết bị đã thiết lập kết nối với thiết bị. Thêm...

BOOL	isConnectedToApp
	Đúng nếu người 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ị. Thêm...

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

NSTimeInterval	reconnectTimeout
	Hệ thống sẽ cố gắng kết nối lại trong khoảng thời gian dài này nếu ổ cắm bị ngắt kết nối do lỗi có thể xảy ra tạm thời. Thêm...

GCKDevice *	device
	Thiết bị do GCKDeviceManager này kiểm soát. Thêm...

id< GCKDeviceManagerDelegate >	delegate
	Người được ủy quyền nhận thông báo của GCKDeviceManager. Thêm...

float	deviceVolume
	Âm lượng hiện tại của thiết bị trong khoảng [0,0, 1,0], nếu biết; nếu không thì 0. Thêm...

BOOL	deviceMuted
	Trạng thái tắt tiếng hiện tại của thiết bị, nếu được biết; nếu không thì `NO`. Thêm...

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

GCKStandbyStatus	standbyStatus
	Trạng thái "đang chờ" hiện tại của thiết bị. Thêm...

NSString *	applicationSessionID
	Mã phiên của ứng dụng dành cho ứng dụng nhận hiện đã kết nối, nếu có; nếu không thì `nil`. Thêm...

GCKApplicationMetadata *	applicationMetadata
	Siêu dữ liệu cho ứng dụng hiện đang nhận trên receiver (nếu có); nếu không, `nil`. Thêm...

NSString *	applicationStatusText
	Văn bản trạng thái được báo cáo gần đây nhất từ ứng dụng nhận đang chạy (nếu có); nếu không, `nil`. Thêm...

Chi tiết phương thức

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

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

Đối tượng sẽ lắng nghe các thông báo trạng thái của ứng dụng và sẽ tự động ngắt kết nối khỏi thiết bị khi ứng dụng chạy ở chế độ nền và cố gắng kết nối lại với thiết bị khi ứng dụng quay lại 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.

Xây dựng một GCKDeviceManager mới để kiểm soát thiết bị đã cho.

Nếu ignoreAppStateNotifications là NO, đối tượng sẽ lắng nghe các thay đổi đối với trạng thái ứng dụng và sẽ tự động ngắt kết nối khỏi thiết bị khi ứng dụng chạy ở chế độ nền và cố gắng kết nối lại với thiết bị khi ứng dụng quay lại nền trước.

Nếu ignoreAppStateNotifications là YES, đối tượng sẽ không lắng nghe các thông báo này và ứng dụng sẽ có trách nhiệm quản lý vòng đời kết nối. Lưu ý rằng nói chung, ứng dụng iOS chạy ở chế độ nền không thể tiếp tục chạy vô thời hạn và cuối cùng, kết nối mạng đang hoạt động 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 sự 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 chủ sở hữu của đối tượng này 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 chủ sở hữu của đối tượng này 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 tin nhắn cho thiết bị này trên một không gian tên cụ thể.

Parameters

channel The channel.

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

- (BOOL) removeChannel: (GCKCastChannel *) channel

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

Parameters

channel The channel.

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

- (NSInteger) launchApplication: (NSString *) applicationID

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

Parameters

applicationID The application ID.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

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

Chạy một ứng dụng bằng các tuỳ chọn khởi chạy cụ thể.

Parameters

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

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

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

Chạy một ứng dụng, không bắt buộc chạy lại ứng dụng đó nếu ứng dụng đang chạy.

Deprecated:: 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.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi 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.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

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

Tham gia một ứng dụng có 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.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

- (BOOL) leaveApplication

Rời khỏi ứng dụng hiện tại.

Trả về: NO nếu không thể gửi thư.

- (NSInteger) stopApplication

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

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi 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.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi 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.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

- (NSInteger) setMuted: (BOOL) muted

Bật hoặc tắt tiếng.

Parameters

muted Whether audio should be muted or unmuted.

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

- (NSInteger) requestDeviceStatus

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

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

Trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi yêu cầu.

Chi tiết thuộc tính

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

Đối tượng này có nghe 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

Đúng nếu người 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

Đúng nếu người 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

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

Lưu ý rằng 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ị kết nối lại để kết nối lại sau sự kiện tạm thời có thể xảy ra, 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ể quan sát được.

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

Hệ thống sẽ cố gắng kết nối lại trong khoảng thời gian dài này nếu ổ cắm bị ngắt kết nối do lỗi có thể xảy ra tạm thời.

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

- (GCKDevice*) device

readnonatomicassign

Thiết bị do GCKDeviceManager này kiểm soát.

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

Người được ủy quyền nhận thông báo của GCKDeviceManager.

- (float) deviceVolume

readnonatomicassign

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

- (BOOL) deviceMuted

readnonatomicassign

Trạng thái tắt tiếng hiện tại của thiết bị, nếu được biết; nếu không thì 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 "đang chờ" hiện tại của thiết bị.

- (NSString*) applicationSessionID

readnonatomiccopy

Mã phiên của ứng dụng dành cho ứng dụng nhận hiện đã kết nối, nếu có; nếu không thì nil.

Mã phiên hoạt động mới duy nhất được tạo bất cứ khi nào ứng dụng nhận được chạy (bao gồm cả khi ứng dụng đó được chạy lại) và duy trì hiệu lực miễn là ứng dụng của người nhận tiếp tục chạy.

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

Siêu dữ liệu cho ứng dụng hiện đang nhận trên receiver (nếu có); nếu khô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 nhận đang chạy (nếu có); nếu không, nil.

Lớp GCKDeviceManager

Tổng quan

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

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

Chi tiết phương thức

Chi tiết thuộc tính