| |
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 } |