SABR en el extractor
SABR es el protocolo de delivery basado en sesión de YouTube. El protocolo en sí, el porqué, UMP, BotGuard, la atestación, es la Guía SABR. Esta sección es el mapa del lado del extractor: las ~47 clases de services/youtube/sabr, qué hace cada una, y cómo se conduce una sesión de reproducción de principio a fin. Se asume que leíste la guía.
Dónde encaja
Cuando YouTube devuelve formatos SABR, el extractor de flujo los expone con DeliveryMethod.SABR (ver Flujos y delivery). A diferencia de progressive o DASH, no hay una URL por-formato que entregar al player. Los bytes viven detrás de un endpoint, serverAbrStreamingUrl, que solo habla el baile petición/respuesta de SABR: POSTeas un VideoPlaybackAbrRequest binario, recibes un body UMP, lo decodificas, avanzas, repites.
El reparto de tareas:
- El extractor posee el protocolo. Hace el probe de la respuesta del player, abre la sesión, construye cada petición binaria, la POSTea, decodifica el UMP, sigue el estado bufferizado por-track, reensambla los segmentos, y acota cada modo de fallo.
- El cliente posee el ritmo y la pantalla. Su pump decide cuándo pedir más, cachea los segmentos, alimenta el decodificador, conduce los seeks, y suministra lo único que el extractor no puede producir: un PO token (minteado en una WebView).
El extractor nunca forja un token y nunca decodifica un píxel.
Leer en este orden
- Iniciar una sesión — el probe: respuesta del player,
serverAbrStreamingUrl, los client profiles, los formatos. - La petición — el proto
VideoPlaybackAbrRequest, campo por campo, y el wire format. - UMP y decodificación — el framing UMP, la tabla completa de part-types, la respuesta decodificada.
- Medio, segmentos e índice — cómo los bytes de medio se vuelven segmentos reproducibles, y cómo un tiempo se mapea a un número de segmento.
- El modelo buffered y el seek — el modelo contiguo-vs-max que evita la starvation, y cómo funciona el seek.
- El driver de sesión — el bucle de pump, la caché, la evicción, y cada retry acotado.
- Referencia de control parts — cada instrucción del servidor y su efecto.
Mapa de clases
| Área | Clases |
|---|---|
| Ciclo de vida de la sesión | YoutubeSabrProbe, YoutubeSabrProbeResult, YoutubeSabrInfo, YoutubeSabrSession, YoutubeSabrStreamState, YoutubeSabrClientProfile |
| Formatos | YoutubeSabrFormat, SabrSelectableFormats, SabrFormatSelectionConfig, SabrFormatInitializationMetadata |
| Petición | YoutubeSabrRequestBuilder, SabrSegmentRequest, SabrRequestIdentifier, SabrColdStartPoToken, SabrProto, SabrRequestDumper |
| UMP + decodificación | UmpReader, UmpPart, SabrResponseDecoder, SabrDecodedResponse |
| Medio + segmentos | SabrMediaHeader, SabrMediaSegment, SabrMediaSegmentCollector, SabrSegmentIndex, SabrMp4SegmentIndexParser, SabrWebmSegmentIndexParser, SabrOnesieData, SabrOnesieHeader, SabrOnesieInnertubeResponse |
| Control parts | SabrNextRequestPolicy, SabrStreamProtectionStatus, SabrRedirect, SabrSeek, SabrReloadPlayerResponse, SabrPlaybackStartPolicy, SabrContextSendingPolicy, SabrContextUpdate, SabrContextValue, SabrRequestCancellationPolicy, SabrPrewarmConnection, SabrLiveMetadata, SabrError, SabrSnackbarMessage |
| Estado de buffer | SabrBufferedRange, SabrPlaybackCookie |
| Tokens | SabrPoTokenProvider |
| Errores | SabrProtocolException |
La frontera
El extractor entiende y conduce el protocolo; no forja tokens y no renderiza el medio. Para el protocolo en sí, las shapes de petición y respuesta, el modelo de sesión, BotGuard y la atestación, lee la Guía SABR.