# Legendas

As legendas são texto derivado de uma transcrição ou do roteiro dos diálogos ou comentários em filmes, programas de televisão, videojogos e afins, geralmente exibido na parte inferior do ecrã.

### Formato VTT

```
WEBVTT

1
00:00:15.000 --> 00:00:18.000 align:start
À esquerda podemos ver...

2
00:00:18.167 --> 00:00:20.083 align:middle
À direita podemos ver o...

3
00:00:20.083 --> 00:00:22.000
...os cabeças-gritantes

4
00:00:22.000 --> 00:00:24.417 align:end
Tudo está seguro. Totalmente seguro.

5
00:00:24.583 --> 00:00:27.083
Emo?
```

### Adicionando ao Fluid Player

Para configurar o Fluid Player para usar o seu ficheiro VTT, defina o parâmetro opcional `subtitlesEnabled` em `layoutControls`.

Forneça URLs de legendas em `<track>` tags sob `kind='metadata'`.

Certifique-se de que **não especifica** `kind='subtitles'`, porque isso não funciona em alguns navegadores.

```html
<video id="my-video" controls>
    <source src="video.mp4" type="video/mp4"/>
    <track label="English" kind="metadata" srclang="en" src="/subtitles/english.vtt" default>
    <track label="Deutsch" kind="metadata" srclang="de" src="/subtitles/deutsch.vtt">
</video>

<script type="application/javascript">
fluidPlayer(
    'my-video',
    {
        layoutControls: {
            subtitlesEnabled: true
        }
    }
);
</script>
```

### subtitlesOnByDefault

Defina este parâmetro para **true** para que as legendas fiquem ativadas por padrão. Este parâmetro já está definido por padrão para **true**.

```javascript
fluidPlayer(
    'my-video',
    {
        layoutControls: {
            subtitlesOnByDefault: false, // Padrão true
        }
    }
);
```

### Opções de tamanho da fonte

O Fluid Player suporta controlos de tamanho da fonte das legendas, melhorando a acessibilidade e a experiência do utilizador ao permitir ajustes no tamanho do texto. Os utilizadores podem personalizar o tamanho das legendas de duas formas convenientes:

#### Método 1: Atalhos de teclado

Ao ver conteúdo, os utilizadores podem ajustar rapidamente o tamanho das legendas usando simples atalhos de teclado:

* Prima a `+` tecla para aumentar o tamanho da fonte das legendas
* Prima a `-` tecla para diminuir o tamanho da fonte das legendas

#### Método 2: Submenu de tamanho da fonte

Está disponível um submenu dedicado de Tamanho da Fonte no painel de controlo de legendas/legendas. Este menu oferece controlo preciso com opções percentuais predefinidas:

* 50%
* 75%
* 100% (Padrão)
* 150%
* 200%


---

# Agent Instructions: 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:

```
GET https://docs.fluidplayer.com/portuguese/configuracao/subtitles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.