# Plugin Kinescope para Moodle


Se você usa Moodle, pode adicionar um vídeo do Kinescope em qualquer editor de texto da plataforma colando o link. O plugin de mídia do Kinescope reconhece o link e o transforma em um player incorporado dentro do curso.

## Como funciona

O plugin é do tipo **Media player** no Moodle. Depois de instalado e ativado, ele registra o domínio do Kinescope como fonte de mídia permitida. O fluxo é este:

1. Você copia o link do vídeo no Kinescope.
2. Cola no editor de texto do Moodle — descrição do curso, tarefa, página ou outra atividade.
3. O Moodle troca o link pelo player incorporado do Kinescope.

O aluno vê o player na página do curso, sem sair para outro site.

## Instalação

O plugin está no catálogo oficial de extensões do Moodle: [media_kinescope](https://moodle.org/plugins/media_kinescope/versions). A versão atual é **v1.0.3**. Ela cobre Moodle 3.11, 4.0–4.5, 5.0 e 5.1.

Para instalar:

1. Baixe o ZIP na página do plugin no Moodle.org.
2. Extraia no servidor em:

   ```
   /path/to/moodle/media/player/kinescope
   ```

3. Entre no Moodle como administrador e abra a administração do site. O Moodle detecta o plugin novo e oferece concluir a instalação.

> **Информация:**

O plugin também está no [diretório de plugins do Moodle](https://moodle.org/plugins/media_kinescope) se você preferir instalar à mão ou pelo controle de versão.



## Configuração

Depois da instalação, ative o plugin:

1. No painel de administração abra **Administração do site → Plugins → Gerenciar players de mídia**.
2. Encontre **Kinescope** na lista e ligue o plugin.
3. Salve as alterações.

Isso basta para o uso básico.

### Tamanho padrão do player

Nas configurações do plugin você define altura e largura do player para todos os vídeos incorporados na plataforma. Abra os parâmetros do plugin na mesma seção de players de mídia e informe os valores em pixels.

> **Информация:**

Os tamanhos nas configurações do plugin valem para o site inteiro. Para um tamanho pontual, edite o HTML de incorporação no editor avançado do Moodle.



## Dicas de uso

**Use o link direto do vídeo.** O plugin reconhece links no formato `https://kinescope.io/VIDEOID`. Copie o link de um vídeo específico, não de uma pasta ou de um projeto.

**Restrinja a reprodução por domínio.** Para o vídeo tocar só dentro do seu Moodle, ative a [restrição por domínio](https://docs-br.kinescope.com/content-protection/access-restrictions/) nas configurações do vídeo no Kinescope. Assim o player não abre em outros sites mesmo se alguém copiar o link.

**Confira a privacidade do vídeo.** Vídeos no Kinescope podem ter o acesso limitado por padrão. As configurações de privacidade precisam permitir a reprodução pelo plugin, senão os alunos veem um erro.

**Não cole o código de incorporação no lugar do link.** O plugin trabalha com links de vídeo. Um iframe colado como está pode aparecer como texto ou não aparecer, conforme o editor.

## Quem já usa o plugin

Pelo catálogo oficial do Moodle, o plugin está instalado em mais de **22 plataformas** no mundo, incluindo organizações de ensino e portais corporativos que guardam e protegem o vídeo dos cursos no Kinescope.

## O que fazer a seguir?

Depois de configurar a integração:

1. **[Restringir o acesso ao vídeo](https://docs-br.kinescope.com/content-protection/access-restrictions/)** — permita a reprodução só no domínio da sua LMS.
2. **[Configurações de arquivos de mídia](https://docs-br.kinescope.com/catalog-and-video-management/media-file-settings/)** — privacidade e condições de acesso.
3. **[Proteção de conteúdo](https://docs-br.kinescope.com/content-protection/)** — criptografia DRM e marcas d'água.
4. **[Analytics](https://docs-br.kinescope.com/catalog-and-video-management/analytics/)** — quem assiste aos vídeos do curso e por quanto tempo.
5. **[Open edX](https://docs-br.kinescope.com/integrations/integration-with-open-edx/)** — se você também usa Open edX.

Dúvidas? Escreva no [chat de suporte](https://t.me/kinescope_bot).