API for Media Resources 1.0

1.1 Formats in scope

Refers to the formats in scope of the Ontology for Media Resources 1.0 specification [ MEDIA-ONTOLOGY ]. .

1.2 Formats out of scope

Refers to the Formats out of scope of the Ontology for Media Resources 1.0 specification [ MEDIA-ONTOLOGY ]. .

1.3 Terminology

In this document the terms "Ontology", "Media Resource", "Property", "Mapping" and "Property value types" are to be interpreted as defined in Section 2 of the Ontology for Media Resources 1.0 specification [ MEDIA-ONTOLOGY ]. .

4.1 MediaResource interface

The MediaResource interface is the core of this API and provides operations to access the metadata properties of a specific media resource. Here, a clear separation between asynchronous and synchronous mode of operation has been achieved by defining two implementing interfaces (derived from MediaResource), interfaces, the AsyncMediaResource and the SyncMediaResource interface. Objects of these interfaces will be created by calling createMediaResource of the MediaResource interface. The actual connection to a specified metadata source will be created with the execution of the getMediaProperty operation of AsyncMediaResource or SyncMediaResource interface. The mediaResource argument identifies the media resource, for which the implementation of this API should try to find relevant metadata sources. Optionally, references to metadata sources can be passed using an array of objects, each implementing the MetadataSource interface (see Section 4.6 ).

"idl-def-MediaResource">interface MediaResource {
    
"idlMethType">short         getSupportedModes ();
    
"idlType" href=
"#idl-def-MediaResource">MediaResource createMediaResource (DOMString mediaResource, optional MetadataSource[] metadataSources, optional short mode);
};

ma = new MediaResource();
var mode 
"sh_symbol">= ma.getSupportedModes();

/** Resulting in:
 * { "supportedModes" : 3 }
*/

 */

metadataSources = new MetadataSource[2];
metadataSources[0] = new MetadataSource(
                         
"sh_string">"http://www.w3.org/2008/WebVideo/Annotations/drafts/metadata_formats/DC_example1.xml","dc");
metadataSources[1] = new MetadataSource(
                         
"sh_string">"http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG","exif");

mediaResource 

mediaResource = new MediaResource();

    aSyncObject 
                         
                         metadataSources

if "sh_symbol">(mediaResource.getSupportedModes() == 1 || mediaResource.getSupportedModes() == 3) {
    aSyncObject = mediaResource.createMediaResource(
                         
"sh_string">"http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",
                         metadataSources, 1);

                             
    syncObject 
                         
                         metadataSources
}

} "sh_keyword">else if (mediaResource.getSupportedModes() == 2 || mediaResource.getSupportedModes() == 3)  {
    syncObject = mediaResource.createMediaResource(
                         
"sh_string">"http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",
                         metadataSources, 2);
}

4.2 AsyncMediaResource interface

The AsyncMediaResource interface provides a number of operations that allow accessing the metadata of a media resource. This interface must be implemented. By calling the getMediaProperty operation with the argument "title" we can retrieve the title of the corresponding media resource.

Next, we give the Web IDL description of the AsyncMediaResource interface and describe the different operations that are part of it. The mediaResource argument identifies the media resource, for which the implementation of this API should try to find relevant metadata sources. Optionally, references to metadata sources can be passed using an array of objects, each implementing the MetadataSource interface. This interface holds an URI identifying the metadata source (metadataSource) and the name of the actual metadata format (sourceFormat).

In this section the MediaAnnotations interface is used in the interface definitions. It serves as a container to hold general values about properties enabling an iteration over a set of different properties. Its definition explanation can be found in Section 4.4

"idl-def-AsyncMediaResource">interface AsyncMediaResource : MediaResource {
    
"idlMethType">void getMediaProperty (DOMString[] propertyNames, PropertyCallback successCallback, ErrorCallback errorCallback, optional DOMString fragment, optional DOMString sourceFormat, optional DOMString language);
    
"idlMethType">void getOriginalMetadata (DOMString sourceFormat, MetadataCallback successCallback, ErrorCallback errorCallback);
};

"idl-def-PropertyCallback">interface PropertyCallback {
    
"idlMethType">void handleEvent (MediaAnnotation[] mediaAnnotations);
};

"idl-def-MetadataCallback">interface MetadataCallback {
    
"idlMethType">void handleEvent (DOMString[] metadata);
};

aSyncMediaResource = mediaResource.createMediaResource("http://www.imdb.com/title/tt0133152/", new Array(), 1);
aSyncMediaResource.getMediaProperty(["title"], successCallback, errorCallback, "", "", "");

                                
function "sh_function">successCallback(MediaAnnotation[] mediaAnnotations) {

    ...
}
/** Resulting in:
 * [ { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "Planet of the apes",

 *         "language" : en-us",
 *         ...
 *         "statusCode" : 200
 *         }
 * },
 * { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "Monkey Planet",

 *         "language" : en-us",
 *         ...,
 *         "statusCode" : 200
 *         }
 * },
 * { ...
 * } ]
 */
                
function "sh_function">errorCallback(DOMString error) {

    ...
}
/** Resulting in:
*/

"sh_comment"> * { error: { "statusCode" : 415 } }
 */

aSyncMediaResource = mediaResource.createMediaResource(
                         
"sh_string">"http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",
                          
"sh_keyword">new Array(), 1);
aSyncMediaResource.getOriginalMetadata("dc", successCallback, errorCallback);

function "sh_function">successCallback(DOMString[] metadata) {

    ...
}
/** Resulting in:
 * [ { "statusCode" : 200
 * },
 
 
 

"sh_comment"> * {"originalMetadata" : "<metadata xmlns='http://example.org/myapp/'
 *
"sh_normal">                                        xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
 *
"sh_normal">                                        xsi:schemaLocation='http://example.org/myapp/ http://example.org/myapp/schema.xsd'
 *
"sh_normal">                                        xmlns:dc='http://purl.org/dc/elements/1.1/'>

"sh_comment"> *                                          <dc:title>DC title</dc:title>

"sh_comment"> *                                  </metadata>"

 * } ]
 */
                                                
function "sh_function">errorCallback(DOMString error) {

   ...
}
/** Resulting in:
*/

"sh_comment"> * { error: { "statusCode" : 415 } }
 */

4.3 SyncMediaResource interface

The SyncMediaResource interface provides a number of operations to access the metadata of a media resource. This interface may be implemented. Next, we give the Web IDL description of the SyncMediaResource interface for synchronous requests and describe the different operations that are part of it. The MediaResource defines a constructor that can be called to construct the object based on an identifier of the media resource and optionally some metadata sources. The mediaResource argument identifies the media resource, for which the implementation of this API should try to find relevant metadata sources. Optionally, references to metadata sources can be passed using an array of objects, each implementing the MetadataSource interface. This interface holds two attributes, namely an URI identifying the metadata source ( metadataSource ) and the name of the actual metadata format ( sourceFormat ). An example, how to create this object can be found here .

"idl-def-SyncMediaResource">interface SyncMediaResource : MediaResource {
    
"idlType" href=
"#idl-def-MediaAnnotation">MediaAnnotation[] getMediaProperty (DOMString[] propertyNames, optional DOMString fragment, optional DOMString sourceFormat, optional DOMString language);
    
"idlMethType">DOMString[]       getOriginalMetadata (DOMString sourceFormat);
};

syncMediaResource = mediaResource.createMediaResource("http://www.imdb.com/title/tt0133152/",
                          
"sh_keyword">new Array(), 2);
title = syncMediaResource.getMediaProperty(["title"], "", "", "");

if "sh_symbol">(noErrorStatus(title[0].statusCode) == true) {

   ...
                                                

"sh_cbracket">}                                                

/** Resulting in:
 * [ { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "Planet of the apes",

 *         "language" : en-us",
 *         ...,
 *         "statusCode" : 200
 *         }
 * },
 * { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "Planet der Affen",

 *         "language" : "de-de",
 *         ...,
 *         "statusCode" : 200
 *         }
 * },
 * { ...
 * } ]
*/

 */

syncMediaResource = mediaResource.createMediaResource("http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",
                         
"sh_keyword">new Array(), 2);
dcMetadata = syncMediaResource.getOriginalMetadata("DC");

if "sh_symbol">(noErrorStatus(dcMetadata[0].statusCode) == true) {

    ...
}
/** Resulting in:
 * [ { "statusCode" : 200
 * },
 
 
 

"sh_comment"> * {"originalMetadata" : "<metadata xmlns='http://example.org/myapp/'
 *
"sh_normal">                                        xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
 *
"sh_normal">                                        xsi:schemaLocation='http://example.org/myapp/ http://example.org/myapp/schema.xsd'
 *
"sh_normal">                                        xmlns:dc='http://purl.org/dc/elements/1.1/'>

"sh_comment"> *                                          <dc:title>DC title</dc:title>

"sh_comment"> *                                  </metadata>"

 * } ]
*/

 */

4.4 MediaAnnotation interface

MediaAnnotation interface is used as the return type of MediaResource.getMediaProperty operation. It is a container for holding to hold general values about metadata properties enabling an iteration over a set of different properties. Depending on the requested property, this interface will be enlarged by more specific attributes.

As several metadata properties are defined as complex types, specific derived types of MediaAnnotation have been defined, adding their specific attributes. added these properties with the appropriate types. However, MediaAnnotation can be used as a generic return type to access a printable string representation of the property (in the value attribute). It also includes a status code. In case of general errors, the first element of the returned MediaAnnotation array contains the global error code, otherwise the status can be given for each of the returned properties.

The following design considerations have been used for specifying the derived interfaces types for each of the metadata properties:

• For each metadata property, all properties, an interface is derived from MediaAnnotation , adding typed attributes according to the specification in the ontology document.
• This API must fill value with a printable string representation, it is recommended to follow these steps:
  • use a name/label if present
  • for a URI
    • if a URI identifies a value known by this API, use the appropriate label
    • dereference a URI to obtain a label, if possible
    • return the URI
  • create a string from the values of the set of attributes (e.g. numeric values)
• This approach possibly duplicates in value a string that is found in another attribute in the value attribute. This is considered as an acceptable amount of redundancy for the benefit of having a generic value field for all metadata properties that can be used regardless of the specific metadata property and data type of the attributes.
• If an attribute has type URI|string , the interface shall have two attributes, one with "Link" and one with "Label" appended to the attribute name, representing the URI and string respectively
• For consistency, this approach is also followed if the attribute property has only either URI or string as type. a single attribute.
• This approach allows for user extensions by deriving from MediaAnnotation or one of the derived interfaces for one of the metadata properties.

"idl-def-MediaAnnotation">interface MediaAnnotation {
    attribute 
"idlAttrType">DOMString propertyName;
    attribute 
"idlAttrType">DOMString value;
    attribute 
"idlAttrType">DOMString language;
    attribute 
"idlAttrType">DOMString sourceFormat;
    attribute 
"idlAttrType">DOMString fragmentIdentifier;
    attribute 
"idlAttrType">DOMString mappingType;
    attribute 
"idlAttrType">short     statusCode;
};

mediaAnnotation = image.getMediaProperty(["title"], "", "", "");

                    

if "sh_symbol">(noErrorStatus(mediaAnnotation[0].statusCode) == true) {                    

   ...
}
/** Resulting in:
 * [ { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "Gone with the Wind",

 *         "language" : "en-us",
"sh_comment"> *         "sourceFormat" : "mpeg7",

"sh_comment"> *         "fragmentIdentifier" : "http://www.example.com/video.ogv#t=10,20",

"sh_comment"> *         "mappingType" : "Exact match",

 *         "statusCode" : 200
 *         } 
*
}
]

 * } ]

4.5 Properties

This section describes the different properties that can be requested through the MediaResource.getMediaProperty() operation. When invoking this operation, objects implementing the MediaAnnotation interface are returned that represent the specified property. All properties are represented with an interface inherited from the MediaAnnotation interface (following the design guidelines described above).

Several of the following return type interfaces can hold the value of the property as both URI (i.e., a pointer to a controlled vocabulary) or as free text. The URI is preferred, and the respective attribute of the MediaAnnotation interface (or specialized type) return value shall be filled whenever possible (i.e., when the information is included in or can be constructed from the source metadata).

In the following, for each property, a (synchronous) JavaScript example illustrates the usage of the property specific attributes. In any case, the general genereal attributes of the MediaAnnotation interface could be also requested.

"idl-def-Identifier">interface Identifier : MediaAnnotation {
    attribute 
"idlAttrType">DOMString identifierLink;
};

id = image.getMediaProperty(["identifier"]);

                                     
/** Resulting in:
 * [ { "Identifier" : {
"sh_comment"> *         "propertyName" : "identifier",

"sh_comment"> *         "identifierLink" : "urn:uuid:36a87260-1102-11df-8a39-0800200c9a66",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Title">interface Title : MediaAnnotation {
    attribute 
"idlAttrType">DOMString titleLabel;
    attribute 
"idlAttrType">DOMString typeLink;
    attribute 
"idlAttrType">DOMString typeLabel;
};

title = song.getMediaProperty(["title"]);

                    
/** Resulting in:
 * [ { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "titleLabel" : "Artificial Horizon" ,

"sh_comment"> *         "typeLink" : "http://www.ebu.ch/metadata/cs/ebu_ObjectTypeCodeCS.xml#21",

"sh_comment"> *         "typeLabel" : "Album title",

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Language">interface Language : MediaAnnotation {
    attribute 
"idlAttrType">DOMString languageLink;
    attribute 
"idlAttrType">DOMString languageLabel;
};

language = video.getMediaProperty(["language"]);

        
/** Resulting in:
 * [ { "Language" : {
"sh_comment"> *         "propertyName" : "language",

"sh_comment"> *         "languageLabel" : "en-us",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Locator">interface Locator : MediaAnnotation {
    attribute 
"idlAttrType">DOMString locatorLink;
};

locator = image.getMediaProperty(["locator"]);

/** Resulting in:
 * [ { "Locator" : {
"sh_comment"> *         "propertyName" : "locator",

"sh_comment"> *         "locatorLink" : "http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Contributor">interface Contributor : MediaAnnotation {
    attribute 
"idlAttrType">DOMString contributorLink;
    attribute 
"idlAttrType">DOMString contributorLabel;
    attribute 
"idlAttrType">DOMString roleLink;
    attribute 
"idlAttrType">DOMString roleLabel;
};

contributor = video.getMediaProperty(["contributor"]);

/** Resulting in:
 * [ { "Contributor" : {
"sh_comment"> *         "propertyName" : "contributor",

"sh_comment"> *         "contributorLink" : "http://en.wikipedia.org/wiki/Tim_Burton",

"sh_comment"> *         "contributorLabel" : "Tim Burton",

"sh_comment"> *         "roleLink" : "http://www.imdb.com/name/nm0000318/",

"sh_comment"> *         "roleLabel" : "director",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Creator">interface Creator : MediaAnnotation {
    attribute 
"idlAttrType">DOMString creatorLink;
    attribute 
"idlAttrType">DOMString creatorLabel;
    attribute 
"idlAttrType">DOMString roleLink;
    attribute 
"idlAttrType">DOMString roleLabel;
};

creator = video.getMediaProperty(["creator"]);

/** Resulting in:
 * [ { "Creator" : {
"sh_comment"> *         "propertyName" : "creator",

"sh_comment"> *         "creatorLink" : "http://dbpedia.org/resource/William_Shakespeare",

"sh_comment"> *         "creatorLabel" : "William Shakespeare",

"sh_comment"> *         "roleLink" : "http://www.ebu.ch/metadata/cs/ebu_RoleCodeCS.xml#22.5",

"sh_comment"> *         "roleLabel" : "playwright",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-MADate">interface MADate : MediaAnnotation {
    attribute 
"idlAttrType">DOMString date;
    attribute 
"idlAttrType">DOMString typeLink;
    attribute 
"idlAttrType">DOMString typeLabel;
};

maDate = video.getMediaProperty(["date"]);

/** Resulting in:
 * [ { "MADate" : {
 *         "propertyName" : "date",
"sh_comment"> *         "date": "2009-06-26T15:30:00",

"sh_comment"> *         "typeLink" : "urn:smpte:ul:06.0E.2B.34.01.01.01.02.07.02.01.10.02.03.00.00",

"sh_comment"> *         "typeLabel" : "modification date",

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Location">interface Location : MediaAnnotation {
    attribute 
"idlAttrType">DOMString locationLink;
    attribute 
"idlAttrType">DOMString locationLabel;
    attribute 
"idlAttrType">double    longitude;
    attribute 
"idlAttrType">double    latitude;
    attribute 
"idlAttrType">double    altitude;
    attribute 
"idlAttrType">DOMString coordinateSystemLabel;
    attribute 
"idlAttrType">DOMString coordinateSystemLink;
};

location = video.getMediaProperty(["location"]);

/** Resulting in:
 * [ { "Location" : {
"sh_comment"> *         "propertyName" : "location",

"sh_comment"> *         "locationLink" : "http://en.wikipedia.org/wiki/San_Jose,_California",

"sh_comment"> *         "locationLabel" : "San Jose",

"sh_comment"> *         "longitude" : 37.33986481118008,

"sh_comment"> *         "latitude" : -121.88507080078125,

 *         "altitude" : 0,
"sh_comment"> *         "coordinateSystemLabel" : "WGS84",

"sh_comment"> *         "coordinateSystemLink" : "http://www.w3.org/2003/01/geo/wgs84_pos#Point",

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Description">interface Description : MediaAnnotation {
    attribute 
"idlAttrType">DOMString descriptionLabel;
};

description = image.getMediaProperty(["description"]);

/** Resulting in:
 * [ { "Description" : {
"sh_comment"> *         "propertyName" : "description",

"sh_comment"> *         "descriptionLabel" : "Group picture of the W3C MAWG at the F2F meeting in Stockholm.",

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Keyword">interface Keyword : MediaAnnotation {
    attribute 
"idlAttrType">DOMString keywordLabel;
    attribute 
"idlAttrType">DOMString keywordLink;
};

keyword = image.getMediaProperty(["keyword"]);

/** Resulting in:
 * [ { "Keyword" : {
"sh_comment"> *         "propertyName" : "keyword",

"sh_comment"> *         "keywordLabel" : "meeting with people from outside the organisation",

"sh_comment"> *         "keywordLink" : "http://sw.opencyc.org/2008/06/10/concept/en/MeetingWithOrganizationalOutsiders",                    

 *         "statusCode" : 200
 *         }
 * }, 
 * { "Keyword" : {
"sh_comment"> *         "propertyName" : "keyword",

"sh_comment"> *         "keywordLabel" : "standardisation",

"sh_comment"> *         "keywordLink" : "http://purl.org/vocabularies/princeton/wn30/synset-standardization-noun-1",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Genre">interface Genre : MediaAnnotation {
    attribute 
"idlAttrType">DOMString genreLabel;
    attribute 
"idlAttrType">DOMString genreLink;
};

genre = image.getMediaProperty(["genre"]);

/** Resulting in:
 * [ { "Genre" : {
"sh_comment"> *         "propertyName" : "genre",

 *         "genreLabel" : "Sports",
"sh_comment"> *         "genreLink" : "http://www.ebu.ch/metadata/cs/ebu_ContentGenreCS.xml#3.1.1.9"                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Rating">interface Rating : MediaAnnotation {
    attribute 
"idlAttrType">double    ratingValue;
    attribute 
"idlAttrType">DOMString ratingSystemLabel;
    attribute 
"idlAttrType">DOMString ratingSystemLink;
    attribute 
"idlAttrType">double    minimum;
    attribute 
"idlAttrType">double    maximum;
};

rating = image.getMediaProperty(["rating"]);

/** Resulting in:
 * [ { "Rating" : {
"sh_comment"> *         "propertyName" : "rating",

 *         "ratingValue" : 10.0,
"sh_comment"> *         "ratingSystemLabel" : "John Doe",

"sh_comment"> *         "ratingSystemLink" : "http://individuals.example.com/JohnDoe",

 *         "minimum" : 0,
"sh_comment"> *         "maximum" : 10.0,                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Relation">interface Relation : MediaAnnotation {
    attribute 
"idlAttrType">DOMString targetLink;
    attribute 
"idlAttrType">DOMString targetLabel;
    attribute 
"idlAttrType">DOMString typeLink;
    attribute 
"idlAttrType">DOMString typeLabel;
};

relation = image.getMediaProperty(["relation"]);

/** Resulting in:
 * [ { "Relation" : {
"sh_comment"> *         "propertyName" : "relation",

"sh_comment"> *         "targetLink" : "http://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626_thumb.JPG",

"sh_comment"> *         "targetLabel" : "Group picture of MAWG in Stockholm",

"sh_comment"> *         "typeLink" : "http://www.ebu.ch/metadata/cs/ebu_HowRelatedCS.xml#19",

"sh_comment"> *         "typeLabel" : "thumbnail",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Collection">interface Collection : MediaAnnotation {
    attribute 
"idlAttrType">DOMString collectionLink;
    attribute 
"idlAttrType">DOMString collectionLabel;
};

collection = image.getMediaProperty(["collection"]);

/** Resulting in:
 * [ { "Collection" : {
"sh_comment"> *         "propertyName" : "collection",

"sh_comment"> *         "collectionLink" : "http://individuals.example.com/JohnDoe/myWorkPictures/",

"sh_comment"> *         "collectionLabel" : "My Work Pictures",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Copyright">interface Copyright : MediaAnnotation {
    attribute 
"idlAttrType">DOMString copyrightLabel;
    attribute 
"idlAttrType">DOMString holderLabel;
    attribute 
"idlAttrType">DOMString holderLink;
};

copyright = image.getMediaProperty(["copyright"]);

/** Resulting in:
 * [ { "Copyright" : {
"sh_comment"> *         "propertyName" : "copyright",

"sh_comment"> *         "copyrightLabel" : "All images in the collection are copyrighted by John Doe.",

"sh_comment"> *         "holderLabel" : "John Doe",

"sh_comment"> *         "holderLink" : "http://individuals.example.com/JohnDoe",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Policy">interface Policy : MediaAnnotation {
    attribute 
"idlAttrType">DOMString statementLink;
    attribute 
"idlAttrType">DOMString statementLabel;
    attribute 
"idlAttrType">DOMString typeLink;
    attribute 
"idlAttrType">DOMString typeLabel;
};

policy = image.getMediaProperty(["policy"]);

/** Resulting in:
 * [ { "Policy" : {
"sh_comment"> *         "propertyName" : "policy",

"sh_comment"> *         "statementLink" : "http://creativecommons.org/licenses/by/2.5/",

"sh_comment"> *         "statementLabel" : "Attribution 2.5 Generic (CC BY 2.5)",

"sh_comment"> *         "typeLabel" : "license",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Publisher">interface Publisher : MediaAnnotation {
    attribute 
"idlAttrType">DOMString publisherLink;
    attribute 
"idlAttrType">DOMString publisherLabel;
};

publisher = image.getMediaProperty(["publisher"]);

/** Resulting in:
 * [ { "Publisher" : {
"sh_comment"> *         "propertyName" : "publisher",

"sh_comment"> *         "publisherLabel" : "ACME",

"sh_comment"> *         "publisherLink" : "http://company.example.com/ACME",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-TargetAudience">interface TargetAudience : MediaAnnotation {
    attribute 
"idlAttrType">DOMString audienceLink;
    attribute 
"idlAttrType">DOMString audienceLabel;
    attribute 
"idlAttrType">DOMString classificationSystemLink;
    attribute 
"idlAttrType">DOMString classificationSystemLabel;
};

targetAudience = image.getMediaProperty(["targetAudience"]);

/** Resulting in:
 * [ { "TargetAudience" : {
"sh_comment"> *         "propertyName" : "targetAudience",

"sh_comment"> *         "audienceLink" : "http://www.mpaa.org/ratings/what-each-rating-means#NC-17",

"sh_comment"> *         "audienceLabel" : "No One 17 and Under Admitted",

"sh_comment"> *         "classificationSystemLink" : "http://www.mpaa.org/ratings",

"sh_comment"> *         "classificationSystemLabel" : "MPAA",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-Fragment">interface Fragment : MediaAnnotation {
    attribute 
"idlAttrType">DOMString identifier;
    attribute 
"idlAttrType">DOMString roleLink;
    attribute 
"idlAttrType">DOMString roleLabel;
};

fragment = movie.getMediaProperty(["fragment"]);

/** Resulting in:
 * [ { "Fragment" : {
"sh_comment"> *         "propertyName" : "fragment",

"sh_comment"> *         "identifier" : "http://www.example.com/video.ogv#t=10,20",

"sh_comment"> *         "roleLabel" : "chapter",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-NamedFragment">interface NamedFragment : MediaAnnotation {
    attribute 
"idlAttrType">DOMString identifier;
    attribute 
"idlAttrType">DOMString label;
};

namedFragment = movie.getMediaProperty(["namedFragment"]);

/** Resulting in:
 * [ { "NamedFragment" : {
"sh_comment"> *         "propertyName" : "namedFragment",

"sh_comment"> *         "identifier" : "http://www.example.com/video.ogv#t=30,35",

 *         "label" : "kissScene",
 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-FrameSize">interface FrameSize : MediaAnnotation {
    attribute 
"idlAttrType">double    width;
    attribute 
"idlAttrType">double    height;
    attribute 
"idlAttrType">DOMString unit;
};

frameSize = image.getMediaProperty(["frameSize"]);

/** Resulting in:
 * [ { "FrameSize" : {
"sh_comment"> *         "propertyName" : "framesize",

 *         "width" : 3072,
 *         "height" : 2304,
"sh_comment"> *         "unit" : "pixels",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-FrameSize2">interface FrameSize : MediaAnnotation {
    attribute 
"idlAttrType">DOMString compressionLink;
    attribute 
"idlAttrType">DOMString compressionLabel;
};

compression = video.getMediaProperty(["compression"]);

/** Resulting in:
 * [ { "Compression" : {
"sh_comment"> *         "propertyName" : "compression",

"sh_comment"> *         "compressionLabel" : "H.264/AVC",

"sh_comment"> *         "compressionLink" : "urn:example-org:codingnames2010#ITU-H264",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Duration">interface Duration : MediaAnnotation {
    attribute 
"idlAttrType">double duration;
};

duration = video.getMediaProperty(["duration"]);

                    
/** Resulting in:
 * [ { "Duration" : {
"sh_comment"> *         "propertyName" : "duration",

"sh_comment"> *         "duration" : 3600,                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-Format">interface Format : MediaAnnotation {
    attribute 
"idlAttrType">DOMString formatLink;
    attribute 
"idlAttrType">DOMString formatLabel;
};

format = image.getMediaProperty(["format"]);

/** Resulting in:
 * [ { "Format" : {
"sh_comment"> *         "propertyName" : "format",

"sh_comment"> *         "formatLabel" : "image/jpeg",

"sh_comment"> *         "formatLink" : "http://dbpedia.org/resource/JPEG",                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-SamplingRate">interface SamplingRate : MediaAnnotation {
    attribute 
"idlAttrType">double samplingRate;
};

samplingrate = audio.getMediaProperty(["samplingRate"]);

/** Resulting in:
 * [ { "SamplingRate" : {
"sh_comment"> *         "propertyName" : "samplingRate",

"sh_comment"> *         "samplingRate" : 44100,                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-FrameRate">interface FrameRate : MediaAnnotation {
    attribute 
"idlAttrType">double frameRate;
};

framerate = video.getMediaProperty(["frameRate"]);

/** Resulting in:
 * [ { "FrameRate" : {
"sh_comment"> *         "propertyName" : "frameRate",

"sh_comment"> *         "frameRate" : 30,                    

 *         "statusCode" : 200
 *         } 
 * } ]
*/

 */

"idl-def-AverageBitRate">interface AverageBitRate : MediaAnnotation {
    attribute 
"idlAttrType">double averageBitRate;
};

bitrate = video.getMediaProperty(["averageBitRate"]);

/** Resulting in:
 * [ { "AverageBitRate" : {
"sh_comment"> *         "propertyName" : "averageBitRate",

"sh_comment"> *         "averageBitRate" : 45.06,                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

"idl-def-NumTracks">interface NumTracks : MediaAnnotation {
    attribute 
"idlAttrType">short     number;
    attribute 
"idlAttrType">DOMString typeString;
};

numTracks = video.getMediaProperty(["numTracks"]);

/** Resulting in:
 * [ { "NumTracks" : {
"sh_comment"> *         "propertyName" : "numTracks",

 *         "number" : 2,
"sh_comment"> *         "typeString" : "audio",                    

 *         "statusCode" : 200
 *         }
 * } ]
*/

 */

4.6 MetadataSource interface

MetadataSource interface is used to identify other metadata sources.

"idl-def-MetadataSource">interface MetadataSource {
    attribute 
"idlAttrType">DOMString metadataSource;
    attribute 
"idlAttrType">DOMString sourceFormat;
};

metadataSource
=
new
MetadataSource
(
"http://www.w3.org/2008/WebVideo/Annotations/drafts/metadata_formats/DC_example1.xml"
,
"dc"
);

metadataSources = new MetadataSource("http://www.w3.org/2008/WebVideo/Annotations/drafts/metadata_formats/DC_example1.xml","dc");

4.7 API Status Codes

This section introduces a set of status codes for the defined API to indicate the system behavior. As described in section 4.4 , the status code is returned as one of the attributes of the MediaAnnotation object returned by a method call to the API. These status codes are used on the API level, and applied to either client side or server side implementations.

Later versions of this document may include additional status codes.

5.1 Usage as JavaScript API

This part illustrates some examples how to use this API using JavaScript in actual implementations. Moreover, in these examples it is assumed that the implementation of this API knows where to find the metadata that corresponds to a specific media resource (if necessary the location of the metadata can be configured by the use of the MetadataSource interface). The implementation should provide the mappings of different metadata formats to the core properties of the Ontology for Media Resources 1.0 specification [ MEDIA-ONTOLOGY ]). specification.

Example 1: Return the name of the director of the movie "Apocalypse now".

"sh_comment">//search the video array for the one with title "Apocalypse now" 
for 
"sh_symbol">(var i = 0; i < mediaResourceVideoArray.length; i++) { 

    
    
    titles  

    "sh_comment">//request for the titles of the video, the variable "titles"
    
"sh_comment">//will be filled with an array of MediaAnnotation objects. 
    titles = mediaResourceVideoArray[i].getMediaProperty(["title"], "", "", ""); 

    
    
    

    "sh_comment">//check if the request is finished correctly
    if 
"sh_symbol">(noErrorStatus(titles[0].statusCode) == true) {

         

        for "sh_symbol">(var j = 0; j < titles.length; j++) { 

            
            

            "sh_comment">//check if the title matches 
            if 
"sh_symbol">(titles[j].titleLabel == "Apocalypse Now") {

                
                
                tempResults 

                "sh_comment">//request for the director of the video, the variable "results" 
                
"sh_comment">//will be filled with an array of MediaAnnotation objects. 
                tempResults = mediaResourceVideoArray[i].getMediaProperty(["contributor"], "", "", "");

                
                    
                        result 
                        

                for "sh_symbol">(var k = 0; k < tempResults.length; k++) {
                    if 
"sh_symbol">(tempResults[i].roleLabel == "director") {
                        result = tempResults[i];
                        
"sh_keyword">break;

                    }
                }  
            } 
        } 
    }
}
/** Resulting in:
 * [ { "Contributor" : {
"sh_comment"> *         "propertyName" : "contributor",

"sh_comment"> *         "value" : "Francis Ford Coppola",

 *         ...,                    
 *         "statusCode" = 200
 *         }
 * } ]
*/

 */ 

Example 2: Retrieve the title of the second song from the album "Joshua Tree" by U2.

tracks trackIdentifier

"sh_comment">//get the id of the second song using the fragments property 
tracks = albumMediaResource.getMediaProperty(["fragment"], "", "", "");
trackIdentifier = tracks[1].identifier; 

mediaResource  
    syncMediaResource 

"sh_comment">//use this identifier to get the mediaResource object that represents the track 
mediaResource = new MediaResource(); 
if 
"sh_symbol">(mediaResource.getSupportedModes() == 2 || mediaResource.getSupportedModes() == 3) {
    syncMediaResource = mediaResource.createMediaResource(trackIdentifier, new Array(), 2);

}
//get the title of the track 
title 

title = syncMediaResource.getMediaProperty(["title"], "", "", "");

/** Resulting in:
 * [ { "Title" : {
"sh_comment"> *         "propertyName" : "title",

"sh_comment"> *         "value" : "I Still Haven't Found What I'm Looking For",

 *         ...,                    
"sh_comment"> *         "statusCode" = 200          

 *         } 
 * } ]
*/

 */

Example 3: Return the genre of the movie "Apocalypse Now".

genre = movie.getMediaProperty(["genre"], "", "", "en-us"); 

/** Resulting in: 
 * [ { "Genre" : {
"sh_comment"> *         "propertyName" : "genre",

 *         "value" : "Action",
 *         ...,                    
 *         "statusCode" = 200
 *         }
 * },
 * { "Genre" : {
"sh_comment"> *         "propertyName" : "genre",

 *         "value" : "Drama",
 *         ...,                    
 *         "statusCode" = 200
 *         }
 * },
 * { ...
 *  } ]
*/

 */

5.2 Usage as Web Service

This part illustrates how this API could be implemented using web services. Note that that, Web IDL currently does not provide bindings for web services. The given examples correspond to the examples given in Section 4.5 for each property.

• Request: http://example.com/my-media-resource/?getOriginalMetadata=DC

  • Response (JSON format):

    ]

    [ "sh_cbracket">{ "statusCode" : "200" },
      {
    "sh_string">"originalMetadata" : "<?xml version='1.0'?><metadata
    
    "sh_string">                         xmlns='http://example.org/myapp/' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    
    "sh_string">                         xsi:schemaLocation='http://example.org/myapp/ http://example.org/myapp/schema.xsd'
    
    "sh_string">                         xmlns:dc='http://purl.org/dc/elements/1.1/'><dc:title>DC title</dc:title></metadata>"}
    ]
    

The following examples illustrate how to request values for the different properties.

• Request: http://example.com/my-media-resource/?ma-query=identifier

  • Response (JSON format):

    [ "sh_cbracket">{ "Identifier" : {
            "propertyName" 
    "sh_symbol">: "identifier",
            
    "sh_string">"identifierLink" : "urn:uuid:36a87260-1102-11df-8a39-0800200c9a66",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=title

  • Response (JSON format):

    [ "sh_cbracket">{ "Title" : {
            "propertyName" 
    "sh_symbol">: "title",
            "value" 
    "sh_symbol">: "Artificial Horizon",
            "typeLink" 
    "sh_symbol">: "http://www.ebu.ch/metadata/cs/ebu_ObjectTypeCodeCS.xml#21",
            "typeLabel" 
    "sh_symbol">: "Album title",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=language

  • Response (JSON format):

    [ "sh_cbracket">{ "Language" : {
            "propertyName" 
    "sh_symbol">: "language",
            "languageLabel" 
    "sh_symbol">: "en-us",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=locator

  • Response (JSON format):

    [ "sh_cbracket">{ "Locator" : {
            "propertyName" 
    "sh_symbol">: "locator",
            "locatorLink" 
    "sh_symbol">: "http://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=contributor

  • Response (JSON format):

    [ "sh_cbracket">{ "Contributor" : {
            "propertyName" 
    "sh_symbol">: "contributor",
            
    "sh_string">"contributorLink" : "http://en.wikipedia.org/wiki/Tim_Burton",
            
    "sh_string">"contributorLabel" : "Tim Burton",
            "roleLink" 
    "sh_symbol">: "http://www.imdb.com/name/nm0000318/",
            "roleLabel" 
    "sh_symbol">: "director",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=creator

  • Response (JSON format):

    [ "sh_cbracket">{ "Creator" : {
            "propertyName" 
    "sh_symbol">: "creator",
            "creatorLink" 
    "sh_symbol">: "http://dbpedia.org/resource/William_Shakespeare",
            "creatorLabel" 
    "sh_symbol">: "William Shakespeare",
            "roleLink" 
    "sh_symbol">: "http://www.ebu.ch/metadata/cs/ebu_RoleCodeCS.xml#22.5",
            "roleLabel" 
    "sh_symbol">: "playwright",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=date

  • Response (JSON format):

    [ "sh_cbracket">{ "MADate" : {
            "propertyName" 
    "sh_symbol">: "date",
            "date"
    "sh_symbol">: "2009-06-26T15:30:00",
            "typeLink" 
    "sh_symbol">: "urn:smpte:ul:06.0E.2B.34.01.01.01.02.07.02.01.10.02.03.00.00",
            "typeLabel" 
    "sh_symbol">: "modification date",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=location

  • Response (JSON format):

    [ "sh_cbracket">{ "Location" : {
            "propertyName" 
    "sh_symbol">: "location",
            "locationLink" 
    "sh_symbol">: "http://en.wikipedia.org/wiki/San_Jose,_California",
            "locationLabel" 
    "sh_symbol">: "San Jose",
            "longitude" 
    "sh_symbol">: 37.33986481118008,
            "latitude" 
    "sh_symbol">: -121.88507080078125,
            "altitude" 
    "sh_symbol">: 0,
            
    "sh_string">"coordinateSystemLabel" : "WGS84",
            
    "sh_string">"coordinateSystemLink" : "http://www.w3.org/2003/01/geo/wgs84_pos#Point",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=description

  • Response (JSON format):

    [ "sh_cbracket">{ "Description" : {
            "propertyName" 
    "sh_symbol">: "description",
            
    "sh_string">"descriptionLabel" : "Group picture of the W3C MAWG at the F2F meeting in Stockholm.",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=keyword

  • Response (JSON format):

    [ "sh_cbracket">{ "Keyword" : {
            "propertyName" 
    "sh_symbol">: "keyword",
            "keywordLabel" 
    "sh_symbol">: "meeting with people from outside the organisation",
            "keywordLink" 
    "sh_symbol">: "http://sw.opencyc.org/2008/06/10/concept/en/MeetingWithOrganizationalOutsiders",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    },
            
            
            
            
    
    { "sh_string">"Keyword" : {
            "propertyName" 
    "sh_symbol">: "keyword",
            "keywordLabel" 
    "sh_symbol">: "standardisation",
            "keywordLink" 
    "sh_symbol">: "http://purl.org/vocabularies/princeton/wn30/synset-standardization-noun-1",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=genre

  • Response (JSON format):

    [ "sh_cbracket">{ "Genre" : {
            "propertyName" 
    "sh_symbol">: "genre",
            "genreLabel" 
    "sh_symbol">: "Sports",
            "genreLink" 
    "sh_symbol">: "http://www.ebu.ch/metadata/cs/ebu_ContentGenreCS.xml#3.1.1.9",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=rating

  • Response (JSON format):

    [ "sh_cbracket">{ "Rating" : {
            "propertyName" 
    "sh_symbol">: "rating",
            "ratingValue" 
    "sh_symbol">: 10.0,
            
    "sh_string">"ratingSystemLabel" : "John Doe",
            
    "sh_string">"ratingSystemLink" : "http://individuals.example.com/JohnDoe",
            "minimum" 
    "sh_symbol">: 0,
            "maximum" 
    "sh_symbol">: 10.0,
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=relation

  • Response (JSON format):

    [ "sh_cbracket">{ "Relation" : {
            "propertyName" 
    "sh_symbol">: "relation",
            "targetLink" 
    "sh_symbol">: "http://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626_thumb.JPG",
            "targetLabel" 
    "sh_symbol">: "Group picture of MAWG in Stockholm",
            "typeLink" 
    "sh_symbol">: "http://www.ebu.ch/metadata/cs/ebu_HowRelatedCS.xml#19",
            "typeLabel" 
    "sh_symbol">: "thumbnail",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=collection

  • Response (JSON format):

    [ "sh_cbracket">{ "Collection" : {
            "propertyName" 
    "sh_symbol">: "collection",
            
    "sh_string">"collectionLink" : "http://individuals.example.com/JohnDoe/myWorkPictures/",
            
    "sh_string">"collectionLabel" : "My Work Pictures",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=copyright

  • Response (JSON format):

    [ "sh_cbracket">{ "Copyright" : {
            "propertyName" 
    "sh_symbol">: "copyright",
            
    "sh_string">"copyrightLabel" : "All images in the collection are copyrighted by John Doe.",
            "holderLabel" 
    "sh_symbol">: "John Doe",
            "holderLink" 
    "sh_symbol">: "http://individuals.example.com/JohnDoe",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=policy

  • Response (JSON format):

    [ "sh_cbracket">{ "Policy" : {
            "propertyName" 
    "sh_symbol">: "policy",
            "statementLink" 
    "sh_symbol">: "http://creativecommons.org/licenses/by/2.5/",
            
    "sh_string">"statementLabel" : "Attribution 2.5 Generic (CC BY 2.5)",
            "typeLabel" 
    "sh_symbol">: "license",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=publisher

  • Response (JSON format):

    [ "sh_cbracket">{ "Publisher" : {
            "propertyName" 
    "sh_symbol">: "publisher",
            
    "sh_string">"publisherLabel" : "ACME",
            "publisherLink" 
    "sh_symbol">: "http://company.example.com/ACME",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=targetAudience

  • Response (JSON format):

    [ "sh_cbracket">{ "TargetAudience" : {
            "propertyName" 
    "sh_symbol">: "targetAudience",
            "audienceLink" 
    "sh_symbol">: "http://www.mpaa.org/ratings/what-each-rating-means#NC-17",
            "audienceLabel" 
    "sh_symbol">: "No One 17 and Under Admitted",
            
    "sh_string">"classificationSystemLink" : "http://www.mpaa.org/ratings",
            
    "sh_string">"classificationSystemLabel" : "MPAA",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=fragment

  • Response (JSON format):

    [ "sh_cbracket">{ "Fragment" : {
            "propertyName" 
    "sh_symbol">: "fragment",
            "identifier" 
    "sh_symbol">: "http://www.example.com/video.ogv#t=10,20",
            "roleLabel" 
    "sh_symbol">: "chapter",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=namedFragment

  • Response (JSON format):

    [ "sh_cbracket">{ "NamedFragment" : {
            "propertyName" 
    "sh_symbol">: "namedFragment",
            "label" 
    "sh_symbol">: "kissScene",
            "identifier" 
    "sh_symbol">: "http://www.example.com/video.ogv#t=30,35",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=frameSize

  • Response (JSON format):

    [ "sh_cbracket">{ "FrameSize" : {
            "propertyName" 
    "sh_symbol">: "framesize",
            "width" 
    "sh_symbol">: 3072,
            "height" 
    "sh_symbol">: 2304,
            "unit" 
    "sh_symbol">: "pixels",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=compression

  • Response (JSON format):

    [ "sh_cbracket">{ "Compression" : {
            "propertyName" 
    "sh_symbol">: "compression",
            
    "sh_string">"compressionLabel" : "H.264/AVC",
            
    "sh_string">"urn:example-org:codingnames2010#ITU-H264",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=duration

  • Response (JSON format):

    [ "sh_cbracket">{ "Duration" : {
            "propertyName" 
    "sh_symbol">: "duration",
            "duration" 
    "sh_symbol">: 3600,
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=format

  • Response (JSON format):

    [ "sh_cbracket">{ "Format" : {
            "propertyName" 
    "sh_symbol">: "format",
            "formatLabel" 
    "sh_symbol">: "image/jpeg",
            "formatLink" 
    "sh_symbol">: "http://dbpedia.org/resource/JPEG",
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=samplingRate

  • Response (JSON format):

    [ "sh_cbracket">{ "SamplingRate" : {
            "propertyName" 
    "sh_symbol">: "samplingRate",
            "samplingRate" 
    "sh_symbol">: 44100,
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=frameRate

  • Response (JSON format):

    [ "sh_cbracket">{ "FrameRate" : {
            "propertyName" 
    "sh_symbol">: "frameRate",
            "frameRate" 
    "sh_symbol">: 30,
            "statusCode" 
    "sh_symbol">: 200
    
            }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=averageBitRate

  • Response (JSON format):

    [ "sh_cbracket">{ "AverageBitRate" : {
             "propertyName" 
    "sh_symbol">: "averageBitRate",
             
    "sh_string">"averageBitRate" : 45.06,
             "statusCode" 
    "sh_symbol">: 200
    
             }
    }
    ]
    
    } ]
    

• Request: http://example.com/my-media-resource/?ma-query=numTracks

  • Response (JSON format):

    [ "sh_cbracket">{ "NumTracks" : {
             "propertyName" 
    "sh_symbol">: "numTracks",
             "number" 
    "sh_symbol">: 2,
             "typeString" 
    "sh_symbol">: "audio",
             "statusCode" 
    "sh_symbol">: 200
    
             }
    }
    ]
    
    } ]