Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3,656 changes: 1,955 additions & 1,701 deletions ai-sdk-context/sdk7-complete-reference.md

Large diffs are not rendered by default.

33 changes: 17 additions & 16 deletions creator-esp/scene-editor/interactivity/video-screen.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,34 +22,35 @@ Puedes configurar el volumen del audio del video. Ten en cuenta que el audio del

El desplegable **Default Media Source** te permite elegir entre dos tipos diferentes de fuentes:

* **Video URL**: Obtén un video o un stream desde una URL o archivo de video local
* **Live Stream**: Usa la infraestructura de streaming gratuita de Decentraland para mostrar un stream. Para usar esto, también debes incluir un smart item [Admin tools](../scene-editor/live-ops/scene-admin.md) en tu escena.
- **Video URL**: Obtén un video o un stream desde una URL o archivo de video local
- **Live Stream**: Usa la infraestructura de streaming gratuita de Decentraland para mostrar un stream. Para usar esto, también debes incluir un smart item [Admin tools](../scene-editor/live-ops/scene-admin.md) en tu escena.

### Reproducir Videos

Puedes reproducir videos pre-grabados desde:

* **Archivos locales**: Sube un archivo de video como parte de la escena, luego apunta el campo _URL_ a la ruta a ese archivo.
* **Stream desde una URL**: Apunta a un stream en vivo o pre-grabado en la web, por ejemplo desde Vimeo. Consulta [streaming videos](video-screen.md#streaming-videos)
- **Archivos locales**: Sube un archivo de video como parte de la escena, luego apunta el campo _URL_ a la ruta a ese archivo.
- **Stream desde una URL**: Apunta a un stream en vivo o pre-grabado en la web, por ejemplo desde Vimeo. Consulta [streaming videos](video-screen.md#streaming-videos)

El momento en que el smart item Video Player reproduce un video puede depender de diferentes cosas:

* **Automatic**: El video comienza a reproducirse tan pronto como se carga la escena. Para esto, establece el desplegable de media source predeterminado en **Video URL** y pega una URL directamente en el campo **Default Video URL**.
- **Automatic**: El video comienza a reproducirse tan pronto como se carga la escena. Para esto, establece el desplegable de media source predeterminado en **Video URL** y pega una URL directamente en el campo **Default Video URL**.

![](../images/editor/admin/video-automatic.png)
* **Activado por un admin**: Un [Scene admin](../scene-editor/live-ops/scene-admin.md) que está actualmente en la escena puede usar la UI de Admin para pegar una URL de video y reproducirlo para todos los jugadores que están actualmente en la escena.
* **Basado en acciones del jugador**: Define una Action de tipo **Play Video Stream**. Esto te permite activar la reproducción del video como resultado de interactuar con algún otro smart item, como caminar a una habitación o presionar un botón. Consulta [Smart Items - Advanced](../scene-editor/interactivity/smart-items-advanced.md).
![](../images/editor/admin/video-automatic.png)

![](../images/editor/video-from-action.png)
- **Activado por un admin**: Un [Scene admin](../scene-editor/live-ops/scene-admin.md) que está actualmente en la escena puede usar la UI de Admin para pegar una URL de video y reproducirlo para todos los jugadores que están actualmente en la escena.
- **Basado en acciones del jugador**: Define una Action de tipo **Play Video Stream**. Esto te permite activar la reproducción del video como resultado de interactuar con algún otro smart item, como caminar a una habitación o presionar un botón. Consulta [Smart Items - Advanced](../scene-editor/interactivity/smart-items-advanced.md).

![](../images/editor/video-from-action.png)

En todos los casos, configuras el video para que se reproduzca en bucle o una sola vez.

{% hint style="warning" %}
**📔 Nota**: Si demasiados videos se están reproduciendo al mismo tiempo en tu escena, algunos serán pausados por el motor. La prioridad se determina en función de la proximidad al jugador, dirección de la cámara y tamaño de la pantalla. La cantidad máxima de videos simultáneos depende de la configuración de calidad del jugador.

* Low: 1
* Medium: 5
* High: 10
- Low: 1
- Medium: 5
- High: 10

También recomendamos comenzar a reproducir el video cuando el jugador está cerca o realiza una acción para hacerlo. Comenzar a reproducir un video cuando tu escena se carga lejos en el horizonte afectará innecesariamente el rendimiento mientras los jugadores visitan escenas vecinas.
{% endhint %}
Expand All @@ -58,9 +59,9 @@ También recomendamos comenzar a reproducir el video cuando el jugador está cer

Los siguientes formatos de archivo son soportados:

* _.mp4_
* _.ogg_
* _.webm_
- _.mp4_
- _.ogg_
- _.webm_

Ten en cuenta que un archivo de video se suma al tamaño total de la escena, lo que hace que la escena tarde más en descargarse para los jugadores que caminan hacia tu escena. El tamaño del video también podría hacer que superes las [scene limitations](../sdk7/optimizing/scene-limitations.md), ya que tienes un máximo de 15 MB por parcel para usar. Recomendamos comprimir el video tanto como sea posible, para que sea menos problemático.

Expand All @@ -72,7 +73,7 @@ Para transmisión en vivo de extremo a extremo (configuración de OBS, stream ke

También puedes transmitir videos usando otras infraestructuras de streaming. Para hacer esto, simplemente configura el smart item Video Player para usar la media source **Video URL**, y pega la URL del stream en el campo **Default Video URL**.

La fuente del streaming debe ser una URL _https_ (las URLs _http_ no son soportadas), y la fuente debe tener [políticas CORS (Cross Origin Resource Sharing)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) que permitan acceder a ella externamente. Esto significa que no puedes transmitir un video desde YouTube o sitios similares, ya que estos solo permiten mostrar su contenido en su widget HTML de marca. Consulta [About External Streaming](../sdk7/media/video-playing.md#about-external-streaming) para opciones y tips.
La fuente del streaming debe ser una URL _https_ (las URLs _http_ no son soportadas). Consulta [About External Streaming](../sdk7/media/video-playing.md#about-external-streaming) para opciones y tips.

Hay una serie de opciones para transmitir video. La opción más simple es usar un proveedor de hosting administrado como [Vimeo](https://vimeo.com/), [Livepeer Studio](https://livepeer.studio/) o [Serraform](https://serraform.gitbook.io/streaming-docs/guides/decentraland-playback) donde pagas una tarifa al proveedor para administrar toda la infraestructura de streaming.

Expand Down
30 changes: 17 additions & 13 deletions creator-esp/scene-editor/live-ops/live-streaming.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,20 @@ Usa el smart item **Video Screen** junto con el smart item **Scene Admin** para

### Requisitos

* Una escena con al menos un smart item [Video Screen](../scene-editor/interactivity/video-screen.md).
* El smart item [Scene Admin](../scene-editor/live-ops/scene-admin.md) vinculado a tus video screens.
* Software de streaming que pueda enviar a un endpoint RTMP (ej. [OBS](https://obsproject.com/), [XSplit](https://www.xsplit.com/), [StreamYard](https://streamyard.com/)).
- Una escena con al menos un smart item [Video Screen](../scene-editor/interactivity/video-screen.md).
- El smart item [Scene Admin](../scene-editor/live-ops/scene-admin.md) vinculado a tus video screens.
- Software de streaming que pueda enviar a un endpoint RTMP (ej. [OBS](https://obsproject.com/), [XSplit](https://www.xsplit.com/), [StreamYard](https://streamyard.com/)).

### Configurar la escena

1. Agrega un smart item **Video Screen** a tu escena.

![](../images/editor/admin/video-player-item.png)

2. Agrega un smart item **Scene Admin** y habilita la sección **Video Screens**. Selecciona cada pantalla del desplegable y dale un nombre amigable para la UI de admin.

![](../../../.gitbook/assets/multi-video-setup.png)

3. Publica tu SC (World o Genesis City) y entra como un usuario con permisos de admin.

![](../images/editor/publish-button.png)
Expand All @@ -33,9 +35,11 @@ Usa el smart item **Video Screen** junto con el smart item **Scene Admin** para
1. Abre la UI de Admin en la escena (ícono superior derecho).

![](../images/editor/admin/admin-icon.png)

2. En la pestaña **Video**, cambia a **Live** y haz clic en **Get Stream Key**.

![](../images/editor/admin/get-key.png)

3. Copia el **RTMP Server** y **Stream Key** en tu software de streaming.

![](../images/editor/admin/OBS-configuration.png)
Expand All @@ -47,24 +51,24 @@ Usa el smart item **Video Screen** junto con el smart item **Scene Admin** para
### Iniciar y controlar el stream

1. Inicia streaming desde tu software.
2. En la UI de Admin, haz clic en **Activate** para mostrar el stream en la escena.
2. En la UI de Admin, haz clic en **Activate** para mostrar el stream en la escena.

![](../images/editor/admin/activate.png)
![](../images/editor/admin/activate.png)

Notas:

* El streaming funciona en Worlds y Genesis City, sin límites de audiencia del lado de la escena.
* Si agregas múltiples Video Screens, silencia todas menos una para evitar artefactos de audio.
- El streaming funciona en Worlds y Genesis City, sin límites de audiencia del lado de la escena.
- Si agregas múltiples Video Screens, silencia todas menos una para evitar artefactos de audio.

### Stream keys

Las stream keys se generan por escena y son válidas por 4 días (96 horas). Una sola sesión en vivo puede ejecutarse hasta 4 horas continuamente.

![](../images/editor/admin/live-stream-settings.png)

* Haz clic en **Reset Stream Key** para revocar la clave actual y emitir una nueva. Los streams en curso se detendrán.
* Cada escena tiene su propia dirección de streaming y clave. Los admins pueden compartir la clave con streamers externos.
* Solo un stream puede estar activo por escena a la vez; iniciar uno nuevo sobrescribirá el stream actual.
- Haz clic en **Reset Stream Key** para revocar la clave actual y emitir una nueva. Los streams en curso se detendrán.
- Cada escena tiene su propia dirección de streaming y clave. Los admins pueden compartir la clave con streamers externos.
- Solo un stream puede estar activo por escena a la vez; iniciar uno nuevo sobrescribirá el stream actual.

{% hint style="danger" %}
**❗Advertencia**: Trata las stream keys como secretos. Restablece la clave entre presentadores si es necesario.
Expand All @@ -74,6 +78,6 @@ Las stream keys se generan por escena y son válidas por 4 días (96 horas). Una

También puedes transmitir usando infraestructura de terceros configurando el Video Screen a **Video URL** y pegando una URL de stream.

* La URL debe ser `https` y habilitada para CORS por el proveedor (YouTube y sitios similares no permitirán reproducción directa). Consulta [About External Streaming](../sdk7/media/video-playing.md#about-external-streaming).
* Los proveedores administrados incluyen [Vimeo](https://vimeo.com/), [Livepeer Studio](https://livepeer.studio/) y [Serraform](https://serraform.gitbook.io/streaming-docs/guides/decentraland-playback).
* Tips para configuración de encoder: [Setting up OBS for successful streaming](../sdk7/media/video-playing.md#setting-up-obs-for-successful-streaming).
- La URL debe ser `https`. Consulta [About External Streaming](../sdk7/media/video-playing.md#about-external-streaming).
- Los proveedores administrados incluyen [Vimeo](https://vimeo.com/), [Livepeer Studio](https://livepeer.studio/) y [Serraform](https://serraform.gitbook.io/streaming-docs/guides/decentraland-playback).
- Tips para configuración de encoder: [Setting up OBS for successful streaming](../sdk7/media/video-playing.md#setting-up-obs-for-successful-streaming).
Loading