Net::U...nderer(3pm)

💖 Net::UPnP::AV::MediaRenderer — bestie edition 💖

okay so this is the page for Net::UPnP::AV::MediaRenderer, straight outta the User Contributed Perl Documentation collection — it's a (3pm) page, aka a Perl module manpage, and it's here to teach you how to boss around your UPnP media renderers. ✨

---

🌸 NAME 🌸

Net::UPnP::AV::MediaRenderer — a Perl extension for UPnP. 🦋

---

🎀 SYNOPSIS 🎀

here's the whole vibe, copy-paste ready:

    use Net::UPnP::ControlPoint;
    use Net::UPnP::AV::MediaRenderer;

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

    @dev_list = ();
    while (@dev_list <= 0 || $retry_cnt > 5) {
        @dev_list = $obj->search(st =>'upnp:rootdevice', mx => 3);
        $retry_cnt++;
    }

    $devNum= 0;
    foreach $dev (@dev_list) {
        my $device_type = $dev->getdevicetype();
        if  ($device_type ne 'urn:schemas-upnp-org:device:MediaRenderer:1') {
            next;
        }
        my $friendlyname = $dev->getfriendlyname();
        print "[$devNum] : " . $friendlyname . "\n";
        my $renderer = Net::UPnP::AV::MediaRenderer->new();
        $renderer->setdevice($dev);
        $renderer->stop();
        $renderer->setAVTransportURI(CurrentURI => 'http://xxx.xxx.xxx.xxx/xxxx.mpg');
        $renderer->play();
        $devNum++;
    }

like, search for devices, filter for the renderer type, grab the friendly name, print it, then make a renderer object, hook it to the device, stop, set a URI, play. the whole character arc fr fr. 🔥

---

💅 DESCRIPTION 💅

the package is a extension UPnP/AV media server. that's it, that's the description, no cap. 🫶

---

✨ METHODS ✨

🌟 new — create new Net::UPnP::AV::MediaRenderer.

        $renderer = Net::UPnP::AV::MediaRenderer();

Creates a new object. Read perldoc perlboot if you don't understand that. (ngl, if that sentence confused you, the perlboot docs are your bestie. 😭)

The new object is not associated with any UPnP devices. Please use setdevice() to set the device. 👑

---

🌟 setdevice — set a UPnP devices

        $renderer->setdevice($dev);

Set a device to the object. simple as. 🎀

---

🌟 setAVTransportURI — set a current content.

        @action_response = $renderer->setAVTransportURI(
                                            InstanceID => $instanceID, # 0
                                            CurrentURI => $url, # ''
                                            CurrentURIMetaData => $metaData, # "'
                                            );

Set a current content to play, Net::UPnP::ActionResponse. 💖

---

🌟 setNextAVTransportURI — set a next content.

            @action_response = $renderer->setNextAVTransportURI(
                                                                                    InstanceID => $instanceID, # 0
                                            NextURI => $url, # ''
                                            NextURIMetaData => $metaData, # "'
                                                                                    );

Set a next content to play, Net::UPnP::ActionResponse. ✨

---

🌟 play — play.

        @action_response = $renderer->play(
                                                                                    InstanceID => $instanceID, # 0
                                                                                    Speed => $url, # 1
                                                                                    );

Play the specified content. main character energy, literally. 👑

---

🌟 stop — stop.

        @action_response = $renderer->stop(
                                                                                    InstanceID => $instanceID, # 0
                                                                                    );

Stop the playing content. periodt. 💅

---

🦋 SEE ALSO 🦋

• Net::UPnP::AV::Content
• Net::UPnP::AV::Item
• Net::UPnP::AV::Container

---

🌈 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.

---

and that's the whole page bestie 🫶 this copy came from perl v5.36.0, dated 2022-12-06 — shoutout to the original Net::UPnP::AV::MediaRenderer(3pm) header and footer for holding it down. now go forth and control some renderers, you iconic legend. 💖✨🎀