Cling Support

Utility, helper, and template classes for developers working with Cling Core are available in the Cling Support module.

Currently bundled in Cling Support are:

InternetGatewayDevice utilities: Create NAT port mappings, query the external IP address, and work with the connections of your InternetGatewayDevice:1.
AVTransport abstract service: An abstract implementation of the UPnP AVTransport:1 service template, with a state machine, data transfer classes for all types, and full support for per-instance eventing through LastChange. Use this and the following two abstract services if you want to implement a MediaRenderer service or a control point for such a service.
RenderingControl abstract service: An abstract implementation of the UPnP RenderingControl:1 service template, focusing on audio control (volume and channels), with full support for per-instance eventing through LastChange.
ConnectionManager abstract service: An abstract implementation of the UPnP ConnectionManager:1 service template, with type-safe protocol information exchange and mime-type content negotiation feature ("Can this renderer accept the resource offered by this content directory?").
ContentDirectory browser: Client and server classes for working with a UPnP ContentDirectory:1. A complete and type-safe model for DIDL, DC, and UPnP elements as required by the content directory XML descriptors. A hand-written and extensible descriptor generator and parser. Use this if you want to implement a MediaServer service or a control point for such a service.
MessageBox: Notification messages for networked Samsung TVs - send any message to your TV via UPnP.

Getting Started

If you are using Maven, add the following dependency to your pom.xml:

<repositories>
    <repository>
        <id>teleal-repo</id>
        <url>http://teleal.org/m2</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>org.teleal.cling</groupId>
        <artifactId>cling-support</artifactId>
        <version>1.0.5</version>
    </dependency>
</dependencies>

Consult the Cling Support manual for detailed documentation of all features, as well as the Cling Core manual for basic setup and usage of the Cling UPnP framework.

Cling Support is Free Software, distributed under the terms of the GNU Lesser General Public License.

org.teleal.cling:cling-support:1.0.5