NAME

WebService::Ustream::API::Stream - Perl interface to Ustream Stream API Service

SYNOPSIS

  use WebService::Ustream::API::Stream;
  
  $ust = WebService::Ustream::API::Stream->new( { key => YOUR_KEY } );
  my $ret = $ust->recent(); 

  print $ret->{array}->{id};
  print $ret->{array}->{userId};
  print $ret->{array}->{userName};
  print $ret->{array}->{title};
  print $ret->{array}->{description};
  print $ret->{array}->{streamStartedAt};
  print $ret->{array}->{url};
  print $ret->{array}->{embedTag};

  my $ret = $ust->most_viewers();
  
  print $ret->{array}->{id};
  ..
  . same properties accessible as first example
  ..
  print $ret->{array}->{embedTag};

  my $ret = $ust->random();
  
  print $ret->{array}->{id};
  ..
  . same properties accessible as first example
  ..
  print $ret->{array}->{embedTag};

  my $ret = $ust->all_new();

  print $ret->{array}->{0}->{id};
  ..
  . same properties accessible as first example
  ..
  print $ret->{array}->{0}->{embedTag};

DESCRIPTION

WebService::Ustream::API::User is a simple interface to Ustream's user information.

METHODS

new(\%fields)

$ust = WebService::Ustream::API::User->new( { key => YOUR_KEY } );

Creates an instace of WebService::Ustream::API::User. KEY is required when you call Ustream API.

get([username or userid])

  my $ret = $ust->get('koba206');
  my $ret = $ust->get('19185'); #19185 is koba206's userid 

retrieve user account information

list_channels([username or userid])

 my $ret = $ust->list_channels('koba206');
 

retrieve all the channels belonging to a user

list_videos([username or userid])

  my $ret = $ust->list_videos('spacevidcast');

retrieve all the videos belonging to the user specified

get_comments([username or userid])

  my $ret = $ust->get_comments('koba206');

returns any comments for the user profile specified by username or userid

SEE ALSO

URI::Fetch http://developer.ustream.tv/

AUTHOR

Takeshi Kobayashi, <koba206@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Takeshi Kobayashi

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.