/
index.xhtml
124 lines (106 loc) · 4.45 KB
/
index.xhtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
<?xml version="1.0" encoding="utf-8"?>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Introduction</title>
</head>
<body>
<div id="content-body">
<h1>
Cling Support
</h1>
<p>
Utility, helper, and template classes for developers working with <a href="/projects/cling/core">Cling Core</a> are
available in the Cling Support module.
</p>
<p>
Currently bundled in Cling Support are:
</p>
<dl>
<dt><strong>InternetGatewayDevice utilities</strong></dt>
<dd>
<p>
Create <a href="/projects/cling/support/manual/cling-support-manual.html#section.PortMapping">NAT port mappings</a>,
<a href="/projects/cling/support/manual/cling-support-manual.html#section.ConnectionInfo">query the external IP address</a>,
and work with the connections of your <em>InternetGatewayDevice:1</em>.
</p>
</dd>
<dt><strong>AVTransport abstract service</strong></dt>
<dd>
<p>
An abstract implementation of the UPnP <em>AVTransport:1</em> service template,
with a state machine, data transfer classes for all types, and full support for per-instance eventing
through <em>LastChange</em>. Use this and the following two abstract services if you want to
implement a <em>MediaRenderer</em> service or a control point for such a service.
</p>
</dd>
<dt><strong>RenderingControl abstract service</strong></dt>
<dd>
<p>
An abstract implementation of the UPnP <em>RenderingControl:1</em> service template,
focusing on audio control (volume and channels), with full support for per-instance eventing
through <em>LastChange</em>.
</p>
</dd>
<dt><strong>ConnectionManager abstract service</strong></dt>
<dd>
<p>
An abstract implementation of the UPnP <em>ConnectionManager:1</em> 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?").
</p>
</dd>
<dt><strong>ContentDirectory browser</strong></dt>
<dd>
<p>
Client and server classes for working with a UPnP <em>ContentDirectory:1</em>. 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
<em>MediaServer</em> service or a control point for such a service.
</p>
</dd>
<dt><strong>MessageBox</strong></dt>
<dd>
<p>
Notification messages for networked Samsung TVs -
<a href="/projects/cling/support/manual/cling-support-manual.html#chapter.MessageBox">send any
message to your TV via UPnP</a>.
</p>
</dd>
</dl>
<h2>
Getting Started
</h2>
<p>
If you are using Maven, add the following dependency to your <code>pom.xml</code>:
</p>
<pre class="prettyprint"><![CDATA[<repositories>
<repository>
<id>4thline-repo</id>
<url>http://4thline.org/m2</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>org.fourthline.cling</groupId>
<artifactId>cling-support</artifactId>
<version>2.1.2-SNAPSHOT</version>
</dependency>
</dependencies>]]></pre>
<p>
Consult the <a href="/projects/cling/support/manual/cling-support-manual.html">Cling Support manual</a> for
detailed documentation of all features, as well as the
<a href="/projects/cling/core/manual/cling-core-manual.html">Cling Core manual</a> for basic setup and usage
of the Cling UPnP framework.
</p>
<p>
Cling is Free Software, distributed under the terms of
the <a class="externalLink" href="http://www.gnu.org/licenses/lgpl-2.1.html">GNU Lesser General Public
License</a> <strong>or at your option</strong> the <a href="http://opensource.org/licenses/CDDL-1.0">Common
Development and Distribution License</a>.
</p>
</div>
</body>
</html>