सूची बनाना

कास्ट फ़्रेमवर्क ऐसे सूची वाले एपीआई उपलब्ध कराता है जो कॉन्टेंट आइटम की सूचियां बनाने की सुविधा देते हैं, जैसे कि वीडियो या ऑडियो स्ट्रीम. ये आइटम, वेब रिसीवर पर एक के बाद एक चलते हैं. कॉन्टेंट आइटम की सूची में बदलाव किए जा सकते हैं, उनका क्रम बदला जा सकता है, अपडेट किया जा सकता है, और दूसरे काम भी किए जा सकते हैं.

जब तक सूची में कम से कम एक चालू आइटम (चलाया जा रहा है या रोका गया है) हो, तब तक वेब रिसीवर SDK टूल सूची को बनाए रखता है और सूची पर होने वाली कार्रवाइयों का जवाब देता है. ईमेल भेजने वाले, सेशन में शामिल हो सकते हैं और सूची में आइटम जोड़ सकते हैं. आइटम पाने वाले को सूची में जोड़े गए आइटम के लिए एक सेशन तब तक बनाए रखता है, जब तक कि आखिरी आइटम प्लेबैक पूरा नहीं हो जाता या भेजने वाला व्यक्ति, वीडियो चलाना बंद कर देता है और सेशन को खत्म कर देता है. ऐसा तब तक होता है, जब तक भेजने वाला, रिसीवर पर नई सूची लोड नहीं कर देता. पाने वाले के पास डिफ़ॉल्ट रूप से, बंद की गई सूचियों के बारे में कोई भी जानकारी नहीं होती. सूची का आखिरी आइटम खत्म होने पर, मीडिया सेशन खत्म हो जाता है और सूची खत्म हो जाती है.

मीडिया सूची आइटम बनाएं और लोड करें

iOS में, मीडिया सूची के आइटम को कास्ट फ़्रेमवर्क में GCKMediaQueueItem इंस्टेंस के तौर पर दिखाया जाता है. जब ज़रूरत के हिसाब से कॉन्टेंट के साथ कोई मीडिया सूची आइटम बनाया जाता है, तो पहले से लोड होने में लगने वाला समय सेट किया जा सकता है. इससे प्लेयर, मीडिया सूची में मौजूद आइटम के चलने से पहले ही उसे बफ़र करना शुरू कर देगा. पहले से लोड करने के बारे में ज़्यादा जानने के लिए, वेब रिसीवर को पहले से लोड करने की गाइड देखें.

आइटम के अपने-आप चलने वाले एट्रिब्यूट को 'सही' पर सेट करने से, वेब रिसीवर इसे अपने-आप चला सकता है. उदाहरण के लिए, अपने मीडिया सूची आइटम को बनाने के लिए, बिल्डर पैटर्न का इस्तेमाल इस तरह किया जा सकता है:

स्विफ़्ट
let builder = GCKMediaQueueItemBuilder.init()
builder.mediaInformation = mediaInformation
builder.autoplay = true
builder.preloadTime = 8.0
let newItem = builder.build()
मकसद-सी
GCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init];
builder.mediaInformation = self.mediaInformation;
builder.autoplay = YES;
builder.preloadTime = 8.0;
GCKMediaQueueItem *newItem = [builder build];

GCKRemoteMediaClient क्लास के सही queueLoadItems तरीके का इस्तेमाल करके, सूची में मीडिया सूची के आइटम का कलेक्शन लोड करें.

मीडिया सूची के स्टेटस का अपडेट पाएं

जब वेब रिसीवर कोई मीडिया सूची आइटम लोड करता है, तब यह उस आइटम को एक यूनीक आईडी असाइन करता है, जो सेशन के दौरान (और सूची के खत्म होने तक) बना रहता है. सूची की स्थिति देखकर पता लगाया जा सकता है कि कौनसा आइटम फ़िलहाल लोड हो रहा है (शायद वह नहीं चल रहा है), लोड हो रहा है या पहले से लोड है. आपको सूची में मौजूद सभी आइटम की क्रम वाली सूची भी मिल सकती है. GCKMediaStatus क्लास में, स्टेटस की यह जानकारी मिलती है:

  • preloadedItemID प्रॉपर्टी - अगर पहले से लोड किए गए आइटम का आईडी है, तो वह आईडी.
  • loadingItemID प्रॉपर्टी - उस आइटम का आईडी जो अभी लोड हो रहा है,
  • currentItemID प्रॉपर्टी - सूची में मौजूद मौजूदा आइटम का आईडी, अगर कोई है.
  • queueItemCount तरीका - यह बताता है कि वीडियो चलाने की सूची में कितने आइटम हैं.
  • queueItemAtIndex तरीका - यह आइटम को वीडियो चलाने की सूची में, तय किए गए इंडेक्स पर दिखाता है.

अपने ऐप्लिकेशन को सूची की स्थिति और सूची में मौजूद आइटम के बारे में सूचना देने के लिए, इन सदस्यों को मीडिया की स्थिति बताने वाले दूसरे सदस्यों के साथ इस्तेमाल करें. वेब रिसीवर से मीडिया की स्थिति के अपडेट के अलावा, आपके पास सूची में होने वाले बदलावों के बारे में जानने का विकल्प है. इसके लिए, GCKRemoteMediaClientListener के -[remoteMediaClientDidUpdateQueue:] को लागू करें.

सूची में बदलाव करें

सूची में मौजूद आइटम पर काम करने के लिए, GCKRemoteMediaClient के सूची वाले तरीकों का इस्तेमाल करें. आपके पास कई एपीआई हैं. इनसे नई सूची में कई आइटम लोड किए जा सकते हैं, मौजूदा सूची में आइटम डाले जा सकते हैं, सूची में आइटम की प्रॉपर्टी अपडेट की जा सकती हैं, सूची में आइटम को आगे या पीछे किया जा सकता है, सूची के गुण भी सेट किए जा सकते हैं (उदाहरण के लिए, अगला आइटम चुनने वाले repeatMode को बदलें), सूची से आइटम हटाएं, और सूची में मौजूद आइटम का क्रम बदलें.