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.