https://ns.adobe.com/xdm/assets/video
The Video class is for video assets, i.e. assets that consist of moving pictures and, optionally, sound.
Abstract | Extensible | Status | Identifiable | Custom Properties | Additional Properties | Defined In |
---|---|---|---|---|---|---|
Can be instantiated | Yes | Experimental | No | Forbidden | Permitted | assets/video.schema.json |
- Video
https://ns.adobe.com/xdm/assets/video
- Asset
https://ns.adobe.com/xdm/assets/asset
- Simple Rectangular Area
https://ns.adobe.com/xdm/assets/rectangular
- Asset
{
"repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ac",
"xmp:createDate": "2017-09-26T15:52:25+00:00",
"repo:createdDate": "2017-09-26T15:52:25+00:00",
"xdm:repositoryCreatedBy": "lars",
"xmp:modifyDate": "2017-09-26T15:52:25+00:00",
"repo:lastModifiedDate": "2017-09-26T15:52:25+00:00",
"xdm:repositoryLastModifiedBy": "2017-09-26T15:52:25+00:00",
"repo:version": "15",
"repo:size": 1632418,
"xdm:path": "here",
"repo:etag": "15",
"tiff:imageLength": 2160,
"tiff:imageWidth": 3840,
"xdm:aspectRatio": 1.77777777778,
"xdm:extent": 11700000,
"xdm:videoFrameRate": "NTSC"
}
{
"repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ad",
"xmp:createDate": "2017-09-26T15:52:25+00:00",
"repo:createdDate": "2017-09-26T15:52:25+00:00",
"xdm:repositoryCreatedBy": "lars",
"xmp:modifyDate": "2017-09-26T15:52:25+00:00",
"repo:lastModifiedDate": "2017-09-26T15:52:25+00:00",
"xdm:repositoryLastModifiedBy": "2017-09-26T15:52:25+00:00",
"repo:version": "15",
"repo:size": 1632418,
"xdm:path": "here",
"repo:etag": "15",
"tiff:imageLength": 2160,
"tiff:imageWidth": 3840,
"xdm:aspectRatio": 1.77777777778,
"xdm:extent": 10920000,
"xdm:videoFrameRate": "f48s1"
}
Property | Type | Required | Defined by |
---|---|---|---|
cc:attributionName | string |
Optional | Asset |
cc:attributionUrl | string |
Optional | Asset |
cc:license | string |
Optional | Asset |
dc:creator | string[] |
Optional | Asset |
dc:description | reference | Optional | Asset |
dc:language | string[] |
Optional | Asset |
dc:rights | reference | Optional | Asset |
dc:subject | string[] |
Optional | Asset |
dc:title | reference | Optional | Asset |
exif:gpsAltitude | number |
Optional | Asset |
exif:gpsAltitudeRef | enum |
Optional | Asset |
exif:gpsLatitude | string |
Optional | Asset |
exif:gpsLongitude | string |
Optional | Asset |
photoshop:credit | string |
Optional | Asset |
plus:copyrightOwner | reference | Optional | Asset |
tiff:imageLength | integer |
Optional | Simple Rectangular Area |
tiff:imageWidth | integer |
Optional | Simple Rectangular Area |
xdm:aliasIDs | array |
Optional | Asset |
xdm:aspectRatio | number |
Optional | Simple Rectangular Area |
xdm:documentID | string |
Optional | Asset |
xdm:extent | integer |
Optional | Video (this schema) |
xdm:milestone | object |
Optional | Asset |
xdm:notSafe | enum |
Optional | Asset |
xmp:artboards | Artboard | Optional | Asset |
xmp:createDate | string |
Optional | Asset |
xmp:creatorTool | string |
Optional | Asset |
xmp:fonts | reference | Optional | Asset |
xmp:keywords | array |
Optional | Asset |
xmp:layers | complex | Optional | Asset |
xmp:machineKeywords | object[] |
Optional | Asset |
xmp:modifyDate | string |
Optional | Asset |
xmp:rating | enum |
Optional | Asset |
xmpDM:videoFrameRate | string |
Optional | Video (this schema) |
xmpMM:history | reference | Optional | Asset |
xmpMM:manageTo | string |
Optional | Asset |
xmpMM:manageUI | string |
Optional | Asset |
xmpRights:marked | boolean |
Optional | Asset |
xmpRights:usageTerms | reference | Optional | Asset |
xmpRights:webStatement | string |
Optional | Asset |
xmpTPg:NPages | integer |
Optional | Asset |
* |
any | Additional | this schema allows additional properties |
For licenses that require attribution, such as some Creative Commons licenses, the user to which a work is attributed. When publishing to Behance, this is taken from the user's Behance profile information.
cc:attributionName
- is optional
- type:
string
- defined in Asset
string
For licenses that require attribution, such as some Creative Commons licenses, a URL that identifies the user to which a work should be attributed. When publishing to Behance, we link to the user's profile page.
cc:attributionUrl
- is optional
- type:
string
- defined in Asset
string
- format:
uri
– Uniformous Resource Identifier (according to RFC3986)
A license is a set of requests/permissions to users of a Work, e.g. a copyright license, the public domain, information for distributors.
cc:license
- is optional
- type:
string
- defined in Asset
string
- format:
uri
– Uniformous Resource Identifier (according to RFC3986)
An entity primarily responsible for making the resource. Examples of a creator include a person, an organization, or a service. Typically, the name of a creator should be used to indicate the entity.
XMP usage is a list of creators. Entities should be listed in order of decreasing precedence, if such order is significant.
dc:creator
-
is optional
-
type:
string[]
-
defined in Asset
Array type: string[]
All items must be of the type:
string
An account of the content of the resource. Description may include but is not limited to: an abstract, table of contents, reference to a graphical representation of content or a free-text account of the content.
dc:description
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
The language or languages of the resource. Languages are specified in language code as defined in IETF RFC 3066, which is part of BCP 47, which is used elsewhere in XDM.
dc:language
-
is optional
-
type:
string[]
-
defined in Asset
Array type: string[]
All items must be of the type:
string
All instances must conform to this regular expression (test examples here):
^(((([A-Za-z]{2,3}(-([A-Za-z]{3}(-[A-Za-z]{3}){0,2}))?)|[A-Za-z]{4}|[A-Za-z]{5,8})(-([A-Za-z]{4}))?(-([A-Za-z]{2}|[0-9]{3}))?(-([A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(-([0-9A-WY-Za-wy-z](-[A-Za-z0-9]{2,8})+))*(-(x(-[A-Za-z0-9]{1,8})+))?)|(x(-[A-Za-z0-9]{1,8})+)|((en-GB-oed|i-ami|i-bnn|i-default|i-enochian|i-hak|i-klingon|i-lux|i-mingo|i-navajo|i-pwn|i-tao|i-tay|i-tsu|sgn-BE-FR|sgn-BE-NL|sgn-CH-DE)|(art-lojban|cel-gaulish|no-bok|no-nyn|zh-guoyu|zh-hakka|zh-min|zh-min-nan|zh-xiang)))$
"\n"
"pt-BR"
"es-ES"
Information about rights held in and over the resource. We can live without mentioning locale if only one entry is there. Default locale is en_us. Locale codes should follow IETF BCP 47 standard.
dc:rights
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
Set of descriptive phrases or keywords that describe the content of the resource. These keywords are part of the XMP metadata of the asset. Compare this with the keyword
and machineKeywords
properties, which provide more structure and context.
dc:subject
-
is optional
-
type:
string[]
-
defined in Asset
Array type: string[]
All items must be of the type:
string
A name given to the resource. Typically, a Title will be a name by which the resource is formally known.
dc:title
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
GPS tag 6, 0x06. Indicates altitude in meters.
exif:gpsAltitude
- is optional
- type:
number
- defined in Asset
number
GPS tag 5, 0x5. Indicates whether the altitude is above or below sea level.
exif:gpsAltitudeRef
- is optional
- type:
enum
- defined in Asset
The value of this property must be equal to one of the known values below.
Value | Description |
---|---|
0 |
The exif:gpsAltitude specifies a value above sea level |
1 |
The exif:gpsAltitude specifies a value below sea level |
GPS tag 2, 0x02 (position) and 1, 0x01 (North/South). Indicates latitude. A Text value in the form “DDD,MM,SSk” or “DDD,MM.mmk”, where:
- DDD is a number of degrees
- MM is a number of minutes
- SS is a number of seconds
- mm is a fraction of minutes
- k is a single character N or S, indicating a direction (north, south) Leading zeros are not necessary for the for DDD, MM, and SS values. The DDD,MM.mmk form should be used when any of the native Exif component rational values has a denominator other than 1. There can be any number of fractional digits.
exif:gpsLatitude
- is optional
- type:
string
- defined in Asset
string
All instances must conform to this regular expression (test examples here):
^[\d]{1,3},[\d]{1,2}(,[\d]{1,2}|.[\d]+)[NS]$
GPS tag 4, 0x04 (position) and 3, 0x03 (East/West). Indicates longitude. A Text value in the form “DDD,MM,SSk” or “DDD,MM.mmk”, where:
- DDD is a number of degrees
- MM is a number of minutes
- SS is a number of seconds
- mm is a fraction of minutes
- k is a single character E or W, indicating a direction (east, west) Leading zeros are not necessary for the for DDD, MM, and SS values. The DDD,MM.mmk form should be used when any of the native Exif component rational values has a denominator other than 1. There can be any number of fractional digits.
exif:gpsLongitude
- is optional
- type:
string
- defined in Asset
string
All instances must conform to this regular expression (test examples here):
^[\d]{1,3},[\d]{1,2}(,[\d]{1,2}|.[\d]+)[EW]$
Who should be credited when the asset is published.
photoshop:credit
- is optional
- type:
string
- defined in Asset
string
Owner or owners of the copyright in the licensed asset.
plus:copyrightOwner
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
Height in pixels. To maintain continuity with the XMP and TIFF standards, the height of an image or video is specified in the property imageLength
. The duration of the video (also commonly called length) is specified in the property extent
tiff:imageLength
- is optional
- type:
integer
- defined in Simple Rectangular Area
integer
- minimum value:
0
Width in pixels
tiff:imageWidth
- is optional
- type:
integer
- defined in Simple Rectangular Area
integer
- minimum value:
0
List of IDs under which external systems track the asset. Example of external systems : google, facebook etc.
xdm:aliasIDs
-
is optional
-
type:
array
-
defined in Asset
Array type: array
All items must be of the type: Unknown type ``.
{
"type": "array",
"meta:usereditable": false,
"title": "Alias IDs",
"items": {
"properties": {
"system": {
"title": "External System",
"type": "string",
"description": "A string used to identify the external systems like google, facebook etc."
},
"id": {
"type": "string",
"title": "External ID",
"description": "An ID under which external systems track the asset."
}
},
"simpletype": "complex"
},
"description": "List of IDs under which external systems track the asset. Example of external systems : google, facebook etc.",
"$oSchema": {
"$linkVal": "Asset",
"$linkPath": "asset.schema.md"
},
"simpletype": "`array`"
}
Describes the proportional relationship between the width and the height. To determine the aspect ratio, divide width by height. Media that have an aspect ratio smaller than one are in landscape format, media that have an aspect ratio greater than one are in portrait format.
xdm:aspectRatio
- is optional
- type:
number
- defined in Simple Rectangular Area
number
- minimum value:
0
It takes the value of xmpMM:DocumentID present in the XMP packet of the asset. For the assets having no XMP packet this property won't be populated.
The value is a GUID, capital A-F, 8-4-4-12, preceded by the string uuid:
xdm:documentID
- is optional
- type:
string
- defined in Asset
string
All instances must conform to this regular expression
^uuid:[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
- test example: uuid:00112233-4455-6677-8899-AABBCCDDEEFF
"uuid:00112233-4455-6677-8899-AABBCCDDEEFF"
The duration of the video in milliseconds. This property is inspired by dc:extent
. However, dc:extent
does not specify units. core:extent
is always an integer and describes the duration in milliseconds.
xdm:extent
- is optional
- type:
integer
- defined in this schema
integer
A label given to a version of the asset.
xdm:milestone
- is optional
- type:
object
- defined in Asset
object
with following properties:
Property | Type | Required |
---|---|---|
description |
string | Optional |
label |
string | Optional |
Description for the version of an asset
description
- is optional
- type:
string
string
Label for the version of an asset
label
- is optional
- type:
string
string
Indicates if the content is SFW (safe for work). Safe is value 0 or missing value. NSFW is value 1.
xdm:notSafe
- is optional
- type:
enum
- defined in Asset
The value of this property must be equal to one of the known values below.
Value | Description |
---|---|
0 |
The content is safe for work |
1 |
The content is not safe for work |
Contains the artboards that are being used in the document. A document can have multiple artboards.
xmp:artboards
-
is optional
-
type: Artboard
-
defined in Asset
Array type: Artboard
All items must be of the type:
- Artboard –
https://ns.adobe.com/xdm/assets/artboard
The date and time the resource was created. It will be taken from within the asset.
xmp:createDate
- is optional
- type:
string
- defined in Asset
string
- format:
date-time
– date and time (according to RFC 3339, section 5.6)
Name of the application which authored the asset. It takes the value present in xmp:CreatorTool
property in XMP.
It is recommended that the value use this format convention:
Organization Software_name Version (token;token;...)
- Organization: The name of the company or organization providing the software, no SPACEs.
- Software_name: The full name of the software, SPACEs allowed.
- version: The version of the software, no SPACEs.
- tokens: Can be used to identify an operating system, plug-in, or more detailed version information.
xmp:creatorTool
- is optional
- type:
string
- defined in Asset
string
This is a list of fonts and typefaces that are used in the document. The order of fonts does not matter.
xmp:fonts
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
The keywords
property is used to track human-assigned descriptive phrases like keywords or tags of an asset. Rather than a plan list of tags, it is a structured set of keywords, where keywords can have an explicit importance ranking and a locale. This allows the management of multi-lingual keywords for a given asset. For machine-generated keywords, use the machineKeywords
property.
xmp:keywords
-
is optional
-
type:
array
-
defined in Asset
Array type: array
All items must be of the type: Unknown type ``.
{
"type": "array",
"title": "Keywords",
"items": {
"$schema": "http://json-schema.org/draft-06/schema#",
"title": "Keyword",
"description": "The `Keyword` schema describes a keyword in a list of keywords, with specific locale and importance relative to other keywords in the same list.",
"properties": {
"value": {
"title": "Value",
"description": "The keyword itself. A keyword can be considered like a tag, i.e. a short description of the content of the asset.",
"type": "string"
},
"localeCode": {
"type": "string",
"pattern": "^(((([A-Za-z]{2,3}(-([A-Za-z]{3}(-[A-Za-z]{3}){0,2}))?)|[A-Za-z]{4}|[A-Za-z]{5,8})(-([A-Za-z]{4}))?(-([A-Za-z]{2}|[0-9]{3}))?(-([A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(-([0-9A-WY-Za-wy-z](-[A-Za-z0-9]{2,8})+))*(-(x(-[A-Za-z0-9]{1,8})+))?)|(x(-[A-Za-z0-9]{1,8})+)|((en-GB-oed|i-ami|i-bnn|i-default|i-enochian|i-hak|i-klingon|i-lux|i-mingo|i-navajo|i-pwn|i-tao|i-tay|i-tsu|sgn-BE-FR|sgn-BE-NL|sgn-CH-DE)|(art-lojban|cel-gaulish|no-bok|no-nyn|zh-guoyu|zh-hakka|zh-min|zh-min-nan|zh-xiang)))$",
"description": "Language of the keyword. The locale code should follow [RFC BCP 47](https://tools.ietf.org/html/bcp47)",
"examples": [
"en-US",
"de-CH"
]
},
"importance": {
"type": "number",
"title": "Importance",
"minimum": 0,
"maximum": 1,
"description": "The importance of the keyword on a scale from zero to one. If required repository will infer it as per its policies and add it for the keywords"
}
},
"required": [
"value"
],
"simpletype": "complex"
},
"description": "The `keywords` property is used to track human-assigned descriptive phrases like keywords or tags of an asset. Rather than a plan list of tags, it is a structured set of keywords, where keywords can have an explicit importance ranking and a locale. This allows the management of multi-lingual keywords for a given asset. For machine-generated keywords, use the `machineKeywords` property. ",
"$oSchema": {
"$linkVal": "Asset",
"$linkPath": "asset.schema.md"
},
"simpletype": "`array`"
}
The Keyword
schema describes a keyword in a list of keywords, with specific locale and importance relative to other keywords in the same list.
xmp:layers
- is optional
- type: complex
- defined in Asset
Unknown type ``.
{
"properties": {
"xdm:name": {
"type": "string",
"title": "Name",
"description": "Name of the Layer Group. This will be visible to the user and users can specify names that can help them to identify different Layer Groups"
},
"xdm:layers": {
"name": "Layers",
"description": "The layers or layer groups contained in this layer group.",
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/definitions/layer-group"
},
{
"$ref": "https://ns.adobe.com/xdm/assets/layer#/definitions/layer"
}
]
}
}
},
"$oSchema": {
"$linkVal": "Asset",
"$linkPath": "asset.schema.md"
},
"simpletype": "complex"
}
The machineKeywords
property is used to track machine-assigned descriptive phrases like keywords or tags of an asset. Rather than a plan list of tags, it is a structured set of keywords, where keywords can have an explicit confidence ranking and a locale. For human-defined keywords, use the keywords
property.
xmp:machineKeywords
-
is optional
-
type:
object[]
-
defined in Asset
Array type: object[]
All items must be of the type:
object
with following properties:
Property | Type | Required |
---|---|---|
algorithm |
string | Optional |
confidence |
number | Optional |
localeCode |
string | Optional |
value |
string | Optional |
Name of the algorithm which generated the keyword.
algorithm
- is optional
- type:
string
string
Confidence of the algorithm that this keyword is applicable to the asset. Confidence values are numbers between zero and one. A value of .95 indicates that the algorithm expects less than 5% of all tags with the same confidence value to be mis-applied, i.e. not to be a proper description of the asset.
confidence
- is optional
- type:
number
number
- minimum value:
0
- maximum value:
1
Language of the keyword. The locale code should follow RFC BCP47
localeCode
- is optional
- type:
string
string
All instances must conform to this regular expression (test examples here):
^(((([A-Za-z]{2,3}(-([A-Za-z]{3}(-[A-Za-z]{3}){0,2}))?)|[A-Za-z]{4}|[A-Za-z]{5,8})(-([A-Za-z]{4}))?(-([A-Za-z]{2}|[0-9]{3}))?(-([A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*(-([0-9A-WY-Za-wy-z](-[A-Za-z0-9]{2,8})+))*(-(x(-[A-Za-z0-9]{1,8})+))?)|(x(-[A-Za-z0-9]{1,8})+)|((en-GB-oed|i-ami|i-bnn|i-default|i-enochian|i-hak|i-klingon|i-lux|i-mingo|i-navajo|i-pwn|i-tao|i-tay|i-tsu|sgn-BE-FR|sgn-BE-NL|sgn-CH-DE)|(art-lojban|cel-gaulish|no-bok|no-nyn|zh-guoyu|zh-hakka|zh-min|zh-min-nan|zh-xiang)))$
The keyword itself. A keyword can be considered like a tag, i.e. a short description of the content of the asset.
value
- is optional
- type:
string
string
The date and time when asset was last modified. The Date Time property should conform to ISO 8601 standard. An example form is "2004-10-23T12:00:00-06:00". Opposed to repositoryLastModifiedDate
, this is the time when the asset was last modified locally, with or without knowledge of the repository.
xmp:modifyDate
- is optional
- type:
string
- defined in Asset
string
- format:
date-time
– date and time (according to RFC 3339, section 5.6)
A user-assigned editable rating for this file. The value shall be -1 or in the range [0..5], where -1 indicates “rejected” and 0 indicates “unrated”. If xmp:Rating is not present, a value of 0 should be assumed. NOTE: Anticipated usage is for a typical “star rating” UI, with the addition of a notion of rejection.
xmp:rating
- is optional
- type:
enum
- defined in Asset
The value of this property must be equal to one of the known values below.
Value | Description |
---|---|
0 |
|
1 |
⭑ |
2 |
⭑⭑ |
3 |
⭑⭑⭑ |
4 |
⭑⭑⭑⭑ |
5 |
⭑⭑⭑⭑⭑ |
-1 |
rejected |
The video frame rate in frames per second (FPS). Predefined values include:
-24
-NTSC
-PAL
Other values must include f
and the integer value of the frame rate. Optionally, s
and the integer value of the rate basis may be included.
These examples show common video and audio frame rates:
- Film at 24 fps (frame rate = 24, rate basis = 1):
f24
- Speech-to-text in milliseconds (frame rate = 1000, rate basis = 1):
f1000
- NTSC at 29.97 fps (frame rate = 30000, rate basis = 1001):
f30000s1001
xmpDM:videoFrameRate
- is optional
- type:
string
- defined in this schema
string
All instances must conform to this regular expression (test examples here):
((f\d+(s\d+)?)|PAL|NTSC|24)
High-level actions that resulted in the creation of this asset. It is intended to give human readers a description of the steps taken to make the changes from the previous version to this one. The list should be at an abstract level; it is not intended to be an exhaustive keystroke or other detailed history. The description should be sufficient for metadata management, as well as for workflow enhancement.
xmpMM:history
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
A URI identifying the managed resource to the asset management system; the presence of this property is the formal indication that this resource is managed. The form and content of this URI is private to the asset management system.
xmpMM:manageTo
- is optional
- type:
string
- defined in Asset
string
- format:
uri
– Uniformous Resource Identifier (according to RFC3986)
A URI that can be used to access information about the managed resource through a web browser.
xmpMM:manageUI
- is optional
- type:
string
- defined in Asset
string
- format:
uri
– Uniformous Resource Identifier (according to RFC3986)
When true, indicates that this is a rights-managed resource. When false, indicates that this is a public-domain resource. Omit if the state is unknown.
xmpRights:marked
- is optional
- type:
boolean
- defined in Asset
boolean
A collection of text instructions on how a resource can be legally used, given in a variety of languages.
xmpRights:usageTerms
-
is optional
-
type: reference
-
defined in Asset
Array type: reference
All items must be of the type:
A Web URL for a statement of the ownership and usage rights for this resource. This is a normal (non-URI) simple value because of historical usage.
xmpRights:webStatement
- is optional
- type:
string
- defined in Asset
string
"http://creativecommons.org/licenses/by/4.0/"
The number of pages in the document (including any in contained documents).
xmpTPg:NPages
- is optional
- type:
integer
- defined in Asset
integer
- minimum value:
0