> 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-pt/scene-editor/operar-ao-vivo/live-streaming.md).

# Streaming ao Vivo

Transmita vídeo ao vivo para sua scene usando a Video Screen e as Admin Tools.

Use o **Ecrã de vídeo** smart item juntamente com o **Ferramentas de administração** smart item para transmitir vídeo em direto para a tua scene.

A Decentraland oferece diferentes formas de transmitir vídeo em direto para a tua scene:

* **DCL Cast** *(Modo fácil)*: Usa a aplicação web gratuita de streaming da Decentraland para partilhar facilmente a tua câmara ou ecrã com outros jogadores na scene, sem precisares de configurar um software de streaming. Este modo tem a latência mais baixa e é o mais fácil de configurar.
* **Stream** *(Modo avançado)*: Usa um software de streaming como [OBS](https://obsproject.com/) para transmitir através da infraestrutura de streaming da Decentraland. Este modo permite-te ter mais controlo sobre a transmissão, como o layout do ecrã e as fontes de áudio.
* **URL do vídeo** *(Modo avançado)*: Aponta para a tua própria infraestrutura de streaming, colando a URL no campo **URL do vídeo** .

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4a5f55b4e645c0ffe6aefffd3f03c2dba5998e02%2Fstreaming-modes.png?alt=media" alt="Métodos de transmissão" width="400">

A transmissão funciona em Worlds e Genesis City, sem limites de audiência do lado da scene.

## Configurar a scene

Os passos seguintes são comuns aos métodos DCL Cast e Stream:

1. Adicione um **Ecrã de vídeo** smart item para a tua scene.

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01d7193f1148aa3fc6d53232dfb403cc815b6bce%2Fvideo-player-item.png?alt=media\&token=a7478d28-02c6-407d-a7c3-e63d964f062e)
2. Adiciona um **Ferramentas de administração** smart item e ativa a **Video Screens** secção. Seleciona cada ecrã no menu suspenso e dá-lhe um nome amigável para a UI de administração.

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7c055a56398873268285f83c53eade303d1024cc%2Fmulti-video-setup.png?alt=media\&token=483ea419-1d94-4494-97d0-cb840b33988d)
3. Publica a tua scene (World ou Genesis City) e entra como utilizador com permissões de administração.

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-65dd1ffe91c288af2ae1f3b7ce92c7fcb12668f9%2Fpublish-button.png?alt=media\&token=238014f0-cea6-461d-a666-0f2fd9240833)

Assim que a tua scene for publicada, podes entrar como utilizador com permissões de administração e configurar as definições de transmissão.

{% hint style="info" %}
**💡 Dica**: Se adicionares vários Video Screens para mostrar o mesmo vídeo, configura a fonte de todos, exceto um, para apontar para o mesmo reprodutor de vídeo, vê [Vários Video Screens](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md#multiple-video-screens) para mais detalhes.
{% endhint %}

## DCL Cast (fácil)

### Partilhar acesso à aplicação

Entra na tua scene publicada como um utilizador com permissões de administração e abre o painel de administração. Seleciona o **Vídeo** separador, depois seleciona a **DCL Cast** funcionalidade.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30fd22f76c104ca0826210e291ba377e9bb11d51%2Fdcl-cast.png?alt=media" alt="DCL Cast" width="400">

Verás dois links que podes copiar e partilhar com outras pessoas.

* **Oradores**: Este link é para os oradores usarem para transmitir o seu vídeo para a scene.

  <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>❗Aviso</strong>: Trata o link de transmissão como um segredo; só o partilhes com pessoas em quem confies. Reinicia o link entre apresentadores, se necessário.</p><p>Quando terminares a transmissão, fecha o separador do browser do DCL Cast para libertar o canal.</p></div>
* **Espectadores**: Este link é para a audiência ver o vídeo a partir de um browser ou telemóvel. Isto é útil para jogadores que atualmente não estão dentro do Decentraland.

Clique no **Copiar link** botão para copiar os links para a área de transferência.

Quando estiveres pronto para transmitir, clica no **Ativar** botão para tornar a transmissão visível para a audiência na scene.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media&amp;token=3e11fe70-05b3-4970-9bd2-f0b20c08fd41" alt="Ativar transmissão" width="150">

Se por qualquer motivo precisares de repor a sala, clica no **Repor sala** botão para gerar uma nova. Qualquer pessoa que esteja atualmente a transmitir será desligada.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-22a6f37702b2d6db0aa395f73f820825ef02642d%2Freset-room.png?alt=media" alt="Repor sala" width="150">

### Usar a aplicação DCL Cast

Quando alguém cola o link do orador num browser, verá um ecrã como este:

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-827cf2d40b68a2da0e0a104f3fc78621ffb13bbe%2Fdcl-cast-landing.png?alt=media" alt="aplicação DCL Cast" width="400">

O browser pedirá permissão para partilhar a tua câmara e microfone. Também podes configurar os diferentes dispositivos de entrada a usar para a transmissão.

{% hint style="info" %}
**📔 Dica**: Usa o Google Chrome ou um browser baseado no motor Chrome. Estes browsers oferecem a funcionalidade de partilhar facilmente vídeo e áudio diretamente a partir de um separador do browser.
{% endhint %}

Os utilizadores podem introduzir um nome (não precisa de corresponder ao nome de utilizador do Decentraland) e clicar no **Entrar agora** botão para começar a transmitir.

Depois de transmitir, a aplicação é semelhante a várias aplicações familiares de videoconferência, com botões para silenciar/ativar som, partilhar câmara e ecrã, e uma interface de chat.

O chat é só de leitura e escuta todas as mensagens enviadas pelos jogadores dentro da scene no Decentraland. Isto é ótimo para manter o contacto com a audiência, mesmo que estejas a transmitir a partir de um dispositivo diferente.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-18632ba0a6e0d2970bad889f0aeeabce9ffc522d%2Fdcl-cast-app.png?alt=media" alt="aplicação DCL Cast" width="700">

Na **Participantes** separador, podes ver três listas:

* **Oradores**: As pessoas que estão atualmente a transmitir para a scene.
* **Espectadores**: As pessoas que estão atualmente a ver a transmissão a partir de um browser.
* **Participantes no mundo**: Os jogadores que estão atualmente dentro da scene, a ver a transmissão no mundo.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f76c901dcdc1524efac9385c3a02431c9e23a051%2Fparticipants.png?alt=media" alt="Separador Participantes" width="200">

Se houver vários oradores presentes numa sessão DCL Cast, os jogadores no mundo ouvirão as vozes de todos os oradores, e o vídeo exibido mudará automaticamente para mostrar quem estiver atualmente a emitir som, para mostrar sempre quem está a falar.

Para substituir este comportamento predefinido:

* Clique no **Oradores** botão no painel de administração da scene

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-416d79974ea970a31400dcce47d57051e416958c%2Fspeakers-button.png?alt=media" alt="Separador Participantes" width="200">

* Escolhe um dos oradores e seleciona uma fonte para apresentar (a câmara ou o ecrã desse orador)

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b88f3d636df869ed094c6cc505de6dde5bc41f62%2Fselect-speaker-source.png?alt=media" alt="Separador Participantes" width="200">

Isto forçará esta fonte a ser sempre mostrada no ecrã, independentemente de outros oradores estarem a falar.

{% hint style="info" %}
**📔 Dica**: Se também estiveres no mundo a ver a transmissão, podes achar desagradável ouvir eco do áudio repetido tanto na aplicação DCL Cast como na scene do Decentraland. Podes silenciar facilmente todo o áudio da aplicação DCL Cast ao alternar o ícone do altifalante no canto inferior esquerdo do ecrã

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-390f3bf8635a5966799928c4c633b8026b81d3d7%2Fmute-dcl-cast.png?alt=media" alt="Participants tab" data-size="original">

Caso contrário, podes silenciar o áudio nas definições do Decentraland.
{% endhint %}

### Partilhar apresentações

Também podes partilhar o conteúdo de uma apresentação de slides como uma fonte alternativa de imagens.

* A partir do mundo, clica no **Partilhar apresentação** botão no mundo no separador DCL Cast. Na aplicação DCL Cast, clica no menu suspenso ao lado do **Partilhar ecrã** botão e seleciona **Partilhar apresentação**.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-895fc29eb9263fdc6d225451e5e92f558dea1f84%2Fshare-presentation-dcl-cast.png?alt=media" alt="Separador Participantes" width="200">

* Cola um link do Google Slides, um link para um .pdf alojado no Drive ou numa fonte semelhante, ou carrega um ficheiro .pdf.

A apresentação passará a ser uma fonte que pode ser selecionada para mostrar no ecrã, enquanto as vozes de todos os oradores continuam a ser ouvidas.

{% hint style="warning" %}
**📔 Observação**: Os ficheiros de apresentação têm de ter menos de 100 MB. As apresentações do Google Slides têm de estar definidas como *públicas*.

Só pode haver uma apresentação ativa de cada vez numa sessão DCL Cast.
{% endhint %}

Depois, podes mudar de slides, ou até reproduzir e pausar quaisquer vídeos incorporados nestes slides ao premir botões que existem tanto na aplicação DCL Cast como no mundo na UI de Admin Tools.

## Stream (avançado)

Para usar a funcionalidade de Live Streaming na tua scene, vais precisar de instalar um software de streaming que possa emitir para um endpoint RTMP (por ex. [OBS](https://obsproject.com/), [XSplit](https://www.xsplit.com/), [StreamYard](https://streamyard.com/)).

{% hint style="warning" %}
**Aviso**: O live streaming não é suportado em mundos Single Player. Se o teu world tiver **Single Player** ativado nas definições do World (ou `fixedAdapter` definido para `"offline:offline"` em `scene.json`), desativa-o antes de configurar a transmissão. A funcionalidade de transmissão depende da camada de comunicações, que está desativada no modo Single Player.
{% endhint %}

### desativa-o antes de configurar a transmissão. A funcionalidade de transmissão depende da camada de comunicações, que está desativada no modo Single Player.

1. Abre a Admin UI na scene (ícone no canto superior direito).

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6cae96494f3809c3b4e4da9a55b1fa9c46922c48%2Fadmin-icon.png?alt=media\&token=893e131b-7f70-42b4-a66f-8a18786c1c51)
2. No **Vídeo** separador, muda para **Stream** e clica em **Obter chave de transmissão**.

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-14884b1619291b1390e768ab51817c57bf5e7eb6%2Fget-key.png?alt=media\&token=9464622b-d702-49c5-8d8f-a7f1e5800ee4)
3. Copia o **Servidor RTMP** e **Chave de transmissão** para o teu software de streaming.

   ![OBS configuration](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8c58e22eb160f37855f2403a738ec4d906783513%2FOBS-configuration.png?alt=media\&token=39d8420f-0919-49a0-9dff-ea15b9611595)

{% hint style="danger" %}
**❗Aviso**: Só uma pessoa pode transmitir para uma scene de cada vez. Quando terminares de transmitir, clica em **Parar transmissão** no teu software para libertar o canal.
{% endhint %}

### Iniciar e controlar a transmissão

1. Inicia a transmissão a partir do teu software.
2. Na UI de administração, clica em **Ativar** para mostrar a transmissão na scene.

   <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media&amp;token=3e11fe70-05b3-4970-9bd2-f0b20c08fd41" alt="Ativar transmissão" width="100">

### Chaves de transmissão

As chaves de transmissão são geradas por scene e são válidas durante 4 dias (96 horas). Uma única sessão em direto pode decorrer continuamente até 4 horas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6b62708bc8ce0cd2fa1e5f514cb0ea06ac28b7ff%2Flive-stream-settings.png?alt=media\&token=a75c4c2e-e502-4ade-b3ae-9ec06450e8cb)

* Clique em **Repor chave de transmissão** para revogar a chave atual e emitir uma nova. As transmissões em curso vão parar.
* Cada scene tem o seu próprio endereço e chave de streaming. Os administradores podem partilhar a chave com streamers externos.
* Só pode haver uma transmissão ativa por scene de cada vez; ao iniciar uma nova, a transmissão atual será substituída.

{% hint style="danger" %}
**❗Aviso**: Trata as chaves de transmissão como segredos. Repor a chave entre apresentadores, se necessário.
{% endhint %}

## Streaming a partir de URL (avançado)

Também podes fazer streaming configurando o Video Screen para usar a opção **URL do vídeo** e colando uma URL de stream.

Deves poder colar uma URL que aponte para um vídeo na maioria dos sites populares de streaming de vídeo. Tem atenção aos termos de serviço dessas plataformas.

Para fazer streaming a partir de um ficheiro de vídeo que tenhas na tua máquina local, a forma mais fácil é carregar esse vídeo para um Google Drive público e colar o link.

* A URL tem de ser `https`. Veja [Sobre Streaming Externo](/creator/content-creator-pt/scenes-sdk7/media/video-playing.md#about-external-streaming).
* Os fornecedores recomendados incluem [Vimeo](https://vimeo.com/), [Bunny](https://bunny.net), [Livepeer Studio](https://livepeer.studio/) e [Serraform](https://serraform.gitbook.io/streaming-docs/guides/decentraland-playback).
* Dicas para a configuração do encoder: [Configurar o OBS para uma transmissão bem-sucedida](/creator/content-creator-pt/scenes-sdk7/media/video-playing.md#setting-up-obs-for-successful-streaming).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/operar-ao-vivo/live-streaming.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
