Página generada desde el TSDoc de @styx/source-sdk. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

Class: HttpRangeSourceCopiar enlace

Source para una URL HTTP con soporte de Range requests (RFC 7233). Útil para assets remotos sin FUSE (r03). Usa fetch nativo de Bun/Node.

ExampleCopiar enlace

const src = new HttpRangeSource('https://cdn.example.com/asset.mkv', 12345678);
const result = await src.readAt({ offset: 0, length: 2048, purpose: 'playback' });

ImplementsCopiar enlace

• ISeekableMediaSource

ConstructorsCopiar enlace

ConstructorCopiar enlace

new HttpRangeSource(url, sizeBytes, fetchImpl?): HttpRangeSource

ParametersCopiar enlace

urlCopiar enlace

string

URL HTTP/HTTPS del recurso (debe soportar Range).

sizeBytesCopiar enlace

number

Tamaño total (de HEAD/Content-Length). 0 si desconocido.

fetchImpl?Copiar enlace

typeof fetch = fetch

Implementación de fetch (para inyección en tests).

ReturnsCopiar enlace

HttpRangeSource

PropertiesCopiar enlace

kindCopiar enlace

readonly kind: "http" = 'http'

Tipo de source (local, http, s3, webdav, torrent, etc.).

Implementation ofCopiar enlace

ISeekableMediaSource.kind

sizeBytesCopiar enlace

readonly sizeBytes: number

Tamaño total en bytes (0 si desconocido, ej: streams live).

Implementation ofCopiar enlace

ISeekableMediaSource.sizeBytes

uriCopiar enlace

readonly uri: string

URI canónica del source (file://, https://, s3://, etc.).

Implementation ofCopiar enlace

ISeekableMediaSource.uri

MethodsCopiar enlace

availability()Copiar enlace

availability(): SourceAvailability

Consulta la disponibilidad actual del source.

ReturnsCopiar enlace

SourceAvailability

Estado de disponibilidad.

Implementation ofCopiar enlace

ISeekableMediaSource.availability

cancel()Copiar enlace

cancel(requestId): Promise<void>

Cancela una read individual por su requestId (r20 §3.6). No afecta a otros requests en curso.

ParametersCopiar enlace

requestIdCopiar enlace

string

ID del request a cancelar.

ReturnsCopiar enlace

Promise<void>

Implementation ofCopiar enlace

ISeekableMediaSource.cancel

cancelOutside()Copiar enlace

cancelOutside(_window): Promise<void>

Cancela todos los requests fuera de la ventana dada (r20 §3.6). Útil tras un seek: cancela reads del offset antiguo. Impl real deferida a F3; este SDK declara la firma.

ParametersCopiar enlace

_windowCopiar enlace

IReadWindow

ReturnsCopiar enlace

Promise<void>

Implementation ofCopiar enlace

ISeekableMediaSource.cancelOutside

metrics()Copiar enlace

metrics(): ISourceMetrics | null

Métricas observadas del source (para SourceMetrics aggregate). NO scoring — eso va en playback-policy o source-selection-policy.

ReturnsCopiar enlace

ISourceMetrics | null

Métricas actuales o null si no hay datos todavía.

Implementation ofCopiar enlace

ISeekableMediaSource.metrics

prefetch()Copiar enlace

prefetch(_ranges): Promise<void>

Hint de prefetch: el source debería precargar estos rangos en cache. No bloquea; el source puede ignorar si su cache está lleno.

ParametersCopiar enlace

_rangesCopiar enlace

readonly IPrefetchRange[]

ReturnsCopiar enlace

Promise<void>

Implementation ofCopiar enlace

ISeekableMediaSource.prefetch

readAt()Copiar enlace

readAt(request): Promise<Result<IReadResult, ResultError<SourceErrorCode>>>

Lee length bytes desde offset.

ParametersCopiar enlace

requestCopiar enlace

IReadRequest

Request de lectura con purpose + deadline + requestId.

ReturnsCopiar enlace

Promise<Result<IReadResult, ResultError<SourceErrorCode>>>

Result con el resultado (puede ser parcial) o ResultError<SourceErrorCode>. El código viaja dentro de ResultError (ver error-handling.md).

Implementation ofCopiar enlace

ISeekableMediaSource.readAt