Integrazioni video

Se ospiti già i tuoi video su Bunny Stream, Cloudflare Stream, Panda Video o su un HLS proprio, non devi caricare niente di nuovo: incolla il link del video nella lezione video o nel testo di uno status del Feed o di un post di Contenuti, e il video parte dentro Memberfy, con il player del provider (l'HLS, nel player di Memberfy).

• Solo per chi ha accesso. Il player arriva solo a chi può vedere la lezione o il post. Chi vede solo l'indice del corso, una lezione bloccata o non ha accesso allo spazio non riceve l'indirizzo del video, né tramite l'API né tramite l'assistente.
• Il video resta sul tuo provider. Memberfy non scarica né copia il video, e non consuma lo spazio di archiviazione della community: il player lo riproduce direttamente dall'origine.
• Con la chiave di firma (Bunny e Cloudflare), l'indirizzo del video scade dopo 6 ore e non si riproduce fuori dalla community. Vedi Video protetto.

#Il link di ogni provider

L'indirizzo deve appartenere esattamente a uno di questi servizi. Un dominio simile (come bunnycdn.com.altro-sito.net), un HLS in http, un IP, una porta o un server interno vengono rifiutati nella lezione; in un post, restano un semplice link.

#Passo per passo

Ruolo: proprietario o amministratore per la lezione; nel Feed e nei Contenuti, chi può pubblicare nello spazio.

#Bunny Stream

1. Nel pannello di Bunny, apri la libreria video (Stream) e il video.
2. Copia il link del player: l'indirizzo https://iframe.mediadelivery.net/embed/… del codice di incorporamento (o il link /play/).
3. In Memberfy, incolla il link nel campo del video della lezione (tipo Video) o nel testo del post.
4. Se la libreria richiede un token per la riproduzione (Security › Embed view token authentication), registra la chiave: vedi Video protetto. Senza la chiave, il video di una libreria con token non parte.

#Cloudflare Stream

1. Nel pannello di Cloudflare, apri Stream e il video.
2. Copia il link del player: https://customer-{codice}.cloudflarestream.com/{id} (o quello di iframe.videodelivery.net).
3. Incolla il link nella lezione o nel post.
4. Se il video richiede link firmati (Require signed URLs), registra la chiave di firma dell'account (quella che crei in Stream › Signing keys).

#Panda Video

1. Nel pannello di Panda, apri il video e il suo codice di incorporamento.
2. Copia l'indirizzo del player: https://{player}.tv.pandavideo.com.br/embed/?v={id}.
3. Incolla il link nella lezione o nel post. Panda non usa chiavi in Memberfy: la protezione del video (domini consentiti e simili) si configura in Panda.

#HLS proprio

1. Copia l'indirizzo del manifest del video, che finisce in .m3u8 e inizia con https://.
2. Incollalo nella lezione o nel post. Il video parte nel player di Memberfy, con controlli, schermo intero e, nella lezione, la ripresa dal punto in cui lo studente si era fermato.
3. Il server deve essere pubblico e consentire la riproduzione del video da un altro sito (CORS); Memberfy non fa passare il video dai propri server. Se non risponde o non lo consente, il player mostra "Non è stato possibile riprodurre questo video qui. Il server di origine non ha risposto o non consente la riproduzione su questo sito.", con il pulsante Apri l'indirizzo del video.

#Video protetto (Bunny e Cloudflare)

Ruolo: proprietario o amministratore. Se la libreria Bunny o l'account Cloudflare richiede un token per la riproduzione, registra la chiave di firma della community in Impostazioni › Integrazioni video (nel gruppo Connessioni):

1. Compila e fai clic su Salva chiave. La schermata conferma "Chiave salvata. Verificala con un tuo video."
2. In Verifica con un tuo video, incolla il link di un video dello stesso provider e fai clic su Verifica: Memberfy firma il link di quel video e chiede al provider se lo accetta. Accettata, la chiave è Valida; rifiutata, Non valida.
3. Fatto: il video della lezione o del post esce firmato, valido per 6 ore, solo per chi poteva già vederlo. Chi copia l'indirizzo del player non riesce a riprodurlo dopo.

Ogni provider mostra lo stato della chiave (Nessuna chiave, Non verificata, Valida o Non valida) e l'Ultima verifica.

• La chiave è di sola scrittura. Una volta salvata, non viene più mostrata: solo gli ultimi 4 caratteri (per Cloudflare, dell'id della chiave). Per cambiarla, usa Sostituisci chiave.
• Rimuovi chiave chiede la conferma "Rimuovere la chiave di Bunny Stream?" (o di Cloudflare Stream) e cancella subito la chiave: i video di quel provider tornano a uscire senza firma e non partono se la libreria richiede un token. Lezioni e post restano come sono.
• Registrazione, sostituzione, verifica e rimozione finiscono nei Log, senza il valore della chiave.
• Solo il proprietario e l'amministratore vedono la schermata e le chiavi.

#Quando il provider rifiuta la chiave

Se il provider rifiuta la chiave (alla verifica o più tardi, perché è stata cambiata lì), i video di quel provider diventano non disponibili finché non registri la chiave giusta: chi guarda vede "Video non disponibile" e "Avvisa il team della community perché lo risolva." Il proprietario e l'amministratore ricevono un avviso nella campanella, al massimo una volta al giorno, che apre Integrazioni video; per loro, il video non disponibile ha il pulsante Apri Integrazioni video. I video degli altri provider continuano a funzionare.

#Con l'API e con l'assistente

• API: la lezione video accetta questi link in contentUrl e restituisce il player pronto in videoEmbed (provider, kind, src), solo per chi può vedere la lezione; le chiavi sono in /api/video-integrations. Vedi Corsi › Con l'API.
• MCP: create_lesson e update_lesson accettano i link; list_video_keys, update_video_key, verify_video_key e delete_video_key (che chiede conferma) gestiscono le chiavi, che non tornano mai nella risposta. Vedi Strumenti dei corsi.

#Domande frequenti

Devo caricare di nuovo il video? No. Usa il link del tuo provider.

Qualcuno può copiare il link? Chi ha accesso vede l'indirizzo del player. Senza la chiave, è l'indirizzo del provider; con la chiave (Bunny e Cloudflare), scade dopo 6 ore.

Consuma lo spazio di archiviazione della community? No. Il video resta sul tuo provider. Solo il video ospitato su Memberfy conta nell'archiviazione.

E il video di benvenuto? Resta solo con YouTube e Vimeo. Vedi Benvenuto.

#Correlati

• Corsi
• Feed › I link diventano player o scheda
• Contenuti › I link diventano player o scheda