Package com.wrapper.spotify.model_objects.miscellaneous

Class AudioAnalysis

java.lang.Object

com.wrapper.spotify.model_objects.AbstractModelObject

com.wrapper.spotify.model_objects.miscellaneous.AudioAnalysis

All Implemented Interfaces:

IModelObject

public class AudioAnalysis
extends AbstractModelObject

Retrieve information about Audio Analysis objects by building instances from this class.
These objects contain a great amount of additional information to AudioFeatures objects.

Note: Audio Analysis data is created by the Software "Analyzer" by "The Echo Nest", which has been bought by Spotify in the past. Since then, new Analyzer versions were created by Spotify but there is a lack of documentation on the side of Spotify, so it is possible that this Javadoc page (and other Audio Analysis related Javadoc pages) contains speculative information about a few of its corresponding methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AudioAnalysis.Builder	Builder class for building AudioAnalysis instances.
static class	AudioAnalysis.JsonUtil	JsonUtil class for building AudioAnalysis instances.

Nested classes/interfaces inherited from interface com.wrapper.spotify.model_objects.IModelObject

IModelObject.IJsonUtil<T>

Method Summary

Modifier and Type	Method	Description
AudioAnalysis.Builder	builder()	Create a builder for building an instance of a model object.
AudioAnalysisMeasure[]	getBars()	Get the list of bar markers, in seconds.
AudioAnalysisMeasure[]	getBeats()	Get the list of beat markers, in seconds.
AudioAnalysisMeta	getMeta()	Get the metadata of the analyzer software for the track.
AudioAnalysisSection[]	getSections()	Get the set of section markers, in seconds.
AudioAnalysisSegment[]	getSegments()	Get the set of sound entities (typically under a second) each relatively uniform in timbre and harmony.
AudioAnalysisMeasure[]	getTatums()	Get the list of tatum markers, in seconds.
AudioAnalysisTrack	getTrack()	Get the track data of the audio analysis object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getBars

public AudioAnalysisMeasure[] getBars()

Get the list of bar markers, in seconds. A bar (or measure) is a segment of time defined as a given number of beats. Bar offsets also indicate downbeats, the first beat of the measure.

Returns:

The list of bar markers, in seconds.

getBeats

public AudioAnalysisMeasure[] getBeats()

Get the list of beat markers, in seconds. A beat is the basic time unit of a piece of music; for example, each tick of a metronome. Beats are typically multiples of tatums.

Returns:

The list of beat markers, in seconds.

getMeta

public AudioAnalysisMeta getMeta()

Get the metadata of the analyzer software for the track.

Returns:

Analyze, compute, and track information.

getSections

public AudioAnalysisSection[] getSections()

Get the set of section markers, in seconds. Sections are defined by large variations in rhythm or timbre, e.g. chorus, verse, bridge, guitar solo, etc. Each section contains its own descriptions of tempo, key, mode, time_signature, and loudness

Returns:

The set of section markers, in seconds.

getSegments

public AudioAnalysisSegment[] getSegments()

Get the set of sound entities (typically under a second) each relatively uniform in timbre and harmony. Segments are characterized by their perceptual onsets and duration in seconds, loudness (dB), pitch and timbral content.

Returns:

The set of sound entities (typically under a second) each relatively uniform in timbre and harmony.

getTatums

public AudioAnalysisMeasure[] getTatums()

Get the list of tatum markers, in seconds. Tatums represent the lowest regular pulse train that a listener intuitively infers from the timing of perceived musical events (segments).

Returns:

Get the list of tatum markers, in seconds.

getTrack

public AudioAnalysisTrack getTrack()

Get the track data of the audio analysis object.

Returns:

Track data of audio analysis object.

builder

public AudioAnalysis.Builder builder()

Description copied from interface: IModelObject

Create a builder for building an instance of a model object.
The type of the builder and its methods depend on its corresponding implementation.

Returns:

A builder object.