A representation of a media item returned by openMusicLibrary or queryMusicLibrary.
This is a read-only object that describes a single media item, not a playlist. Titanium does not support access to playlists.
Item objects cannot be created explicitly. The
openMusicLibrary returns Item objects in its
success callback function, while queryMusicLibrary
returns an array of Item objects.
Artist credited for the album containing this item.
Artist credited for the album containing this item.
The persistent identifier for an album artist.
The persistent identifier for an album artist.
The key for the persistent identifier for an album.
The key for the persistent identifier for an album.
Title of the album containing this item.
Title of the album containing this item.
Number of tracks for the album containing this item.
Number of tracks for the album containing this item.
The name of the API that this proxy corresponds to.
The name of the API that this proxy corresponds to.
The value of this property is the fully qualified name of the API. For example, Button
returns Ti.UI.Button.
Image for the item's artwork as a Blob object, or null if no artwork is
available.
Image for the item's artwork as a Blob object, or null if no artwork is
available.
A URL pointing to the media item.
A URL pointing to the media item.
The number of musical beats per minute for the media item, corresponding to the "BPM" field in the Info tab in the "Get Info" dialog in iTunes.
The user's place in the media item the most recent time it was played.
The user's place in the media item the most recent time it was played.
Indicates if the proxy will bubble an event to its parent.
Some proxies (most commonly views) have a relationship to other proxies, often established by the add() method. For example, for a button added to a window, a click event on the button would bubble up to the window. Other common parents are table sections to their rows, table views to their sections, and scrollable views to their views. Set this property to false to disable the bubbling to the proxy's parent.
Default: true
Textual information about the media item, corresponding to the "Comments" field in in the Info tab in the Get Info dialog in iTunes.
Date when the item was added to the music library.
Requires: iOS 10.0 and later
Total number of discs for the album containing this item.
Total number of discs for the album containing this item.
Disc number for this item in the album.
Disc number for this item in the album.
The persistent identifier for a genre.
The persistent identifier for a genre.
True if the item represents a protected asset.
True if the item represents a protected asset.
True if the media item is an iCloud item.
True if the media item is an iCloud item.
True if this item is part of a compilation album.
True if this item is part of a compilation album.
True if this item is marked as "Explicit".
True if this item is marked as "Explicit".
The most recent calendar date on which the user played the media item.
The most recent calendar date on which the user played the media item.
The Window or TabGroup whose Activity lifecycle should be triggered on the proxy.
The Window or TabGroup whose Activity lifecycle should be triggered on the proxy.
If this property is set to a Window or TabGroup, then the corresponding Activity lifecycle event callbacks will also be called on the proxy. Proxies that require the activity lifecycle will need this property set to the appropriate containing Window or TabGroup.
The type of the media.
The type of the media.
At least in theory, a single item can have more than one media type, in which case the value represents a bitwise-OR of all the applicable media types.
This API can be assigned the following constants:
The key for the persistent identifier for the media item.
The key for the persistent identifier for the media item.
Number of times the item has been played.
Number of times the item has been played.
Length (in seconds) of this item.
Length (in seconds) of this item.
Used to enqueue store tracks by their ID.
Requires: iOS 10.3 and later
The persistent identifier for an audio podcast.
The persistent identifier for an audio podcast.
Title of a podcast item.
Title of a podcast item.
Only included if the media type is Titanium.Media.MUSIC_MEDIA_TYPE_PODCAST.
Date when this this item was released.
Date when this this item was released.
Number of times this item has been skipped.
Number of times this item has been skipped.
Corresponds to the "Grouping" field in the Info tab in the "Get Info" dialog in iTunes.
Corresponds to the "Grouping" field in the Info tab in the "Get Info" dialog in iTunes.
Adds the specified callback as an event listener for the named event.
Name of the event.
Callback function to invoke when the event is fired.
Applies the properties to the proxy.
Properties are supplied as a dictionary. Each key-value pair in the object is applied to the proxy such that myproxy[key] = value.
A dictionary of properties to apply.
Fires a synthesized event to any registered listeners.
Name of the event.
A dictionary of keys and values to add to the Titanium.Event object sent to the listeners.
Removes the specified callback as an event listener for the named event.
Multiple listeners can be registered for the same event, so the
callback parameter is used to determine which listener to remove.
When adding a listener, you must save a reference to the callback function in order to remove the listener later:
var listener = function() { Ti.API.info("Event listener called."); }
window.addEventListener('click', listener);
To remove the listener, pass in a reference to the callback function:
window.removeEventListener('click', listener);
Name of the event.
Callback function to remove. Must be the same function passed to addEventListener.
Sets the value of the bubbleParent property.
New value for the property.
Sets the value of the lifecycleContainer property.
New value for the property.