node-taglib-sharp / Exports / AsfTag

Class: AsfTag

This class extends Tag to provide a representation of an ASF tag which can be read from and written to disk.

Hierarchy

Tag

↳ AsfTag

Accessors

Methods

Accessors

album

• get album(): string

Gets the album of the media represented by the current instance. For video media, this represents the collection the video belongs to.

This field represents the name of the album the media belongs to. In the case of a boxed set, it should be the name of the entire set rather than the individual disc. In the case of a series, this should be the name of the series, rather than the season of a series.

For example, "Kintsugi" (an album by Death Cab for Cutie), "The Complete Red Green Show" (a boxed set of TV episodes), or "Shark Tank" (a series with several seasons).

Remarks

Stored in the WM/AlbumTitle or Album descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-albumtitle

Returns

string

Overrides

Tag.album

• set album(value): void

Sets the album of the media represented by the current instance. For video media, this represents the collection the video belongs to.

For example, "Kintsugi" (an album by Death Cab for Cutie), "The Complete Red Green Show" (a boxed set of TV episodes), or "Shark Tank" (a series with several seasons).

Remarks

Stored in the WM/AlbumTitle or Album descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-albumtitle

Parameters

Name	Type	Description
`value`	`string`	of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.album

albumArtists

• get albumArtists(): string[]

Gets the band or artist who is credited in the creation of the entire album or collection containing the media described by the current instance.

This field is typically optional but aids in the sorting of compilations or albums with multiple artist. For example, if an album has several artists, sorting by artist will split up albums by the same artist. Having a single album artist for an entire album solves this problem. As this value is to be used as a sorting key, it should be used with less variation than performers. Where performers can be broken into multiple artists, it is best to stick to a single name. Eg, "Super8 & Tab"

Remarks

Stored in the WM/AlbumArtist or AlbumArtist descriptors

Returns

string[]

Overrides

Tag.albumArtists

• set albumArtists(value): void

Sets the bands or artists who are credited in the creation of the entire album or collection containing the media described by the current instance.

Remarks

Stored in the WM/AlbumArtist or AlbumArtist descriptors

Parameters

Name	Type	Description
`value`	`string`[]	Band or artist credited with the creation of the entire album or collection containing the media described by the current instance or an empty array if no value is present

Returns

void

Overrides

Tag.albumArtists

albumArtistsSort

• get albumArtistsSort(): string[]

Gets the sortable names of the bands/artists who are credited with creating the entire album or collection containing the media described by the current instance. See also: albumArtists

This is used to provide more control over how the media is sorted. Typical uses are to skip articles or sort by last name. For example "Ben Folds" might be sorted as "Folds, Ben". As this value is to be used as a sorting key, it should be used with less variation than performers. Where performers can be broken into multiple performers, it is best to stick to a single album artist. Eg, "Van Buuren, Armin"

Remarks

Stored in the WM/AlbumArtistSortOrder descriptor http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Returns

string[]

Overrides

Tag.albumArtistsSort

• set albumArtistsSort(value): void

Sets the sortable names of the bands/artists who are credited with creating the entire album or collection containing the media described by the current instance. See also: albumArtists

Remarks

Stored in the WM/AlbumArtistSortOrder descriptor http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Parameters

Name	Type	Description
`value`	`string`[]	Sortable names for the bands/artists are credited with the creation of the entire album or collection containing the media described by the current instance, or an empty array if no value is present.

Returns

void

Overrides

Tag.albumArtistsSort

albumSort

• get albumSort(): string

Gets the sortable name of the album title of the media represented by the current instance. See also: album

This field is typically optional but aids in sort of compilations or albums with similar titles.

Remarks

Stored in the WM/AlbumSortOrder descriptors

Returns

string

Overrides

Tag.albumSort

• set albumSort(value): void

Sets the sortable name of the album title of the media represented by the current instance. See also: album

This field is typically optional but aids in sort of compilations or albums with similar titles.

Remarks

Stored in the WM/AlbumSortOrder descriptors

Parameters

Name	Type	Description
`value`	`string`	Sortable name for the album title of the media or `undefined` if the value is not present

Returns

void

Overrides

Tag.albumSort

amazonId

• get amazonId(): string

Gets the Amazon ID of the media represented by the current instance.

This field represents the AmazonID, also called the ASIN, and is used to uniquely identify the particular track or album in the Amazon catalog.

Returns

string

Amazon ID of the media represented by the current instance or undefined if no value is present

Inherited from

Tag.amazonId

• set amazonId(value): void

Sets the Amazon ID of the media represented by the current instance.

This field represents the AmazonID, also called the ASIN, and is used to uniquely identify the particular track or album in the Amazon catalog.

Parameters

Name	Type	Description
`value`	`string`	Amazon ID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Inherited from

Tag.amazonId

beatsPerMinute

• get beatsPerMinute(): number

Gets the number of beats per minute in the audio of the media represented by the current instance.

This field is useful for DJ's who are trying to beat match tracks. It should be calculated from the audio or pulled from a database.

Remarks

Stored in the WM/BeatsPerMinute descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-beatsperminute

Returns

number

Overrides

Tag.beatsPerMinute

• set beatsPerMinute(value): void

Sets the number of beats per minute in the audio of the media represented by the current instance.

This field is useful for DJ's who are trying to beat match tracks. It should be calculated from the audio or pulled from a database.

Remarks

Stored in the WM/BeatsPerMinute descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-beatsperminute

Parameters

Name	Type	Description
`value`	`number`	Beats per minute of the audio in the media represented by the current instance, or `0` if not specified

Returns

void

Overrides

Tag.beatsPerMinute

comment

• get comment(): string

Gets a user comment on the media represented by the current instance.

This field should be used to store user notes and comments. There is no constraint on what text can be stored here, but it should not contain programmatic data. Because this field contains notes the user might think of while consuming the media, it may be useful for an application to make this field easily accessible, perhaps even including it in the main interface.

Remarks

Stored in the WM/Text descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-text It should be noted that many applications store comments in the field read by description.

Returns

string

Overrides

Tag.comment

• set comment(value): void

Sets a user comment on the media represented by the current instance.

Remarks

Stored in the WM/Text descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-text It should be noted that many applications store comments in the field read by description.

Parameters

Name	Type	Description
`value`	`string`	User comments on the media represented by the current instance or `undefined` if the value is not present

Returns

void

Overrides

Tag.comment

composers

• get composers(): string[]

Gets the composers of the media represented by the current instance.

This field represents the composers, songwriters, scriptwriters, or persons who claim authorship of the media.

Remarks

Stored in the WM/Composer or Composer descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-composer

Returns

string[]

Overrides

Tag.composers

• set composers(value): void

Sets the composers of the media represented by the current instance.

This field represents the composers, songwriters, scriptwriters, or persons who claim authorship of the media.

Remarks

Stored in the WM/Composer or Composer descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-composer

Parameters

Name	Type	Description
`value`	`string`[]	Composers of the media represented by the current instance of an empty array if no value is present.

Returns

void

Overrides

Tag.composers

composersSort

• get composersSort(): string[]

Gets the sortable names of the composers of the media represented by the current instance. See also: composers

This field is typically optional but aids in the sorting of compilations or albums with multiple composers.

Returns

string[]

Sortable names for the composers of the media represented by the current instance or an empty array if no value is present.

Inherited from

Tag.composersSort

• set composersSort(value): void

Sets the sortable names of the composers of the media represented by the current instance. See also: composers

This field is typically optional but aids in the sorting of compilations or albums with multiple composers.

Parameters

Name	Type	Description
`value`	`string`[]	Sortable names for the composers of the media represented by the current instance or an empty array if no value is present.

Returns

void

Inherited from

Tag.composersSort

conductor

• get conductor(): string

Gets the conductor or director of the media represented by the current instance.

This field is most useful for organizing classical music and movies.

Remarks

Stored in the WM/Conductor descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-conductor

Returns

string

Overrides

Tag.conductor

• set conductor(value): void

Sets the conductor or director of the media represented by the current instance.

This field is most useful for organizing classical music and movies.

Remarks

Stored in the WM/Conductor descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-conductor

Parameters

Name	Type	Description
`value`	`string`	Conductor or director of the media represented by the current instance or `undefined` if no value present.

Returns

void

Overrides

Tag.conductor

contentDescriptionObject

• get contentDescriptionObject(): AsfContentDescriptionObject

Gets the ASF content description object used by the current instance.

Returns

AsfContentDescriptionObject

copyright

• get copyright(): string

Gets the copyright information for the media represented by the current instance.

This field should be used for storing copyright information. It may be useful to show this information somewhere in the program while the media is playing. Players should not support editing this field, but media creation tools should definitely allow modification.

Remarks

Stored in the ContentDescriptionObject.copyright

Returns

string

Overrides

Tag.copyright

• set copyright(value): void

Sets the copyright information for the media represented by the current instance.

Remarks

Stored in the ContentDescriptionObject.copyright

Parameters

Name	Type	Description
`value`	`string`	Copyright information for the media represented by the current instance or `undefined` if no value is present.

Returns

void

Overrides

Tag.copyright

dateTagged

• get dateTagged(): Date

Gets the date and time at which the tag has been written.

Returns

Date

Date/time at which the tag has been written, or undefined if no value is present

Inherited from

Tag.dateTagged

• set dateTagged(value): void

Sets the date and time at which the tag has been written.

Parameters

Name	Type	Description
`value`	`Date`	Date/time at which the tag has been written, or `undefined` if no value is present

Returns

void

Inherited from

Tag.dateTagged

description

• get description(): string

Gets a short description of the media. For music, this could be the comment that the artist made of his/her work. For a video, this should be a short summary of the story/plot, but generally no spoliers. This should give the impression of what to expect in the media.

This is especially relevant for a movie. For example, for "Fear and Loathing in Las Vegas", this could be "An oddball journalist and his psychopathic lawyer travel to Las Vegas for a series of psychedelic escapades."

Remarks

Stored in the ContentDescriptionObject.description Some applications will use this field for storing comments.

Returns

string

Overrides

Tag.description

• set description(value): void

Sets a short description of the media. For music, this could be the comment that the artist made of his/her work. For a video, this should be a short summary of the story/plot, but generally no spoliers. This should give the impression of what to expect in the media.

Remarks

Stored in the ContentDescriptionObject.description Some applications will use this field for storing comments.

Parameters

Name	Type	Description
`value`	`string`	Description of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.description

disc

• get disc(): number

Gets the number of the disc containing the media represented by the current instance in the boxed set. For a series, this represents the season number.

This value should be the same as the number that appears on the disc. For example, if the disc is the first of three, the value should be 1. It should be no more than discCount if discCount is non-zero.

Remarks

Stored in the WM/PartOfSet descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-partofset

Returns

number

Overrides

Tag.disc

• set disc(value): void

Sets the number of the disc containing the media represented by the current instance in the boxed set. For a series, this represents the season number.

Remarks

Stored in the WM/PartOfSet descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-partofset

Parameters

Name	Type	Description
`value`	`number`	Number of the disc or season of the media represented by the current instance in a boxed set.

Returns

void

Overrides

Tag.disc

discCount

• get discCount(): number

Gets the number of discs or seasons in the boxed set containing the media represented by the current instance.

If non-zero, this should be at least equal to disc. If disc is zero, this value should also be zero.

Remarks

Stored in the WM/PartOfSet descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-partofset

Returns

number

Overrides

Tag.discCount

• set discCount(value): void

Sets the number of discs or seasons in the boxed set containing the media represented by the current instance.

If non-zero, this should be at least equal to disc. If disc is zero, this value should also be zero.

Remarks

Stored in the WM/PartOfSet descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-partofset

Parameters

Name	Type	Description
`value`	`number`	Number of discs or seasons in the boxed set containing the media represented by the current instance or `0` if not specified.

Returns

void

Overrides

Tag.discCount

extendedContentDescriptionObject

This field represents genres that apply to the song, album, or video. This is often used for filtering media. A list of common audio genres as popularized by ID3v1 is stored in genres.ts. Additionally, genres.ts contains video genres as used by DivX.

Remarks

Stored in the WM/Genre, WM/GenreID, or Genre descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-genre https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-genreid

Returns

string[]

Overrides

Tag.genres

• set genres(value): void

Sets the genres of the media represented by the current instance.

This field represents genres that apply to the song, album, or video. This is often used for filtering media. A list of common audio genres as popularized by ID3v1 is stored in genres.ts. Additionally, genres.ts` contains video genres as used by DivX.

Remarks

Stored in the WM/Genre, WM/GenreID, or Genre descriptors https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-genre https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-genreid

Parameters

Name	Type	Description
`value`	`string`[]	Genres of the media represented by the current instance or an empty array if no value is present.

Returns

void

Overrides

Tag.genres

grouping

• get grouping(): string

Gets the grouping on the album which the media in the current instance belongs to.

This field contains a non-physical group to which the track belongs. In classical music this could be a movement. It could also be parts of a series like "Introduction", "Closing Remarks", etc.

Remarks

Stored in the WM/ContentGroupDescription descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-contentgroupdescription

Returns

string

Overrides

Tag.grouping

• set grouping(value): void

Sets the grouping on the album which the media in the current instance belongs to.

This field contains a non-physical group to which the track belongs. In classical music this could be a movement. It could also be parts of a series like "Introduction", "Closing Remarks", etc.

Remarks

Stored in the WM/ContentGroupDescription descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-contentgroupdescription

Parameters

Name	Type	Description
`value`	`string`	Grouping on the album which the media in the current instance belongs to or `undefined` if no value is present.

Returns

void

Overrides

Tag.grouping

initialKey

• get initialKey(): string

Gets the initial key of the track.

Returns

string

Initial key of the track or undefined if no value is set

Inherited from

Tag.initialKey

• set initialKey(value): void

Sets the initial key of the track.

Parameters

Name	Type	Description
`value`	`string`	Initial key of the track or `undefined` if no value is set

Returns

void

Inherited from

Tag.initialKey

isCompilation

• get isCompilation(): boolean

Gets whether the album described by the current instance is a compilation.

Returns

boolean

Inherited from

Tag.isCompilation

• set isCompilation(value): void

Gets whether the album described by the current instance is a compilation.

Parameters

Name	Type	Description
`value`	`boolean`	Whether the album described by the current instance is a compilation

Returns

void

Inherited from

Tag.isCompilation

isEmpty

• get isEmpty(): boolean

Gets whether the current instance is empty.

Returns

boolean

Overrides

Tag.isEmpty

isrc

• get isrc(): string

Gets the ISRC (International Standard Recording Code) of the track.

Returns

string

ISRC of the track or undefined if no value is set

Inherited from

Tag.isrc

• set isrc(value): void

Sets the ISRC (International Standard Recording Code) of the track.

Parameters

Name	Type	Description
`value`	`string`	ISRC of the track or `undefined` if no value is set

This field contains a plain text representation of the lyrics or scripts with line breaks and whitespace being the only formatting marks. Some formats support more advanced lyrics, like synchronized lyrics, but those must be accessed using format-specific implementations.

Remarks

Stored in the WM/Lyrics descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-lyrics

Returns

string

Overrides

Tag.lyrics

• set lyrics(value): void

Sets the lyrics or script of the media represented by the current instance.

Remarks

Stored in the WM/Lyrics descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-lyrics

Parameters

Name	Type	Description
`value`	`string`	Lyrics or script of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.lyrics

metadataLibraryObject

• get metadataLibraryObject(): AsfMetadataLibraryObject

Gets the ASF metadata library object used by the current instance.

Returns

AsfMetadataLibraryObject

musicBrainzAlbumArtistId

• get musicBrainzAlbumArtistId(): string

Inherit Doc

Remarks

Stored in the MusicBrainz/Album Artist Id descriptor

Returns

string

• set musicBrainzAlbumArtistId(value): void

Inherit Doc

Remarks

Stored in the MusicBrainz/Artist Id descriptor

Parameters

Name	Type
`value`	`string`

Returns

void

musicBrainzArtistId

• get musicBrainzArtistId(): string

Gets the MusicBrainz artist ID of the media represented by the current instance.

This field represents the MusicBrainz ArtistID, and is used to uniquely identify a particular artist of the track.

Remarks

Stored in the MusicBrainz/Artist Id descriptor

Returns

string

Overrides

Tag.musicBrainzArtistId

• set musicBrainzArtistId(value): void

Sets the MusicBrainz artist ID of the media represented by the current instance.

This field represents the MusicBrainz ArtistID, and is used to uniquely identify a particular artist of the track.

Remarks

Stored in the MusicBrainz/Artist Id descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ArtistID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzArtistId

musicBrainzDiscId

• get musicBrainzDiscId(): string

Gets the MusicBrainz disc ID of the media represented by the current instance.

This field represents the MusicBrainz DiscID and is used to uniquely identify the particular released media associated with this track.

Remarks

Stored in the MusicBrainz/Disc Id descriptor

Returns

string

Overrides

Tag.musicBrainzDiscId

• set musicBrainzDiscId(value): void

Sets the MusicBrainz disc ID of the media represented by the current instance.

This field represents the MusicBrainz DiscID and is used to uniquely identify the particular released media associated with this track.

Remarks

Stored in the MusicBrainz/Disc Id descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz DiscID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzDiscId

musicBrainzReleaseArtistId

• get musicBrainzReleaseArtistId(): string

Gets the MusicBrainz release artist ID of the media represented by the current instance.

This field represents the MusicBrainz ReleaseArtistID, and is used to uniquely identify a particular album artist credited with the album.

Returns

string

MusicBrainz ReleaseArtistID of the media represented by the current instance or undefined if no value is present

Inherited from

Tag.musicBrainzReleaseArtistId

• set musicBrainzReleaseArtistId(value): void

Sets the MusicBrainz release artist ID of the media represented by the current instance.

This field represents the MusicBrainz ReleaseArtistID, and is used to uniquely identify a particular album artist credited with the album.

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ReleaseArtistID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Inherited from

Tag.musicBrainzReleaseArtistId

musicBrainzReleaseCountry

• get musicBrainzReleaseCountry(): string

Gets the MusicBrainz release country of the media represented by the current instance.

This field represents the MusicBrainz ReleaseCountry which describes the country in which an album was released. Note that the release country of an album is not necessarily the country in which it was produced. The label itself will typically be more relevant. Eg, a release on "Foo Records UK" that has "Made in Austria" printed on it will likely be a UK release.

Remarks

Stored in the MusicBrainz/Album Release Country descriptor

Returns

string

Overrides

Tag.musicBrainzReleaseCountry

• set musicBrainzReleaseCountry(value): void

Sets the MusicBrainz release country of the media represented by the current instance.

Remarks

Stored in the MusicBrainz/Album Release Country descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ReleaseCountry of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzReleaseCountry

musicBrainzReleaseGroupId

• get musicBrainzReleaseGroupId(): string

Gets the MusicBrainz release group ID of the media represented by the current instance.

This field represents the MusicBrainz ReleaseGroupID and is used to uniquely identify a particular release group to which this track belongs.

Remarks

Stored in the MusicBrainz/Release Group Id descriptor

Returns

string

Overrides

Tag.musicBrainzReleaseGroupId

• set musicBrainzReleaseGroupId(value): void

Sets the MusicBrainz release group ID of the media represented by the current instance.

This field represents the MusicBrainz ReleaseGroupID and is used to uniquely identify a particular release group to which this track belongs.

Remarks

Stored in the MusicBrainz/Release Group Id descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ReleaseGroupID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzReleaseGroupId

musicBrainzReleaseId

• get musicBrainzReleaseId(): string

Gets the MusicBrainz release ID of the media represented by the current instance.

This field represents the MusicBrains ReleaseID and is used to uniquely identify a particular release to which this track belongs.

Remarks

Stored in the MusicBrainz/Album Id descriptor

Returns

string

Overrides

Tag.musicBrainzReleaseId

• set musicBrainzReleaseId(value): void

Sets the MusicBrainz release ID of the media represented by the current instance.

This field represents the MusicBrains ReleaseID and is used to uniquely identify a particular release to which this track belongs.

Remarks

Stored in the MusicBrainz/Album Id descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ReleaseID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzReleaseId

musicBrainzReleaseStatus

• get musicBrainzReleaseStatus(): string

Gets the MusicBrainz release status of the media represented by the current instance.

This field represents the MusicBrainz ReleaseStatus used to describe how 'official' a release is. Common statuses are: Official, Promotion, Bootleg, Pseudo-release.

Remarks

Stored in the MusicBrainz/Album Status descriptor

Returns

string

Overrides

Tag.musicBrainzReleaseStatus

• set musicBrainzReleaseStatus(value): void

Sets the MusicBrainz release status of the media represented by the current instance.

This field represents the MusicBrainz ReleaseStatus used to describe how 'official' a release is. Common statuses are: Official, Promotion, Bootleg, Pseudo-release.

Remarks

Stored in the MusicBrainz/Album Status descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz ReleaseStatus of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzReleaseStatus

musicBrainzReleaseType

• get musicBrainzReleaseType(): string

Gets the MusicBrainz release type of the media represented by the current instance.

This field represents the MusicBrainz ReleaseType that describes what kind of release a release is. Common types are: Single, Album, EP, Compilation, Soundtrack, SpokenWord, Interview, Audiobook, Live, Remix, and Other`. Careful thought must be given when using this field to decide if a particular track "is a compilation".

@returns MusicBrainz ReleaseType of the media represented by the current instance or undefined if no value is present

Remarks

Stored in the MusicBrainz/Album Type descriptor

Returns

string

Overrides

Tag.musicBrainzReleaseType

• set musicBrainzReleaseType(value): void

Sets the MusicBrainz release type of the media represented by the current instance.

@param value MusicBrainz ReleaseType of the media represented by the current instance or undefined if no value is present

Remarks

Stored in the MusicBrainz/Album Type descriptor

Parameters

Name	Type
`value`	`string`

Returns

void

Overrides

Tag.musicBrainzReleaseType

musicBrainzTrackId

• get musicBrainzTrackId(): string

Gets the MusicBrainz track ID of the media represented by the media represented by the current instance.

This field represents the MusicBrainz TrackID and is used to uniquely identify a particular track.

Remarks

Stored in the MusicBrainz/Track Id descriptor

Returns

string

Overrides

Tag.musicBrainzTrackId

• set musicBrainzTrackId(value): void

Sets the MusicBrainz track ID of the media represented by the media represented by the current instance.

This field represents the MusicBrainz TrackID and is used to uniquely identify a particular track.

Remarks

Stored in the MusicBrainz/Track Id descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicBrainz TrackID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicBrainzTrackId

musicIpId

• get musicIpId(): string

Gets the MusicIP PUID of the media represented by the current instance.

This field represents the MusicIP PUID, an acoustic fingerprint identifier. It identifies wht this track "sounds like".

Remarks

Stored in the MusicIP/PUID descriptor

Returns

string

Overrides

Tag.musicIpId

• set musicIpId(value): void

Sets the MusicIP PUID of the media represented by the current instance.

This field represents the MusicIP PUID, an acoustic fingerprint identifier. It identifies wht this track "sounds like".

Remarks

Stored in the MusicIP/PUID descriptor

Parameters

Name	Type	Description
`value`	`string`	MusicIP PUID of the media represented by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.musicIpId

performers

• get performers(): string[]

Gets the performers or artists who performed in the media described by the current instance.

This field is most commonly called "Artists" in audio media or "Actors" in video media, and should be used to represent each artist/actor appearing in the media. It can be simple in the form of "Above & Beyond" or more complicated in the form of "Jono Grant, Tony McGuinness, Paavo Siljamäki", depending on the preferences of the user and the degree to which they organize their media collection. As the preference of the user may vary, applications should avoid limiting the user in what constitutes the performers field - especially in regard to number of performers.

Remarks

Stored in the ContentDescriptionObject.author

Returns

string[]

Overrides

Tag.performers

• set performers(value): void

Sets the performers or artists who performed in the media described by the current instance.

Remarks

Stored in the ContentDescriptionObject.author

Parameters

Name	Type	Description
`value`	`string`[]	Performers who performed in the media described by the current instance or an empty array if no value is present.

Returns

void

Overrides

Tag.performers

performersRole

• get performersRole(): string[]

Gets the characters portrayed by an actor for a video or instruments played by a musician for music. This must match the performers array (for each person, correspond one/more role). Several roles for the same artist/actor can be separated with semicolons. For example: "Bass; Backing Vocals; Vibraphone".

It is highly important to match each role to the performers. This means that an entry in the performersRole array is undefined to maintain the relationship between performers[i] and performersRole[i].

Returns

string[]

Array containing the roles played by the performers in the media described by the current instance, or an empty array if no value is present.

Inherited from

Tag.performersRole

• set performersRole(value): void

Sets the characters portrayed by an actor for a video or instruments played by a musician for music. This must match the performers array (for each person, correspond one/more role). Several roles for the same artist/actor can be separated with semicolons. For example: "Bass; Backing Vocals; Vibraphone".

Parameters

Name	Type	Description
`value`	`string`[]	Array containing the roles played by the performers in the media described by the current instance, or an empty array if no value is present.

Returns

void

Inherited from

Tag.performersRole

performersSort

• get performersSort(): string[]

Gets the sortable names of the performers or artists who performed in the media described by the current instance.

This is used to provide more control over how the media is sorted. Typical uses are to skip articles or sort by last name. For example, "The Pillows" might be sorted as "Pillows, The". See also: performers

Remarks

Stored in the WM/ArtistSortOrder descriptor http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Returns

string[]

Overrides

Tag.performersSort

• set performersSort(value): void

Gets the sortable names of the performers or artists who performed in the media described by the current instance.

Remarks

Stored in the WM/ArtistSortOrder descriptor http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Parameters

Name	Type	Description
`value`	`string`[]	Sortable names for the performers who performed in the media described by the current instance, or an empty array if no value is present.

Returns

void

Overrides

Tag.performersSort

pictures

• get pictures(): IPicture[]

Gets a collection of pictures associated with the media represented by the current instance.

Typically, this value is used to store an album cover or icon to use for the file, but it is capable of holding any type of image or file, including pictures of the band, the recording studio, the concert, etc.

Remarks

Stored in the WM/Picture content descriptor and description record. https://docs.microsoft.com/en-us/windows/win32/wmformat/wmpicture Modifications to the returned array will not be stored.

Returns

IPicture[]

Overrides

Tag.pictures

• set pictures(value): void

Sets a collection of pictures associated with the media represented by the current instance.

Remarks

Stored in the WM/Picture content descriptor and description record. https://docs.microsoft.com/en-us/windows/win32/wmformat/wmpicture

Parameters

Name	Type	Description
`value`	`IPicture`[]	Array containing a collection of pictures associated with the media represented by the current instance or an empty array if no pictures are present.

Returns

void

Overrides

Tag.pictures

publisher

• get publisher(): string

Gets the publisher of the track.

Returns

string

Publisher of the track or undefined if no value is set

Inherited from

Tag.publisher

• set publisher(value): void

Sets the publisher of the track.

Parameters

Name	Type	Description
`value`	`string`	Publisher of the track or `undefined` if no value is set

Returns

void

Inherited from

Tag.publisher

remixedBy

• get remixedBy(): string

Gets the remixer of the track.

Returns

string

Remixer of the track or undefined if no value is set

Inherited from

Tag.remixedBy

• set remixedBy(value): void

Sets the remixer of the track.

Parameters

Name	Type	Description
`value`	`string`	Remixer of the track or `undefined` if no value is set

Returns

void

Inherited from

Tag.remixedBy

replayGainAlbumGain

• get replayGainAlbumGain(): number

Gets the ReplayGain album gain in dB.

Remarks

Stored in the ReplayGain/Album descriptor

Returns

number

Overrides

Tag.replayGainAlbumGain

• set replayGainAlbumGain(value): void

Sets the ReplayGain album gain in dB.

Remarks

Stored in the ReplayGain/Album descriptor

Parameters

Name	Type	Description
`value`	`number`	Album gain as per the ReplayGain specifications, in dB, or `NaN` if no value is set

Returns

void

Overrides

Tag.replayGainAlbumGain

replayGainAlbumPeak

• get replayGainAlbumPeak(): number

Gets the ReplayGain album peak sample.

Remarks

Stored in the ReplayGain/Album Peak descriptor

Returns

number

Overrides

Tag.replayGainAlbumPeak

• set replayGainAlbumPeak(value): void

Sets the ReplayGain album peak sample.

Remarks

Stored in the ReplayGain/Album Peak descriptor

Parameters

Name	Type	Description
`value`	`number`	Album peak as per the ReplayGain specifications, or `NaN` if no value is set

Returns

void

Overrides

Tag.replayGainAlbumPeak

replayGainTrackGain

• get replayGainTrackGain(): number

Gets the ReplayGain track gain in dB.

Remarks

Stored in the ReplayGain/Track descriptor

Returns

number

Overrides

Tag.replayGainTrackGain

• set replayGainTrackGain(value): void

Sets the ReplayGain track gain in dB.

Remarks

Stored in the ReplayGain/Track descriptor

Parameters

Name	Type	Description
`value`	`number`	Track gain as per ReplayGain specifications, in dB, or `NaN` if no value is set

Returns

void

Overrides

Tag.replayGainTrackGain

replayGainTrackPeak

• get replayGainTrackPeak(): number

Gets the ReplayGain track peak sample.

Remarks

Stored in the ReplayGain/Track Peak descriptor

Returns

number

Overrides

Tag.replayGainTrackPeak

• set replayGainTrackPeak(value): void

Sets the ReplayGain track peak sample.

Remarks

Stored in the ReplayGain/Track Peak descriptor

Parameters

Name	Type	Description
`value`	`number`	Track peak as per the ReplayGain specifications, or `NaN` if no value is set

Returns

void

Overrides

Tag.replayGainTrackPeak

sizeOnDisk

• get sizeOnDisk(): number

Gets the size of the tag in bytes on disk as it was read from disk.

Returns

number

Overrides

Tag.sizeOnDisk

subtitle

• get subtitle(): string

Gets a description, one-line. It represents the tagline of the vide/music.

This field gives a nice/short precision to the title, which is typically below the title on the front cover of the media. For example for "Ocean's 13", this would be "Revenge is a funny thing".

Remarks

Stored in the WM/SubTitle descriptor https://msdn.microsoft.com/en-us/library/windows/desktop/dd757997(v=vs.85).aspx

Returns

string

Overrides

Tag.subtitle

• set subtitle(value): void

Sets a description, one-line. It represents the tagline of the vide/music.

This field gives a nice/short precision to the title, which is typically below the title on the front cover of the media. For example for "Ocean's 13", this would be "Revenge is a funny thing".

Remarks

Stored in the WM/SubTitle descriptor https://msdn.microsoft.com/en-us/library/windows/desktop/dd757997(v=vs.85).aspx

Parameters

Name	Type	Description
`value`	`string`	Subtitle of the media represented by the current instance or `undefined` if no value is present

Sets the title for the media described by the current instance.

The title is most commonly the name of the song, episode or a movie title. For example "Time Won't Me Go" (a song by The Bravery), "Three Stories" (an episode of House MD), or "Fear and Loathing In Las Vegas" (a movie).

Remarks

Stored in the content description object

Parameters

Name	Type	Description
`value`	`string`	Title of the media described by the current instance or `undefined` if no value is present.

Returns

void

Overrides

Tag.title

titleSort

• get titleSort(): string

Gets the sortable name for the title of the media described by the current instance.

Possibly used to sort compilations or episodic content.

Remarks

Stored in the WM/TitleSortOrder http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Returns

string

Overrides

Tag.titleSort

• set titleSort(value): void

Sets the sortable name for the title of the media described by the current instance.

Possibly used to sort compilations or episodic content.

Remarks

Stored in the WM/TitleSortOrder http://msdn.microsoft.com/en-us/library/aa386866(VS.85).aspx

Parameters

Name	Type	Description
`value`	`string`	Sortable name of the media described by the current instance or `undefined` if no value is present

Returns

void

Overrides

Tag.titleSort

track

• get track(): number

Gets the position of the media represented by the current instance in its containing album or season (for a series).

This value should be the same as is listed on the album cover and no more than trackCount, if trackCount is non-zero. Most tagging formats store this as a string. To help sorting, a two-digit zero-padded value is used in the resulting tag. For a series, this property represents the episodes in a season of the series.

Remarks

Stored in the WM/TrackNumber descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-tracknumber

Returns

number

Overrides

Tag.track

• set track(value): void

Sets the position of the media represented by the current instance in its containing album or season (for a series).

Remarks

Stored in the WM/TrackNumber descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-tracknumber

Parameters

Name	Type	Description
`value`	`number`	Position of the media represented by the current instance in its containing album or `0` if not specified.

Returns

void

Overrides

Tag.track

trackCount

• get trackCount(): number

Gets the number of tracks on the album or the number of episodes in a series of the media represented by the current instance.

If non-zero, this value should be equal to or greater than track. If track is 0, this value should also be 0.

Remarks

Stored in the TrackTotal descriptor

Returns

number

Overrides

Tag.trackCount

• set trackCount(value): void

Sets the number of tracks on the album or the number of episodes in a series of the media represented by the current instance.

If non-zero, this value should be equal to or greater than track. If track is 0, this value should also be 0.

Remarks

Stored in the TrackTotal descriptor

Parameters

Name	Type	Description
`value`	`number`	Number of tracks on the album or number of episodes in a series of the media represented by the current instance or `0` if not specified.

Returns

void

Overrides

Tag.trackCount

year

• get year(): number

Gets the year that the media represented by the current instance was recorded.

Years greater than 9999 cannot be stored by most tagging formats and will be cleared if a higher value is set. Some tagging formats store higher precision dates which will be truncated when this property is set. Format specific implementations are necessary to access the higher precision values.

Remarks

Stored in the WM/Year descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-year

Returns

number

Overrides

Tag.year

• set year(value): void

Sets the year that the media represented by the current instance was recorded.

Remarks

Stored in the WM/Year descriptor https://docs.microsoft.com/en-us/windows/win32/wmformat/wm-year

Parameters

Name	Type	Description
`value`	`number`	Year that the media represented by the current instance was created or `0` if no value is present.

Returns

void

Overrides

Tag.year

Methods

addDescriptor

▸ addDescriptor(descriptor): void

Adds a descriptor to the current instance's extended content description object.

Parameters

Name	Type	Description
`descriptor`	`AsfContentDescriptor`	Content descriptor to add to the current instance. Must be truthy

Returns

void

clear

▸ clear(): void

Clears all values stored in the current instance.

Returns

void

Overrides

Tag.clear

copyTo

▸ copyTo(target, overwrite): void

Copies the values from the current instance to another Tag, optionally overwriting existing values.

This method only copies the most basic values when copying between different tag formats. However, if target is of the same type as the current instance, more advanced copying may be done. For example if both this and target are Id3v2Tag, all frames will be copied to the target.

Parameters

Name	Type	Description
`target`	`Tag`	Target tag to copy values to
`overwrite`	`boolean`	Whether or not to copy values over existing ones

Returns

void

Inherited from

Tag.copyTo

getDescriptorString

▸ getDescriptorString(...names): string

Gets the string contained in a specific descriptor from the extended content description object in the current instance.

Parameters

Name	Type	Description
`...names`	`string`[]	Names of the descriptors to look for

Returns

string

The contents of the first descriptor found whose name is in the provided collection of descriptor names

getDescriptorStrings

▸ getDescriptorStrings(...names): string[]

Gets the strings contained in a specific descriptor from the extended content description object in the current instance, as split by ;.

Parameters

Name	Type	Description
`...names`	`string`[]	Names of the descriptors to look for

Returns

string[]

The contents of the first descriptor found whose name is in the provided collection of descriptor names, split by ;

getDescriptorUint

▸ getDescriptorUint(...names): number

Gets the unsigned integer contained in a specific descriptor from the extended content description object in the current instance.

Parameters

Name	Type	Description
`...names`	`string`[]	Names of the descriptors to look for

Returns

number

The contents of the first descriptor found whose name is in the provided collection of descriptor names

getDescriptors

▸ getDescriptors(...names): AsfContentDescriptor[]

Gets all descriptors in the extended description object with names matching any of the names in the provided collection of names.

Parameters

Name	Type	Description
`...names`	`string`[]	Collection of names to search the extended description object for

Returns

AsfContentDescriptor[]

removeDescriptors

▸ removeDescriptors(name): void

Removes all descriptors with a specified name from the extended content description object in the current instance.

Parameters

Name	Type	Description
`name`	`string`	Name of the descriptor to remove rom the current instance

Returns

void

setDescriptorString

▸ setDescriptorString(value, ...names): void

Sets the string for a collection of descriptors in the current instance.

Remarks

The value will be stored in the first value in names and the rest of the descriptors with the matching names will be cleared.

Parameters

Name	Type	Description
`value`	`string`	Value to store or `undefined` to clear the value
`...names`	`string`[]	Names in which the value would be expected. For example, `WM/AlbumTitle` and `Album`

Returns

void

setDescriptorStrings

▸ setDescriptorStrings(value, ...names): void

Sets the strings for a collection of descriptors in the current instance. The strings will be stored as a single string, joined together with ; .

Remarks

The value will be stored in the first value in names and the rest of the descriptors with the matching names will be cleared.

Parameters

Name	Type	Description
`value`	`string`[]	Value to store or `undefined` to clear the value
`...names`	`string`[]	Names in which the value would be expected. For example, `WM/AlbumTitle` and `Album`

Returns

void

setDescriptors

▸ setDescriptors(name, ...descriptors): void

Sets a collection of descriptors in the extended content description object for a given name, removing the existing matching records.

Remarks

All added descriptors should have their name set to name but this is not verified by the method. The descriptors will be added with their own names and not the one provided as an argument, which is only used for removing existing values and determining where to position the new descriptors.

Parameters

Name	Type	Description
`name`	`string`	Name of the descriptors to be added/removed
`...descriptors`	`AsfContentDescriptor`[]	Descriptors to add to the new instance

Returns

void

firstInGroup

▸ Static Protected firstInGroup(group): string

Gets the first string in an array.

Parameters

Name	Type	Description
`group`	`string`[]	Array of strings to get the first string from.

Returns

string

First string contained in group or undefined if the array is undefined or empty

Inherited from

Tag.firstInGroup

fromEmpty

▸ Static fromEmpty(): AsfTag

Constructs and initializes a new, empty instance.

Returns

AsfTag

fromHeader

▸ Static fromHeader(header): AsfTag

Constructs and initializes a new instance using the children of a HeaderObject object.

Parameters

Name	Type	Description
`header`	`AsfHeaderObject`	Header object whose children will be used to populate the new instance

Returns

AsfTag

isFalsyOrLikeEmpty

▸ Static Protected isFalsyOrLikeEmpty(value): boolean

Checks if a value is falsy or empty.

Parameters

Name	Type	Description
`value`	`string` \| `string`[]	Object to check

Returns

boolean

If value is a string, true is returned if the value is falsy or all whitespace, false is returned otherwise. If value is an array of strings, the array must be falsy or all elements must be falsy or whitespace to return true.

Inherited from

Tag.isFalsyOrLikeEmpty

joinGroup

▸ Static Protected joinGroup(group): string

Joins an array of string into a single, semicolon and space separated string.

Parameters

Name	Type	Description
`group`	`string`[]	Array of string to join

Returns

string

A semicolon and space separated string containing the values from group or undefined if the array is undefined or empty.

Inherited from

Tag.joinGroup

tagTypeFlagsToArray

▸ Static tagTypeFlagsToArray(tagTypes): TagTypes[]

Generates an array of tag types that are set in the provided flags value.

Parameters

Name	Type	Description
`tagTypes`	`TagTypes`	Tag types that have been OR'd together.

Returns

TagTypes[]

Inherited from

Tag.tagTypeFlagsToArray

FilesExpand file tree

AsfTag.md

Latest commit

History

AsfTag.md

File metadata and controls

Class: AsfTag

Hierarchy

Table of contents

Accessors

Methods

Accessors

album

Returns

Overrides

Parameters

Returns

Overrides

albumArtists

Returns

Overrides

Parameters

Returns

Overrides

albumArtistsSort

Returns

Overrides

Parameters

Returns

Overrides

albumSort

Returns

Overrides

Parameters

Returns

Overrides

amazonId

Returns

Inherited from

Parameters

Returns

Inherited from

beatsPerMinute

Returns

Overrides

Parameters

Returns

Overrides

comment

Returns

Overrides

Parameters

Returns

Overrides

composers

Returns

Overrides

Parameters

Returns

Overrides

composersSort

Returns

Inherited from

Parameters

Returns

Inherited from

conductor

Returns

Overrides

Parameters

Returns

Overrides

contentDescriptionObject

Returns

copyright

Returns

Overrides

Parameters

Returns

Overrides