ภาพรวม

ตัวควบคุมสําหรับอุปกรณ์แคสต์

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

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

Deprecated:: ใช้ GCKSessionManager และ GCKCastSession เพื่อโต้ตอบกับเครื่องรับการแคสต์

รับค่า 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
	สถานะปัจจุบันของการเชื่อมต่อของผู้จัดการอุปกรณ์ เพิ่มเติม...

GCKConnectionState	applicationConnectionState
	สถานะปัจจุบันของการเชื่อมต่อแอปพลิเคชันของผู้จัดการอุปกรณ์ เพิ่มเติม...

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

สถานะปัจจุบันของการเชื่อมต่อของผู้จัดการอุปกรณ์

- (GCKConnectionState) applicationConnectionState

readnonatomicassign

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

- (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

คลาส GCKDeviceManager

ภาพรวม

สรุปเมธอดของอินสแตนซ์

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

รายละเอียดเมธอด

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