Integrações de vídeo

Quem já aloja os vídeos no Bunny Stream, no Cloudflare Stream, no Panda Video ou num HLS próprio não precisa de carregar nada de novo: cole a ligação do vídeo na aula de vídeo ou no texto de um status do Feed ou de uma publicação de Conteúdo, e o vídeo reproduz-se dentro da Memberfy, com o player do fornecedor (o HLS, no player da própria Memberfy).

• Só para quem tem acesso. O player só aparece a quem pode ver a aula ou a publicação. Quem vê só o índice do curso, uma aula travada ou não tem acesso ao espaço não recebe o endereço do vídeo, nem pela API nem pelo assistente.
• O vídeo fica no seu fornecedor. A Memberfy não descarrega nem copia o vídeo, e ele não gasta o armazenamento da comunidade: o player reproduz diretamente a partir da origem.
• Com a chave de assinatura (Bunny e Cloudflare), o endereço do vídeo expira em 6 horas e não se reproduz fora da comunidade. Ver Vídeo protegido.

#A ligação de cada fornecedor

O endereço tem de ser exatamente de um destes serviços. Um domínio parecido (como bunnycdn.com.outro-site.net), um HLS em http, um IP, uma porta ou um servidor interno são recusados na aula; numa publicação, ficam só como ligação.

#Passo a passo

Papel: proprietário ou administrador para a aula; no Feed e no Conteúdo, quem pode publicar no espaço.

#Bunny Stream

1. No painel do Bunny, abra a biblioteca de vídeos (Stream) e o vídeo.
2. Copie a ligação do player: o endereço https://iframe.mediadelivery.net/embed/… do código de incorporação (ou a ligação /play/).
3. Na Memberfy, cole a ligação no campo do vídeo da aula (tipo Vídeo) ou no texto da publicação.
4. Se a biblioteca exige token para reproduzir (Security › Embed view token authentication), registe a chave: ver Vídeo protegido. Sem a chave, o vídeo de uma biblioteca com token não se reproduz.

#Cloudflare Stream

1. No painel do Cloudflare, abra Stream e o vídeo.
2. Copie a ligação do player: https://customer-{código}.cloudflarestream.com/{id} (ou a de iframe.videodelivery.net).
3. Cole a ligação na aula ou na publicação.
4. Se o vídeo exige ligação assinada (Require signed URLs), registe a chave de assinatura da conta (a que cria em Stream › Signing keys).

#Panda Video

1. No painel do Panda, abra o vídeo e o código de incorporação.
2. Copie o endereço do player: https://{player}.tv.pandavideo.com.br/embed/?v={id}.
3. Cole a ligação na aula ou na publicação. O Panda não usa chave na Memberfy: a proteção do vídeo (domínios permitidos e afins) configura-se no próprio Panda.

#HLS próprio

1. Copie o endereço do manifesto do vídeo, que termina em .m3u8 e começa por https://.
2. Cole-o na aula ou na publicação. O vídeo reproduz-se no player da Memberfy, com controlos, ecrã inteiro e, na aula, a retoma do ponto onde o aluno parou.
3. O servidor tem de ser público e aceitar que o vídeo seja reproduzido noutro site (CORS); a Memberfy não passa o vídeo pelos servidores dela. Se ele não responder ou não permitir, o player mostra "Não foi possível reproduzir este vídeo aqui. O servidor de origem não respondeu ou não permite a reprodução neste site.", com o botão Abrir o endereço do vídeo.

#Vídeo protegido (Bunny e Cloudflare)

Papel: proprietário ou administrador. Se a biblioteca do Bunny ou a conta do Cloudflare exige token para reproduzir, registe a chave de assinatura da comunidade em Definições › Integrações de vídeo (no grupo Conexões):

1. Preencha e clique em Guardar chave. O ecrã confirma "Chave guardada. Verifica com um vídeo teu."
2. Em Verificar com um vídeo teu, cole a ligação de um vídeo do mesmo fornecedor e clique em Verificar: a Memberfy assina a ligação desse vídeo e pergunta ao fornecedor se a aceita. Aceite, a chave fica Válida; recusada, Inválida.
3. Pronto: o vídeo da aula ou da publicação passa a sair assinado, válido durante 6 horas, só para quem já o podia ver. Quem copia o endereço do player não o consegue reproduzir depois disso.

Cada fornecedor mostra o estado da chave (Sem chave, Não verificada, Válida ou Inválida) e a Última verificação.

• A chave é só de escrita. Depois de guardada, já não aparece: só os 4 últimos caracteres (no Cloudflare, do id da chave). Para a mudar, use Trocar chave.
• Remover chave pede a confirmação "Remover a chave do Bunny Stream?" (ou do Cloudflare Stream) e apaga a chave de imediato: os vídeos desse fornecedor voltam a sair sem assinatura e não se reproduzem se a biblioteca exige token. As aulas e as publicações continuam como estão.
• Registar, trocar, verificar e remover ficam nos Logs, sem o valor da chave.
• Só o proprietário e o administrador veem o ecrã e as chaves.

#Quando o fornecedor recusa a chave

Se o fornecedor recusar a chave (na verificação ou mais tarde, por ter sido trocada lá), os vídeos desse fornecedor ficam indisponíveis até registar a chave certa: quem assiste vê "Vídeo indisponível" e "Avisa a equipa da comunidade para que ela resolva." O proprietário e o administrador recebem um aviso no sino, no máximo uma vez por dia, que abre Integrações de vídeo; para eles, o vídeo indisponível traz o botão Abrir Integrações de vídeo. Os vídeos dos outros fornecedores continuam a reproduzir-se.

#Pela API e pelo assistente

• API: a aula de vídeo aceita estas ligações em contentUrl e devolve o player pronto em videoEmbed (provider, kind, src), só para quem pode ver a aula; as chaves ficam em /api/video-integrations. Ver Cursos › Pela API.
• MCP: create_lesson e update_lesson aceitam as ligações; list_video_keys, update_video_key, verify_video_key e delete_video_key (que pede confirmação) tratam das chaves, que nunca voltam na resposta. Ver Ferramentas de cursos.

#Perguntas frequentes

Preciso de carregar o vídeo de novo? Não. Use a ligação do seu fornecedor.

Alguém pode copiar a ligação? Quem tem acesso vê o endereço do player. Sem a chave, é o endereço do fornecedor; com a chave (Bunny e Cloudflare), expira em 6 horas.

Gasta o armazenamento da comunidade? Não. O vídeo fica no seu fornecedor. Só o vídeo alojado na Memberfy conta no armazenamento.

E o vídeo de boas-vindas? Continua só com YouTube e Vimeo. Ver Boas-vindas.

#Relacionados

• Cursos
• Feed › Links viram player ou cartão
• Conteúdo › Links viram player ou cartão