Files
9minutes/doc/app/LastFM/Track.html
T
Tobias Klika 2cbb942282 doc files;
2011-06-13 14:56:41 +02:00

368 lines
12 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<title>Class: LastFM::Track</title>
<link rel="stylesheet" href="../rdoc.css" type="text/css" media="screen" />
<script src="../js/jquery.js" type="text/javascript"
charset="utf-8"></script>
<script src="../js/thickbox-compressed.js" type="text/javascript"
charset="utf-8"></script>
<script src="../js/quicksearch.js" type="text/javascript"
charset="utf-8"></script>
<script src="../js/darkfish.js" type="text/javascript"
charset="utf-8"></script>
</head>
<body class="class">
<div id="metadata">
<div id="home-metadata">
<div id="home-section" class="section">
<h3 class="section-header">
<a href="../index.html">Home</a>
<a href="../index.html#classes">Classes</a>
<a href="../index.html#methods">Methods</a>
</h3>
</div>
</div>
<div id="file-metadata">
<div id="file-list-section" class="section">
<h3 class="section-header">In Files</h3>
<div class="section-body">
<ul>
<li><a href="../lib/last_fm/track_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
class="thickbox" title="lib/last_fm/track.rb">lib/last_fm/track.rb</a></li>
</ul>
</div>
</div>
</div>
<div id="class-metadata">
<!-- Parent Class -->
<div id="parent-class-section" class="section">
<h3 class="section-header">Parent</h3>
<p class="link"><a href="Request.html">LastFM::Request</a></p>
</div>
<!-- Namespace Contents -->
<!-- Method Quickref -->
<div id="method-list-section" class="section">
<h3 class="section-header">Methods</h3>
<ul class="link-list">
<li><a href="#method-c-getInfo">::getInfo</a></li>
<li><a href="#method-c-getSimilar">::getSimilar</a></li>
<li><a href="#method-c-getTopTags">::getTopTags</a></li>
<li><a href="#method-c-search">::search</a></li>
</ul>
</div>
<!-- Included Modules -->
</div>
<div id="project-metadata">
<div id="fileindex-section" class="section project-section">
<h3 class="section-header">Files</h3>
<ul>
<li class="file"><a href="../doc/README_FOR_APP.html">README_FOR_APP</a></li>
</ul>
</div>
<div id="classindex-section" class="section project-section">
<h3 class="section-header">Class Index
<span class="search-toggle"><img src="../images/find.png"
height="16" width="16" alt="[+]"
title="show/hide quicksearch" /></span></h3>
<form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
<fieldset>
<legend>Quicksearch</legend>
<input type="text" name="quicksearch" value=""
class="quicksearch-field" />
</fieldset>
</form>
<ul class="link-list">
<li><a href="../LastFM.html">LastFM</a></li>
<li><a href="../LastFM/Album.html">LastFM::Album</a></li>
<li><a href="../LastFM/Artist.html">LastFM::Artist</a></li>
<li><a href="../LastFM/Chart.html">LastFM::Chart</a></li>
<li><a href="../LastFM/Request.html">LastFM::Request</a></li>
<li><a href="../LastFM/Track.html">LastFM::Track</a></li>
<li><a href="../LastFM/Validator.html">LastFM::Validator</a></li>
<li><a href="../DeviseAuth.html">DeviseAuth</a></li>
<li><a href="../DeviseAuth/RegistrationsController.html">DeviseAuth::RegistrationsController</a></li>
<li><a href="../DeviseAuth/SessionsController.html">DeviseAuth::SessionsController</a></li>
<li><a href="../Users.html">Users</a></li>
<li><a href="../Users/OmniauthCallbacksController.html">Users::OmniauthCallbacksController</a></li>
<li><a href="../ApplicationController.html">ApplicationController</a></li>
<li><a href="../ApplicationHelper.html">ApplicationHelper</a></li>
<li><a href="../Artist.html">Artist</a></li>
<li><a href="../ArtistsController.html">ArtistsController</a></li>
<li><a href="../ChartsController.html">ChartsController</a></li>
<li><a href="../HomeController.html">HomeController</a></li>
<li><a href="../Playlist.html">Playlist</a></li>
<li><a href="../PlaylistsTracks.html">PlaylistsTracks</a></li>
<li><a href="../RedisQueryable.html">RedisQueryable</a></li>
<li><a href="../SearchController.html">SearchController</a></li>
<li><a href="../Track.html">Track</a></li>
<li><a href="../TracksController.html">TracksController</a></li>
<li><a href="../User.html">User</a></li>
<li><a href="../UsersController.html">UsersController</a></li>
<li><a href="../UsersHelper.html">UsersHelper</a></li>
<li><a href="../YoutubeVideoRating.html">YoutubeVideoRating</a></li>
</ul>
<div id="no-class-search-results" style="display: none;">No matching classes.</div>
</div>
</div>
</div>
<div id="documentation">
<h1 class="class">LastFM::Track</h1>
<div id="description">
</div>
<!-- Constants -->
<!-- Attributes -->
<!-- Methods -->
<div id="public-class-method-details" class="method-section section">
<h3 class="section-header">Public Class Methods</h3>
<div id="get-nfo-method" class="method-detail ">
<a name="method-c-getInfo"></a>
<div class="method-heading">
<span class="method-name">getInfo</span><span
class="method-args">(track, artist)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>
return: track name, id, (top)tags, artist, duration (in msec), album (
artist, title, image urls ( different sizes) ), mbid
</p>
<div class="method-source-code"
id="get-nfo-source">
<pre>
<span class="ruby-comment cmt"># File lib/last_fm/track.rb, line 13</span>
13: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">getInfo</span> <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>
14: <span class="ruby-identifier">track_request</span> <span class="ruby-value str">&quot;getInfo&quot;</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>
15: <span class="ruby-keyword kw">end</span></pre>
</div>
</div>
</div>
<div id="get-imilar-method" class="method-detail ">
<a name="method-c-getSimilar"></a>
<div class="method-heading">
<span class="method-name">getSimilar</span><span
class="method-args">(track, artist, limit = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>
return: tracks ( name, artist (name, mbid), duration (in msec), image urls
(sometimes) )
</p>
<div class="method-source-code"
id="get-imilar-source">
<pre>
<span class="ruby-comment cmt"># File lib/last_fm/track.rb, line 18</span>
18: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">getSimilar</span> <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>, <span class="ruby-identifier">limit</span> = <span class="ruby-keyword kw">nil</span>
19: <span class="ruby-identifier">track_request</span> <span class="ruby-value str">&quot;getSimilar&quot;</span>, <span class="ruby-value str">&quot;similartracks&quot;</span>, <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>, <span class="ruby-identifier">limit</span>
20: <span class="ruby-keyword kw">end</span></pre>
</div>
</div>
</div>
<div id="get-op-ags-method" class="method-detail ">
<a name="method-c-getTopTags"></a>
<div class="method-heading">
<span class="method-name">getTopTags</span><span
class="method-args">(track, artist)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>
return: tags ( name, tag´s last.fm-url ) ordered by popularity
</p>
<div class="method-source-code"
id="get-op-ags-source">
<pre>
<span class="ruby-comment cmt"># File lib/last_fm/track.rb, line 23</span>
23: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">getTopTags</span> <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>
24: <span class="ruby-identifier">track_request</span> <span class="ruby-value str">&quot;getTopTags&quot;</span>, <span class="ruby-value str">&quot;toptags&quot;</span>, <span class="ruby-identifier">track</span>, <span class="ruby-identifier">artist</span>
25: <span class="ruby-keyword kw">end</span></pre>
</div>
</div>
</div>
<div id="search-method" class="method-detail ">
<a name="method-c-search"></a>
<div class="method-heading">
<span class="method-name">search</span><span
class="method-args">(query, limit = nil, page = nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code"
id="search-source">
<pre>
<span class="ruby-comment cmt"># File lib/last_fm/track.rb, line 4</span>
4: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">search</span> <span class="ruby-identifier">query</span>, <span class="ruby-identifier">limit</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">page</span> = <span class="ruby-keyword kw">nil</span>
5: <span class="ruby-identifier">track_request</span> <span class="ruby-value str">&quot;search&quot;</span>, <span class="ruby-value str">&quot;trackmatches&quot;</span>, <span class="ruby-identifier">query</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">limit</span>, <span class="ruby-identifier">page</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">result</span><span class="ruby-operator">|</span>
6: <span class="ruby-identifier">result</span> = <span class="ruby-constant">LastFM</span><span class="ruby-operator">::</span><span class="ruby-constant">Validator</span>.<span class="ruby-identifier">validate_mash</span> <span class="ruby-identifier">result</span>
7: <span class="ruby-identifier">result</span> = <span class="ruby-constant">Hashie</span><span class="ruby-operator">::</span><span class="ruby-constant">Mash</span>.<span class="ruby-identifier">new</span>({ <span class="ruby-value">:track</span> =<span class="ruby-operator">&gt;</span> [] }) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">blank?</span>
8: <span class="ruby-identifier">update_results</span> [<span class="ruby-identifier">current_class_name</span>, <span class="ruby-identifier">__method__</span>], <span class="ruby-identifier">result</span>
9: <span class="ruby-keyword kw">end</span>
10: <span class="ruby-keyword kw">end</span></pre>
</div>
</div>
</div>
</div>
</div>
<div id="rdoc-debugging-section-dump" class="debugging-section">
<p>Disabled; run with --debug to generate this.</p>
</div>
<div id="validator-badges">
<p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
<p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
Rdoc Generator</a> 1.1.6</small>.</p>
</div>
</body>
</html>