ESS:Media

From ESS
Jump to: navigation, search
Format ESS
Ess-feed-icon.png
.ess, .xml
application/ess+xml
version 0.9

Contents

"media" definition

To present an event, after fundamental description, it is often necessary to define several media files that represent the event. An event's media files are represented in ESS through three element "type" attributes :

EVENT IMAGES

EVENT SOUNDS

EVENT VIDEOS

EVENT WEBSITES

Define event images URLs.

Define event sounds URLs.

Defined event videos URLs.

Defined event website URLs.




ESS structure

ESS documents are composed by various main XML elements. ESS processors must consider each and every element's descriprion as valid and applicable to each and every other XML element within the same ESS document. If it is not the case, it belong to an other feed to describe this event parameter.
Example: every items must be valid and applicable to every and items within the same feed.

XML element (ess:media) is an optionnal structure within ESS Documents, it is not a mandatory ESS XML element.
This section describe the representation of the event with media files. (ess:media) XML element, if it is defined, must be composed by, at least, one (ess:item) XML element.
Several elements can be defined within XML structure to better represent the current event.




Media


Name Description Type Required
type The "type" attribute can take four values: "image", "sound", "video" or "website" to represent each type of media file that can represent the event. ESS Processors should consider that "image" is the default attribute if it is not specified. String TRUE
priority The "priority" attribute refer to the order and the preference to applied to each XML element. ESS processors should consider the natural position as the priority if this attribute is not defined. Number FALSE



Media childs elements


Name Description Type Required
Language-sensitive media file name. Should not be longer then 64 chars String TRUE
Define media file URL in URI taxonomy. The file format, according to type attribute, should be a web readable format: images (jpg, gif, png), sound (wav, mp3, ogg), video (mp4, 3gp, mpg) URI RFC2396 TRUE
This optional XML element contains the specific media file description. Using HTML tags inside this XML element is possible but should be reduced to the minimum because ESS processors could use this information in an environment that can not read HTML. String FALSE



ESS media sample

DTD description http://essfeed.org/history/0.9

 version="1.0" encoding="UTF-8"?>

 xmlns="http://essfeed.org/history/0.9" version="0.9" lang="en">
     ...
     >
 
        
         type="image" priority="1">
           >Main event image>
           >http://example.org/media/images/main_image.jpg>
        >
 
        
         type="sound"  priority="2">
           >Radio spot>
           >http://example.org/media/sounds/radio_spot.mp3>
        >
 
        
         type="video"  priority="3">
           >Youtube video>
           >http://youtube.com/?v=xxxxxxxxxxxx>
        >
 
        
         type="website"  priority="4">
           >Website URL>
           >http://example.com/event/blog?num=123>
        >
 
     >
     ...
  >







External documentation

Ietf logo.png

ESS standard under RFC validation process: RFC ESS Draft

  • RFC 2396 : Uniform Resource Identifiers (URI)
  • RFC 3076 : Canonical XML Version 1.0
  • RFC 3987 : Internationalized Resource Identifiers


IF EVENTS MATTER TO YOU

Spread the news about ESS!
Personal tools
Actions
Standard

 


Developers

 


Communication