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
|
/*
* Copyright (C) 2008,2010 Nokia Corporation.
* Copyright (C) 2012 Intel Corporation.
*
* Author: Zeeshan Ali (Khattak) <zeeshanak@gnome.org>
* <zeeshan.ali@nokia.com>
*
* This file is part of Rygel.
*
* Rygel is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* Rygel is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/**
* This is the base class for every Rygel implementation of a UPnP media
* server. It should be used either for a real plug-in for the Rygel process or used
* in-process via the librygel-server API.
*/
public abstract class Rygel.MediaServerPlugin : Rygel.Plugin {
private static const string MEDIA_SERVER_DESC_PATH =
BuildConfig.DATA_DIR + "/xml/MediaServer3.xml";
public MediaContainer root_container { get; private set; }
/**
* Create an instance of the plugin.
* The plugin's service will have the same title as its root container.
*
* @param root_container The container that should be served by this plugin's service.
* @param name The non-human-readable name for the plugin and its service, used in UPnP messages and in the Rygel configuration file.
* @param description An optional human-readable description (modelDescription) of the UPnP service provided by the plugin.
*/
public MediaServerPlugin (MediaContainer root_container,
string name,
string? description = null,
PluginCapabilities capabilities =
PluginCapabilities.NONE) {
base (MEDIA_SERVER_DESC_PATH,
name,
root_container.title,
description,
capabilities);
this.root_container = root_container;
var path = ContentDirectory.DESCRIPTION_PATH_NO_TRACK;
// MediaServer implementations must implement ContentDirectory service
if (PluginCapabilities.TRACK_CHANGES in this.capabilities) {
path = ContentDirectory.DESCRIPTION_PATH;
}
var info = new ResourceInfo (ContentDirectory.UPNP_ID,
ContentDirectory.UPNP_TYPE,
path,
typeof (ContentDirectory));
this.add_resource (info);
// Register Rygel.ConnectionManager
info = new ResourceInfo (ConnectionManager.UPNP_ID,
ConnectionManager.UPNP_TYPE,
ConnectionManager.DESCRIPTION_PATH,
typeof (SourceConnectionManager));
this.add_resource (info);
info = new ResourceInfo (MediaReceiverRegistrar.UPNP_ID,
MediaReceiverRegistrar.UPNP_TYPE,
MediaReceiverRegistrar.DESCRIPTION_PATH,
typeof (MediaReceiverRegistrar));
this.add_resource (info);
if (root_container.child_count == 0) {
debug ("Deactivating plugin '%s' until it provides content.",
this.name);
this.active = false;
root_container.container_updated.connect
(this.on_container_updated);
}
}
public override void apply_hacks (RootDevice device,
string description_path)
throws Error {
// Apply V1 downgrades
var v1_hacks = new V1Hacks ();
v1_hacks.apply_on_device (device, description_path);
// Apply XBox hacks on top of that
var xbox_hacks = new XBoxHacks ();
xbox_hacks.apply_on_device (device, v1_hacks.description_path);
}
private void on_container_updated (MediaContainer root_container,
MediaContainer updated,
MediaObject object,
ObjectEventType event_type,
bool sub_tree_update) {
if (updated != root_container || updated.child_count == 0) {
return;
}
root_container.container_updated.disconnect
(this.on_container_updated);
debug ("Activating plugin '%s' since it now provides content.",
this.name);
this.active = true;
}
}
|
