Mercurial > libervia-backend
view libervia/backend/plugins/plugin_xep_0103.py @ 4240:79c8a70e1813
backend, frontend: prepare remote control:
This is a series of changes necessary to prepare the implementation of remote control
feature:
- XEP-0166: add a `priority` attribute to `ApplicationData`: this is needed when several
applications are working in a same session, to know which one must be handled first.
Will be used to make Remote Control have precedence over Call content.
- XEP-0166: `_call_plugins` is now async and is not used with `DeferredList` anymore: the
benefit to have methods called in parallels is very low, and it cause a lot of trouble
as we can't predict order. Methods are now called sequentially so workflow can be
predicted.
- XEP-0167: fix `senders` XMPP attribute <=> SDP mapping
- XEP-0234: preflight acceptance key is now `pre-accepted` instead of `file-accepted`, so
the same key can be used with other jingle applications.
- XEP-0167, XEP-0343: move some method to XEP-0167
- XEP-0353: use new `priority` feature to call preflight methods of applications according
to it.
- frontend (webrtc): refactor the sources/sink handling with a more flexible mechanism
based on Pydantic models. It is now possible to have has many Data Channel as necessary,
to have them in addition to A/V streams, to specify manually GStreamer sources and
sinks, etc.
- frontend (webrtc): rework of the pipeline to reduce latency.
- frontend: new `portal_desktop` method. Screenshare portal handling has been moved there,
and RemoteDesktop portal has been added.
- frontend (webrtc): fix `extract_ufrag_pwd` method.
rel 436
author | Goffi <goffi@goffi.org> |
---|---|
date | Sat, 11 May 2024 13:52:41 +0200 |
parents | 4b842c1fb686 |
children | 0d7bb4df2343 |
line wrap: on
line source
#!/usr/bin/env python3 # Copyright (C) 2009-2022 Jérôme Poisson (goffi@goffi.org) # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # This program 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 Affero General Public License for more details. # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. from typing import Dict, Any from twisted.words.xish import domish from libervia.backend.core.constants import Const as C from libervia.backend.core.i18n import _ from libervia.backend.core.log import getLogger from libervia.backend.core import exceptions log = getLogger(__name__) PLUGIN_INFO = { C.PI_NAME: "URL Address Information", C.PI_IMPORT_NAME: "XEP-0103", C.PI_TYPE: "XEP", C.PI_MODES: C.PLUG_MODE_BOTH, C.PI_PROTOCOLS: ["XEP-0103"], C.PI_MAIN: "XEP_0103", C.PI_HANDLER: "no", C.PI_DESCRIPTION: _("""Implementation of XEP-0103 (URL Address Information)"""), } NS_URL_DATA = "http://jabber.org/protocol/url-data" class XEP_0103: namespace = NS_URL_DATA def __init__(self, host): log.info(_("XEP-0103 (URL Address Information) plugin initialization")) host.register_namespace("url-data", NS_URL_DATA) def get_url_data_elt( self, url: str, **kwargs ) -> domish.Element: """Generate the element describing the URL @param url: URL to use @param extra: extra metadata describing how to access the URL @return: ``<url-data/>`` element """ url_data_elt = domish.Element((NS_URL_DATA, "url-data")) url_data_elt["target"] = url return url_data_elt def parse_url_data_elt( self, url_data_elt: domish.Element ) -> Dict[str, Any]: """Parse <url-data/> element @param url_data_elt: <url-data/> element a parent element can also be used @return: url-data data. It's a dict whose keys correspond to [get_url_data_elt] parameters @raise exceptions.NotFound: no <url-data/> element has been found """ if url_data_elt.name != "url-data": try: url_data_elt = next( url_data_elt.elements(NS_URL_DATA, "url-data") ) except StopIteration: raise exceptions.NotFound try: data: Dict[str, Any] = {"url": url_data_elt["target"]} except KeyError: raise ValueError(f'"target" attribute is missing: {url_data_elt.toXml}') return data