คลาส GCKCastContext

ภาพรวม

คลาสที่มีออบเจ็กต์ส่วนกลางและสถานะสำหรับเฟรมเวิร์ก

บริบทจะต้องเริ่มต้นตั้งแต่เนิ่นๆ ในวงจรของแอปพลิเคชันผ่านการเรียกไปยัง setSharedInstanceWithOptions: (GCKCastContext)

Since
3.0

รับค่า NSObject

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

(void) - registerDeviceProvider:
 ลงทะเบียนผู้ให้บริการอุปกรณ์ ซึ่งจะเพิ่มการรองรับอุปกรณ์ประเภทใหม่ (ไม่ใช่แคสต์) เพิ่มเติม...
 
(void) - unregisterDeviceProviderForCategory:
 ยกเลิกการลงทะเบียนผู้ให้บริการอุปกรณ์สำหรับหมวดหมู่อุปกรณ์ที่ระบุ เพิ่มเติม...
 
(void) - setLaunchCredentialsData:
 ตั้งค่าข้อมูลเข้าสู่ระบบของผู้ใช้ปัจจุบัน เพิ่มเติม...
 
(void) - presentCastDialog
 แสดงกล่องโต้ตอบการแคสต์ เพิ่มเติม...
 
(GCKUICastContainerViewController *) - createCastContainerControllerForViewController:
 สร้าง GCKUICastContainerViewController ที่ฝังตัวควบคุมมุมมองที่กำหนด เพิ่มเติม...
 
(GCKUIMiniMediaControlsViewController *) - createMiniMediaControlsViewController
 สร้าง GCKUIMiniMediaControlsViewController เพิ่มเติม...
 
(BOOL) - presentCastInstructionsViewControllerOnce
 หากยังไม่เคยแสดงมาก่อน จะแสดงตัวควบคุมมุมมองโมดัลแบบเต็มหน้าจอที่เรียกความสนใจมายังปุ่ม "แคสต์" และแสดงข้อความแนะนำการใช้งานสั้นๆ เพิ่มเติม...
 
(BOOL) - presentCastInstructionsViewControllerOnceWithCastButton:
 หากยังไม่เคยแสดงมาก่อน จะแสดงตัวควบคุมมุมมองโมดัลแบบเต็มหน้าจอที่เรียกความสนใจไปยังปุ่ม "แคสต์" ที่มีการส่งมุมมองเข้ามา และแสดงข้อความให้คำแนะนำสั้นๆ เกี่ยวกับการใช้งาน เพิ่มเติม...
 
(void) - clearCastInstructionsShownFlag
 ล้างแฟล็กถาวรที่ติดตามว่าตัวควบคุมมุมมองโมดัลวิธีการแคสต์นั้นแสดงขึ้นหรือไม่ เพิ่มเติม...
 
(void) - presentDefaultExpandedMediaControls
 แสดงการควบคุมสื่อแบบขยายของ Cast ตามค่าเริ่มต้น เพิ่มเติม...
 

สรุปวิธีการของชั้นเรียน

(void) + setSharedInstanceWithOptions:
 ตั้งค่าอินสแตนซ์ที่แชร์โดยให้ออบเจ็กต์ตัวเลือกการแคสต์ เพิ่มเติม...
 
(BOOL) + setSharedInstanceWithOptions:error:
 ตั้งค่าอินสแตนซ์ที่แชร์โดยให้ออบเจ็กต์ตัวเลือกการแคสต์ เพิ่มเติม...
 
(instancetype) + sharedInstance
 แสดงผลอินสแตนซ์ซิงเกิล เพิ่มเติม...
 
(BOOL) + isSharedInstanceInitialized
 ทดสอบว่าอินสแตนซ์ Singleton เริ่มต้นแล้วหรือยัง เพิ่มเติม...
 

แอตทริบิวต์สาธารณะ

NSString *const kGCKNotificationKeyCastState
 แป้น userInfo สำหรับสถานะ Cast ใหม่ในการแจ้งเตือนการเปลี่ยนสถานะ Cast เพิ่มเติม...
 
NSString *const kGCKCastStateDidChangeNotification
 ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อมีการเปลี่ยนแปลงสถานะการแคสต์ เพิ่มเติม...
 
NSString *const kGCKExpandedMediaControlsTriggeredNotification
 ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อมีการแสดงตัวควบคุมสื่อแบบขยายแก่ผู้ใช้ เพิ่มเติม...
 
NSString *const kGCKUICastDialogWillShowNotification
 ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อกล่องโต้ตอบการแคสต์กำลังจะแสดง เพิ่มเติม...
 
NSString *const kGCKUICastDialogDidHideNotification
 ชื่อการแจ้งเตือนที่จะเผยแพร่เมื่อมีการปิดกล่องโต้ตอบการแคสต์ เพิ่มเติม...
 

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

GCKCastState castState
 สถานะการแคสต์ปัจจุบันสำหรับแอปพลิเคชัน เพิ่มเติม...
 
GCKDiscoveryManagerdiscoveryManager
 เครื่องมือจัดการการสำรวจ เพิ่มเติม...
 
GCKSessionManagersessionManager
 ผู้จัดการเซสชัน เพิ่มเติม...
 
id< GCKUIImageCacheimageCache
 การใช้งานแคชรูปภาพที่จะใช้โดยเฟรมเวิร์กเพื่อดึงรูปภาพที่อ้างอิงในข้อมูลเมตาของสื่อ เพิ่มเติม...
 
id< GCKUIImagePickerimagePicker
 การใช้งานเครื่องมือเลือกรูปภาพที่จะใช้ในการเลือกรูปภาพสำหรับวัตถุประสงค์ที่เฉพาะเจาะจง เพิ่มเติม...
 
BOOL useDefaultExpandedMediaControls
 กำหนดค่าลักษณะการทำงานของเฟรมเวิร์กเมื่อมีการดำเนินการของผู้ใช้ที่ควรส่งผลให้เกิดการนำเสนอการควบคุมแบบขยาย เพิ่มเติม...
 
GCKUIExpandedMediaControlsViewControllerdefaultExpandedMediaControlsViewController
 อินสแตนซ์ของตัวควบคุมมุมมองตัวควบคุมสื่อแบบขยายของ Cast ตามค่าเริ่มต้น เพิ่มเติม...
 

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

+ (void) setSharedInstanceWithOptions: (GCKCastOptions *)  options

ตั้งค่าอินสแตนซ์ที่แชร์โดยให้ออบเจ็กต์ตัวเลือกการแคสต์

หากอินสแตนซ์ที่แชร์เริ่มต้นแล้ว จะมีการส่งข้อยกเว้น

Parameters
optionsThe Cast options.
+ (BOOL) setSharedInstanceWithOptions: (GCKCastOptions *)  options
error: (GCKError *_Nullable *_Nullable)  error 

ตั้งค่าอินสแตนซ์ที่แชร์โดยให้ออบเจ็กต์ตัวเลือกการแคสต์

การเรียกจะล้มเหลวหากมีการเริ่มต้นบริบทแล้ว ต้องเรียกใช้เมธอดนี้ในเทรดหลัก

Parameters
optionsThe Cast options.
errorA pointer at which to store the error in case of a failure.
การคืนสินค้า
YES เมื่อประสบความสำเร็จ NO เมื่อล้มเหลว
Since
4.0
+ (instancetype) sharedInstance

แสดงผลอินสแตนซ์ซิงเกิล

ถ้ายังไม่ได้เริ่มต้นอินสแตนซ์ที่ใช้ร่วมกัน จะมีการส่งข้อยกเว้น

+ (BOOL) isSharedInstanceInitialized

ทดสอบว่าอินสแตนซ์ Singleton เริ่มต้นแล้วหรือยัง

Since
3.5.4
- (void) registerDeviceProvider: (GCKDeviceProvider *)  deviceProvider

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

Parameters
deviceProviderAn instance of a GCKDeviceProvider subclass for managing the devices.
- (void) unregisterDeviceProviderForCategory: (NSString *)  category

ยกเลิกการลงทะเบียนผู้ให้บริการอุปกรณ์สำหรับหมวดหมู่อุปกรณ์ที่ระบุ

Parameters
categoryA string that uniquely identifies the type of device.
- (void) setLaunchCredentialsData: (GCKCredentialsData *_Nullable)  credentialsData

ตั้งค่าข้อมูลเข้าสู่ระบบของผู้ใช้ปัจจุบัน

คุณควรเรียกใช้ API นี้ด้วยข้อมูลผู้ใช้ปัจจุบันก่อนเริ่มเซสชันการแคสต์และเมื่อใดก็ตามที่มีการเปลี่ยนแปลงบัญชีผู้ใช้

ระบบจะฝังข้อมูลเข้าสู่ระบบไว้ในคำขอเปิดใช้งาน หากต้องการเปิดแอป Android TV แอปจะใช้ข้อมูลเข้าสู่ระบบดังกล่าวเพื่อระบุว่าแอปรองรับผู้ใช้ที่เจาะจงรายนี้หรือไม่ ไม่เช่นนั้นระบบจะเปิดแอปแคสต์แทน

หากแอป Android TV เปิดขึ้น ระบบจะส่งผ่านข้อมูลเข้าสู่ระบบไปยังแอปภายในเจตนาการเปิดตัว แอปจะใช้ข้อมูลนี้เพื่อปรับเปลี่ยนประสบการณ์ของผู้ใช้ให้เหมาะกับผู้ใช้ได้

Parameters
credentialsDataAn instance of GCKCredentialsData. May be nil.
- (void) presentCastDialog

แสดงกล่องโต้ตอบการแคสต์

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (GCKUICastContainerViewController *) createCastContainerControllerForViewController: (UIViewController *)  viewController

สร้าง GCKUICastContainerViewController ที่ฝังตัวควบคุมมุมมองที่กำหนด

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (GCKUIMiniMediaControlsViewController *) createMiniMediaControlsViewController

สร้าง GCKUIMiniMediaControlsViewController

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (BOOL) presentCastInstructionsViewControllerOnce

หากยังไม่เคยแสดงมาก่อน จะแสดงตัวควบคุมมุมมองโมดัลแบบเต็มหน้าจอที่เรียกความสนใจมายังปุ่ม "แคสต์" และแสดงข้อความแนะนำการใช้งานสั้นๆ

การคืนสินค้า
YES หากตัวควบคุมมุมมองแสดงอยู่ NO หากตัวควบคุมไม่ปรากฏเนื่องจากเคยแสดงมาก่อนแล้ว ตั้งแต่เวอร์ชัน 4.1 เป็นต้นไป ระบบจะส่งคืน NO ด้วยหากไม่พบปุ่ม "แคสต์"
Deprecated:
ใช้ currentCastRecommendationViewControllerWhenWithCastButton:.

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (BOOL) presentCastInstructionsViewControllerOnceWithCastButton: (GCKUICastButton *)  castButton

หากยังไม่เคยแสดงมาก่อน จะแสดงตัวควบคุมมุมมองโมดัลแบบเต็มหน้าจอที่เรียกความสนใจไปยังปุ่ม "แคสต์" ที่มีการส่งมุมมองเข้ามา และแสดงข้อความให้คำแนะนำสั้นๆ เกี่ยวกับการใช้งาน

การคืนสินค้า
YES หากตัวควบคุมมุมมองแสดงอยู่ NO หากตัวควบคุมไม่ปรากฏเนื่องจากเคยแสดงมาก่อนแล้ว และจะแสดงผล NO ด้วยหากไม่พบปุ่ม "แคสต์"
Since
4.1

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (void) clearCastInstructionsShownFlag

ล้างแฟล็กถาวรที่ติดตามว่าตัวควบคุมมุมมองโมดัลวิธีการแคสต์นั้นแสดงขึ้นหรือไม่

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (void) presentDefaultExpandedMediaControls

แสดงการควบคุมสื่อแบบขยายของ Cast ตามค่าเริ่มต้น

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

เอกสารประกอบข้อมูลสมาชิก

- (NSString* const) kGCKNotificationKeyCastState

แป้น userInfo สำหรับสถานะ Cast ใหม่ในการแจ้งเตือนการเปลี่ยนสถานะ Cast

- (NSString* const) kGCKCastStateDidChangeNotification

ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อมีการเปลี่ยนแปลงสถานะการแคสต์

- (NSString* const) kGCKExpandedMediaControlsTriggeredNotification

ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อมีการแสดงตัวควบคุมสื่อแบบขยายแก่ผู้ใช้

- (NSString* const) kGCKUICastDialogWillShowNotification

ชื่อของการแจ้งเตือนที่จะเผยแพร่เมื่อกล่องโต้ตอบการแคสต์กำลังจะแสดง

Since
3.4
- (NSString* const) kGCKUICastDialogDidHideNotification

ชื่อการแจ้งเตือนที่จะเผยแพร่เมื่อมีการปิดกล่องโต้ตอบการแคสต์

Since
3.4

รายละเอียดที่พัก

- (GCKCastState) castState
readnonatomicassign

สถานะการแคสต์ปัจจุบันสำหรับแอปพลิเคชัน

คุณสามารถตรวจสอบการเปลี่ยนแปลงพร็อพเพอร์ตี้นี้ได้ด้วย KVO หรือโดยการฟังการแจ้งเตือน kGCKCastStateDidChangeNotification

- (GCKDiscoveryManager*) discoveryManager
readnonatomicstrong

เครื่องมือจัดการการสำรวจ

ออบเจ็กต์นี้จะจัดการการค้นพบอุปกรณ์ตัวรับ

- (GCKSessionManager*) sessionManager
readnonatomicstrong

ผู้จัดการเซสชัน

ออบเจ็กต์นี้จัดการการโต้ตอบกับอุปกรณ์ตัวรับ

- (id<GCKUIImageCache>) imageCache
readwritenonatomicstrong

การใช้งานแคชรูปภาพที่จะใช้โดยเฟรมเวิร์กเพื่อดึงรูปภาพที่อ้างอิงในข้อมูลเมตาของสื่อ

ระบบจะใช้การติดตั้งใช้งานเริ่มต้นหากแอปพลิเคชันไม่ได้ระบุไว้ อาจตั้งค่าเป็น nil เพื่อคืนสิทธิแคชรูปภาพเริ่มต้น

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (id<GCKUIImagePicker>) imagePicker
readwritenonatomicstrong

การใช้งานเครื่องมือเลือกรูปภาพที่จะใช้ในการเลือกรูปภาพสำหรับวัตถุประสงค์ที่เฉพาะเจาะจง

ระบบจะใช้การติดตั้งใช้งานเริ่มต้นหากแอปพลิเคชันไม่ได้ระบุไว้ อาจตั้งค่าเป็น nil เพื่อคืนสถานะเครื่องมือเลือกรูปภาพเริ่มต้น

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (BOOL) useDefaultExpandedMediaControls
readwritenonatomicassign

กำหนดค่าลักษณะการทำงานของเฟรมเวิร์กเมื่อมีการดำเนินการของผู้ใช้ที่ควรส่งผลให้เกิดการนำเสนอการควบคุมแบบขยาย

หากเป็น YES เฟรมเวิร์กจะแสดงมุมมองการควบคุมแบบขยายที่เป็นค่าเริ่มต้น หากเป็น NO เฟรมเวิร์กจะทริกเกอร์ GCKCastContext::kGCKExpandedMediaControlsTriggeredNotification เท่านั้น

ให้บริการตามหมวดหมู่ GCKCastContext(UI)

- (GCKUIExpandedMediaControlsViewController*) defaultExpandedMediaControlsViewController
readnonatomicstrong

อินสแตนซ์ของตัวควบคุมมุมมองตัวควบคุมสื่อแบบขยายของ Cast ตามค่าเริ่มต้น

ให้บริการตามหมวดหมู่ GCKCastContext(UI)