git clone https://@opensourceprojects.eu/git/p/libupnppsamples/code libupnppsamples-code
Read Me
= libupnpp sample programs
This repository has a bunch of small(ish) sample programs to help with
starting-up a libupnpp-based project. Some of them may be useful in their
own right but beware:
NOTE: none of the samples take a lot of care about managing memory because
they're of the 'run once and die' kind. Be careful about cleanup if you
integrate bits of code in a longer-running program.
The different samples are hopefully commented enough to be understandable
and useful.
== samples
=== src/uplistdir.cpp
Just list all devices and services on the local network, using the simple
libupnpp discovery 'traverse' method, which has to wait for the full
discovery window.
=== src/rdcvolume.cpp
Control the volume on an UPnP AV renderer, using the keyboard. This is a
simple demonstration of using a predefined libupnpp control class to control a
standard device. It uses discovery callbacks to connect to the device as
soon as it responds to search.
=== src/myrdcvolume.cpp
This is functionally the same as rdcvolume, but it defines its own service
control interface class. This is to show how you can do stuff without the
predefined control classes, and use libupnpp to control an arbitrary UPnP
device.
=== hello_src/hellodevice.cpp, hello_src/helloctl.cpp
This shows how to implement a "Hello World" device/service and the
corresponding control interface. Nothing in there that is not more
interestingly implemented in upmpdcli, but it is as simple as possible,
so certainly easier to understand.
=== upsend_src
A program to send an audio file to an UPnP AV renderer, without using a
Media Server. Can also send a 44100/16/2 stream read on stdin as a wav
file. The file description part (DIDL) is not too smart, but most
renderers don't seem to care. It uses libmicrohttpd to serve the audio file
to the renderer. Possibly could be improved and find a use.
=== src/multirdr.cpp
Shows that we can get events from multiple UPnP AV renderers.
=== src/upexplo.cpp
Has a whole bunch of more or less useful code snippets, accessing UPnP AV
Media Server and Renderer services.
=== src/ohradio.cpp, src/ohsender.cpp
Code to interface the OpenHome Radio and Sender services. Not sure that
this is good for anything...
Jean-Francois Dockes