comparison libervia/backend/plugins/plugin_xep_0261.py @ 4231:e11b13418ba6

plugin XEP-0353, XEP-0234, jingle: WebRTC data channel signaling implementation: Implement XEP-0343: Signaling WebRTC Data Channels in Jingle. The current version of the XEP (0.3.1) has no implementation and contains some flaws. After discussing this on xsf@, Daniel (from Conversations) mentioned that they had a sprint with Larma (from Dino) to work on another version and provided me with this link: https://gist.github.com/iNPUTmice/6c56f3e948cca517c5fb129016d99e74 . I have used it for my implementation. This implementation reuses work done on Jingle A/V call (notably XEP-0176 and XEP-0167 plugins), with adaptations. When used, XEP-0234 will not handle the file itself as it normally does. This is because WebRTC has several implementations (browser for web interface, GStreamer for others), and file/data must be handled directly by the frontend. This is particularly important for web frontends, as the file is not sent from the backend but from the end-user's browser device. Among the changes, there are: - XEP-0343 implementation. - `file_send` bridge method now use serialised dict as output. - New `BaseTransportHandler.is_usable` method which get content data and returns a boolean (default to `True`) to tell if this transport can actually be used in this context (when we are initiator). Used in webRTC case to see if call data are available. - Support of `application` media type, and everything necessary to handle data channels. - Better confirmation message, with file name, size and description when available. - When file is accepted in preflight, it is specified in following `action_new` signal for actual file transfer. This way, frontend can avoid the display or 2 confirmation messages. - XEP-0166: when not specified, default `content` name is now its index number instead of a UUID. This follows the behaviour of browsers. - XEP-0353: better handling of events such as call taken by another device. - various other updates. rel 441
author Goffi <goffi@goffi.org>
date Sat, 06 Apr 2024 12:57:23 +0200
parents 4b842c1fb686
children 0d7bb4df2343
comparison
equal deleted inserted replaced
4230:314d3c02bb67 4231:e11b13418ba6
18 # along with this program. If not, see <http://www.gnu.org/licenses/>. 18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
19 19
20 from libervia.backend.core.i18n import _ 20 from libervia.backend.core.i18n import _
21 from libervia.backend.core.constants import Const as C 21 from libervia.backend.core.constants import Const as C
22 from libervia.backend.core.log import getLogger 22 from libervia.backend.core.log import getLogger
23 from libervia.backend.plugins.plugin_xep_0166.models import BaseTransportHandler
23 24
24 log = getLogger(__name__) 25 log = getLogger(__name__)
25 from wokkel import disco, iwokkel 26 from wokkel import disco, iwokkel
26 from zope.interface import implementer 27 from zope.interface import implementer
27 from twisted.words.xish import domish 28 from twisted.words.xish import domish
46 C.PI_HANDLER: "yes", 47 C.PI_HANDLER: "yes",
47 C.PI_DESCRIPTION: _("""Implementation of Jingle In-Band Bytestreams"""), 48 C.PI_DESCRIPTION: _("""Implementation of Jingle In-Band Bytestreams"""),
48 } 49 }
49 50
50 51
51 class XEP_0261(object): 52 class XEP_0261(BaseTransportHandler):
52 NAMESPACE = NS_JINGLE_IBB # used by XEP-0260 plugin for transport-replace 53 NAMESPACE = NS_JINGLE_IBB # used by XEP-0260 plugin for transport-replace
53 54
54 def __init__(self, host): 55 def __init__(self, host):
55 log.info(_("plugin Jingle In-Band Bytestreams")) 56 log.info(_("plugin Jingle In-Band Bytestreams"))
56 self.host = host 57 self.host = host