```meta
title: @video — um player de vídeo
description: Um player para um vídeo enviado para este site, com controles e sem tocar sozinho — ou o fundo silencioso de uma abertura.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @video

Um player para um vídeo enviado para este site: com controles, e nada toca sozinho. Ou, com `mode:background`, o fundo silencioso e em loop de uma abertura.

## Ao vivo

```@video src:/demo/gradiente.mp4 title:"Cinco segundos de gradiente" poster:/demo/layout/app-dashboard.svg
```

~~~text
```@video src:/demo/gradiente.mp4 title:"Cinco segundos de gradiente" poster:/demo/layout/app-dashboard.svg
```
~~~

No seu espaço, `src:` é o endereço que o arquivo ganhou ao ser enviado: arraste o vídeo para a página no editor, ou use o `upload` do MCP, e o `files` mostra o markdown pronto.

## De fundo, numa abertura

`mode:background` toca mudo, em loop e sem controles, atrás do texto de um `:::hero`. Para quem pediu menos movimento, fica parado.

:::hero height:half surface:inverse
```@video src:/demo/gradiente.mp4 mode:background
```
# Ateliê Exemplo

Cerâmica feita à mão.
:::

~~~text
:::hero height:half surface:inverse
```@video src:/demo/gradiente.mp4 mode:background
```
# Ateliê Exemplo

Cerâmica feita à mão.
:::
~~~

## Argumentos

- `src` — o caminho do arquivo neste site. Obrigatório. Um vídeo de outro site (YouTube, Vimeo) é um cartão: o [@embed](/@docs/blocks/embed).
- `title` — uma linha embaixo do player.
- `poster` — a imagem mostrada antes de tocar.
- `preload` — quanto o navegador baixa antes: `none`, `metadata` (o padrão) ou `auto`.
- `mode` — `player` (o padrão) ou `background`.