Modifier and Type | Method | Description |
---|---|---|
default Artwork |
addArtwork(Path artworkFile) |
Convenience method to add an artwork file to this track.
|
default int |
countArtworks() |
|
int |
countArtworks(String filter) |
|
String |
getAlbum() |
The album name of the track.
|
String |
getAlbumArtist() |
The album artist of the track.
|
int |
getAlbumRating() |
The rating of the album for this track (0 to 100).
|
Ertk |
getAlbumRatingKind() |
The rating kind of the album rating for this track.
|
String |
getArtist() |
The artist/source of the track.
|
Artwork |
getArtwork(int index) |
|
Artwork |
getArtwork(Id id) |
|
default Artwork[] |
getArtworks() |
|
Artwork[] |
getArtworks(String filter) |
|
int |
getBitRate() |
The bit rate of the track (in kbps).
|
double |
getBookmark() |
The bookmark time of the track in seconds.
|
int |
getBpm() |
The tempo of this track in beats per minute.
|
String |
getCategory() |
The category of the track.
|
Ecls |
getCloudStatus() |
The iCloud status of the track.
|
String |
getComment() |
Freeform notes about the track.
|
String |
getComposer() |
The composer of the track.
|
int |
getDatabaseId() |
The common, unique ID for this track.
|
Date |
getDateAdded() |
The date the track was added to the playlist.
|
String |
getDescription() |
The description of the track.
|
int |
getDiscCount() |
The total number of discs in the source album.
|
int |
getDiscNumber() |
The index of the disc containing this track on the source album.
|
String |
getDownloaderAppleId() |
The Apple ID of the person who downloaded this track.
|
String |
getDownloaderName() |
The name of the person who downloaded this track.
|
double |
getDuration() |
The length of the track in seconds.
|
String |
getEpisodeId() |
The episode ID of the track.
|
int |
getEpisodeNumber() |
The episode number of the track.
|
String |
getEq() |
The name of the EQ preset of the track.
|
double |
getFinish() |
The stop time of the track in seconds.
|
String |
getGenre() |
The music/audio genre (category) of the track.
|
String |
getGrouping() |
The grouping (piece) of the track.
|
String |
getKind() |
A text description of the track.
|
String |
getLongDescription() |
The long description of the track.
|
String |
getLyrics() |
The lyrics of the track.
|
Emdk |
getMediaKind() |
The media kind of the track.
|
Date |
getModificationDate() |
The modification date of the content of this track.
|
String |
getMovement() |
The movement name of the track.
|
int |
getMovementCount() |
The total number of movements in the work.
|
int |
getMovementNumber() |
The index of the movement in the work.
|
int |
getPlayedCount() |
Number of times this track has been played.
|
Date |
getPlayedDate() |
The date and time this track was last played.
|
Map<String,Object> |
getProperties() |
Returns all properties for an instance of this class.
|
String |
getPurchaserAppleId() |
The Apple ID of the person who purchased this track.
|
String |
getPurchaserName() |
The name of the person who purchased this track.
|
int |
getRating() |
The rating of this track (0 to 100).
|
Ertk |
getRatingKind() |
The rating kind of this track.
|
Date |
getReleaseDate() |
The release date of this track.
|
int |
getSampleRate() |
The sample rate of the track (in Hz).
|
int |
getSeasonNumber() |
The season number of the track.
|
String |
getShow() |
The show name of the track.
|
long |
getSize() |
The size of the track (in bytes).
|
int |
getSkippedCount() |
Number of times this track has been skipped.
|
Date |
getSkippedDate() |
The date and time this track was last skipped.
|
String |
getSortAlbum() |
Override string to use for the track when sorting by album.
|
String |
getSortAlbumArtist() |
Override string to use for the track when sorting by album artist.
|
String |
getSortArtist() |
Override string to use for the track when sorting by artist.
|
String |
getSortComposer() |
Override string to use for the track when sorting by composer.
|
String |
getSortName() |
Override string to use for the track when sorting by name.
|
String |
getSortShow() |
Override string to use for the track when sorting by show name.
|
double |
getStart() |
The start time of the track in seconds.
|
String |
getTime() |
The length of the track in MM:SS format.
|
int |
getTrackCount() |
The total number of tracks on the source album.
|
int |
getTrackNumber() |
The index of the track on the source album.
|
int |
getVolumeAdjustment() |
Relative volume adjustment of the track (-100% to 100%).
|
String |
getWork() |
The work name of the track.
|
int |
getYear() |
The year the track was recorded/released.
|
boolean |
isAlbumDisliked() |
Is the album for this track disliked?
|
boolean |
isAlbumFavorited() |
Is the album for this track favorited?
|
boolean |
isBookmarkable() |
Is the playback position for this track remembered?
|
boolean |
isCompilation() |
Is this track from a compilation album?
|
boolean |
isDisliked() |
Is this track disliked?
|
boolean |
isEnabled() |
Is this track checked for playback?
|
boolean |
isFavorited() |
Is this track favorited?
|
boolean |
isGapless() |
Is this track from a gapless album?
|
boolean |
isShufflable() |
Is this track included when shuffling?
|
boolean |
isUnplayed() |
Is this track unplayed?
|
void |
setAlbum(String album) |
The album name of the track.
|
void |
setAlbumArtist(String albumArtist) |
The album artist of the track.
|
void |
setAlbumDisliked(boolean albumDisliked) |
Is the album for this track disliked?
|
void |
setAlbumFavorited(boolean albumFavorited) |
Is the album for this track favorited?
|
void |
setAlbumRating(int albumRating) |
The rating of the album for this track (0 to 100).
|
void |
setArtist(String artist) |
The artist/source of the track.
|
void |
setBookmark(double bookmark) |
The bookmark time of the track in seconds.
|
void |
setBookmarkable(boolean bookmarkable) |
Is the playback position for this track remembered?
|
void |
setBpm(int bpm) |
The tempo of this track in beats per minute.
|
void |
setCategory(String category) |
The category of the track.
|
void |
setComment(String comment) |
Freeform notes about the track.
|
void |
setCompilation(boolean compilation) |
Is this track from a compilation album?
|
void |
setComposer(String composer) |
The composer of the track.
|
void |
setDescription(String description) |
The description of the track.
|
void |
setDiscCount(int discCount) |
The total number of discs in the source album.
|
void |
setDiscNumber(int discNumber) |
The index of the disc containing this track on the source album.
|
void |
setDisliked(boolean disliked) |
Is this track disliked?
|
void |
setEnabled(boolean enabled) |
Is this track checked for playback?
|
void |
setEpisodeId(String episodeId) |
The episode ID of the track.
|
void |
setEpisodeNumber(int episodeNumber) |
The episode number of the track.
|
void |
setEq(String eq) |
The name of the EQ preset of the track.
|
void |
setFavorited(boolean favorited) |
Is this track favorited?
|
void |
setFinish(double finish) |
The stop time of the track in seconds.
|
void |
setGapless(boolean gapless) |
Is this track from a gapless album?
|
void |
setGenre(String genre) |
The music/audio genre (category) of the track.
|
void |
setGrouping(String grouping) |
The grouping (piece) of the track.
|
void |
setLongDescription(String longDescription) |
The long description of the track.
|
void |
setLyrics(String lyrics) |
The lyrics of the track.
|
void |
setMediaKind(Emdk mediaKind) |
The media kind of the track.
|
void |
setMovement(String movement) |
The movement name of the track.
|
void |
setMovementCount(int movementCount) |
The total number of movements in the work.
|
void |
setMovementNumber(int movementNumber) |
The index of the movement in the work.
|
void |
setPlayedCount(int playedCount) |
Number of times this track has been played.
|
void |
setPlayedDate(Date playedDate) |
The date and time this track was last played.
|
void |
setRating(int rating) |
The rating of this track (0 to 100).
|
void |
setSeasonNumber(int seasonNumber) |
The season number of the track.
|
void |
setShow(String show) |
The show name of the track.
|
void |
setShufflable(boolean shufflable) |
Is this track included when shuffling?
|
void |
setSkippedCount(int skippedCount) |
Number of times this track has been skipped.
|
void |
setSkippedDate(Date skippedDate) |
The date and time this track was last skipped.
|
void |
setSortAlbum(String sortAlbum) |
Override string to use for the track when sorting by album.
|
void |
setSortAlbumArtist(String sortAlbumArtist) |
Override string to use for the track when sorting by album artist.
|
void |
setSortArtist(String sortArtist) |
Override string to use for the track when sorting by artist.
|
void |
setSortComposer(String sortComposer) |
Override string to use for the track when sorting by composer.
|
void |
setSortName(String sortName) |
Override string to use for the track when sorting by name.
|
void |
setSortShow(String sortShow) |
Override string to use for the track when sorting by show name.
|
void |
setStart(double start) |
The start time of the track in seconds.
|
void |
setTrackCount(int trackCount) |
The total number of tracks on the source album.
|
void |
setTrackNumber(int trackNumber) |
The index of the track on the source album.
|
void |
setUnplayed(boolean unplayed) |
Is this track unplayed?
|
void |
setVolumeAdjustment(int volumeAdjustment) |
Relative volume adjustment of the track (-100% to 100%).
|
void |
setWork(String work) |
The work name of the track.
|
void |
setYear(int year) |
The year the track was recorded/released.
|
getContainer, getId, getIndex, getKlass, getName, getPersistentId, setName
cast, getApplicationReference, getObjectReference, getTypeClass, isInstanceOf
static final TypeClass CLASS
@Kind("element") @Type("artwork") default Artwork[] getArtworks()
Artwork
s@Kind("element") @Type("artwork") Artwork[] getArtworks(String filter)
filter
- AppleScript filter clause without the leading "whose" or "where"Artwork
s@Kind("element") @Type("artwork") Artwork getArtwork(int index)
index
- index into the element list (zero-based)Artwork
at the requested index@Kind("element") @Type("artwork") Artwork getArtwork(Id id)
id
- id of the itemArtwork
with the requested id@Kind("element") @Type("artwork") default int countArtworks()
Artwork
s@Kind("element") @Type("artwork") int countArtworks(String filter)
filter
- AppleScript filter clause without the leading "whose" or "where"@Code("pAlb") @Kind("property") @Name("album") @Type("text") String getAlbum()
@Code("pAlb") @Kind("property") @Name("album") @Type("text") void setAlbum(String album)
album
- new property value@Code("pAlA") @Kind("property") @Name("album artist") @Type("text") String getAlbumArtist()
@Code("pAlA") @Kind("property") @Name("album artist") @Type("text") void setAlbumArtist(String albumArtist)
albumArtist
- new property value@Code("pAHt") @Kind("property") @Name("album disliked") @Type("boolean") boolean isAlbumDisliked()
@Code("pAHt") @Kind("property") @Name("album disliked") @Type("boolean") void setAlbumDisliked(boolean albumDisliked)
albumDisliked
- new property value@Code("pALv") @Kind("property") @Name("album favorited") @Type("boolean") boolean isAlbumFavorited()
@Code("pALv") @Kind("property") @Name("album favorited") @Type("boolean") void setAlbumFavorited(boolean albumFavorited)
albumFavorited
- new property value@Code("pAlR") @Kind("property") @Name("album rating") @Type("integer") int getAlbumRating()
@Code("pAlR") @Kind("property") @Name("album rating") @Type("integer") void setAlbumRating(int albumRating)
albumRating
- new property value@Code("pARk") @Kind("property") @Name("album rating kind") @Type("eRtK") Ertk getAlbumRatingKind()
@Code("pArt") @Kind("property") @Name("artist") @Type("text") String getArtist()
@Code("pArt") @Kind("property") @Name("artist") @Type("text") void setArtist(String artist)
artist
- new property value@Code("pBRt") @Kind("property") @Name("bit rate") @Type("integer") int getBitRate()
@Code("pBkt") @Kind("property") @Name("bookmark") @Type("real") double getBookmark()
@Code("pBkt") @Kind("property") @Name("bookmark") @Type("real") void setBookmark(double bookmark)
bookmark
- new property value@Code("pBkm") @Kind("property") @Name("bookmarkable") @Type("boolean") boolean isBookmarkable()
@Code("pBkm") @Kind("property") @Name("bookmarkable") @Type("boolean") void setBookmarkable(boolean bookmarkable)
bookmarkable
- new property value@Code("pBPM") @Kind("property") @Name("bpm") @Type("integer") int getBpm()
@Code("pBPM") @Kind("property") @Name("bpm") @Type("integer") void setBpm(int bpm)
bpm
- new property value@Code("pCat") @Kind("property") @Name("category") @Type("text") String getCategory()
@Code("pCat") @Kind("property") @Name("category") @Type("text") void setCategory(String category)
category
- new property value@Code("pClS") @Kind("property") @Name("cloud status") @Type("eClS") Ecls getCloudStatus()
@Code("pCmt") @Kind("property") @Name("comment") @Type("text") String getComment()
@Code("pCmt") @Kind("property") @Name("comment") @Type("text") void setComment(String comment)
comment
- new property value@Code("pAnt") @Kind("property") @Name("compilation") @Type("boolean") boolean isCompilation()
@Code("pAnt") @Kind("property") @Name("compilation") @Type("boolean") void setCompilation(boolean compilation)
compilation
- new property value@Code("pCmp") @Kind("property") @Name("composer") @Type("text") String getComposer()
@Code("pCmp") @Kind("property") @Name("composer") @Type("text") void setComposer(String composer)
composer
- new property value@Code("pDID") @Kind("property") @Name("database ID") @Type("integer") int getDatabaseId()
@Code("pAdd") @Kind("property") @Name("date added") @Type("date") Date getDateAdded()
@Code("pDes") @Kind("property") @Name("description") @Type("text") String getDescription()
@Code("pDes") @Kind("property") @Name("description") @Type("text") void setDescription(String description)
description
- new property value@Code("pDsC") @Kind("property") @Name("disc count") @Type("integer") int getDiscCount()
@Code("pDsC") @Kind("property") @Name("disc count") @Type("integer") void setDiscCount(int discCount)
discCount
- new property value@Code("pDsN") @Kind("property") @Name("disc number") @Type("integer") int getDiscNumber()
@Code("pDsN") @Kind("property") @Name("disc number") @Type("integer") void setDiscNumber(int discNumber)
discNumber
- new property value@Code("pHat") @Kind("property") @Name("disliked") @Type("boolean") boolean isDisliked()
@Code("pHat") @Kind("property") @Name("disliked") @Type("boolean") void setDisliked(boolean disliked)
disliked
- new property value@Code("pDAI") @Kind("property") @Name("downloader Apple ID") @Type("text") String getDownloaderAppleId()
@Code("pDNm") @Kind("property") @Name("downloader name") @Type("text") String getDownloaderName()
@Code("pDur") @Kind("property") @Name("duration") @Type("real") double getDuration()
@Code("enbl") @Kind("property") @Name("enabled") @Type("boolean") boolean isEnabled()
@Code("enbl") @Kind("property") @Name("enabled") @Type("boolean") void setEnabled(boolean enabled)
enabled
- new property value@Code("pEpD") @Kind("property") @Name("episode ID") @Type("text") String getEpisodeId()
@Code("pEpD") @Kind("property") @Name("episode ID") @Type("text") void setEpisodeId(String episodeId)
episodeId
- new property value@Code("pEpN") @Kind("property") @Name("episode number") @Type("integer") int getEpisodeNumber()
@Code("pEpN") @Kind("property") @Name("episode number") @Type("integer") void setEpisodeNumber(int episodeNumber)
episodeNumber
- new property value@Code("pEQp") @Kind("property") @Name("EQ") @Type("text") String getEq()
@Code("pEQp") @Kind("property") @Name("EQ") @Type("text") void setEq(String eq)
eq
- new property value@Code("pStp") @Kind("property") @Name("finish") @Type("real") double getFinish()
@Code("pStp") @Kind("property") @Name("finish") @Type("real") void setFinish(double finish)
finish
- new property value@Code("pGpl") @Kind("property") @Name("gapless") @Type("boolean") boolean isGapless()
@Code("pGpl") @Kind("property") @Name("gapless") @Type("boolean") void setGapless(boolean gapless)
gapless
- new property value@Code("pGen") @Kind("property") @Name("genre") @Type("text") String getGenre()
@Code("pGen") @Kind("property") @Name("genre") @Type("text") void setGenre(String genre)
genre
- new property value@Code("pGrp") @Kind("property") @Name("grouping") @Type("text") String getGrouping()
@Code("pGrp") @Kind("property") @Name("grouping") @Type("text") void setGrouping(String grouping)
grouping
- new property value@Code("pKnd") @Kind("property") @Name("kind") @Type("text") String getKind()
@Code("pLds") @Kind("property") @Name("long description") @Type("text") String getLongDescription()
@Code("pLds") @Kind("property") @Name("long description") @Type("text") void setLongDescription(String longDescription)
longDescription
- new property value@Code("pLov") @Kind("property") @Name("favorited") @Type("boolean") boolean isFavorited()
@Code("pLov") @Kind("property") @Name("favorited") @Type("boolean") void setFavorited(boolean favorited)
favorited
- new property value@Code("pLyr") @Kind("property") @Name("lyrics") @Type("text") String getLyrics()
@Code("pLyr") @Kind("property") @Name("lyrics") @Type("text") void setLyrics(String lyrics)
lyrics
- new property value@Code("pMdK") @Kind("property") @Name("media kind") @Type("eMdK") Emdk getMediaKind()
@Code("pMdK") @Kind("property") @Name("media kind") @Type("eMdK") void setMediaKind(Emdk mediaKind)
mediaKind
- new property value@Code("asmo") @Kind("property") @Name("modification date") @Type("date") Date getModificationDate()
@Code("pMNm") @Kind("property") @Name("movement") @Type("text") String getMovement()
@Code("pMNm") @Kind("property") @Name("movement") @Type("text") void setMovement(String movement)
movement
- new property value@Code("pMvC") @Kind("property") @Name("movement count") @Type("integer") int getMovementCount()
@Code("pMvC") @Kind("property") @Name("movement count") @Type("integer") void setMovementCount(int movementCount)
movementCount
- new property value@Code("pMvN") @Kind("property") @Name("movement number") @Type("integer") int getMovementNumber()
@Code("pMvN") @Kind("property") @Name("movement number") @Type("integer") void setMovementNumber(int movementNumber)
movementNumber
- new property value@Code("pPlC") @Kind("property") @Name("played count") @Type("integer") int getPlayedCount()
@Code("pPlC") @Kind("property") @Name("played count") @Type("integer") void setPlayedCount(int playedCount)
playedCount
- new property value@Code("pPlD") @Kind("property") @Name("played date") @Type("date") Date getPlayedDate()
@Code("pPlD") @Kind("property") @Name("played date") @Type("date") void setPlayedDate(Date playedDate)
playedDate
- new property value@Code("pPAI") @Kind("property") @Name("purchaser Apple ID") @Type("text") String getPurchaserAppleId()
@Code("pPNm") @Kind("property") @Name("purchaser name") @Type("text") String getPurchaserName()
@Code("pRte") @Kind("property") @Name("rating") @Type("integer") int getRating()
@Code("pRte") @Kind("property") @Name("rating") @Type("integer") void setRating(int rating)
rating
- new property value@Code("pRtk") @Kind("property") @Name("rating kind") @Type("eRtK") Ertk getRatingKind()
@Code("pRlD") @Kind("property") @Name("release date") @Type("date") Date getReleaseDate()
@Code("pSRt") @Kind("property") @Name("sample rate") @Type("integer") int getSampleRate()
@Code("pSeN") @Kind("property") @Name("season number") @Type("integer") int getSeasonNumber()
@Code("pSeN") @Kind("property") @Name("season number") @Type("integer") void setSeasonNumber(int seasonNumber)
seasonNumber
- new property value@Code("pSfa") @Kind("property") @Name("shufflable") @Type("boolean") boolean isShufflable()
@Code("pSfa") @Kind("property") @Name("shufflable") @Type("boolean") void setShufflable(boolean shufflable)
shufflable
- new property value@Code("pSkC") @Kind("property") @Name("skipped count") @Type("integer") int getSkippedCount()
@Code("pSkC") @Kind("property") @Name("skipped count") @Type("integer") void setSkippedCount(int skippedCount)
skippedCount
- new property value@Code("pSkD") @Kind("property") @Name("skipped date") @Type("date") Date getSkippedDate()
@Code("pSkD") @Kind("property") @Name("skipped date") @Type("date") void setSkippedDate(Date skippedDate)
skippedDate
- new property value@Code("pShw") @Kind("property") @Name("show") @Type("text") String getShow()
@Code("pShw") @Kind("property") @Name("show") @Type("text") void setShow(String show)
show
- new property value@Code("pSAl") @Kind("property") @Name("sort album") @Type("text") String getSortAlbum()
@Code("pSAl") @Kind("property") @Name("sort album") @Type("text") void setSortAlbum(String sortAlbum)
sortAlbum
- new property value@Code("pSAr") @Kind("property") @Name("sort artist") @Type("text") String getSortArtist()
@Code("pSAr") @Kind("property") @Name("sort artist") @Type("text") void setSortArtist(String sortArtist)
sortArtist
- new property value@Code("pSAA") @Kind("property") @Name("sort album artist") @Type("text") String getSortAlbumArtist()
@Code("pSAA") @Kind("property") @Name("sort album artist") @Type("text") void setSortAlbumArtist(String sortAlbumArtist)
sortAlbumArtist
- new property value@Code("pSNm") @Kind("property") @Name("sort name") @Type("text") String getSortName()
@Code("pSNm") @Kind("property") @Name("sort name") @Type("text") void setSortName(String sortName)
sortName
- new property value@Code("pSCm") @Kind("property") @Name("sort composer") @Type("text") String getSortComposer()
@Code("pSCm") @Kind("property") @Name("sort composer") @Type("text") void setSortComposer(String sortComposer)
sortComposer
- new property value@Code("pSSN") @Kind("property") @Name("sort show") @Type("text") String getSortShow()
@Code("pSSN") @Kind("property") @Name("sort show") @Type("text") void setSortShow(String sortShow)
sortShow
- new property value@Code("pSiz") @Kind("property") @Name("size") @Type("double integer") long getSize()
@Code("pStr") @Kind("property") @Name("start") @Type("real") double getStart()
@Code("pStr") @Kind("property") @Name("start") @Type("real") void setStart(double start)
start
- new property value@Code("pTim") @Kind("property") @Name("time") @Type("text") String getTime()
@Code("pTrC") @Kind("property") @Name("track count") @Type("integer") int getTrackCount()
@Code("pTrC") @Kind("property") @Name("track count") @Type("integer") void setTrackCount(int trackCount)
trackCount
- new property value@Code("pTrN") @Kind("property") @Name("track number") @Type("integer") int getTrackNumber()
@Code("pTrN") @Kind("property") @Name("track number") @Type("integer") void setTrackNumber(int trackNumber)
trackNumber
- new property value@Code("pUnp") @Kind("property") @Name("unplayed") @Type("boolean") boolean isUnplayed()
@Code("pUnp") @Kind("property") @Name("unplayed") @Type("boolean") void setUnplayed(boolean unplayed)
unplayed
- new property value@Code("pAdj") @Kind("property") @Name("volume adjustment") @Type("integer") int getVolumeAdjustment()
@Code("pAdj") @Kind("property") @Name("volume adjustment") @Type("integer") void setVolumeAdjustment(int volumeAdjustment)
volumeAdjustment
- new property value@Code("pWrk") @Kind("property") @Name("work") @Type("text") String getWork()
@Code("pWrk") @Kind("property") @Name("work") @Type("text") void setWork(String work)
work
- new property value@Code("pYr ") @Kind("property") @Name("year") @Type("integer") int getYear()
@Code("pYr ") @Kind("property") @Name("year") @Type("integer") void setYear(int year)
year
- new property valueMap<String,Object> getProperties()
getProperties
in interface Item
default Artwork addArtwork(Path artworkFile) throws IOException
Note that this method executes three AppleScript calls
and must not be called from inside an active Session
.
artworkFile
- artwork fileIOException
- if the artwork file cannot be readIllegalStateException
- if this method is called from inside an active session