> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/media/audio-streaming.md).

# Transmisión de audio

Reproduce transmisiones de audio en vivo en tu scene.

Puedes transmitir audio desde una URL. Esto es útil para reproducir música directamente desde una radio por Internet o transmitir una conferencia a tu escena.

{% hint style="info" %}
**💡 Consejo**: En el [Scene Editor in Creator Hub](/creator/content-creator-es/scene-editor/comenzar/about-editor.md), puedes usar un **Audio Stream** [Smart Item](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) como una forma sin código de lograrlo.
{% endhint %}

El audio en la fuente debe estar en uno de los siguientes formatos: `.mp3`, `ogg`, o `aac`. La fuente también debe ser una *https* URL (*http* las URLs no son compatibles), y la fuente debe tener [políticas CORS (Cross Origin Resource Sharing)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) que permitan acceder externamente a ella. Si no es así, es posible que necesites configurar un server para actuar como proxy y exponer el stream de una forma válida.

{% hint style="warning" %}
**📔 Nota**: Para reproducir en su lugar un sonido pregrabado en tu escena, consulta [Sounds](/creator/content-creator-es/scenes-sdk7/conceptos-basicos-del-contenido-3d/sounds.md).
{% endhint %}

Para añadir un audio stream a tu escena, simplemente añade un `AudioStream` componente a una entidad:

```ts
const streamEntity = engine.addEntity()

AudioStream.create(streamEntity, {
	url: 'https://icecast.ravepartyradio.org/ravepartyradio-192.mp3',
	playing: true,
	volume: 0.8,
})
```

{% hint style="warning" %}
**📔 Nota**: El sonido transmitido no es posicional; se escuchará con un volumen constante en toda tu escena. Si un jugador sale de la escena, no escuchará la transmisión en absoluto.
{% endhint %}

Establece el volumen del `AudioStream` componente cambiando su `volume` propiedad.

Activa o desactiva el `AudioStream` componente estableciendo su `playing` property en *true* o *false*.

{% hint style="info" %}
**📔 Nota**: No todos los servicios de streaming permiten reproducir su audio fuera de su sitio. Los siguientes son algunos ejemplos que funcionan en Decentraland:

```ts
DELTA = "https://cdn.instream.audio/:9069/stream?_=171cd6c2b6e"
GRAFFITI = "https://n07.radiojar.com/2qm1fc5kb.m4a?1617129761=&rj-tok=AAABeIR7VqwAilDFeUM39SDjmw&rj-ttl=5"
ISLA NEGRA = "https://radioislanegra.org/listen/up/basic.aac"
```

{% endhint %}

## Estado del stream

Puedes supervisar el estado de un audio stream usando ya sea el `audioEventsSystem` (basado en callback, recomendado) o haciendo polling con `AudioStream.getAudioState()`.

### Uso de audioEventsSystem (recomendado)

Registra un callback que se activa solo cuando cambia el estado del stream. Este es el mismo sistema que se usa para `AudioSource` entities (ver [Detectar cuándo termina un sound](/creator/content-creator-es/scenes-sdk7/conceptos-basicos-del-contenido-3d/sounds.md#detect-when-a-sound-finishes)).

```ts
import { engine, AudioStream, MediaState } from '@dcl/sdk/ecs'
import { audioEventsSystem } from '@dcl/sdk/ecs'

export function main() {
	const entity = engine.addEntity()

	AudioStream.create(entity, {
		playing: true,
		volume: 1,
		url: 'https://audio-edge-es6pf.mia.g.radiomast.io/ref-128k-mp3-stereo',
	})

	audioEventsSystem.registerAudioEventsEntity(entity, (event) => {
		console.log('Stream state: ', event.state)

		if (event.state === MediaState.MS_ERROR) {
			// Intentar reconectar
		}
	})
}
```

### Polling con getAudioState

También puedes hacer polling del estado de un stream en cada frame usando `AudioStream.getAudioState()`. Esto devuelve un `PBAudioEvent` objeto (o `undefined` si todavía no se ha reportado ningún estado), con un `state` campo y un `timestamp` campo. El `state` campo es un valor del `MediaState` enum:

* `MS_NONE`
* `MS_LOADING`
* `a MS_READY`
* `MS_PLAYING`
* `MS_PAUSED`
* `MS_BUFFERING`
* `MS_SEEKING`
* `MS_ERROR`

```ts
export function main() {
	const entity = engine.addEntity()

	AudioStream.create(entity, {
		playing: true,
		volume: 1,
		url: 'https://audio-edge-es6pf.mia.g.radiomast.io/ref-128k-mp3-stereo',
	})

	let lastState: MediaState | undefined = undefined
	engine.addSystem(() => {
		const currentState = AudioStream.getAudioState(entity)?.state
		if (lastState !== currentState) {
			console.log('Stream state: ', currentState)
			lastState = currentState

			if (currentState == MediaState.MS_ERROR) {
				// Intentar reconectar
			}
		}
	})
}
```

## Audio espacial

De forma predeterminada, el audio de un `AudioStream` componente es global, lo que significa que se escuchará con un volumen constante en toda tu escena. Si un jugador sale de la escena, no escuchará la transmisión en absoluto.

Para hacer espacial el audio, establece el `spatial` property en *true*.

```ts
AudioStream.create(entity, {
	url: 'https://radioislanegra.org/listen/up/stream',
    playing: true,
	spatial: true,
})
```

Ahora el audio se escuchará desde la posición de la entidad que posee el `AudioStream` componente, y sonará más fuerte a medida que el jugador se acerque a ella.

Controla el audio espacial con las siguientes propiedades:

* `spatialMinDistance`: La distancia mínima a la que el audio se vuelve espacial. Si el jugador está más cerca, el audio se escuchará a volumen máximo. *0* de forma predeterminada.
* `spatialMaxDistance`: La distancia máxima a la que se escucha el audio. Si el jugador está más lejos, el audio se escuchará a 0 de volumen. *60* de forma predeterminada

```ts
const audioStreamEntity = engine.addEntity();

Transform.create(audioStreamEntity, {
    position: Vector3.create(8, 0, 8),
});

AudioStream.create(audioStreamEntity, {
    url: 'https://radioislanegra.org/listen/up/stream',
    playing: true,
    volume: 1.0,
    spatial: true,
    spatialMinDistance: 5,
    spatialMaxDistance: 10
});
```

{% hint style="warning" %}
**📔 Nota**: Algunos formatos de audio no admiten audio espacial. Asegúrate de que el audio del stream esté codificado en *mp3*, *AAC-LC* o *FLAC*.
{% endhint %}

## Análisis de audio

Puedes leer datos de amplitud y frecuencia en tiempo real desde una `AudioStream` entidad para impulsar elementos visuales reactivos como equalizadores o luces que pulsan al ritmo. Ver [Análisis de audio](/creator/content-creator-es/scenes-sdk7/media/audio-analysis.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/media/audio-streaming.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.