NAME

UPnP::Device - Perl extension for UPnP.

SYNOPSIS

use UPnP::ControlPoint;

my $obj = UPnP::ControlPoint->new();

@dev_list = $obj->search(st =>'upnp:rootdevice', mx => 3);

$devNum= 0;
foreach $dev (@dev_list) {
    $device_type = $dev->getdevicetype();
    if  ($device_type ne 'urn:schemas-upnp-org:device:MediaServer:1') {
        next;
    }
    print "[$devNum] : " . $dev->getfriendlyname() . "\n";
    unless ($dev->getservicebyname('urn:schemas-upnp-org:service:ContentDirectory:1')) {
        next;
    }
    $condir_service = $dev->getservicebyname('urn:schemas-upnp-org:service:ContentDirectory:1');
    unless (defined(condir_service)) {
        next;
    }
    %action_in_arg = (
            'ObjectID' => 0,
            'BrowseFlag' => 'BrowseDirectChildren',

            'Filter' => '*',
            'StartingIndex' => 0,
            'RequestedCount' => 0,
            'SortCriteria' => '',
        );
    $action_res = $condir_service->postcontrol('Browse', \%action_in_arg);
    unless ($action_res->getstatuscode() == 200) {
    	next;
    }
    $actrion_out_arg = $action_res->getargumentlist();
    unless ($actrion_out_arg->{'Result'}) {
        next;
    }
    $result = $actrion_out_arg->{'Result'};
    while ($result =~ m/<dc:title>(.*?)<\/dc:title>/sgi) {
        print "\t$1\n";
    }
    $devNum++;
}

DESCRIPTION

The package is used a object of UPnP device.

METHODS

getdescription - get the description.
$description = $dev->getdescription();

Get the device description from the SSDP location header.

getdevicetype - get the device type.
$description = $dev->getdevicetype();

Get the device type from the device description.

getfriendlyname - get the device type.
$friendlyname = $dev->getfriendlyname();

Get the friendly name from the device description.

getudn - get the device type.
$udn = $dev->getudn();

Get the udn from the device description.

getservicelist - get the device type.
@service_list = $dev->getservicelist();

Get the service list in the device. Please see UPnP::Service too.

SEE ALSO

UPnP::Service

AUTHOR

Satoshi Konno skonno@cybergarage.org

CyberGarage http://www.cybergarage.org

COPYRIGHT AND LICENSE

Copyright (C) 2005 by Satoshi Konno

It may be used, redistributed, and/or modified under the terms of BSD License.