दूसरी इमेज

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

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

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

टेबल 1: कॉन्टेंट और डिवाइस टाइप के हिसाब से सेकंडरी इमेज यूज़र इंटरफ़ेस (यूआई)

डिवाइस का टाइप	ऑडियो कॉन्टेंट	वीडियो सामग्री
Chromecast
Google TV वाला Chromecast
स्मार्ट डिसप्ले
स्मार्ट डिसप्ले रिमोट कंट्रोल		ध्यान दें: दूसरी इमेज, वीडियो कॉन्टेंट के रिमोट कंट्रोल पर काम नहीं करती.

ऑडियो

खास जानकारी

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

अगर स्मार्ट डिसप्ले का इस्तेमाल ऑडियो के रिमोट कंट्रोल के तौर पर किया जाता है, तो दूसरी इमेज यह सुविधा सेट होने पर, स्मार्ट डिसप्ले के यूज़र इंटरफ़ेस (यूआई) पर भी दिखेगी.

ध्यान दें: हम कास्ट डेवलपर को, डिफ़ॉल्ट ऑडियो यूज़र इंटरफ़ेस (यूआई) इस्तेमाल करने का सुझाव देते हैं वेब रिसीवर के <cast-media-player> तत्व के माध्यम से. डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना Chromecast, स्मार्ट डिसप्ले, और Chromecast with Google TV, जिसमें डिवाइस का इस्तेमाल कम होता है. दूसरी इमेज वाली सुविधा यह है यह सुविधा, कस्टम यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने वाले ऐप्लिकेशन के लिए उपलब्ध नहीं है. यह रिमोट कंट्रोल पर लागू नहीं होता है क्योंकि सेट होने पर वे हमेशा दूसरी इमेज दिखाएंगे.

लागू करना

दूसरी इमेज को सेट करने, हटाने या अपडेट करने के लिए, secondaryImage MusicTrackMediaMetadata की प्रॉपर्टी में बदलाव किया जाना चाहिए. यह प्रॉपर्टी Image ऑब्जेक्ट के यूआरएल में जानकारी अपने-आप भर गई है. इसमें बताया गया है कि सेकंडरी इमेज कहां होस्ट की गई है.

नीचे दिए गए सैंपल में, सेकंडरी इमेज को load इंटरसेप्टर में सेट किया गया है. टास्क कब शुरू होगा जब प्लेयर सामग्री लोड कर लेता है, तो दूसरी इमेज दिखाई जाती है.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
playerManager.setMessageInterceptor(
    cast.framework.messages.MessageType.LOAD, loadRequestData => {
      loadRequestData.media.metadata =
          new cast.framework.messages.MusicTrackMediaMetadata();

      // Set image on secondaryImage field of metadata object
      loadRequestData.media.metadata.secondaryImage =
          new cast.framework.messages.Image('https://www.image.png');

      return loadRequestData;
    });

प्लेबैक के दौरान दूसरी इमेज अपडेट करने के लिए, ऐप्लिकेशन को इस नंबर पर कॉल करके, MediaInformation पाने के लिए PlayerManager getMediaInformation. इसके बाद ऐप्लिकेशन कोmetadata secondaryImage प्रॉपर्टी को अपनी पसंद की वैल्यू पर सेट करें. आख़िर में, कॉल किया जा रहा हैsetMediaInformation डालने से यूज़र इंटरफ़ेस (यूआई) अपडेट हो जाएगा. आपके विज्ञापन कॉलम में, EMSG या ID3 इवेंट जैसे अपडेट के ज़रिए दिए गए मेटाडेटा में हुए बदलाव मिलता है.

const context = cast.framework.CastReceiverContext.getInstance();
const playerManager = context.getPlayerManager();
playerManager.addEventListener(cast.framework.events.EventType.EMSG, () => {
  let mediaInformation = playerManager.getMediaInformation();
  mediaInformation.metadata.secondaryImage =
      new cast.framework.messages.Image('http://anotherimage.png');
  playerManager.setMediaInformation(mediaInformation);
});

सेकंडरी इमेज को अनसेट करने के लिए, secondaryImage प्रॉपर्टी को शून्य पर सेट करें मेटाडेटा ऑब्जेक्ट.

// To unset the secondary image, set secondaryImage to null.
let mediaInformation = playerManager.getMediaInformation();
mediaInformation.metadata.secondaryImage = null;
playerManager.setMediaInformation(mediaInformation);

वीडियो

खास जानकारी

वीडियो कॉन्टेंट के लिए, सेकंडरी इमेज को इसका इस्तेमाल करके सेट किया जाता है और हटाया जाता है UiManager. दूसरी इमेज, वीडियो कंट्रोल ओवरले के साथ दिखाई जाती है.

लागू करना

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

/**
 * Sets the image url for the secondary image overlay. Replaces any image that
 * was previously set.
 */
castUiManager.setSecondaryImage(
    cast.framework.ui.SecondaryImagePosition.TOP_RIGHT_VIDEO_OVERLAY,
    'http://www.image.png');

सेकंडरी इमेज को हटाने के लिए, इमेज के यूआरएल को null या इसके तौर पर सेट करें खाली स्ट्रिंग.

// To  clear out the image, set the url to null or an empty string.
const castUiManager = cast.framework.ui.UiManager.getInstance();
castUiManager.setSecondaryImage(
    cast.framework.ui.SecondaryImagePosition.TOP_RIGHT_VIDEO_OVERLAY, null);

अगले चरण

इसके साथ वे सुविधाएं पूर्ण होती हैं जिन्हें आप अपने वेब प्राप्तकर्ता में जोड़ सकते हैं. अब ये काम किए जा सकते हैं iOS पर ईमेल भेजने के लिए ऐप्लिकेशन बनाएं, Android या वेब.