API for Media Resource 1.0

The identifier property identifies a resource.

An array of object elements implementing the StringObject interface. The value attribute should represent a URI identifying the resource, the type attribute holds the type of the identifier, which can be filtered on in the getProperty operation. Possible values are " UMID" and "ISAN".

interface Identifier: MAObject {
			attribute DOMString value;
        		attribute DOMString type;
	        	};
        					

["https://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626.JPG"]

The title property defines the title of the document, or the name given to the resource.

An array of object elements implementing the Title interface. The value attribute should hold the title as a plain string. Additionally, a type describes the type of the title, which can be filtered on in the getProperty operation. Possibilities for this are "Album title" and "Song title".

interface Title: MAObject, Language {
			attribute DOMString value;
			attribute DOMString type;
		};
					

["MAWG Stockholm 20090626",""]

The language property specifies a language used in the entity, Recommended best practice is to use BCP 47 [BCP 47].

An array of object elements implementing the StringObject interface. The value attribute should represent the language as a plain string.

interface StringObject: MAObject {
			attribute DOMString value;
		};
					

["en-us"]

The locator property holds a URI at which the entity can be accessed (e.g. a URL, or a DVB URI).

An array of object elements implementing the StringObject interface. The value attribute should hold the URI.

interface StringObject: MAObject {
			attribute DOMString value;
		};
					

["https://www.w3.org/2008/WebVideo/Annotations/wiki/images/9/93/MAWG-Stockholm-20090626.JPG"]

The contributor property holds a pair identifying the contributors and the nature of the contribution. E.g. actor, cameraman, director, singer, author, artist (Note: subject see addition of contributors type) identifies a resource.

An array of object elements implementing the Contributor interface. This object has an attribute id which identifies the contributor. Additionally, the role attribute defines the role, which can be filtered on in the getProperty operation. For the latter a number of suggested terms are defined:

• editor (EBU 11.1)

• actor (EBU 25.9)

• composer

• featured_in

• cinematographer

• director

• musicproducer

• producer

• screenplayer

• writer

• distributor (company)

• production company

interface Contributor: MAObject {
			attribute DOMString id;
			attribute DOMString role;
		};
				  

["https://individuals.example.com/Contributor1", "editor"], ["https://individuals.example.com/Contributor2", "producer"]

The creator property holds the authors of the resource (listed in order of precedence, if significant).

An array of object elements implementing the StringObject interface. The value attribute should hold an identifier for an author.

interface StringObject: MAObject {
			attribute DOMString value;
		};
					

["https://individuals.example.com/Author1", "https://individuals.example.com/Author2"]

The createDate property holds the date and time the entity was originally created. (for commercial purpose there might be an annotation of publication date).

An array of object elements implementing the Date interface. The exact format of the date attribute is currently undefined. It should hold a type attribute defining the specific type of creation, which can be filtered on in the getProperty operation. Possibilities are "Create Date" and "Publish Date".

interface Date: MAObject {
			attribute DOMString date;
			attribute DOMString type;
		};				  
				  

[2009-06-26T15:30:00]

The location property holds the location where the resource has been shot/recorded.

An array of object elements implementing the Location interface. The name attribute holds a free text name of the location. The longitude, latitude, and altitude determin the spatial coordinates according to the system defined in system.

interface Location: MAObject, Language {
			attribute DOMString name;
			attribute Float longitude;
			attribute Float latitude;
			attribute Float altitude;
			attribute DOMString system;
		};
				  

["San Jose", 37.33986481118008, -121.88507080078125, 0, "GPS"]

The description property holds a textual description of the content of the resource.

An array of object elements implementing the StringObject interface. The value attribute should hold a description of the content of the media resource.

interface StringObject: MAObject, Language {
			attribute DOMString value;
		};
					

["Group picture of the W3C Media Annotations WG at the face-to-face meeting in Stockholm."]

The keyword property represents a keyword that specifies the topic of the content of the resource.

An array of object elements implementing the StringObject interface. The value attribute should hold one keyword.

interface StringObject: MAObject, Language {
			attribute DOMString value;
		};
					

["W3C Media Annotations WG", "meeting", "group picture"]

The genre property describes the genre of the entity.

An array of object elements implementing the StringObject interface. The value attribute should represent the genre of the media resource.

interface StringObject: MAObject, Language {
			attribute DOMString value;
		};
					

["Work"]

The rating property holds information to identify the rating person or organization and the rating (real value). Additionally, a minimum and maximum value can be given. Lastly, information on the context of the rating is also included.

An array of object elements implementing the Rating interface. This object holds an attribute issuer to identify the rating person or organization. Next, the rating value can be represented, together with the minimum and maximum rating values. These allow to interpret the rating value. Lastly, a textual description of the context can be given. A type attribute determines the type of the rating, which can be filtered on in the getProperty operation. Possibilities are "Review Rating", "MPAA", "Personal Rating"

interface Rating: MAObject, Language {
	        		attribute DOMString issuer;
			attribute short value;
			attribute short minimum;
			attribute short maximum;
			attribute DOMString type;
		};
				  

["https://individuals.example.com/ChrisPoppe", 10.0, 0, 10.0, "Personal Rating"]

The relation property holds pairs identifying the entities and the nature of the realtionships. E.g. transcript, original_work.

An array of object elements implementing the Relation interface. This object holds an attribute id to identify the entitiy. A textual description of the relationship is represented using the relationship attribute, which can be filtered on in the getProperty operation. For the latter a number of suggested terms are defined:

• version of

• reference

• sound tracks

• influenced by

• re-edit

• adapted_work

• translated

• interpretation

• followed by

• similar theme

• similar touch

• is similar to

• nominated award

• origin country

interface Relation: MAObject {
			attribute DOMString id;
			attribute DOMString relationship;
		};				  
				  

["https://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626_thumb.JPG", "re-edit"]

The collection property holds a name of the collection from wich the entities originates.

An array of object elements implementing the StringObject interface. The value attribute should hold the name of the collection from which the media resource originates.

interface StringObject: MAObject, Language {
			attribute DOMString value;
		};
					

["My Work Pictures"]

The copyright property holds the copyright statement and an identification of the copyrights holder (DRM is out of scope for MAWG).

An array ofobject elements implementing the Copyright interface. This object holds an attribute statement that holds the copyright statement. An array of DOMString elements is used to denote the copyright holders and stored in attribute holder.

interface Copyright: MAObject, Language {
			attribute DOMString statement;
			attribute DOMString[] holder;
		};
				  

["All images in the collection are copyrighted by John Doe", "https://individuals.example.com/JohnDoe"]

The policy property holds a description of the rights-related information regarding the media resource.

An array of object elements implementing the Policy interface. This object holds an attribute policy that holds the description of the license. Attribute organization identifies the organization that issued the license. Lastly, the type holds the actual type of the policy, which can be filtered on in the getProperty operation. Current possibilities are "license", "access", and "privacy".

interface Policy: MAObject, Language {
			attribute DOMString policy;
			attribute DOMString organization;
			attribute DOMString type;
		};
				  

["Attribution 2.5 ", "https://creativecommons.org/licenses/by/2.5"]

The publisher property holds identification of the publisher of the entitiy. Examples of a Publisher include a person, an organization, or a service. Typically, the name of a Publisher should be used to indicate the entity.

An array of object elements implementing the StringObject interface. The value attribute should represent the name of the publisher.

	interface StringObject: MAObject, Language  {
		attribute DOMString value;
	};
					

["https://individuals.example.com/JohnDoe"]

The targetAudience property holds a pair identifying the issuer of the classification (agency) and the classification. E.g. parental guide, targeted geographical region. Lastly, a type attribute defines the type of the classification. Possible values are "Age group" and "Geographical".

An array of object elements implementing the TargetAudience interface. This object has an attribute issuer which identifies the issuer of the classification. Additionally, the classification attribute defines the actual classification. Lastly, a type attribute determins the type of the classification, which can be filtered on in the getProperty operation. Possibilities include "Age group" and "Geographical".

interface TargetAudience: MAObject, Language {
			attribute DOMString issuer;
			attribute DOMString classification;
			attribute DOMString type;
		};
				  

["https://www.fosi.org/icra","no nudity", "Age Group"]

The fragments property holds a list of pairs of fragment role and fragment identifier (e.g. chapters, favourite scenes).

An array of object elements implementing the Fragment interface. This object holds an attribute role that holds the role of the fragment. The attribute identifier is used to identify the fragment.

interface Fragment: MAObject {
			  attribute DOMString role;
			  attribute DOMString identifier;
		};
				  

[["Person", "https://www.example.com/movie.mov#xywh=320,320,40,100"],

["Person", "https://www.example.com/movie.mov#xywh=300,350,40, 40"]]

The namedFragments property holds the list of named fragments annotated for this resource (pairs of label and fragment identifier).

An array of object elements implementing the NamedFragment interface. This object holds an attribute name with the name given to the fragment. The attribute identifier is used to identify the fragment.

interface NamedFragment: MAObject {
			  attribute DOMString name;	
			  attribute DOMString identifier;
		};
				  

[["Joakim Söderberg", "https://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626.JPG#xywh=1600,550,80,150]",

["Chris Poppe", "https://www.w3.org/2008/WebVideo/Annotations/wiki/Image:MAWG-Stockholm-20090626.JPG#xywh=1400,600,80, 80]]"

The frameSize property determines the frame size.

An array of object elements implementing the FrameSize interface. This object has an attribute width and height to represent the width and height of the frame, respectively.

interface FrameSize: MAObject {
			  attribute unsigned long width;
			  attribute unsigned long height;
		};
				  

[3.072, 2.304]

The compression property holds the compression type used. Note: it might be possible to use extended mime type, see RFC 4281.

An array of object elements implementing the StringObject interface. The value attribute should hold the compression type as a plain string.

	interface StringObject: MAObject, Language  {
		attribute DOMString value;
	};
					

["H.264/AVC"]

The duration property represents the duration of the entitiy.

An array of object elements implementing the FloatObject interface. The value attribute should represent the duration (in secs).

interface FloatObject: MAObject {
		attribute unsigned long value;
	};
					

[3600]

The format property holds the MIME type of the entity (wrapper, bucket media types).

An array of object elements implementing the StringObject interface. The value attribute should hold the MIME type as a plain string.

	interface StringObject: MAObject, Language  {
		attribute DOMString value;
	};
					

A DOMString representing the MIME type.

["image/jpeg"]

The samplingrate property holds the samplingrate of an audio file. Only applicable for audio.

An array of object elements implementing the UnsignedLongObject interface. The value attribute should represent the samplingrate (in Hz).

interface UnsignedLongObject: MAObject {
		attribute unsigned long value;
	};
					

[100]

The framerate property holds the frame rate of the video. Only applicable for video.

An array of object elements implementing the FloatObject interface. The value attribute should represent the framerate (in fps).

interface FloatObject: MAObject {
		attribute float value;
	};
					

[30]

The bitrate property holds the average bitrate. Only applicable for audio and video.

An array of object elements implementing the FloatObject interface. The value attribute should represent the bitrate (in kbps).

interface FloatObject: MAObject {
		attribute float value;
	};
					

[100]

The numTracks property holds the number of tracks.

An array of object elements implementing the UnsignedShortObject interface. The value attribute should represent the number of tracks.

interface StringObject: MAObject {
		attribute unsigned short value;
	};
					

[2]