Forum Discussion

avodahsoftware's avatar
avodahsoftware
Binge Watcher
6 years ago

liveFeed JSON question

I'm adding liveFeed to my direct publisher JSON file, and I have a question about the content child object. Inside of "content" there is a required duration field, so how do you know what to set as the duration?

 

Also, inside of "content" is "videos" object and quality and videoType are required.... I just a have m3u8 stream file, so not sure what quality or videoType should be used?

 

Are these truly required fields when using the liveFeed?

13 Replies

  • While I don't run live streams, I have tested one.  Take a look at the Roku Schema Document.  You'll see that the 'duration' field should be set to the maximum time your live feed will be broadcasting.

    Set the 'videoType' field to HLS.

    • JohnLocke1's avatar
      JohnLocke1
      Channel Surfer

      Cannot find an actual example json with liveFeed. I continually get

      1 item has an error: No valid items were found in the feed: validateAnyOf
       
      The .m3u8 feed link is valid, though.
       
      Roku gives no json example including the .m3u8 feed, nor have I found it anywhere.
       
      No help anywhere thus far.
      • 37mediagroup's avatar
        37mediagroup
        Roku Guru

        JohnLocke1 wrote:

        Cannot find an actual example json with liveFeed. I continually get

        1 item has an error: No valid items were found in the feed: validateAnyOf
         
        The .m3u8 feed link is valid, though.
         
        Roku gives no json example including the .m3u8 feed, nor have I found it anywhere.
         
        No help anywhere thus far.

        Have you tried mimicking this?  https://developer.roku.com/docs/specs/direct-publisher-feed-specs/json-dp-spec.md#livefeed

         

        {  
           "id":"1509428502953",
           "title":"Sample Stream",
           "content":{  
              ...
           },
           "language":{  
              "en"
           },
           "thumbnail":"https://example.org/cdn/thumbnails/1509428502952/1",
           "brandedThumbnail":"https://example.org/cdn/thumbnails/1509428502952/1",
           "shortDescription":"A live description",
           "longDescription":"A longer description of a live stream",
           "tags":[  
              "linear",
              "news",
              "celebrity"
           ]
        }
  • Hi,

    You do not need duration for liveFeeds in Roku Direct Publisher, videoType should be HLS for live stream and quality is based on the stream resolution (FHD for 1080p, HD for 720p etc.)

    Here is a sample JSON with liveFeeds:

    {
        "providerName": "OTTfeed.com"
        , "lastUpdated": "2021-01-22T21:01:43+00:00"
        , "language": "en-US"
        , "liveFeeds": [{
            "id": "GCUGbgJZalE6XOuIzJVV"
            , "title": "OTTfeed"
            , "content": {
                "dateAdded": "2021-01-23T17:20:46+00:00"
                , "videos": [{
                    "url": "https://playlist.ottfeed.com/live/master.m3u8?channel=GCUGbgJZalE6XOuIzJVV"
                    , "quality": "FHD"
                    , "videoType": "HLS"
                }]
                , "language": "en-US"
            }
            , "thumbnail": "https://ottfeed.com/GCUGbgJZalE6XOuIzJVV/OTTfeed-live-image.png"
            , "shortDescription": "All-in-one feed management system for Roku Direct Publisher, Roku Channel and custom OTT apps"
            , "longDescription": "OTTfeed: All-in-one feed management system for Roku Direct Publisher, Roku Channel and custom OTT apps. All Content Types, Management Tools & Advanced workflows. For more info go to https://OTTfeed.com"
            , "tags": ["ottfeed", "live"]
            , "rating": {
                "rating": "UNRATED"
                , "ratingSource": "USA_PR"
            }
            , "genres": ["technology"]
        }]
        , "categories": [{
            "name": "Latest"
            , "order": "most_recent"
            , "query": "live OR ottfeed"
        }]
    }

    Download the file: https://ottfeed.com/GCUGbgJZalE6XOuIzJVV/OTTfeed-RDP-liveFeed.json

    • newperceptions's avatar
      newperceptions
      Streaming Star

      I just added "duration" to it because I read somewhere that may be the issue. What happens is it loads up the Roku channel, and then flashes the live video in the "Hero Row" briefly, but then it disappears and all that shows is the Search and About buttons. Is a lack of the "duration" causing this? Here's my full code (note that I have tried both with and without "duration".

      Richard P.

      {
          "providerName": "Pioneer Memorial Church",
          "lastUpdated": "2021-03-26T22:30:00+00:00",
          "language": "en",
          "liveFeeds": [{  
         "id":"FTXVjkLZw3H5BPeFcMWW",
         "title":"Pioneer Live",
         "content":{
                  "dateAdded": "2021-03-15T22:30:00+00:00"
                  , "videos": [{
                      "url": "http://pioneermem.mmdlive.lldns.net/pioneermem/e62d944fc8744b1ab441fa0b0ba752a2/manifest.m3u8"
                      , "quality": "FHD"
                      , "videoType": "HLS"
                  }],
      			"language": "en-US",
      			"duration": 18000
              },
         "thumbnail":"https://pmchurch.org/sites/default/files/images/brand/pmc-roku-live-slate.jpg",
         "brandedThumbnail":"https://pmchurch.org/sites/default/files/images/brand/pmc-roku-live-slate.jpg",
         "shortDescription":"Pioneer at Worship",
         "longDescription":"The live worship service from Pioneer Memorial Church.",
         "tags":[  
      	"religion",
      	"worship",
      	"church",
      	"live"
         ]
      	}
      
          ]
      }
      • sattun's avatar
        sattun
        Roku Guru

        Hi Richard,

        I dont see categories in your feed, did you set the categories on the Roku developer site?