:right-sidebar: True

URIHandler
===================================================================

.. currentmodule:: gi.repository.Gst





.. class:: URIHandler(*args, **kwargs)
   :no-contents-entry:






The :obj:`~gi.repository.Gst.URIHandler` is an interface that is implemented by Source and Sink
:obj:`~gi.repository.Gst.Element` to unify handling of URI.

An application can use the following functions to quickly get an element
that handles the given URI for reading or writing
(:func:`~gi.repository.Gst.Element.make_from_uri`).

Source and Sink plugins should implement this interface when possible.




Methods
-------

.. rst-class:: interim-class

.. class:: URIHandler
   :no-index:


   .. method:: get_protocols() -> list[str] | None

      Gets the list of protocols supported by ``handler``\. This list may not be
      modified.









   .. method:: get_uri() -> str | None

      Gets the currently handled URI.









   .. method:: get_uri_type() -> ~gi.repository.Gst.URIType

      Gets the type of the given URI handler









   .. method:: set_uri(uri: str) -> bool

      Tries to set the URI of the given handler.






      :param uri: URI to set












Virtual Methods
---------------

.. rst-class:: interim-class

.. class:: URIHandler
   :no-index:
   

   .. method:: do_get_uri() -> str | None

      Gets the currently handled URI.









   .. method:: do_set_uri(uri: str) -> bool

      Tries to set the URI of the given handler.






      :param uri: URI to set