Video Object
A video file.
The VideoObject
type allows you to provide details such as caption and transcript, and the details which are included in MediaObject
which VideoObject
extends.
Properties​
Name | @id | Type | Description | Inherited from |
---|---|---|---|---|
contentUrl | schema:contentUrl | string | URL for the actual bytes of the media object, for example the image file or video file. See note 1. | MediaObject |
about | schema:about | Array of ThingTypes | The subject matter of the content. See note 2. | CreativeWork |
alternateNames | schema:alternateName | Array of string | Alternate names (aliases) for the item. | Thing |
authors | schema:author | Parser 'scsi' and Array of (Person or Organization) | The authors of this creative work. | CreativeWork |
bitrate | schema:bitrate | number | Bitrate in megabits per second (Mbit/s, Mb/s, Mbps). | MediaObject |
caption | schema:caption | string | The caption for this video recording. | VideoObject |
comments | schema:comment | Array of Comment | Comments about this creative work. | CreativeWork |
content | stencila:content | Array of Node or string | The structured content of this creative work c.f. property text . | CreativeWork |
contentSize | schema:contentSize | number | File size in megabits (Mbit, Mb). | MediaObject |
dateAccepted | stencila:dateAccepted | Date | Date/time of acceptance. See note 3. | CreativeWork |
dateCreated | schema:dateCreated | Date | Date/time of creation. | CreativeWork |
dateModified | schema:dateModified | Date | Date/time of most recent modification. | CreativeWork |
datePublished | schema:datePublished | Date | Date of first publication. | CreativeWork |
dateReceived | schema:dateReceived | Date | Date/time that work was received. | CreativeWork |
description | schema:description | Array of BlockContent or Array of InlineContent or string | A description of the item. See note 4. | Thing |
editors | schema:editor | Array of Person | People who edited the CreativeWork . | CreativeWork |
embedUrl | schema:embedUrl | string | URL that can be used to embed the media on a web page via a specific media player. | MediaObject |
fundedBy | stencila:fundedBy | Array of (Grant or MonetaryGrant) | Grants that funded the CreativeWork ; reverse of fundedItems . See note 5. | CreativeWork |
funders | schema:funder | Array of (Person or Organization) | People or organizations that funded the CreativeWork . | CreativeWork |
genre | schema:genre | Parser 'csi' and Array of string | Genre of the creative work, broadcast channel or group. | CreativeWork |
id | schema:id | string | The identifier for this item. | Entity |
identifiers | schema:identifier | Array of (PropertyValue or string) | Any kind of identifier for any kind of Thing. See note 6. | Thing |
images | schema:image | Array of (ImageObject or Format 'uri') | Images of the item. | Thing |
isPartOf | schema:isPartOf | CreativeWorkTypes | An item or other CreativeWork that this CreativeWork is a part of. | CreativeWork |
keywords | schema:keywords | Parser 'csi' and Array of string | Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas. | CreativeWork |
licenses | schema:license | Array of (CreativeWorkTypes or Format 'uri') | License documents that applies to this content, typically indicated by URL. | CreativeWork |
maintainers | schema:maintainer | Array of (Person or Organization) | The people or organizations who maintain this CreativeWork. See note 7. | CreativeWork |
mediaType | schema:encodingFormat | string | IANA media type (MIME type). See note 8. | MediaObject |
meta | stencila:meta | object | Metadata associated with this item. | Entity |
name | schema:name | string | The name of the item. | Thing |
parts | schema:hasParts | Array of CreativeWorkTypes | Elements of the collection which can be a variety of different elements, such as Articles, Datatables, Tables and more. | CreativeWork |
publisher | schema:publisher | Person or Organization | A publisher of the CreativeWork. | CreativeWork |
references | schema:citation | Array of (CreativeWorkTypes or string) | References to other creative works, such as another publication, web page, scholarly article, etc. | CreativeWork |
text | schema:text | string | The textual content of this creative work. | CreativeWork |
thumbnail | schema:thumbnail | ImageObject | Thumbnail image of this video recording. | VideoObject |
title | schema:headline | Array of InlineContent or string | The title of the creative work. See note 9. | CreativeWork |
transcript | schema:transcript | string | The transcript of this video recording. | VideoObject |
url | schema:url | Format 'uri' | The URL of the item. | Thing |
version | schema:version | string or number | The version of the creative work. See note 10. | CreativeWork |
Notes​
- contentUrl : To allow for file paths, including possibly erroneous paths, niether
format
orpattern
keywords are used here, or onembedUrl
. - about : Consistent with https://schema.org/about, this property allows for linking to one of more
Thing
nodes. This could for example include aPerson
(e.g for a bibliography) or aDefinedTerm
(e.g. for subject areas the creative work relates to). - dateAccepted : This is not yet a schema.org property but the term is used in Dublin Core.
- description : Allows for the description to be an array of nodes (e.g. an array of inline content, or a couple of paragraphs), or a string. The
minItems
restriction avoids a string being coerced into an array with a single string item. - fundedBy : This follows the proposal here for a property that is the reverse of
fundedItems
. It is an any because aCreativeWork
may have been funded through more than oneGrant
. - identifiers : Some identifiers have specific properties e.g the
issn
property for thePeriodical
type. These should be used in preference to this property which is intended for identifiers that do not yet have a specific property. Identifiers can be represented as strings, but using aPropertyValue
will usually be better because it allows forpropertyID
(i.e. the type of identifier). - maintainers : A maintainer of a Dataset, SoftwareApplication, or other CreativeWork. A maintainer is a Person or Organization that manages contributions to, and/or publication of, some (typically complex) artifact. It is common for distributions of software and data to be based on "upstream" sources. When maintainer is applied to a specific version of something e.g. a particular version or packaging of a Dataset, it is always possible that the upstream source has a different maintainer. The isBasedOn property can be used to indicate such relationships between datasets to make the different maintenance roles clear. Similarly in the case of software, a package may have dedicated maintainers working on integration into software distributions such as Ubuntu, as well as upstream maintainers of the underlying work.
- mediaType : This property is more restrictive than https://schema.org/encodingFormat which expects either Text or URL for this property. This schema expects a media type e.g.
text/html
as listed at http://www.iana.org/assignments/media-types/media-types.xhtml. - title : Allows for the title to include inline content (e.g
Strong
,Math
) or a string. The title can not be block content e.gParagraph
. TheminItems
restriction avoids a string being coerced into an array with a single string item. - version : In this case
string
is listed as an alternative beforenumber
to avoid semantic version numbers e.g.1.0
being parsed, and subsequently encoded, as1
thereby resulting in loss of information.
Examples​
{
"type": "VideoObject",
"caption": "Example Video File",
"contentSize": "45",
"contentUrl": "http://www.example.com/file.mp4",
"encodingFormat": "video/mpeg",
"transcript": "This is the transcript for the video file..."
}
Related​
- Parent: MediaObject
- Descendants: None
Available as​
- JSON-LD
- JSON Schema
- Python
class VideoObject
- TypeScript
interface VideoObject
- R
class VideoObject
- Rust
struct VideoObject
Source​
This documentation was generated from VideoObject.schema.yaml.