Net::UPnP::Device(3pm)

Net::UPnP::Device3pm

Perl extension for upnp.

Usage

    use Net::UPnP::ControlPoint;
    my $obj = Net::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++;
    }

Overview

The package is used a object of UPnP device.

Methods

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

Get the device description of the SSDP location header.

The function returns the all description when the name parameter is not specified, otherwise return a value the specified name.

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.

getmanufacturer - get the manufacturer.
    $manufacturer = $dev->getmanufacturer();

Get the manufacturer name from the device description.

getmanufacturerrul - get the manufacturer url.
    $manufacturer_url = $dev->getmanufacturerrul();

Get the manufacturer url from the device description.

getmodeldescription - get the model description.
    $model_description = $dev->getmodeldescription();

Get the model description from the device description.

getmodelname - get the model name.
    $model_name = $dev->getmodelname();

Get the model name from the device description.

getmodelnumber - get the model number.
    $model_number = $dev->getmodelnumber();

Get the model number from the device description.

getmodelurl - get the model url.
    $model_url = $dev->getmodelurl();

Get the model url from the device description.

getserialnumber - get the serialnumber.
    $serialnumber = $dev->getserialnumber();

Get the model description from the device description.

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

Get the UDN from the device description.

getupc - get the device UPC.
    $upc = $dev->getupc();

Get the UPC from the device description.

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

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

Releases

9 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0
  2. 6.0–9
  3. 10–11
  4. 12–13

Author

Satoshi Konno [email protected]

CyberGarage http://www.cybergarage.org

From libnet-upnp-perl 1.4.6-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.