Testsuite for the API for Media Resources 1.0

This version:
Thierry Michel, W3C/ERCIM
Florian Stegmaier, University of Passau
이원석(WonSuk Lee), Samsung Electronics Co., Ltd.
Felix Sasaki, DFKI GmbH

Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.


The public API 1.0 Test Suite was designed to validate the API for Media Resources 1.0 specification.

The API 1.0 Test Suite is maintained by the Media Annotations Working Group.

This Test Suite covers  the multimedia metadata formats and features to be tested by the implementations.

The following elements are considered features of the API:

Comments on this document should be sent to <public-media-annotation@w3.org>. The archive of public comments is available at http://lists.w3.org/Archives/Public/public-media-annotation/

1. Formats

The API is designed for both client- and server side implementations. Depending on whether the API is implemented in a user agent or plugin, or as a web service, different communication patterns are more appropriate. In the client side case, asynchronous access is typically preferred, while synchronous access is more appropriate for a web service. Thus the two version of the interface are not considered distinct features but different modes of access for the different use cases.

2. Formats in scope

The following tables lists the formats that were selected as in-scope. We distinguish multimedia metadata formats that focus on the description of multimedia resources from multimedia container formats. In the case of the latter, only few technical properties are relevant, because of they widespread usage.

The API for Media Resources 1.0 specification defines a specific JSON response structure, to which a implementation has to be compliant. To enable an (automatic) evaluation, a normative JSON response for a example media resource for each metadata format has been created covering all properties defined in the corresponding mapping table. These files are available in following sections 2.1 and 2.2.

Note: The example media resources have been taken from the in the Ontology for Media Resource 1.0

2.1 Multimedia metadata formats in scope

Metadata format Example Normative JSON response
DIG35 DIG35 example
Dublin Core Dublin Core example
EBU Core EBU Core example
Exif 2.2 Exif 2.2 example
ID3 ID3 example
IPTC IPTC example
LOM 2.1 LOM 2.1 example
Media RSS Media RSS example
MPEG-7 MPEG-7 example
DMS-1 DMS-1 example
TTML TTML example
TV-Anytime TV-Anytime example
TXFeed TXFeed example
XMP XMP example
YouTube YouTube example

2.2 Multimedia container formats

Metadata format Example Normative JSON response
3gp 3GP example
f4v F4V example
flv FLV example
mp4 MP4 example
quicktime Quicktime example

A References

3GPP Specifications. Available for download at http://www.3gpp.org/specifications.
[Cablelabs 1.1]
CableLabs VOD Content Specification Version 1.1. Available for download at http://www.cablelabs.com/specifications/MD-SP-VOD-CONTENT1.1-I05-060831.pdf .
DIG35 Specification - Metadata for Digital Image. April 2001. Available for download at http://www.bgbm.org/TDWG/acc/Documents/DIG35-v1.1WD-010416.pdf .
DMS-1 (SMPTE 380M-2004). April 2001. Available for download at http://www.smpte.org/standards .
[Dublin Core]
DCMI Metadata Terms. January 2008. Available for download at http://dublincore.org/documents/2008/01/14/dcmi-terms/ . The latest version of DCMI Metadata Terms is available at http://dublincore.org/documents/dcmi-terms/ .
EBUCore v.1.0. December 2008. Available for download at http://tech.ebu.ch/publications/tech3293.
EXIF 2.2. Specification by JEITA, April 2002. Available for download at http://www.exif.org/Exif2-2.PDF .
Adobe Flash Video File Format Specification Version 10.1. 2010. Available for download at http://download.macromedia.com/f4v/video_file_format_spec_v10_1.pdf.
Draft Standard for Learning Object Metadata. July 2002. Available for download at http://ltsc.ieee.org/wg12/files/LOM_1484_12_1_v1_Final_Draft.pdf .
ID3 tag version 2.4.0. February 1999. Available for download at http://www.id3.org/Developer_Information .
IPTC Standard Photo Metadata 2008. IPTC Core Specification Version 1.1, IPTC Extension Specification 1.0, Document Revision 2, June 2008. Available for download at http://www.iptc.org/std/photometadata/2008/specification/IPTC-PhotoMetadata-2008.pdf
IPTC NewsML-G2. Available for download at http://www.iptc.org/cms/site/ .
Metadata Encoding & Transmission Standard 1.7. Available for download at http://www.loc.gov/standards/mets/ .
[Media RDF]
Media RDF. Available for download at http://digitalbazaar.com/.
[Media RSS]
Yahoo! Media RSS Module - RSS 2.0 Module. March 2008. Available for download at http://video.search.yahoo.com/mrss .
ISO/IEC 14496-14 MP4 file format. date 2003. Available for download at http://www.iso.org/iso/catalogue_detail.htm?csnumber=38538.
Information technology Multimedia content description interface Part 10: Schema definition. Available for download at http://www.chiariglione.org/mpeg/working_documents/mpeg-07/schema_def/cd.zip .
The Ogg container format. September 2007. Available for download at http://www.xiph.org/ogg/.
[OWL2 Profiles]
OWL 2 Web Ontology Language Profiles. W3C OWL Working Group. Available for download at http://www.w3.org/TR/owl2-profiles/.
Introduction to QuickTime File Format Specification. August 2010. Available for download at http://developer.apple.com/mac/library/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html .
Resource Description Framework (RDF). W3C RDF Working Group. Available for download at http://www.w3.org/RDF/ .
SMPTE Metadata. Available for download at http://www.smpte-ra.org/mdd/RP210v11-pub-20080415.2048.xls .
Glenn Adams. Timed Text Markup Language (TTML) 1.0. W3C Recommendation 18 November 2010. Available for download at http://www.w3.org/TR/2010/REC-ttaf1-dfxp-20101118/.
TXFeed standard 0.9. December 2007. Available for download at http://clearerchannel.org/docs/tx_metadata_standard_0_9.pdf .
ETSI 102 822-3-1 V1.4.1. November 2007. Broadcast and On-line Services: Search, select, and rightful use of content on personal storage systems("TV-Anytime"). Part 3: Metadata, Sub-part 1: Phase 1 - Metadata schemas .
WebM Container Guidelines. Available for download at http://www.webmproject.org/code/specs/container/.
[XML Schema 2]
Biron, P. V. and A. Malhotra. XML Schema Part 2: Datatypes Second Edition. W3C Recommendation, October 2004. Available for download at http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/ . The latest version of XML Schema Part 2 is available for download at http://www.w3.org/TR/xmlschema-2/ .
XMP Specification Part 1 - Standard Schemas . Adobe, 2010. Available for download at http://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart1.pdf.
XMP Specification Part 2 - Standard Schemas . Adobe, 2010. Available for download at http://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart2.pdf.
[YouTube Data API Protocol]
YouTube Data API Protocol. April 2008. Available for download at http://code.google.com/intl/en/apis/youtube/2.0/reference.html .