Package com.wrapper.spotify.model_objects.specification

Class AudioFeatures

java.lang.Object

com.wrapper.spotify.model_objects.AbstractModelObject

com.wrapper.spotify.model_objects.specification.AudioFeatures

All Implemented Interfaces:

IModelObject

public class AudioFeatures
extends AbstractModelObject

Retrieve information about Audio Feature objects by building instances from this class.

Nested Class Summary

Nested Classes

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

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

IModelObject.IJsonUtil<T>

Method Summary

Modifier and Type	Method	Description
AudioFeatures.Builder	builder()	Create a builder for building an instance of a model object.
Float	getAcousticness()	Get the acousticness of the track as a value between 0.0 and 1.0.
String	getAnalysisUrl()	Get the Spotify Web API endpoint URL for a full audio analysis.
Float	getDanceability()	Get the danceability of the track as a value between 0.0 and 1.0.
Integer	getDurationMs()	Get the duration of the track in milliseconds.
Float	getEnergy()	Get the energy of the track as a value between 0.0 and 1.0. The energetic value of the track depends on factors like speed and loudness.
String	getId()	Get the Spotify ID of the track.
Float	getInstrumentalness()	Get the instrumentalness of the track as a value between 0.0 and 1.0.
Integer	getKey()	Get the main key of the track.
Float	getLiveness()	Get the liveness of the track as a value between 0.0 and 1.0. The liveness depends on ambient sounds like the presence of an audience.
Float	getLoudness()	Get the average loudness of the track.
Modality	getMode()	Get the modality of the track.
Float	getSpeechiness()	Get the speechiness of the track as a value between 0.0 and 1.0.
Float	getTempo()	Get the estimated tempo of the track in beats per minute.
Integer	getTimeSignature()	Get the estimated overall time signature of the track.
String	getTrackHref()	Get the Spotify Web API endpoint URL of the track.
ModelObjectType	getType()	Get the model object type.
String	getUri()	Get the Spotify URI of the track.
Float	getValence()	Get the valence of the track as a value between 0.0 and 1.0. A track with a high valence sounds more positive (happy, cheerful, euphoric) like the track with a low valence.

Methods inherited from class java.lang.Object

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

Method Detail

getAcousticness

public Float getAcousticness()

Get the acousticness of the track as a value between 0.0 and 1.0.
The higher the value, the higher the chance the track is acoustic.

Returns:

Acousticness value.

getAnalysisUrl

public String getAnalysisUrl()

Get the Spotify Web API endpoint URL for a full audio analysis. An audio analysis contains additional information to audio feature objects.

Returns:

Spotify Web API endpoint URL.

See Also:

AudioAnalysis

getDanceability

public Float getDanceability()

Get the danceability of the track as a value between 0.0 and 1.0.
The danceability depends on factors like tempo and rhythm stability. Higher is better.

Returns:

Danceability value.

getDurationMs

public Integer getDurationMs()

Get the duration of the track in milliseconds.

Returns:

Track duration.

getEnergy

public Float getEnergy()

Get the energy of the track as a value between 0.0 and 1.0.
The energetic value of the track depends on factors like speed and loudness. Fast and loud tracks feel more energetic than slow and quiet tracks.

Returns:

Energetic value.

getId

public String getId()

Get the Spotify ID of the track.

Returns:

Spotify track ID.

getInstrumentalness

public Float getInstrumentalness()

Get the instrumentalness of the track as a value between 0.0 and 1.0.
The higher the value, the higher the chance the track contains no vocals.

Returns:

Instrumentalness value.

See Also:

getSpeechiness()

getKey

public Integer getKey()

Get the main key of the track.

Returns:

Main key.

See Also:

Wikipedia: Pitch class notation

getLiveness

public Float getLiveness()

Get the liveness of the track as a value between 0.0 and 1.0.
The liveness depends on ambient sounds like the presence of an audience. The higher the value, the higher the chance the track was performed live.

Returns:

Liveness value.

getLoudness

public Float getLoudness()

Get the average loudness of the track. These values have mostly a range between -60 and 0 decibels.

Returns:

Loudness value.

getMode

public Modality getMode()

Get the modality of the track. (either "major" or "minor")

Returns:

Modality type.

See Also:

Wikipedia: Mode (music)

getSpeechiness

public Float getSpeechiness()

Get the speechiness of the track as a value between 0.0 and 1.0.
The higher the value, the higher the chance the track only consists of spoken words.

Returns:

Speechiness value.

See Also:

getInstrumentalness()

getTempo

public Float getTempo()

Get the estimated tempo of the track in beats per minute.

Returns:

Tempo value.

getTimeSignature

public Integer getTimeSignature()

Get the estimated overall time signature of the track. The time signature (or meter) is the number of beats in a bar.
Example: A Viennese waltz has a three-quarters beat, so this method would return the value 3 in this case.

Returns:

Time signature value.

getTrackHref

public String getTrackHref()

Get the Spotify Web API endpoint URL of the track.

Returns:

A Spotify Web API endpoint URL.

getType

public ModelObjectType getType()

Get the model object type. In this case "audio_features".

Returns:

A ModelObjectType.

getUri

public String getUri()

Get the Spotify URI of the track.

Returns:

Spotify track URI.

getValence

public Float getValence()

Get the valence of the track as a value between 0.0 and 1.0.
A track with a high valence sounds more positive (happy, cheerful, euphoric) like the track with a low valence. (sad, depressed, angry)

Returns:

Valence value.

builder

public AudioFeatures.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.