The easiest way content providers can send video to Oovvuu is via MRSS or other similar XML feeds.
Oovvuu's systems can map fields where necessary as there are a wide variety of ways that some metadata can be specified in the MRSS format, so if you have an existing feed format that includes all the relevant information Oovvuu can make it work.
Or if there is a single api call that can be made that can return the fields listed below as XML we could use that too.
If you are a content aggregator, it will be fastest and easiest if Oovvuu can receive one feed (or make one call) per content creator. If there are query string parameters on an MRSS that would allow us to filter, or API parameters that could be used then please provide this information.
Below is a quick outline of the required elements, how they might look in a feed, and how that then would get displayed to a user.
Expected metadata
In terms of the expected metadata they are as follows:
Video Title - The headline of the video. eg 'Katy Perry's Baby News'
GUID - your unique identifier for the video. We can report against this id if you require.
Publication date - datetime the content was published
Video Description - a few lines providing further context for the video. eg "Katy Perry has confirmed she is pregnant, and said she and fiance Orlando Bloom are "excited and happy" about their baby news."
Image URL - eg https://image.server.com/Katy-Perry-baby.jpg
Additional images are ok, but at least one 600px or larger. Preferred 960 and over. If multiple images are presented, please include the width and height of each with the url.
If your system has access to multiple video files, but only one can be included in the MRSS, then pls provide the highest bitrate, largest resolution H.264 encoded file.
Image mime type - eg "image/jpg" (this can be omitted if all image files will always have a correct file extension, or if images are always provided as a single mime type)
Video URL https://video.server.com/Katy-Perry-baby.mp4 (single video file, not segmented or a player link - 16:9, 5mbps or greater and minimum resolution 1280x720)
Additional videos are ok, If multiple videos are presented, please include the width, height and bitrate of each with the url.
If your system has access to multiple image files, but only one can be included in the MRSS, then pls provide the largest resolution image.
Video mime type - eg "video/mp4" (this can be omitted if all video files will always have a correct file extension, or if videos are always provided as a single mime type)
Preferred, but not required:
Content category - eg "News", "Sport", "entertainment" etc.
If this is not provided then the default of "News" will be applied.
Please provide an exhaustive list of categories that exist for your content so they can be mapped to our categories
Alternatively multiple feeds can be provided for each category (You could provide a sport feed, a news feed etc)
Keywords - If any manual keywording has been done in house then pls provide this as a comma separated list
Additional metadata elements can be included in the feed without any issue. Our systems will simply ignore any elements that are not mapped so they won't create problems if they exist.
Example Item
One example of how this might look in an MRSS is included below - however as mentioned there is no requirement to format your feed exactly like this example. And that as long as it is XML (as an API response might be) we can map that too.
<item>
<title>Katy Perry's Baby News</title>
<link>https://example.com/videos/katy-perrys-baby-news</link>
<description>Katy Perry has confirmed she is pregnant, and said she and fiance Orlando Bloom are "excited and happy" about their baby news.</description>
<guid>2058239585</guid>
<media:content url="https://video.server.com/Katy-Perry-baby-576.mp4" type="video/mp4" width="1024" height="576" bitrate="2000" lang="en"/>
<media:content url="https://video.server.com/Katy-Perry-baby-720.mp4" type="video/mp4" width="1280" height="720" bitrate="3500" lang="en"/>
<media:content url="https://video.server.com/Katy-Perry-baby-1080.mov" type="video/mov" width="1920" height="1080" bitrate="5000" lang="en"/>
<media:thumbnail url="https://image.server.com/1920x1080/Katy-Perry-baby.jpg" type="image/jpg" width="1920" height="1080" />
<media:thumbnail url="https://image.server.com/1280x720/Katy-Perry-baby.png" type="image/png" width="1280" height="720" />
<media:keywords>Katy Perry, baby, Orlando Bloom, pregnant</media:keywords>
<media:category>entertainment</media:category>
<pubDate>Tue, 21 Jul 2020 13:35:44 -0400</pubDate>
<updated>Tue, 21 Jul 2020 13:35:44 -0400</pubDate>
</item>
Example Display
An example image of how that item is displayed to readers when the see the content on a publishers site
