libpurple/media/backend-iface.c

branch
cpw.maiku.media_refactor
changeset 29555
15bb28ca4cf6
child 29558
a151d2be726c
equal deleted inserted replaced
29554:f6ea03b38873 29555:15bb28ca4cf6
1 /**
2 * @file backend-iface.c Interface for media backend
3 * @ingroup core
4 */
5
6 /* purple
7 *
8 * Purple is the legal property of its developers, whose names are too numerous
9 * to list here. Please refer to the COPYRIGHT file distributed with this
10 * source distribution.
11 *
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
25 */
26
27 #include "backend-iface.h"
28
29 #include "marshallers.h"
30
31 enum {
32 S_ERROR,
33 CANDIDATES_PREPARED,
34 CODECS_CHANGED,
35 NEW_CANDIDATE,
36 ACTIVE_CANDIDATE_PAIR,
37 LAST_SIGNAL
38 };
39
40 static guint purple_media_backend_signals[LAST_SIGNAL] = {0};
41
42 enum {
43 PROP_0,
44 PROP_MEDIA,
45 };
46
47 static void
48 purple_media_backend_base_init(gpointer iface)
49 {
50 static gboolean is_initialized = FALSE;
51
52 if (is_initialized)
53 return;
54
55 g_object_class_install_property(iface, PROP_MEDIA,
56 g_param_spec_object("media",
57 "Purple Media",
58 "The media object that this backend is bound to.",
59 PURPLE_TYPE_MEDIA,
60 G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE));
61
62 purple_media_backend_signals[S_ERROR] =
63 g_signal_new("error", G_TYPE_FROM_CLASS(iface),
64 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
65 g_cclosure_marshal_VOID__STRING,
66 G_TYPE_NONE, 1, G_TYPE_STRING);
67 purple_media_backend_signals[CANDIDATES_PREPARED] =
68 g_signal_new("candidates-prepared",
69 G_TYPE_FROM_CLASS(iface),
70 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
71 purple_smarshal_VOID__STRING_STRING,
72 G_TYPE_NONE, 2, G_TYPE_STRING,
73 G_TYPE_STRING);
74 purple_media_backend_signals[CODECS_CHANGED] =
75 g_signal_new("codecs-changed",
76 G_TYPE_FROM_CLASS(iface),
77 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
78 g_cclosure_marshal_VOID__STRING,
79 G_TYPE_NONE, 1, G_TYPE_STRING);
80 purple_media_backend_signals[NEW_CANDIDATE] =
81 g_signal_new("new-candidate",
82 G_TYPE_FROM_CLASS(iface),
83 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
84 purple_smarshal_VOID__POINTER_POINTER_OBJECT,
85 G_TYPE_NONE, 3, G_TYPE_POINTER,
86 G_TYPE_POINTER, PURPLE_TYPE_MEDIA_CANDIDATE);
87 purple_media_backend_signals[ACTIVE_CANDIDATE_PAIR] =
88 g_signal_new("active-candidate-pair",
89 G_TYPE_FROM_CLASS(iface),
90 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
91 purple_smarshal_VOID__STRING_STRING_OBJECT_OBJECT,
92 G_TYPE_NONE, 4, G_TYPE_STRING, G_TYPE_STRING,
93 PURPLE_TYPE_MEDIA_CANDIDATE,
94 PURPLE_TYPE_MEDIA_CANDIDATE);
95
96 is_initialized = TRUE;
97 }
98
99 GType
100 purple_media_backend_get_type(void)
101 {
102 static GType iface_type = 0;
103 if (iface_type == 0) {
104 static const GTypeInfo info = {
105 sizeof(PurpleMediaBackendIface),
106 purple_media_backend_base_init,
107 NULL,
108 NULL,
109 NULL,
110 NULL,
111 0,
112 0,
113 NULL,
114 NULL
115 };
116
117 iface_type = g_type_register_static (G_TYPE_INTERFACE,
118 "PurpleMediaBackend", &info, 0);
119 }
120
121 return iface_type;
122 }
123
124 gboolean
125 purple_media_backend_add_stream(PurpleMediaBackend *self,
126 const gchar *sess_id, const gchar *who,
127 PurpleMediaSessionType type, gboolean initiator,
128 const gchar *transmitter,
129 guint num_params, GParameter *params)
130 {
131 g_return_val_if_fail(PURPLE_IS_MEDIA_BACKEND(self), FALSE);
132 return PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->add_stream(self,
133 sess_id, who, type, initiator, transmitter,
134 num_params, params);
135 }
136
137 void
138 purple_media_backend_add_remote_candidates(PurpleMediaBackend *self,
139 const gchar *sess_id, const gchar *participant,
140 GList *remote_candidates)
141 {
142 g_return_if_fail(PURPLE_IS_MEDIA_BACKEND(self));
143 PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->add_remote_candidates(self,
144 sess_id, participant, remote_candidates);
145 }
146
147
148 GList *
149 purple_media_backend_get_codecs(PurpleMediaBackend *self,
150 const gchar *sess_id)
151 {
152 g_return_val_if_fail(PURPLE_IS_MEDIA_BACKEND(self), NULL);
153 return PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->get_codecs(self,
154 sess_id);
155 }
156
157 GList *
158 purple_media_backend_get_local_candidates(PurpleMediaBackend *self,
159 const gchar *sess_id, const gchar *participant)
160 {
161 g_return_val_if_fail(PURPLE_IS_MEDIA_BACKEND(self), NULL);
162 return PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->
163 get_local_candidates(self,
164 sess_id, participant);
165 }
166
167 void
168 purple_media_backend_set_remote_codecs(PurpleMediaBackend *self,
169 const gchar *sess_id, const gchar *participant,
170 GList *codecs)
171 {
172 g_return_if_fail(PURPLE_IS_MEDIA_BACKEND(self));
173 PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->set_remote_codecs(self,
174 sess_id, participant, codecs);
175 }
176
177 void
178 purple_media_backend_set_send_codec(PurpleMediaBackend *self,
179 const gchar *sess_id, PurpleMediaCodec *codec)
180 {
181 g_return_if_fail(PURPLE_IS_MEDIA_BACKEND(self));
182 PURPLE_MEDIA_BACKEND_GET_INTERFACE(self)->set_send_codec(self,
183 sess_id, codec);
184 }

mercurial