<<

NAME

Feed::Parser::NS::Media

DESCRIPTION

"Media RSS" is a new RSS module that supplements the enclosure capabilities of RSS 2.0. RSS enclosures are already being used to syndicate audio files and images. Media RSS extends enclosures to handle other media types, such as short films or TV, as well as provide additional metadata with the media. Media RSS enables content publishers and bloggers to syndicate multimedia content such as TV and video clips, movies, images, and audio.

NAMESPACE

xmlns:media="http://search.yahoo.com/mrss"

ELEMENTS

media:group

media:group is a sub-element of item. It allows grouping of media:content elements that are effectively the same content, yet different representations. For instance: the same song recorded in both the WAV and MP3 format. It's an optional element that must only be used for this purpose.

media:content

media:content is a sub-element of either item or media:group. Media objects that are not the same content should not be included in the same media:group element. The sequence of these items implies the order of presentation. While many of the attributes appear to be audio/video specific, this element can be used to publish any type of media. It contains 10 attributes, most of which are optional.

        <media:content 
               url="http://www.foo.com/movie.mov" 
               fileSize="12216320" 
               type="video/quicktime"
               isDefault="true" 
               expression="full" 
               bitrate="128" 
               framerate="25"
               duration="185" 
               height="200"
               width="300" />

url

should specify the direct url to the media object. If not included, a media:player element must be specified.

fileSize

is the number of bytes of the media object. It is an optional attribute.

type

is the standard MIME type of the object. It is an optional attribute.

isDefault

determines if this is the default object that should be used for the media:group. It is an optional attribute.

expression

determines if the object is a sample or the full version of the object, or even if it is a continuous stream (sample | full | nonstop). It is an optional attribute. Default value is 'full'.

bitrate

is the kilobits per second rate of media. It is an optional attribute.

framerate

is the number of frames per second for video. It is an optional attribute.

duration

is the number of seconds the media plays, for audio and video. It is an optional attribute.

height

is the height of the media object. It is an optional attribute.

width

is the width of the media object. It is an optional attribute.

These optional attributes, along with the optional elements below, contain the primary metadata entries needed to index and organize media content. Additional supported attributes for describing images, audio, and video may be added in future revisions of this document.

Note: While both media:content and media:group have no limitations on the number of times they can appear, the general nature of RSS should be preserved: an item represents a "story". Simply stated, this is similar to the blog style of syndication. However, if one is using this module to strictly publish media, there should be one item element for each media object/group. This is to allow for proper attribution for the origination of the media content through the link element. It also allows the full benefit of the other RSS elements to be realized.

media:adult

Specifies if the content should most likely be viewed only by adults. For example: pornography. Possible values are either 'true' (adult) or 'false' (not adult). If this element is not included, the default is "false". This element requires a certain level of reasonability, which is trusted that the author of the RSS feed understands. If there is any level of doubt, the media objects should be labeled as ADULT. This is a required sub-element if the content is of an adult nature.

Note: If the author of a feed wishes to add a greater level of detail, please note the rating element and the PICS specification.

media:title

The title of the particular media object.

        <media:title>The Judy's - The Moo Song</media:title>

media:thumbnail

Allows a particular image to be used as the representative image for the media object. It has 3 optional attributes.

        <media:thumbnail url="http://www.foo.com/keyframe.jpg" height="50" width="75" />

url specifies the url of the thumbnail. It is a required attribute.

height specifies the height of the thumbnail. It is an optional attribute.

width specifies the width of the thumbnail. It is an optional attribute.

media:category

Allows a taxonomy to be set that gives an indication of the type of media content, and its particular contents. It has 2 optional attributes.

        <media:category scheme="http://search.yahoo.com/mrss/category_schema">
        music/artist/album/song</media:category>

        <media:category scheme="http://dmoz.org" label="Ace Ventura - Pet 
        Detective">Arts/Movies/Titles/A/Ace_Ventura_Series/Ace_Ventura_
        -_Pet_Detective</media:category>

scheme is the URI that identifies the categorization scheme. It is an optional attribute.

label is the human readable label that can be displayed in end user applications. It is an optional attribute.

media:hash

This is the hash of the media file using the MD5 Message-Digest Algorithm. The hash is a 32-character hexadecimal number (lowercase). Future revision of this element will possibly allow for the selection of a specific algorithm, such as SHA1.

        <media:hash>dfdec888b72151965a34b4b59031290a</media:hash>

media:player

Allows the media object to be accessed through a web browser media player console. This element is required only if a direct media url attribute is not specified in the media:content element. It has 1 required attribute, and 2 optional attributes.

        <media:player url="http://www.foo.com/player?id=1111" height="200" width="400" />

url is the url of the player console that plays the media. It is a required attribute.

height is the height of the browser window that the url should be opened in. It is an optional attribute.

width is the width of the browser window that the url should be opened in. It is an optional attribute.

media:credit

Notable entity and the contribution to the creation of the media object. Current entities allowed are people and companies. Future revisions of this document will also extend entities to include places and locations. Specific entities can have multiple roles, and several entices can have the same role. These should appear as distinct media:credit elements. This element has 1 optional attribute.

        <media:credit role="producer">entity name</media:credit>

role specifies the role the individual played. Must be lowercase. It is an optional attribute.

Example roles:

        actor
        anchor person
        author
        choreographer
        composer
        conductor
        director
        editor
        graphic designer     
        grip
        illustrator
        lyricist
        music arranger
        music group
        musician
        orchestra
        performer
        photographer
        producer
        reporter
        vocalist

Additional roles: http://www.ebu.ch/en/technical/metadata/specifications/role_codes.php

media:text

Allows the inclusion of a text transcript, closed captioning, or lyrics of the media content. It has 1 optional attribute.

    <media:text type="plain">Oh, say, can you see, by the dawn's early light,...</media:text>

type specifies the type of text embedded. Possible values are either 'plain' or 'html'.All html must be entity-encoded. A future type of text will allow embedding of time coding information (closed captioning). It is a required attribute.

SEE ALSO

Specified in: http://search.yahoo.com/mrss

COPYRIGHT

<<