Android TV पर 'देखना जारी रखें' सुविधा को इंटिग्रेट करना

इस गाइड में, Engage SDK टूल का इस्तेमाल करके, Android TV के ऐप्लिकेशन में 'देखना जारी रखें' सुविधा को इंटिग्रेट करने का तरीका बताया गया है.

सेशन की तैयारी

शुरुआती निर्देश में दिए गए प्री-वर्क निर्देशों को पूरा करें.

इंटिग्रेशन

इकाइयां बनाना

SDK टूल ने हर तरह के आइटम को दिखाने के लिए, अलग-अलग इकाइयां तय की हैं. कंटिन्यूएशन क्लस्टर में ये इकाइयां शामिल होती हैं:

  1. MovieEntity
  2. TvEpisodeEntity
  3. LiveStreamingVideoEntity
  4. VideoClipEntity

इन इकाइयों के लिए, प्लैटफ़ॉर्म के हिसाब से यूआरआई और पोस्टर इमेज तय करें.

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

// Required. Set this when you want continue watching entities to show up on
// Google TV
val playbackUriTv = PlatformSpecificUri.Builder()
    .setPlatformType(PlatformType.TYPE_ANDROID_TV)
    .setActionUri(Uri.parse("https://www.example.com/entity_uri_for_tv"))
    .build()

// Required. Set this when you want continue watching entities to show up on
// Google TV Android app, Entertainment Space, Playstore Widget
val playbackUriAndroid = PlatformSpecificUri.Builder()
    .setPlatformType(PlatformType.TYPE_ANDROID_MOBILE)
    .setActionUri(Uri.parse("https://www.example.com/entity_uri_for_android"))
    .build()

// Optional. Set this when you want continue watching entities to show up on
// Google TV iOS app
val playbackUriIos = PlatformSpecificUri.Builder()
    .setPlatformType(PlatformType.TYPE_IOS)
    .setActionUri(Uri.parse("https://www.example.com/entity_uri_for_ios"))
    .build()

val platformSpecificPlaybackUris =
    Arrays.asList(playbackUriTv, playbackUriAndroid, playbackUriIos)

पोस्टर इमेज के लिए, यूआरआई और पिक्सल डाइमेंशन (ऊंचाई और चौड़ाई) की ज़रूरत होती है. अलग-अलग डिवाइसों को टारगेट करने के लिए, कई पोस्टर इमेज उपलब्ध कराएं. हालांकि, यह पुष्टि करें कि सभी इमेज का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 हो और उनकी ऊंचाई कम से कम 200 पिक्सल हो. इससे "देखना जारी रखें" इकाई सही तरीके से दिखती है. खास तौर पर, Google के Entertainment Space में. ऐसा हो सकता है कि 200 पिक्सल से कम ऊंचाई वाली इमेज न दिखें.

val images = Arrays.asList(
    Image.Builder()
        .setImageUri(Uri.parse("http://www.example.com/entity_image1.png"))
        .setImageHeightInPixel(300)
        .setImageWidthInPixel(169)
        .build(),
    Image.Builder()
        .setImageUri(Uri.parse("http://www.example.com/entity_image2.png"))
        .setImageHeightInPixel(640)
        .setImageWidthInPixel(360)
        .build()
    // Consider adding other images for different form factors
)

MovieEntity

इस उदाहरण में, सभी ज़रूरी फ़ील्ड के साथ MovieEntity बनाने का तरीका बताया गया है:

val movieEntity = MovieEntity.Builder()
   .setWatchNextType(WatchNextType.TYPE_CONTINUE)
   .setName("Movie name")
   .addPlatformSpecificPlaybackUris(platformSpecificPlaybackUris)
   .addPosterImages(images)
   // Timestamp in millis for sample last engagement time 12/1/2023 00:00:00
   .setLastEngagementTimeMillis(1701388800000)
   // Suppose the duration is 2 hours, it is 72000000 in milliseconds
   .setDurationMillis(72000000)
   // Suppose last playback offset is 1 hour, 36000000 in milliseconds
   .setLastPlayBackPositionTimeMillis(36000000)
   .setCallToActionText("Resume")
   .addTag("Action")
   .build()

कॉन्टेंट की शैली और रेटिंग जैसी जानकारी देने से, Google TV को आपके कॉन्टेंट को ज़्यादा डाइनैमिक तरीके से दिखाने और उसे सही दर्शकों से जोड़ने में मदद मिलती है.

val genres = Arrays.asList("Action", "Science fiction")
val rating1 = RatingSystem.Builder().setAgencyName("MPAA").setRating("PG-13").build()
val contentRatings = Arrays.asList(rating1)
val movieEntity = MovieEntity.Builder()
    ...
    .addGenres(genres)
    .addContentRatings(contentRatings)
    .build()

एंटिटी अपने-आप 60 दिनों तक उपलब्ध रहती हैं. हालांकि, अगर आपने इनके खत्म होने की समयसीमा कम रखी है, तो ये कम समय तक उपलब्ध रहेंगी. अगर आपको डिफ़ॉल्ट समयसीमा से पहले इकाई को हटाना है, तो ही कस्टम समयसीमा सेट करें.

// Set the expiration time to be now plus 30 days in milliseconds
val expirationTime = DisplayTimeWindow.Builder()
    .setEndTimestampMillis(now().toMillis()+2592000000).build()
val movieEntity = MovieEntity.Builder()
    ...
    .addAvailabilityTimeWindow(expirationTime)
    .build()

TvEpisodeEntity

इस उदाहरण में, सभी ज़रूरी फ़ील्ड के साथ TvEpisodeEntity बनाने का तरीका बताया गया है:

val tvEpisodeEntity = TvEpisodeEntity.Builder()
    .setWatchNextType(WatchNextType.TYPE_CONTINUE)
    .setName("Episode name")
    .addPlatformSpecificPlaybackUris(platformSpecificPlaybackUris)
    .addPosterImages(images)
    // Timestamp in millis for sample last engagement time 12/1/2023 00:00:00
    .setLastEngagementTimeMillis(1701388800000)
    .setDurationMillis(72000000) // 2 hours in milliseconds
    // 45 minutes and 15 seconds in milliseconds is 2715000
    .setLastPlayBackPositionTimeMillis(2715000)
    .setEpisodeNumber("2")
    .setSeasonNumber("1")
    .setShowTitle("Title of the show")
    .setCallToActionText("Resume")
    .addTag("Comedy")
    .build()

एपिसोड नंबर स्ट्रिंग (जैसे कि "2") और सीज़न नंबर स्ट्रिंग (जैसे कि "1") को 'देखना जारी रखें' कार्ड पर दिखाने से पहले, सही फ़ॉर्मैट में बड़ा किया जाएगा. ध्यान दें कि ये न्यूमेरिक स्ट्रिंग होनी चाहिए. इनमें "e2", "episode 2", "s1" या "season 1" न डालें.

अगर किसी टीवी शो का सिर्फ़ एक सीज़न है, तो सीज़न नंबर को 1 के तौर पर सेट करें.

Google TV पर दर्शकों को आपका कॉन्टेंट आसानी से मिल सके, इसके लिए ज़्यादा से ज़्यादा डेटा उपलब्ध कराएं. जैसे, कॉन्टेंट की शैली, रेटिंग, और उसे उपलब्ध कराने की समयावधि. इस जानकारी से, कॉन्टेंट को बेहतर तरीके से दिखाने और फ़िल्टर करने के विकल्पों को बेहतर बनाने में मदद मिल सकती है.

val genres = Arrays.asList("Action", "Science fiction")
val rating1 = RatingSystem.Builder().setAgencyName("MPAA").setRating("PG-13").build()
val contentRatings = Arrays.asList(rating1)
val tvEpisodeEntity = TvEpisodeEntity.Builder()
    ...
    .addGenres(genres)
    .addContentRatings(contentRatings)
    .setSeasonTitle("Season Title")
    .setShowTitle("Show Title")
    .build()

VideoClipEntity

यहां सभी ज़रूरी फ़ील्ड के साथ VideoClipEntity बनाने का उदाहरण दिया गया है.

VideoClipEntity, उपयोगकर्ता की जनरेट की गई क्लिप को दिखाता है. जैसे, YouTube वीडियो.

val videoClipEntity = VideoClipEntity.Builder()
    .setPlayBackUri(Uri.parse("https://www.example.com/uri_for_current_platform"))
    .setWatchNextType(WatchNextType.TYPE_CONTINUE)
    .setName("Video clip name")
    .addPlatformSpecificPlaybackUris(platformSpecificPlaybackUris)
    .addPosterImages(images)
    // Timestamp in millis for sample last engagement time 12/1/2023 00:00:00
    .setLastEngagementTimeMillis(1701388800000)
    .setDurationMillis(600000) //10 minutes in milliseconds
    .setLastPlayBackPositionTimeMillis(300000) //5 minutes in milliseconds
    .setCallToActionText("Resume")
    .addTag("Vlog")
    .build()

आपके पास क्रिएटर, क्रिएटर की इमेज, मिलीसेकंड में क्रिएशन का समय या उपलब्धता की समयावधि सेट करने का विकल्प होता है .

LiveStreamingVideoEntity

यहां सभी ज़रूरी फ़ील्ड के साथ LiveStreamingVideoEntity बनाने का उदाहरण दिया गया है.

val liveStreamingVideoEntity = LiveStreamingVideoEntity.Builder()
    .setPlayBackUri(Uri.parse("https://www.example.com/uri_for_current_platform"))
    .setWatchNextType(WatchNextType.TYPE_CONTINUE)
    .setName("Live streaming name")
    .addPlatformSpecificPlaybackUris(platformSpecificPlaybackUris)
    .addPosterImages(images)
    // Timestamp in millis for sample last engagement time 12/1/2023 00:00:00
    .setLastEngagementTimeMillis(1701388800000)
    .setLastPlayBackPositionTimeMillis(36000000) //1 hour in milliseconds
    .addContentRating(contentRating)
    .setCallToActionText("Resume")
    .addTag("Live")
    .build()

इसके अलावा, लाइव स्ट्रीमिंग वाली इकाई के लिए, शुरू होने का समय, ब्रॉडकास्टर, ब्रॉडकास्टर का आइकॉन या उपलब्धता की समयावधि सेट की जा सकती है.

एट्रिब्यूट और ज़रूरी शर्तों के बारे में ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस देखें.

जारी रखने वाले क्लस्टर का डेटा उपलब्ध कराना

AppEngagePublishClient, कंटिन्यूएशन क्लस्टर को पब्लिश करने के लिए ज़िम्मेदार है. ContinuationCluster ऑब्जेक्ट को पब्लिश करने के लिए, publishContinuationCluster तरीके का इस्तेमाल किया जाता है.

क्लाइंट को शुरू करना और सेवा की उपलब्धता की जांच करना न भूलें. इसके बारे में शुरुआती निर्देश में बताया गया है.

client.publishContinuationCluster(
    PublishContinuationClusterRequest
        .Builder()
        .setContinuationCluster(
            ContinuationCluster.Builder()
                .setAccountProfile(accountProfile)
                .addEntity(movieEntity1)
                .addEntity(movieEntity2)
                .addEntity(tvEpisodeEntity1)
                .addEntity(tvEpisodeEntity2)
                .setSyncAcrossDevices(true)
                .build()
        )
        .build()
)

जब सेवा को अनुरोध मिलता है, तो एक लेन-देन के अंदर ये कार्रवाइयां होती हैं:

  • डेवलपर पार्टनर का मौजूदा ContinuationCluster डेटा हटा दिया जाता है.
  • अनुरोध से मिले डेटा को पार्स करके, अपडेट किए गए ContinuationCluster में सेव किया जाता है.

किसी गड़बड़ी के मामले में, पूरा अनुरोध अस्वीकार कर दिया जाता है और मौजूदा स्थिति को बनाए रखा जाता है.

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

कॉन्टिन्यूएशन क्लस्टर का डेटा, सिर्फ़ वयस्क खातों के लिए उपलब्ध कराया जाना चाहिए. सिर्फ़ तब पब्लिश करें, जब खाते की प्रोफ़ाइल किसी वयस्क की हो.

क्रॉस-डिवाइस सिंक करने की सुविधा

setSyncAcrossDevices से यह कंट्रोल किया जाता है कि किसी उपयोगकर्ता का ContinuationCluster डेटा, टीवी, फ़ोन, टैबलेट वगैरह जैसे डिवाइसों पर सिंक किया जाए या नहीं. क्रॉस-डिवाइस सिंक करने की सुविधा, डिफ़ॉल्ट रूप से बंद होती है.

वैल्यू:

  • true: कॉन्टिन्यूएशन क्लस्टर का डेटा, उपयोगकर्ता के सभी डिवाइसों पर शेयर किया जाता है, ताकि उसे कॉन्टेंट देखने का बेहतरीन अनुभव मिल सके. हमारा सुझाव है कि आप इस विकल्प को चुनें, ताकि आपको सभी डिवाइसों पर बेहतर अनुभव मिल सके.
  • false: कॉन्टिन्यूएशन क्लस्टर का डेटा, मौजूदा डिवाइस तक ही सीमित है.

इसके अलावा, आपको खाता आईडी के साथ AccountProfile देना होगा, ताकि कॉन्टेंट को सभी डिवाइसों पर सिंक किया जा सके. खाते की प्रोफ़ाइल बनाना देखें.

मीडिया ऐप्लिकेशन में, क्रॉस-डिवाइस सिंक करने की सुविधा को चालू या बंद करने के लिए, साफ़ तौर पर सेटिंग दी जानी चाहिए. उपयोगकर्ता को इसके फ़ायदे बताएं और उसकी प्राथमिकता को एक बार सेव करें. इसके बाद, उसे publishContinuationCluster में उसी हिसाब से लागू करें.

// Example to allow cross device syncing.
client.publishContinuationCluster(
    PublishContinuationClusterRequest
        .Builder()
        .setContinuationCluster(
            ContinuationCluster.Builder()
                .setAccountProfile(accountProfile)
                .setSyncAcrossDevices(true)
                .build()
        )
        .build()
)

क्रॉस-डिवाइस की सुविधा का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, पुष्टि करें कि ऐप्लिकेशन को उपयोगकर्ता की सहमति मिली हो. साथ ही, SyncAcrossDevices से true को चालू करें. इससे कॉन्टेंट को सभी डिवाइसों पर आसानी से सिंक किया जा सकता है. इससे उपयोगकर्ताओं को बेहतर अनुभव मिलता है और उनकी दिलचस्पी बढ़ती है. उदाहरण के लिए, इस सुविधा को लागू करने वाले एक पार्टनर को "देखना जारी रखें" पर मिलने वाले क्लिक में 40% की बढ़ोतरी देखने को मिली. ऐसा इसलिए हुआ, क्योंकि उनका कॉन्टेंट कई डिवाइसों पर दिखाया गया था.

Engage का डेटा मिटाना

डेटा को Google TV के सर्वर पर 60 दिनों तक सेव रखने की स्टैंडर्ड अवधि से पहले, मैन्युअल तरीके से मिटाने के लिए, deleteClusters तरीके का इस्तेमाल करें. अनुरोध मिलने पर, सेवा खाते की प्रोफ़ाइल या पूरे खाते के लिए, Engage का सारा मौजूदा डेटा मिटा देगी.

DeleteReason enum, डेटा मिटाने की वजह के बारे में बताता है. यहां दिया गया कोड, लॉग आउट करने पर 'देखना जारी रखें' डेटा को हटा देता है.


// If the user logs out from your media app, you must make the following call
// to remove continue watching data from the current google TV device,
// otherwise, the continue watching data will persist on the current
// google TV device until 60 days later.
client.deleteClusters(
    DeleteClustersRequest.Builder()
        .setAccountProfile(accountProfile)
        .setDeleteReason(DeleteReason.DELETE_REASON_USER_LOG_OUT)
        .setSyncAcrossDevices(true)
        .build()
)

जांच करना

पुष्टि करने वाले ऐप्लिकेशन का इस्तेमाल करके, यह पुष्टि करें कि Engage SDK टूल का इंटिग्रेशन सही तरीके से काम कर रहा है.

Publication API को शुरू करने के बाद, पुष्टि करने वाले ऐप्लिकेशन में जाकर देखें कि आपका डेटा सही तरीके से पब्लिश हो रहा है या नहीं. आपका कंटिन्यूएशन क्लस्टर, ऐप्लिकेशन के इंटरफ़ेस में एक अलग लाइन के तौर पर दिखना चाहिए.

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

    पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से गड़बड़ी की जानकारी देने वाला स्क्रीनशॉट
    पहली इमेज. पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से पुष्टि होने की जानकारी
  • पुष्टि करने वाला ऐप्लिकेशन, समस्या वाली सभी इकाइयों को फ़्लैग करेगा.

    पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से गड़बड़ी की जानकारी देने वाला स्क्रीनशॉट
    दूसरी इमेज. पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से गड़बड़ी
  • गड़बड़ियों वाली इकाइयों से जुड़ी समस्याएं हल करने के लिए, टीवी के रिमोट का इस्तेमाल करके, पुष्टि करने वाले ऐप्लिकेशन में इकाई को चुनें और उस पर क्लिक करें. आपको खास समस्याएं दिखेंगी और उन्हें लाल रंग में हाइलाइट किया जाएगा, ताकि आप उनकी समीक्षा कर सकें. इसका उदाहरण नीचे देखें.

    पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से गड़बड़ी की जानकारी
    तीसरी इमेज. पुष्टि करने वाले ऐप्लिकेशन के इस्तेमाल से गड़बड़ी की जानकारी