Class: Spotify::SDK::Item

Inherits:
Model
  • Object
show all
Defined in:
lib/spotify/sdk/item.rb

Instance Attribute Summary

Attributes inherited from Model

#parent

Instance Method Summary collapse

Methods inherited from Model

alias_attribute, hash_selector, #initialize, #to_h, #to_json

Constructor Details

This class inherits a constructor from Spotify::SDK::Model

Instance Method Details

#album ⇒ Spotify::SDK::Album

Get the album for this item.

Examples:

@sdk.connect.playback.item.album

Returns:



14
15
16
 
# File 'lib/spotify/sdk/item.rb', line 14

def album
  Spotify::SDK::Album.new(super, parent)
end

#artist ⇒ Spotify::SDK::Artist

Get the primary artist/creator for this item.

Examples:

@sdk.connect.playback.item.artist

Returns:



40
41
42
 
# File 'lib/spotify/sdk/item.rb', line 40

def artist
  artists.first
end

#artists ⇒ Array

Get the artists/creators for this item.

Examples:

@sdk.connect.playback.item.artists

Returns:

  • (Array) —

    artists A list of artists, wrapped in Spotify::SDK::Artist



26
27
28
29
30
 
# File 'lib/spotify/sdk/item.rb', line 26

def artists
  super.map do |artist|
    Spotify::SDK::Artist.new(artist, parent)
  end
end

#duration ⇒ Integer

Get the duration. Alias to self.duration_ms

Examples:

@sdk.connect.playback.item.duration # => 10331

Returns:

  • (Integer) —

    duration_ms In milliseconds, how long the item is.



53
 
# File 'lib/spotify/sdk/item.rb', line 53

alias_attribute :duration, :duration_ms

#explicit? ⇒ TrueClass, FalseClass

Is this track explicit? Alias to self.explicit

Examples:

@sdk.connect.playback.item.explicit? # => true

Returns:

  • (TrueClass, FalseClass) —

    is_explicit Returns true if item contains explicit content.



64
 
# File 'lib/spotify/sdk/item.rb', line 64

alias_attribute :explicit?, :explicit

#isrc ⇒ String

Get the ISRC for this track.

Examples:

@sdk.connect.playback.item.isrc # => "USUM00000000"

Returns:

  • (String) —

    isrc The ISRC string for this track.



131
 
# File 'lib/spotify/sdk/item.rb', line 131

alias_attribute :isrc, "external_ids.isrc"

#local? ⇒ TrueClass, FalseClass

Is this a local track, not a Spotify track? Alias to self.is_local

Examples:

@sdk.connect.playback.item.local? # => false

Returns:

  • (TrueClass, FalseClass) —

    is_local Returns true if item is local to the user.



75
 
# File 'lib/spotify/sdk/item.rb', line 75

alias_attribute :local?, :is_local

#playable? ⇒ TrueClass, FalseClass

Is this a playable track? Alias to self.is_playable

Examples:

@sdk.connect.playback.item.playable? # => false

Returns:

  • (TrueClass, FalseClass) —

    is_playable Returns true if item is playable.



86
 
# File 'lib/spotify/sdk/item.rb', line 86

alias_attribute :playable?, :is_playable

#spotify_uri ⇒ String

Get the Spotify URI for this item. Alias to self.uri

Examples:

@sdk.connect.playback.item.spotify_uri # => "spotify:track:..."

Returns:

  • (String) —

    spotify_uri The direct URI to this Spotify resource.



110
 
# File 'lib/spotify/sdk/item.rb', line 110

alias_attribute :spotify_uri, :uri

#spotify_url ⇒ String

Get the Spotify HTTP URL for this item. Alias to self.external_urls

Examples:

@sdk.connect.playback.item.spotify_url # => "https://open.spotify.com/..."

Returns:

  • (String) —

    spotify_url The direct HTTP URL to this Spotify resource.



121
 
# File 'lib/spotify/sdk/item.rb', line 121

alias_attribute :spotify_url, "external_urls.spotify"

#track? ⇒ TrueClass, FalseClass

Is this a track? Alias to self.type == “track”

Examples:

@sdk.connect.playback.item.track? # => true

Returns:

  • (TrueClass, FalseClass) —

    is_track Returns true if item is an music track.



97
98
99
 
# File 'lib/spotify/sdk/item.rb', line 97

def track?
  type == "track"
end