ภาพรวม

รีโมตคอนโทรลสำหรับอุปกรณ์แคสต์

คลาสนี้สามารถส่งข้อความไปยัง รับข้อความจาก เปิด และปิดแอปพลิเคชันที่ทำงานบนอุปกรณ์ Cast ได้

GCKDeviceManagerอินสแตนซ์ต้องอยู่ในขอบเขตตราบใดที่ยังมีการเชื่อมต่อกับอุปกรณ์แคสต์ หรืออยู่ในกระบวนการสร้างหรือทำลาย คุณสามารถปล่อยออบเจ็กต์ก่อนที่จะเริ่มการเชื่อมต่อกับ connect (GCKDeviceManager) หรือหลังจากเรียกใช้การเรียกกลับของตัวแทน deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p), deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) หรือ deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) แล้ว

Deprecated:: ใช้ GCKSessionManager และ GCKCastSession เพื่อโต้ตอบกับตัวรับสัญญาณ Cast

รับค่า NSObject

สรุปวิธีการของอินสแตนซ์
(instancetype)	- initWithDevice:clientPackageName:
	สร้าง GCKDeviceManager ใหม่ด้วยอุปกรณ์ที่ระบุ เพิ่มเติม...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	ตัวเริ่มต้นที่กำหนด เพิ่มเติม...

(void)	- connect
	เชื่อมต่อกับอุปกรณ์ เพิ่มเติม...

(void)	- disconnect
	ยกเลิกการเชื่อมต่อจากอุปกรณ์ เพิ่มเติม...

(void)	- disconnectWithLeave:
	ยกเลิกการเชื่อมต่อจากอุปกรณ์ เพิ่มเติม...

(BOOL)	- addChannel:
	เพิ่มช่องทางที่สามารถส่งและรับข้อความสำหรับอุปกรณ์นี้ในเนมสเปซหนึ่งๆ เพิ่มเติม...

(BOOL)	- removeChannel:
	นำช่องที่เพิ่มไว้ก่อนหน้านี้ออก เพิ่มเติม...

(NSInteger)	- launchApplication:
	เปิดแอปพลิเคชัน เพิ่มเติม...

(NSInteger)	- launchApplication:withLaunchOptions:
	เปิดแอปพลิเคชันโดยใช้ตัวเลือกการเปิดที่ระบุ เพิ่มเติม...

(NSInteger)	- launchApplication:relaunchIfRunning:
	เปิดแอปพลิเคชัน และจะเปิดแอปพลิเคชันอีกครั้งก็ได้หากกำลังทำงานอยู่ เพิ่มเติม...

(NSInteger)	- joinApplication:
	เข้าร่วมแอปพลิเคชัน เพิ่มเติม...

(NSInteger)	- joinApplication:sessionID:
	เข้าร่วมแอปพลิเคชันที่มีรหัสเซสชันแอปพลิเคชันที่เฉพาะเจาะจง เพิ่มเติม...

(BOOL)	- leaveApplication
	ออกจากแอปพลิเคชันปัจจุบัน เพิ่มเติม...

(NSInteger)	- stopApplication
	หยุดแอปพลิเคชันที่ทำงานอยู่ เพิ่มเติม...

(NSInteger)	- stopApplicationWithSessionID:
	หยุดแอปพลิเคชันที่มีรหัสเซสชันแอปพลิเคชันที่ระบุ เพิ่มเติม...

(NSInteger)	- setVolume:
	ตั้งค่าระดับเสียงของระบบ เพิ่มเติม...

(NSInteger)	- setMuted:
	เปิดหรือปิดการปิดเสียง เพิ่มเติม...

(NSInteger)	- requestDeviceStatus
	ขอสถานะปัจจุบันของอุปกรณ์ เพิ่มเติม...

สรุปพร็อพเพอร์ตี้
BOOL	ignoreAppStateNotifications
	ออบเจ็กต์นี้จะรอรับการแจ้งเตือนสถานะแอปหรือไม่ เพิ่มเติม...

GCKConnectionState	connectionState
	สถานะการเชื่อมต่อปัจจุบันของ Device Manager เพิ่มเติม...

GCKConnectionState	applicationConnectionState
	สถานะการเชื่อมต่อแอปพลิเคชันปัจจุบันของ Device Manager เพิ่มเติม...

BOOL	isConnected
	จริง หากผู้จัดการอุปกรณ์สร้างการเชื่อมต่อกับอุปกรณ์ เพิ่มเติม...

BOOL	isConnectedToApp
	จริง หากผู้จัดการอุปกรณ์ได้สร้างการเชื่อมต่อกับแอปพลิเคชันในอุปกรณ์ เพิ่มเติม...

BOOL	isReconnecting
	เป็นจริงหากตัวจัดการอุปกรณ์ถูกยกเลิกการเชื่อมต่อเนื่องจากเหตุการณ์ที่อาจเกิดขึ้นชั่วคราว (เช่น แอปทำงานในเบื้องหลัง หรือเกิดข้อผิดพลาดเกี่ยวกับเครือข่ายซึ่งอาจแก้ไขได้โดยการเชื่อมต่อใหม่) เพิ่มเติม...

NSTimeInterval	reconnectTimeout
	ระบบจะพยายามเชื่อมต่อใหม่เป็นระยะเวลานานเท่านี้ในกรณีที่ซ็อกเก็ตตัดการเชื่อมต่อเนื่องจากข้อผิดพลาดที่อาจเกิดขึ้นชั่วคราว เพิ่มเติม...

GCKDevice *	device
	อุปกรณ์ที่ GCKDeviceManager นี้ควบคุมอยู่ เพิ่มเติม...

id< GCKDeviceManagerDelegate >	delegate
	ผู้รับมอบสิทธิ์ในการรับการแจ้งเตือนจาก GCKDeviceManager เพิ่มเติม...

float	deviceVolume
	ระดับเสียงปัจจุบันของอุปกรณ์ในช่วง [0.0, 1.0] หากทราบ หรือ 0 หากไม่ทราบ เพิ่มเติม...

BOOL	deviceMuted
	สถานะปิดเสียงปัจจุบันของอุปกรณ์ หากทราบ มิเช่นนั้นจะเป็น `NO` เพิ่มเติม...

GCKActiveInputStatus	activeInputStatus
	สถานะ "อินพุตที่ใช้งานอยู่" ปัจจุบันของอุปกรณ์ เพิ่มเติม...

GCKStandbyStatus	standbyStatus
	สถานะ "สแตนด์บาย" ปัจจุบันของอุปกรณ์ เพิ่มเติม...

NSString *	applicationSessionID
	รหัสเซสชันแอปพลิเคชันสำหรับแอปพลิเคชันตัวรับที่เชื่อมต่ออยู่ในปัจจุบัน (หากมี) มิฉะนั้นจะเป็น `nil` เพิ่มเติม...

GCKApplicationMetadata *	applicationMetadata
	ข้อมูลเมตาสำหรับแอปพลิเคชันตัวรับที่กำลังทำงานบนตัวรับ หากมี หรือ `nil` เพิ่มเติม...

NSString *	applicationStatusText
	ข้อความสถานะที่รายงานล่าสุดจากแอปพลิเคชันตัวรับที่กำลังทำงานอยู่ หากมี มิฉะนั้นจะเป็น `nil` เพิ่มเติม...

รายละเอียดวิธีการ

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

สร้าง GCKDeviceManager ใหม่ด้วยอุปกรณ์ที่ระบุ

ออบเจ็กต์จะรอรับการแจ้งเตือนสถานะแอป และจะตัดการเชื่อมต่อจากอุปกรณ์โดยอัตโนมัติเมื่อแอปเข้าสู่เบื้องหลัง และจะพยายามเชื่อมต่อกับอุปกรณ์อีกครั้งเมื่อแอปกลับมาที่เบื้องหน้า

Parameters

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

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

ตัวเริ่มต้นที่กำหนด

สร้าง GCKDeviceManager ใหม่เพื่อควบคุมอุปกรณ์ที่ระบุ

หาก ignoreAppStateNotifications เป็น NO ออบเจ็กต์จะรอรับการเปลี่ยนแปลงสถานะแอปและจะยกเลิกการเชื่อมต่อจากอุปกรณ์โดยอัตโนมัติเมื่อแอปเข้าสู่เบื้องหลัง และจะพยายามเชื่อมต่อกับอุปกรณ์อีกครั้งเมื่อแอปกลับมาที่เบื้องหน้า

หาก ignoreAppStateNotifications เป็น YES ออบเจ็กต์จะไม่รับฟังการแจ้งเตือนเหล่านี้ และแอปจะเป็นผู้รับผิดชอบในการจัดการวงจรการเชื่อมต่อ โปรดทราบว่าโดยทั่วไปแล้ว แอป iOS ที่ทำงานในเบื้องหลังจะทำงานต่อไปอย่างไม่มีกำหนดไม่ได้ และระบบปฏิบัติการจะปิดการเชื่อมต่อเครือข่ายที่ใช้งานอยู่ในที่สุด

Parameters

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

- (void) connect

เชื่อมต่อกับอุปกรณ์

- (void) disconnect

ยกเลิกการเชื่อมต่อจากอุปกรณ์

นี่คือการยกเลิกการเชื่อมต่ออย่างชัดเจน

คุณต้องเรียกใช้เมธอดยกเลิกการเชื่อมต่ออย่างใดอย่างหนึ่งหลังจากเรียกใช้ connect และก่อนที่เจ้าของจะปล่อยออบเจ็กต์นี้

- (void) disconnectWithLeave: (BOOL) leaveApplication

ยกเลิกการเชื่อมต่อจากอุปกรณ์

คุณต้องเรียกใช้เมธอดยกเลิกการเชื่อมต่ออย่างใดอย่างหนึ่งหลังจากเรียกใช้ connect และก่อนที่เจ้าของจะปล่อยออบเจ็กต์นี้

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

เพิ่มช่องทางที่สามารถส่งและรับข้อความสำหรับอุปกรณ์นี้ในเนมสเปซหนึ่งๆ

Parameters

channel The channel.

การคืนสินค้า: YES หากเพิ่มช่องแล้ว NO หากเพิ่มไม่ได้เนื่องจากมีช่องที่เชื่อมโยงกับเนมสเปซนั้นอยู่แล้ว

- (BOOL) removeChannel: (GCKCastChannel *) channel

นำช่องที่เพิ่มไว้ก่อนหน้านี้ออก

Parameters

channel The channel.

การคืนสินค้า: YES หากมีการนำช่องออก NO หากไม่มีการนำช่องออกเนื่องจากช่องที่ระบุไม่ได้เชื่อมต่อไว้ก่อนหน้านี้

- (NSInteger) launchApplication: (NSString *) applicationID

เปิดแอปพลิเคชัน

Parameters

applicationID The application ID.

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

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

เปิดแอปพลิเคชันโดยใช้ตัวเลือกการเปิดที่ระบุ

Parameters

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

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

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

เปิดแอปพลิเคชัน และจะเปิดแอปพลิเคชันอีกครั้งก็ได้หากกำลังทำงานอยู่

Deprecated:: โปรดใช้ launchApplication:withLaunchOptions: แทน

Parameters

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

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

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

เข้าร่วมแอปพลิเคชัน

Parameters

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

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

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

เข้าร่วมแอปพลิเคชันที่มีรหัสเซสชันแอปพลิเคชันที่เฉพาะเจาะจง

คำขอจะล้มเหลวหากรหัสเซสชันที่ระบุไม่มีการใช้งานบนตัวรับอีกต่อไป

Parameters

applicationID	The application ID.
sessionID	The application session ID.

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

- (BOOL) leaveApplication

ออกจากแอปพลิเคชันปัจจุบัน

การคืนสินค้า: NO หากส่งข้อความไม่ได้

- (NSInteger) stopApplication

หยุดแอปพลิเคชันที่ทำงานอยู่

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

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

หยุดแอปพลิเคชันที่มีรหัสเซสชันแอปพลิเคชันที่ระบุ

คำขอจะล้มเหลวหากรหัสเซสชันที่ระบุไม่มีการใช้งานบนตัวรับอีกต่อไป

Parameters

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

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

- (NSInteger) setVolume: (float) volume

ตั้งค่าระดับเสียงของระบบ

Parameters

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

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

- (NSInteger) setMuted: (BOOL) muted

เปิดหรือปิดการปิดเสียง

Parameters

muted Whether audio should be muted or unmuted.

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

- (NSInteger) requestDeviceStatus

ขอสถานะปัจจุบันของอุปกรณ์

ซึ่งจะส่งผลให้มีการเรียกใช้การเรียกกลับการอัปเดตสถานะของผู้รับมอบสิทธิ์ทั้งหมดเมื่อได้รับข้อมูลสถานะที่อัปเดตแล้ว

การคืนสินค้า: รหัสคำขอ หรือ kGCKInvalidRequestID หากส่งคำขอไม่ได้

รายละเอียดพร็อพเพอร์ตี้

- (BOOL) ignoreAppStateNotifications

readnonatomicassign

ออบเจ็กต์นี้จะรอรับการแจ้งเตือนสถานะแอปหรือไม่

คุณระบุแฟล็กนี้ได้ในตัวเริ่มต้น ค่าเริ่มต้นคือ NO

- (GCKConnectionState) connectionState

readnonatomicassign

สถานะการเชื่อมต่อปัจจุบันของ Device Manager

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

สถานะการเชื่อมต่อแอปพลิเคชันปัจจุบันของ Device Manager

- (BOOL) isConnected

readnonatomicassign

จริง หากผู้จัดการอุปกรณ์สร้างการเชื่อมต่อกับอุปกรณ์

Deprecated:: ใช้ connectionState

- (BOOL) isConnectedToApp

readnonatomicassign

จริง หากผู้จัดการอุปกรณ์ได้สร้างการเชื่อมต่อกับแอปพลิเคชันในอุปกรณ์

Deprecated:: ใช้ applicationConnectionState

- (BOOL) isReconnecting

readnonatomicassign

เป็นจริงหากตัวจัดการอุปกรณ์ถูกยกเลิกการเชื่อมต่อเนื่องจากเหตุการณ์ที่อาจเกิดขึ้นชั่วคราว (เช่น แอปทำงานในเบื้องหลัง หรือเกิดข้อผิดพลาดเกี่ยวกับเครือข่ายซึ่งอาจแก้ไขได้โดยการเชื่อมต่อใหม่)

โปรดทราบว่าระบบจะไม่เรียกใช้การเรียกกลับของการตัดการเชื่อมต่อ/การเชื่อมต่อในขณะที่ตัวจัดการอุปกรณ์พยายามเชื่อมต่ออีกครั้งหลังจากเหตุการณ์ที่อาจเกิดขึ้นชั่วคราว แต่พร็อพเพอร์ตี้จะแสดงสถานะปัจจุบันจริงเสมอและสามารถสังเกตได้

- (NSTimeInterval) reconnectTimeout

readwritenonatomicassign

ระบบจะพยายามเชื่อมต่อใหม่เป็นระยะเวลานานเท่านี้ในกรณีที่ซ็อกเก็ตตัดการเชื่อมต่อเนื่องจากข้อผิดพลาดที่อาจเกิดขึ้นชั่วคราว

ระยะหมดเวลาเริ่มต้นคือ 15 วินาที

- (GCKDevice*) device

readnonatomicassign

อุปกรณ์ที่ GCKDeviceManager นี้ควบคุมอยู่

- (id<GCKDeviceManagerDelegate>) delegate

readwritenonatomicweak

ผู้รับมอบสิทธิ์ในการรับการแจ้งเตือนจาก GCKDeviceManager

- (float) deviceVolume

readnonatomicassign

ระดับเสียงปัจจุบันของอุปกรณ์ในช่วง [0.0, 1.0] หากทราบ หรือ 0 หากไม่ทราบ

- (BOOL) deviceMuted

readnonatomicassign

สถานะปิดเสียงปัจจุบันของอุปกรณ์ หากทราบ มิเช่นนั้นจะเป็น NO

- (GCKActiveInputStatus) activeInputStatus

readnonatomicassign

สถานะ "อินพุตที่ใช้งานอยู่" ปัจจุบันของอุปกรณ์

- (GCKStandbyStatus) standbyStatus

readnonatomicassign

สถานะ "สแตนด์บาย" ปัจจุบันของอุปกรณ์

- (NSString*) applicationSessionID

readnonatomiccopy

รหัสเซสชันแอปพลิเคชันสำหรับแอปพลิเคชันตัวรับที่เชื่อมต่ออยู่ในปัจจุบัน (หากมี) มิฉะนั้นจะเป็น nil

ระบบจะสร้างรหัสเซสชันใหม่ที่ไม่ซ้ำกันทุกครั้งที่เปิดแอปพลิเคชันตัวรับ (รวมถึงเมื่อเปิดแอปพลิเคชันเดียวกันอีกครั้ง) และจะยังคงมีผลตราบใดที่แอปพลิเคชันตัวรับยังคงทํางานอยู่

- (GCKApplicationMetadata*) applicationMetadata

readnonatomiccopy

ข้อมูลเมตาสำหรับแอปพลิเคชันตัวรับที่กำลังทำงานบนตัวรับ หากมี หรือ nil

- (NSString*) applicationStatusText

readnonatomiccopy

ข้อความสถานะที่รายงานล่าสุดจากแอปพลิเคชันตัวรับที่กำลังทำงานอยู่ หากมี มิฉะนั้นจะเป็น nil

ภาพรวม

สรุปวิธีการของอินสแตนซ์

สรุปพร็อพเพอร์ตี้

รายละเอียดวิธีการ

รายละเอียดพร็อพเพอร์ตี้