คลาส GCKCastContext

ภาพรวม

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

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

Since
3.0

รับค่า NSObject

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

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

สรุปเมธอดของคลาส

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

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

NSString *const kGCKNotificationKeyCastState
 คีย์ userInfo สําหรับสถานะแคสต์ใหม่ในการแจ้งเตือนการเปลี่ยนแปลงสถานะแคสต์ เพิ่มเติม...
 
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

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

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

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

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

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

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

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

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

+ (BOOL) isSharedInstanceInitialized

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

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

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

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:
ใช้ currentCastInstructionsViewControllerControllerWithWithCastButton:

ให้บริการโดยหมวดหมู่ 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 สําหรับสถานะแคสต์ใหม่ในการแจ้งเตือนการเปลี่ยนแปลงสถานะแคสต์

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