Implemented By

Supported Methods

Description of Methods

SetUrl(url as String) as Void

Sets the URL to the audio file. Only file URLs are initially supported.

GetTags() as Object

Returns an associative array that contains a simple set of tags that are common to most audio formats. This associative array contains:

Name

Type

Notes

title

String

 

artist

String

Returns the first artist found even though many titles have multiple artists.

album

String

 

composer

String

Returns the first composer found even though many titles have multiple composers.

comment

String

 

genre

String

 

year

Integer

 

track

Integer

 

GetAudioProperties() as Object

Returns an associative array with a simple set of audio properties. These are values which may involve reading a larger portion of the file and thus may take longer to retrieve than the tags. The associative array contains:

Name

Type

Notes

length

Integer

Duration in seconds.

bitrate

Integer

In kilobytes per second.

samplerate

Integer

Samples per second.  For example: 44100 for CD sample rate.

channels

Integer

Number of channels. For example: 2 for stereo.

GetCoverArt() as Object

Returns the cover art if available. Returns an associative array with two entries: "bytes" and "type". "bytes" is an roByteArray containing the image data. "type" specifies the mime-type of the image which is almost always either "image/jpeg" or "image/png".  Looks for the picture designated as the cover art if there is more than one picture in the file. If there is no FrontCover picture then the first picture is used.