| CARVIEW |
Testsuite for the API for Media Resources 1.0
- This version:
- https://www.w3.org/2008/WebVideo/Annotations/drafts/API/testsuite.html
- Editors:
- Thierry Michel, W3C/ERCIM
- Florian Stegmaier, University of Passau
- Werner Bailer, JOANNEUM RESEARCH
- Authors:
- 이원석(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.
Summary
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:
- construction of MediaResource with one or more metadata sources and querying of the supported modes
- read access to the list of properties (single properties and sets of properties, applying filters)
- reading source metadata
Comments on this document should be sent to <public-media-annotation@w3.org>. The archive of public comments is available at https://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
2.2 Multimedia container formats
| Metadata format | Example | Normative JSON response |
|---|---|---|
| 3gp | 3GP
example |
JSON |
| f4v | F4V
example |
JSON |
| flv | FLV
example |
JSON |
| mp4 | MP4
example |
JSON |
| quicktime | Quicktime
example |
JSON |
OGG QuickTime DMS-1 TTML TV-Anytime XMP TXFeed
Date Location Description Keywords Genre Rating
Relation Collection Copyright Policy Publisher TargetAudience
Fragments NamedFragment FrameSize Compression Duration
Format SamplingRate FrameRate BitRate NumTracks
| Identification Properties |
|---|
| Identifier |
| Title |
| Language |
| Locator |
| Creation Properties |
| Contributor |
| Creator |
| Date |
| Location |
| Content Properties |
| Description |
| Keywords |
| Genre |
| Rating |
| Relational Properties |
| Relation |
| Collection |
| Rights Properties |
| Copyright |
| Policy |
| Distribution Properties |
| Publisher |
| TargetAudience |
| Fragment Properties |
| Fragment |
| NamedFragment |
| Technical Properties |
| FrameSize |
| Compression |
| Duration |
| Format |
| SamplingRate |
| FrameRate |
| AverageBitRate |
| NumTracks |
A References
- [3GP]
- 3GPP Specifications. Available for download at https://www.3gpp.org/specifications.
- [Cablelabs 1.1]
- CableLabs VOD Content Specification Version 1.1. Available for download at https://www.cablelabs.com/specifications/MD-SP-VOD-CONTENT1.1-I05-060831.pdf .
- [DIG35]
- DIG35 Specification - Metadata for Digital Image. April 2001. Available for download at https://www.bgbm.org/TDWG/acc/Documents/DIG35-v1.1WD-010416.pdf .
- [DMS-1]
- DMS-1 (SMPTE 380M-2004). April 2001. Available for download at https://www.smpte.org/standards .
- [Dublin Core]
- DCMI Metadata Terms. January 2008. Available for download at https://dublincore.org/documents/2008/01/14/dcmi-terms/ . The latest version of DCMI Metadata Terms is available at https://dublincore.org/documents/dcmi-terms/ .
- [EBUCore]
- EBUCore v.1.0. December 2008. Available for download at https://tech.ebu.ch/publications/tech3293.
- [EXIF]
- EXIF 2.2. Specification by JEITA, April 2002. Available for download at https://www.exif.org/Exif2-2.PDF .
- [Flash]
- Adobe Flash Video File Format Specification Version 10.1. 2010. Available for download at https://download.macromedia.com/f4v/video_file_format_spec_v10_1.pdf.
- [LOM]
- Draft Standard for Learning Object Metadata. July 2002. Available for download at https://ltsc.ieee.org/wg12/files/LOM_1484_12_1_v1_Final_Draft.pdf .
- [ID3]
- ID3 tag version 2.4.0. February 1999. Available for download at https://www.id3.org/Developer_Information .
- [IPTC]
- 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 https://www.iptc.org/std/photometadata/2008/specification/IPTC-PhotoMetadata-2008.pdf
- [IPTC NewsML]
- IPTC NewsML-G2. Available for download at https://www.iptc.org/cms/site/ .
- [METS]
- Metadata Encoding & Transmission Standard 1.7. Available for download at https://www.loc.gov/standards/mets/ .
- [Media RDF]
- Media RDF. Available for download at https://digitalbazaar.com/.
- [Media RSS]
- Yahoo! Media RSS Module - RSS 2.0 Module. March 2008. Available for download at https://video.search.yahoo.com/mrss .
- [MP4]
- ISO/IEC 14496-14 MP4 file format. date 2003. Available for download at https://www.iso.org/iso/catalogue_detail.htm?csnumber=38538.
- [MPEG-7]
- Information technology Multimedia content description interface Part 10: Schema definition. Available for download at https://www.chiariglione.org/mpeg/working_documents/mpeg-07/schema_def/cd.zip .
- [OGG]
- The Ogg container format. September 2007. Available for download at https://www.xiph.org/ogg/.
- [OWL2 Profiles]
- OWL 2 Web Ontology Language Profiles. W3C OWL Working Group. Available for download at https://www.w3.org/TR/owl2-profiles/.
- [QuickTime]
- Introduction to QuickTime File Format Specification. August 2010. Available for download at https://developer.apple.com/mac/library/documentation/QuickTime/QTFF/QTFFPreface/qtffPreface.html .
- [RDF]
- Resource Description Framework (RDF). W3C RDF Working Group. Available for download at https://www.w3.org/RDF/ .
- [SMPTE]
- SMPTE Metadata. Available for download at https://www.smpte-ra.org/mdd/RP210v11-pub-20080415.2048.xls .
- [TTML]
- Glenn Adams. Timed Text Markup Language (TTML) 1.0. W3C Recommendation 18 November 2010. Available for download at https://www.w3.org/TR/2010/REC-ttaf1-dfxp-20101118/.
- [TXFeed]
- TXFeed standard 0.9. December 2007. Available for download at https://clearerchannel.org/docs/tx_metadata_standard_0_9.pdf .
- [TV-Anytime]
- 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]
- WebM Container Guidelines. Available for download at https://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 https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/ . The latest version of XML Schema Part 2 is available for download at https://www.w3.org/TR/xmlschema-2/ .
- [XMP]
- XMP Specification Part 1 - Standard Schemas . Adobe, 2010. Available for download at https://www.adobe.com/content/dam/Adobe/en/devnet/xmp/pdfs/XMPSpecificationPart1.pdf.
- XMP Specification Part 2 - Standard Schemas . Adobe, 2010. Available for download at https://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 https://code.google.com/intl/en/apis/youtube/2.0/reference.html .
