:right-sidebar: True MessageType =================================================================== .. currentmodule:: gi.repository.Gst .. class:: MessageType :no-contents-entry: The different message types that are available. Methods ------- .. rst-class:: interim-class .. class:: MessageType :no-index: .. method:: get_name(type: ~gi.repository.Gst.MessageType) -> str Get a printable name for the given message type. Do not modify or free. :param type: the message type .. method:: to_quark(type: ~gi.repository.Gst.MessageType) -> int Get the unique quark for the given message type. :param type: the message type Fields ------ .. rst-class:: interim-class .. class:: MessageType :no-index: .. attribute:: ANY Mask for all of the above messages. .. attribute:: APPLICATION Message posted by the application, possibly via an application-specific element. .. attribute:: ASYNC_DONE Posted by elements when they complete an ASYNC :obj:`~gi.repository.Gst.StateChange`. The application will only receive this message from the toplevel pipeline. .. attribute:: ASYNC_START Posted by elements when they start an ASYNC :obj:`~gi.repository.Gst.StateChange`. This message is not forwarded to the application but is used internally. .. attribute:: BUFFERING The pipeline is buffering. When the application receives a buffering message in the PLAYING state for a non-live pipeline it must PAUSE the pipeline until the buffering completes, when the percentage field in the message is 100%. For live pipelines, no action must be performed and the buffering percentage can be used to inform the user about the progress. .. attribute:: CLOCK_LOST The current clock as selected by the pipeline became unusable. The pipeline will select a new clock on the next PLAYING state change. The application should set the pipeline to PAUSED and back to PLAYING when this message is received. .. attribute:: CLOCK_PROVIDE An element notifies its capability of providing a clock. This message is used internally and never forwarded to the application. .. attribute:: DEVICE_ADDED Message indicating a :obj:`~gi.repository.Gst.Device` was added to a :obj:`~gi.repository.Gst.DeviceProvider` (Since: 1.4) .. attribute:: DEVICE_CHANGED Message indicating a :obj:`~gi.repository.Gst.Device` was changed a :obj:`~gi.repository.Gst.DeviceProvider` (Since: 1.16) .. attribute:: DEVICE_REMOVED Message indicating a :obj:`~gi.repository.Gst.Device` was removed from a :obj:`~gi.repository.Gst.DeviceProvider` (Since: 1.4) .. attribute:: DURATION_CHANGED The duration of a pipeline changed. The application can get the new duration with a duration query. .. attribute:: ELEMENT Element-specific message, see the specific element's documentation .. attribute:: EOS End-of-stream reached in a pipeline. The application will only receive this message in the PLAYING state and every time it sets a pipeline to PLAYING that is in the EOS state. The application can perform a flushing seek in the pipeline, which will undo the EOS state again. .. attribute:: ERROR An error occurred. When the application receives an error message it should stop playback of the pipeline and not assume that more data will be played. It is possible to specify a redirection url to the error messages by setting a ``redirect-location`` field into the error message, application or high level bins might use the information as required. .. attribute:: EXTENDED Message is an extended message type (see below). These extended message IDs can't be used directly with mask-based API like :func:`~gi.repository.Gst.Bus.poll` or :func:`~gi.repository.Gst.Bus.timed_pop_filtered`, but you can still filter for GST_MESSAGE_EXTENDED and then check the result for the specific type. (Since: 1.4) .. attribute:: HAVE_CONTEXT Message indicating that an element created a context (Since: 1.2) .. attribute:: INFO An info message occurred .. attribute:: INSTANT_RATE_REQUEST Message sent by elements to request the running time from the pipeline when an instant rate change should be applied (which may be in the past when the answer arrives). (Since: 1.18) .. attribute:: LATENCY Posted by elements when their latency changes. The application should recalculate and distribute a new latency. .. attribute:: NEED_CONTEXT Message indicating that an element wants a specific context (Since: 1.2) .. attribute:: NEW_CLOCK A new clock was selected in the pipeline. .. attribute:: PROGRESS A progress message. .. attribute:: PROPERTY_NOTIFY Message indicating a :obj:`~gi.repository.GObject.Object` property has changed (Since: 1.10) .. attribute:: QOS A buffer was dropped or an element changed its processing strategy for Quality of Service reasons. .. attribute:: REDIRECT Message indicating to request the application to try to play the given URL(s). Useful if for example a HTTP 302/303 response is received with a non-HTTP URL inside. (Since: 1.10) .. attribute:: REQUEST_STATE Posted by elements when they want the pipeline to change state. This message is a suggestion to the application which can decide to perform the state change on (part of) the pipeline. .. attribute:: RESET_TIME Message to request resetting the pipeline's running time from the pipeline. This is an internal message which applications will likely never receive. .. attribute:: SEGMENT_DONE Pipeline completed playback of a segment. This message is forwarded to the application after all elements that posted ``GST_MESSAGE_SEGMENT_START`` posted a GST_MESSAGE_SEGMENT_DONE message. .. attribute:: SEGMENT_START Pipeline started playback of a segment. This message is used internally and never forwarded to the application. .. attribute:: STATE_CHANGED A state change happened .. attribute:: STATE_DIRTY An element changed state in a streaming thread. This message is deprecated. .. attribute:: STEP_DONE A stepping operation finished. .. attribute:: STEP_START A stepping operation was started. .. attribute:: STREAMS_SELECTED Message indicating the active selection of :obj:`~gi.repository.Gst.Stream` has changed (Since: 1.10) .. attribute:: STREAM_COLLECTION Message indicating a new :obj:`~gi.repository.Gst.StreamCollection` is available (Since: 1.10) .. attribute:: STREAM_START Message indicating start of a new stream. Useful e.g. when using playbin in gapless playback mode, to get notified when the next title actually starts playing (which will be some time after the URI for the next title has been set). .. attribute:: STREAM_STATUS Status about a stream, emitted when it starts, stops, errors, etc.. .. attribute:: STRUCTURE_CHANGE The structure of the pipeline changed. This message is used internally and never forwarded to the application. .. attribute:: TAG A tag was found. .. attribute:: TOC A new table of contents (TOC) was found or previously found TOC was updated. .. attribute:: UNKNOWN An undefined message .. attribute:: WARNING A warning occurred.