Chumby Property Dictionary

From Chumby Wiki
Revision as of 05:59, 3 May 2008 by Wayn3w (Talk | contribs)

Jump to: navigation, search

Under development: --Wayn3w 20:45, 31 March 2008 (PDT)

_root

The following are properties of _root explicitly set by the Chumby environment.

_chumby_chumby_*

_chumby_chumby_id

_chumby_chumby_name

_chumby_clock_*

_chumby_clock_format

  • valid values are 12 and 24

_chumby_instance_*

_chumby_instance_url

_chumby_music_source_*

_selector _name _state _label
cbspodcasts CBS Podcasts
<item>
   <id>1</id>
   <name>Eye to Eye</name>
   <description>Hear newsmakers in their own words as Katie Couric picks the hottest
interview of the day.</description>
   <url>http://www.cbsnews.com/common/includes/podcast/podcast_kceye_1.rss</url>
   <image_url>http://content.chumby.com/podcast/cbs/image/1</image_url>
</item>
Eye to Eye: Sadr City
chumbcast Radio Free Chumby
<station channels="2" samplerate="44100" lc="1" 
 ct="WERS - Emerson College" genre="Independent" br="128" id="30" 
 mt="audio/mpeg" name="WERS- Emerson College" />
WERS - Emerson College
directurl My Streams
<stream url="http://www.wbur.org/listen/feed/shoutcast.pls" 
 id="a234a514-a483-4cd7-1869-46061aa805fc" mimetype="audio/x-scpls" name="WBUR" />
WBUR
ipod iPod
<playlist id="1" trackcount="13" fullTrackCOunt="13">
   <name>Bruce Springsteen</name>
</playlist>
Streets of Philadelpha
mediafly Mediafly Podcasts
<channel slug="history and culture" name="history and culture" />
US Job Losses; Dr King---s Dream; Primary News
mp3files My Music Files
<mp3files/>
(an empty string)
nytpodcasts New York Times Podcasts
<item>
   <id>25</id>
   <name>Front Page</name>
   <description>James Barron summarizes the top headlines every weekday 
morning.&lt;&gt;Schedule: Mon - Fri</description>
   <url>http://www.nytimes.com/services/xml/rss/nyt/podcasts/frontpage.xml</url>
   <image_url>http://content.chumby.com/podcast/ny_times/image/25</image_url>
</item>
NYT Front Page for 04/05/2008
shoutcast Shoutcast
<station lc="4311" ct="Ulrich Schnauss - Never Be The Same" 
genre="Ambient Chill" br="128" id="841" mt="audio/mpeg" 
name="Groove Salad: a plate of ambient beats and grooves. [Soma FM]" />
Groove Salad: a plate of ambient beats and grooves. [Soma FM]
slimserver SlimServer
<slimserver ip="172.25.251.11"/>
Streaming from 172.25.251.11
  • These parameters are not updated during the widget's run-time.

_chumby_music_source_state

  • Only set when music is playing
  • XML: Contains the properties of the current music selection.
  • the name of the entity changes depending on the music source.

_chumby_music_source_label

  • Only set when music is playing
  • Contains the name of the current playing

_chumby_music_source_name

  • Only set when music is playing
  • The name of the music source, such as "Radio Free Chumby" or "Mediafly Podcasts."

_chumby_music_source_selector

  • Only set when music is playing

_chumby_profile_*

_chumby_profile_id

_chumby_profile_name

_chumby_timer_*

_chumby_timer_expires

This value is the time (milliseconds after the epoch) when the current widget will expire, or -1 if the current widget is pinned. Unlike most of the other parameters, this value will be updated while a widget is running This will happen if the user interacts with the widget by pinning it or touching the screen.

You can get the current time in the same format as _chumby_timer_expires value by using the getTime() method of Date, as in:

var myDate:Date = new Date();
var expires:Number = _root["_chumby_timer_expires"];

if ( expires == -1 ) {
    trace ("ya pinned me!");
} else of ( expires - myDate.getTime() < 10000 ) {
    trace("less that ten seconds to go...");  
}

_chumby_user_*

_chumby_user_id

_chumby_user_name

_chumby_widget_*

_chumby_widget_done

  • Cooperative mode; setting it to true signals the widget is done
  • See Cooperative Mode

_chumby_widget_name

_chumby_widget_instance_*

_chumby_widget_instance_count

_chumby_widget_instance_href

  • URL of service which the widget uses to send widget parameters. The configuration widget uses a different URL if it needs to send new parameter values; see _chumby_instance_url
  • See Data Persistence

_chumby_widget_instance_id

_chumby_widget_instance_index