Media File

Validate against: http://json-schema.org/schema#

Schema ID: http://cdn.digitallinguistics.io/schemas/Media-1.0.0.json

Description

An object containing information about a media file. The file itself should be stored at the URL indicated in the mediaUrl field. Media files generally contain primary data. Examples might include audio/video recordings, scans of archival materials, photos taken during fieldwork, or scans of field notes.

Type: object

Required Properties

  • filename
  • format
  • languages
  • mediaUrl

Additional properties: true

Properties

  • Abbreviation: "abbreviation"

    Description

    An abbreviation for referring to this file.

    Must be an instance of the Abbreviation schema.

  • Access Rights: "access"

    Must be an instance of the Access schema.

  • Content: "content"

    Description

    A description of the content of this file, optionally in multiple languages or orthographies.

    Must be an instance of the mulitLangString schema.

  • MIME Content Type: "contentType"

    Description

    The media type of the file. Examples: audio/wav, application/pdf, video/mpeg

  • Creator: "creator"

    Description

    The person who created this specific file.

    Must be an instance of the Person schema.

  • Date Created: "dateCreated"

    Must be an instance of the DateCreated schema.

  • Date Recorded: "dateRecorded"

    Must be an instance of the DateRecorded schema.

  • End Time: "endTime"

    Description

    Within an audiovisual file, the time at which the relevant linguistic data ends. Programs may use this field in different ways. For example, if the camera recorded for five minutes after the speaker finished talking, the End Time would be the time 5 minutes before the end of the file. The time stamp should be in seconds and milliseconds, separated by a period, e.g. 12.573, or 1.2, or 167.78012, etc.

    Type: number

  • Filename: "filename"

    Description

    The filename for this media item without spaces, but including the extension.

    Type: string

    Regular expression pattern: ^[^ ]+\.[^ ]+

  • File Size: "fileSize"

    Description

    The size of the file, in bytes.

    Type: integer

  • Format (File Extension): "format"

    Description

    The format (file extension) of the media file, without a period. Examples: wav, mp4, pdf

    Type: string

  • Languages: "languages"

    Description

    A collection of the languages that are used in this media file.

    Type: array

    Unique items: true

    Items

    Language

    Must be an instance of the Language schema.

  • Length (in Time / Pages): "length"

    Description

    The length of the file, in seconds and milliseconds if an audio/video file (in SS.MM format), or pages if a document.

    Type: number

  • Location: "location"

    Description

    The location where the content in this media file was recorded or produced.

    Must be an instance of the Location schema.

  • Media URL: "mediaUrl"

    Description

    The URL where the media file itself can be found.

    Must be an instance of the Url schema.

  • Notes: "notes"

    Description

    A collection of notes about this media item.

    Type: array

    Unique items: true

    Items

    Note

    Must be an instance of the Note schema.

  • Original Media Item: "original"

    Description

    The URL of the media object (not the URL to the media file itself) that this file is derived from.

    Must be an instance of the Url schema.

  • Persons in File: "persons"

    Description

    A list of all the people who appear in this file. Often a list of speakers.

    Type: array

    Unique items: true

    Items

    Person

    Must be an instance of the Person schema.

  • Start Time: "startTime"

    Description

    Within an audiovisual file, the time at which the relevant linguistic data starts, or the time at which an offset should be calibrated from. This may also be used to synchronize the starting point of multiple media files associated with a single Text. For example, if the camera started recording five minutes before the speaker began speaking, the Start Time might be 5 minutes from the start of the file (so 300.00 seconds). The time stamp should be in seconds and milliseconds, separated by a period, e.g. 12.573, or 1.2, or 167.78012, etc.

    Type: number

  • Tags: "tags"

    Must be an instance of the Tags schema.

  • URL: "url"

    Description

    The URL where this media object can be retrieved. NOT the URL of the media file itself (for that, see the mediaUrl attribute).

    Must be an instance of the Url schema.