Package se.michaelthelin.spotify.model_objects.miscellaneous

Class AudioAnalysis

java.lang.Object
se.michaelthelin.spotify.model_objects.AbstractModelObject
se.michaelthelin.spotify.model_objects.miscellaneous.AudioAnalysis
All Implemented Interfaces:
Serializable, 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.

See Also:

  • Method Details

    • 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.

    • toString

      public String toString()
      Description copied from class: AbstractModelObject
      Returns a String representation of this model object in the style:

      ModelObject(attr1=value1, attr2=value2, ...)

      Specified by:
      toString in class AbstractModelObject

    • 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.