คลาส GCKDeviceManager

การอ้างอิงคลาส GCKDeviceManager

ภาพรวม

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

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

อินสแตนซ์ 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
 ระบบจะลองเชื่อมต่อใหม่เป็นระยะเวลานานในกรณีที่ซ็อกเก็ตถูกตัดการเชื่อมต่อด้วยข้อผิดพลาดที่อาจเกิดขึ้นชั่วคราว เพิ่มเติม...
 
GCKDevicedevice
 อุปกรณ์ที่ GCKDeviceManager ควบคุมอยู่ เพิ่มเติม...
 
id< GCKDeviceManagerDelegatedelegate
 ผู้รับมอบสิทธิ์สําหรับรับการแจ้งเตือนจาก GCKDeviceManager เพิ่มเติม...
 
float deviceVolume
 ระดับเสียงปัจจุบันของอุปกรณ์ในช่วง [0.0, 1.0] หากทราบ ไม่เช่นนั้นจะเป็น 0 เพิ่มเติม...
 
BOOL deviceMuted
 สถานะการปิดเสียงปัจจุบันของอุปกรณ์ (หากมี) หากไม่ใช่ NO เพิ่มเติม...
 
GCKActiveInputStatus activeInputStatus
 สถานะ "อินพุตที่ใช้งานอยู่" ปัจจุบันของอุปกรณ์ เพิ่มเติม...
 
GCKStandbyStatus standbyStatus
 สถานะ "สแตนด์บาย" ของอุปกรณ์ในปัจจุบัน เพิ่มเติม...
 
NSString * applicationSessionID
 รหัสเซสชันของแอปพลิเคชันสําหรับแอปพลิเคชันตัวรับที่เชื่อมต่อปัจจุบัน (หากมี) หรือnil เพิ่มเติม...
 
GCKApplicationMetadataapplicationMetadata
 ข้อมูลเมตาสําหรับแอปพลิเคชันในฝั่งผู้รับที่กําลังทํางานอยู่ในฝั่งผู้รับ (หากมี) หากไม่ใช่ nil เพิ่มเติม...
 
NSString * applicationStatusText
 ข้อความสถานะที่รายงานล่าสุดจากแอปพลิเคชันในฝั่งผู้รับที่ใช้งานอยู่ (หากมี) หากไม่ใช่ nil เพิ่มเติม...
 

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

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

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

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

Parameters
deviceThe device to control.
clientPackageNameThe client package name.
- (instancetype) initWithDevice: (GCKDevice *)  device
clientPackageName: (NSString *)  clientPackageName
ignoreAppStateNotifications: (BOOL)  ignoreAppStateNotifications 

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

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

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

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

Parameters
deviceThe device to control.
clientPackageNameThe client package name.
ignoreAppStateNotificationsWhether this object will ignore app state notifications.
- (void) connect

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

- (void) disconnect

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

ปัญหานี้เป็นการยกเลิกการเชื่อมต่ออย่างชัดเจน

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

- (void) disconnectWithLeave: (BOOL)  leaveApplication

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

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

Parameters
leaveApplicationYES 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
channelThe channel.
การคืนสินค้า
YES หากเพิ่มช่องแล้ว NO หากไม่มีการเพิ่มช่องเนื่องจากมีช่องที่แนบสําหรับเนมสเปซนั้นอยู่แล้ว
- (BOOL) removeChannel: (GCKCastChannel *)  channel

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

Parameters
channelThe channel.
การคืนสินค้า
YES หากมีการนําช่องออก NO หากระบบไม่ได้นําช่องดังกล่าวออกเพราะไม่ได้แนบช่องที่ระบุก่อนหน้านี้
- (NSInteger) launchApplication: (NSString *)  applicationID

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

Parameters
applicationIDThe application ID.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) launchApplication: (NSString *)  applicationID
withLaunchOptions: (GCKLaunchOptions *__nullable)  launchOptions 

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

Parameters
applicationIDThe application ID.
launchOptionsThe launch options for this request. If nil, defaults will be used.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) launchApplication: (NSString *)  applicationID
relaunchIfRunning: (BOOL)  relaunchIfRunning 

เปิดแอปพลิเคชัน (ไม่บังคับ) เพื่อเรียกใช้งานหากแอปพลิเคชันนั้นทํางานอยู่แล้ว

Deprecated:
ใช้ launchApplication:withLaunchOptions: แทน
Parameters
applicationIDThe application ID.
relaunchIfRunningIf YES, relaunches the application if it is already running instead of joining the running application.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) joinApplication: (NSString *__nullable)  applicationID

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

Parameters
applicationIDThe 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
applicationIDThe application ID.
sessionIDThe application session ID.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (BOOL) leaveApplication

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

การคืนสินค้า
NO หากส่งข้อความไม่ได้
- (NSInteger) stopApplication

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

การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable)  sessionID

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

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

Parameters
sessionIDThe application session ID, which may not be nil.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) setVolume: (float)  volume

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

Parameters
volumeThe new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.
การคืนสินค้า
รหัสคําขอ หรือ kGCKInvalidRequestID หากส่งคําขอไม่ได้
- (NSInteger) setMuted: (BOOL)  muted

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

Parameters
mutedWhether 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