> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# transmisión en tiempo real

Utilidades robustas de transmisión en tiempo real para el SDK de X API.

Este módulo proporciona gestión de conexiones de transmisión en tiempo real con reconexión automática,
backoff exponencial y manejo exhaustivo de errores. Los clientes pueden consumir
endpoints de transmisión en tiempo real sin preocuparse por la gestión de la conexión: el SDK
se encarga de todo el restablecimiento de forma automática.

<div id="class-xdkstreamingstreamconfig">
  ### `class xdk.streaming.StreamConfig`
</div>

Configuración para conexiones de streaming con lógica de reintento.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.max_retries" type="int" default="10" />

<ParamField path="path.initial_backoff" type="float" default="1.0" />

<ParamField path="path.max_backoff" type="float" default="64.0" />

<ParamField path="path.backoff_multiplier" type="float" default="2.0" />

<ParamField path="path.jitter" type="bool" default="True" />

<ParamField path="path.timeout" type="float or None" default="None" />

<ParamField path="path.chunk_size" type="int" default="1024" />

<ParamField path="path.on_connect" type="Callable[[], None] or None" default="None" />

<ParamField path="path.on_disconnect" type="Callable[[Exception or None], None] or None" default="None" />

<ParamField path="path.on_reconnect" type="Callable[[int, float], None] or None" default="None" />

<ParamField path="path.on_error" type="Callable[[[StreamError" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.max_retries" type="int" default="10" />

<ParamField path="path.initial_backoff" type="float" default="1.0" />

<ParamField path="path.max_backoff" type="float" default="64.0" />

<ParamField path="path.backoff_multiplier" type="float" default="2.0" />

<ParamField path="path.jitter" type="bool" default="True" />

<ParamField path="path.timeout" type="float or None" default="None" />

<ParamField path="path.chunk_size" type="int" default="1024" />

<ParamField path="path.on_connect" type="Callable[[], None] or None" default="None" />

<ParamField path="path.on_disconnect" type="Callable[[Exception or None], None] or None" default="None" />

<ParamField path="path.on_reconnect" type="Callable[[int, float], None] or None" default="None" />

<ParamField path="path.on_error" type="Callable[[[StreamError" />

<div id="on_error-callablestreamerror">
  ### `on_error : Callable[[[StreamError]`
</div>

<div id="exception-xdkstreamingstreamerror">
  ### `exception xdk.streaming.StreamError`
</div>

Excepción que se lanza para errores de streaming con clasificación.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.message" type="str" />

<ParamField path="path.error_type" type="StreamErrorType" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.message" type="str" />

<ParamField path="path.error_type" type="StreamErrorType" />

<div id="class-xdkstreamingstreamerrortype">
  ### `class xdk.streaming.StreamErrorType`
</div>

Clasificación de errores de streaming para tomar decisiones de reintento.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.value" type="Any" />

<div id="class-xdkstreamingstreamstate">
  ### `class xdk.streaming.StreamState`
</div>

Estado interno de una conexión de streaming.

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.retry_count" type="int" default="0" />

<ParamField path="path.current_backoff" type="float" default="1.0" />

<ParamField path="path.is_connected" type="bool" default="False" />

<ParamField path="path.total_items_received" type="int" default="0" />

<ParamField path="path.last_error" type="StreamError" />

<div id="__init__">
  ### `__init__`
</div>

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.retry_count" type="int" default="0" />

<ParamField path="path.current_backoff" type="float" default="1.0" />

<ParamField path="path.is_connected" type="bool" default="False" />

<ParamField path="path.total_items_received" type="int" default="0" />

<ParamField path="path.last_error" type="StreamError" />

<div id="last_error-streamerror">
  ### `last_error : [StreamError]`
</div>

<div id="xdkstreamingstream_with_retry">
  ### `xdk.streaming.stream_with_retry`
</div>

Transmite datos desde un endpoint con reconexión automática y backoff exponencial.
Esta función gestiona toda la conexión, incluyendo:

* Reconexión automática ante desconexiones
* Backoff exponencial con jitter para los retrasos entre reintentos
* Clasificación de errores como reintentables o fatales
* Callbacks de ciclo de vida para supervisar el estado de la conexión

<div id="parameters">
  #### Parámetros
</div>

<ParamField path="path.session" type="Session">
  La sesión de requests que se utilizará para las llamadas HTTP.
</ParamField>

<ParamField path="path.method" type="str">
  Método HTTP (normalmente «GET»).
</ParamField>

<ParamField path="path.url" type="str">
  La URL completa desde la que se hará streaming.
</ParamField>

<ParamField path="path.config" type="StreamConfig">
  StreamConfig con configuración de reintentos y callbacks.
</ParamField>