Video in Dynamic Media video

Questa sezione descrive come lavorare con i video in Dynamic Media.

Guida introduttiva: Video quick-start-videos

La seguente descrizione dettagliata del flusso di lavoro è stata progettata per aiutarti a iniziare rapidamente a utilizzare i set per video adattivi in Dynamic Media. Dopo ogni passaggio, sono disponibili riferimenti incrociati alle intestazioni degli argomenti in cui è possibile trovare ulteriori informazioni.

Utilizzare i video in Dynamic Media working-with-video-in-dynamic-media

Video in Dynamic Media è una soluzione end-to-end che consente di pubblicare facilmente video adattivi di alta qualità per lo streaming su più schermi, tra cui dispositivi mobili desktop, iOS, Android™, BlackBerry® e Windows. Un set video adattivo raggruppa le versioni dello stesso video che sono codificate in diversi formati e bit rate, ad esempio 400 kbps, 800 kbps e 1000 kbps. Il computer desktop o il dispositivo mobile rileva la larghezza di banda disponibile.

Ad esempio, su un dispositivo mobile iOS rileva una larghezza di banda, come 3G, 4G o Wi-Fi. Quindi seleziona automaticamente il video codificato giusto tra i vari bit rate video all’interno del set video adattivo. Il video viene inviato in streaming a desktop, dispositivi mobili o tablet.

Inoltre, la qualità video viene commutata automaticamente se cambiano le condizioni di rete sul desktop o sul dispositivo mobile. Inoltre, se un cliente entra in modalità a tutto schermo su un desktop, il set video adattivo risponde con una risoluzione migliore, migliorando l’esperienza di visualizzazione del cliente. I set video adattivi garantiscono una riproduzione ottimale per i clienti che visualizzano video Dynamic Media su più schermi e dispositivi.

La logica utilizzata da un lettore video per determinare quale video codificato riprodurre o selezionare durante la riproduzione si basa sul seguente algoritmo:

Per informazioni tecniche dettagliate sull'algoritmo, vedere https://android.googlesource.com/platform/frameworks/av/+/master/media/libstagefright/httplive/LiveSession.cpp

Per la gestione di un singolo video e di set di video adattivi, sono supportati i seguenti elementi:

Lo streaming video adattivo è supportato su varie piattaforme iOS. Consulta la Guida di riferimento per i visualizzatori Dynamic Media.

Dynamic Media supporta la riproduzione di video per dispositivi mobili per video MP4 H.264.

È possibile trovare i dispositivi Windows che supportano questo formato video nel seguente percorso: Codec multimediali supportati per Windows Phone 8

Consulta anche Visualizzatori per Experience Manager Assets e Dynamic Media Classic e Visualizzatori per risorse di Experience Manager.

Best practice: utilizzo del visualizzatore video HTML5 best-practice-using-the-html-video-viewer

I predefiniti visualizzatore video Dynamic Media HTML5 sono lettori video affidabili. È possibile utilizzarli per evitare molti problemi comuni associati alla riproduzione di video HTML5. Inoltre, problemi associati ai dispositivi mobili come la mancanza di distribuzione di streaming bitrate adattivo e la portata limitata del browser desktop.

Dal lato della progettazione del lettore, puoi progettare le funzionalità del lettore video utilizzando gli strumenti di sviluppo web standard. Ad esempio, puoi progettare pulsanti, controlli e sfondo personalizzato per le immagini del poster utilizzando HTML5 e CSS per raggiungere i clienti con un aspetto personalizzato.

Sul lato di riproduzione del visualizzatore, rileva automaticamente la funzionalità video del browser. Distribuisce quindi il video utilizzando HLS (HTTP Live Streaming) o DASH (Dynamic Adaptive Streaming over HTTP), noto anche come streaming bitrate adattivo. In alternativa, se tali metodi di distribuzione non sono presenti, viene utilizzato HTML5 progressive.

Combinando in un singolo lettore quanto segue:

È possibile estendere la portata dei contenuti rich media agli utenti desktop e mobili e garantire un'esperienza video semplificata.

Vedi anche Informazioni sui visualizzatori HTML5.

Riproduzione di video su computer desktop e dispositivi mobili mediante il visualizzatore video HTML5 playback-of-video-on-desktop-computers-and-mobile-devices-using-the-html-video-viewer

Per lo streaming video adattivo per desktop e dispositivi mobili, i video utilizzati per il passaggio a bit rate si basano su tutti i video MP4 nel set di video adattivi.

La riproduzione video viene eseguita utilizzando DASH o HLS oppure tramite download progressivo di video. Nelle versioni precedenti di Experience Manager, come 6.0, 6.1 e 6.2, i video venivano inviati in streaming tramite HTTP.

In Experience Manager 6.3 e versioni successive, i video vengono ora inviati in streaming tramite HTTPS (ovvero DASH o HLS) perché l’URL del servizio gateway DM utilizza sempre anche HTTPS. Questo comportamento predefinito non ha alcun impatto sul cliente. Lo streaming video avviene sempre tramite HTTPS, tranne quando il browser non lo supporta. (Vedi la tabella seguente). Pertanto,

DASH è lo standard internazionale e HLS è uno standard Apple. Entrambi vengono utilizzati per lo streaming video adattivo. Entrambe le tecnologie regolano automaticamente la riproduzione in base alla capacità della larghezza di banda della rete. Consente inoltre al cliente di "cercare" in qualsiasi punto del video senza dover attendere il download del resto del video.

Il video progressivo viene distribuito scaricando e memorizzando il video localmente sul sistema desktop o sul dispositivo mobile di un utente.

La tabella seguente descrive il dispositivo, il browser e il metodo di riproduzione dei video su computer desktop e dispositivi mobili che utilizzano il visualizzatore video Dynamic Media.

Architettura della soluzione video Dynamic Media architecture-of-dynamic-media-video-solution

L’immagine seguente mostra il flusso di lavoro complessivo per l’authoring dei video caricati e codificati tramite DMGateway (in modalità ibrida Dynamic Media) e resi disponibili al pubblico.

Architettura di pubblicazione ibrida per video hybrid-publishing-architecture-for-videos

Best practice per la codifica dei video best-practices-for-encoding-videos

Se hai attivato Dynamic Media e hai impostato Cloud Services per i video, il flusso di lavoro Codifica video elementi multimediali dinamici ti consente di eseguire la codifica dei video. Questo flusso di lavoro acquisisce la cronologia del processo del flusso di lavoro e le informazioni di errore. Se hai attivato Dynamic Media e hai impostato Cloud Services per i video, il flusso di lavoro Codifica video elementi multimediali dinamici viene applicato automaticamente al momento di caricare un video. Se non utilizzi Dynamic Media, viene applicato il flusso di lavoro Risorsa di aggiornamento DAM.

File video Source source-video-files

Quando codificate un file video, utilizzate un file video sorgente della massima qualità possibile. Evita di utilizzare file video codificati in precedenza perché sono già compressi e un’ulteriore codifica crea un video di qualità inferiore.

La tabella seguente descrive le dimensioni, le proporzioni e la velocità bit minima consigliate per i file video sorgente prima di codificarli:

Ottenere i metadati di un file obtaining-a-file-s-metadata

È possibile ottenere i metadati di un file visualizzandone i metadati mediante uno strumento di modifica video o un'applicazione progettata per ottenere i metadati. Di seguito sono riportate le istruzioni per l’utilizzo di MediaInfo, un’applicazione di terze parti, per ottenere i metadati di un file video:

Proporzioni aspect-ratio

Quando selezioni o crei un predefinito di codifica video per il file video principale, assicurati che le proporzioni del predefinito corrispondano a quelle del file video principale. Le proporzioni corrispondono al rapporto tra la larghezza e l'altezza del video.

Per determinare le proporzioni di un file video, recuperate i metadati del file e annotate la larghezza e l'altezza del file. Consulta Ottenere i metadati di un file qui sopra. Quindi utilizza questa formula per determinare le proporzioni:

larghezza/altezza = proporzioni

Nella tabella seguente viene descritto come i risultati della formula si traducono in scelte di proporzioni comuni:

Ad esempio, un video con larghezza 1440 × altezza 1080 ha proporzioni 1440/1080 o 1,33. In questo caso, scegliete un predefinito di codifica video con proporzioni 4:3 per codificare il file video.

Bitrate bitrate

Un bitrate è la quantità di dati codificati per formare un singolo secondo di riproduzione video. Il bitrate viene misurato in kilobit al secondo (Kbps).

Quando si seleziona una codifica bitrate, è possibile scegliere tra due tipi:

Quando si utilizza VBR rispetto a CRB?
Quando selezioni VBR rispetto a CBR, si consiglia quasi sempre di utilizzare VBR per i file multimediali. VBR fornisce file di qualità superiore a bitrate competitivi. Quando si utilizza VBR, assicurarsi di utilizzare con la codifica a due passate e impostare il bitrate massimo su 1,5 volte il bitrate video di destinazione.

Quando scegli un predefinito di codifica video, ricorda la velocità di connessione dell’utente finale target. Scegli un predefinito con una velocità dati pari all’80% di quella velocità. Ad esempio, se la velocità di connessione dell'utente finale è di 1000 Kbps, il valore predefinito migliore è 800 Kbps.

Questa tabella descrive la velocità dati delle velocità di connessione tipiche.

Risoluzione resolution

La risoluzione descrive l'altezza e la larghezza in pixel di un file video. La maggior parte dei video sorgente viene memorizzata ad alta risoluzione (ad esempio, 1920 × 1080). Ai fini dello streaming, il video sorgente viene compresso a una risoluzione inferiore (640 × 480 o inferiore).

La risoluzione e la velocità dei dati sono due fattori strettamente collegati che determinano la qualità video. Per mantenere la stessa qualità video, maggiore è il numero di pixel in un file video (maggiore è la risoluzione), maggiore è la velocità dati. Ad esempio, si consideri il numero di pixel per fotogramma in un file video con risoluzione 320 × 240 e 640 × 480:

Il file 640 × 480 ha un numero di pixel per fotogramma quattro volte superiore. Per ottenere la stessa velocità dati per queste due risoluzioni di esempio, applicate una compressione quattro volte superiore al file 640 × 480, riducendo in tal modo la qualità del video. Di conseguenza, una velocità di dati video di 250 Kbps produce una visualizzazione di alta qualità con una risoluzione di 320 × 240, ma non con una risoluzione di 640 × 480.

In generale, maggiore è la velocità dati utilizzata, migliore è l'aspetto del video e maggiore è la risoluzione, maggiore è la velocità dati, maggiore è la qualità di visualizzazione (rispetto alle risoluzioni più basse).

Poiché la risoluzione e la velocità dati sono collegate, durante la codifica del video sono disponibili due opzioni:

Quando scegli (o crei) un predefinito di codifica video per il file video sorgente principale, utilizza questa tabella per individuare la risoluzione corretta:

La risoluzione video in ingresso massima supportata è 16.384 × 16.384. La risoluzione massima di codifica video in uscita è 8.192 × 4.320 o 4.320 × 8.192.

Fps (frame al secondo) fps-frames-per-second

Negli Stati Uniti e in Giappone, la maggior parte dei video sono registrati a 29,97 fotogrammi al secondo (fps). In Europa, lo standard è 25 fps. Il film, tuttavia, viene generalmente girato a 24 fps.

Scegli un predefinito di codifica video che corrisponda alla velocità fps del file video sorgente principale. Ad esempio, se il video sorgente principale è a 25 fps, scegliete un predefinito di codifica con 25 fps. Per impostazione predefinita, tutta la codifica personalizzata utilizza il fps del file video sorgente principale. Per questo motivo, non è necessario specificare esplicitamente l'impostazione fps quando si crea un predefinito di codifica video.

Dimensioni di codifica video video-encoding-dimensions

Per risultati ottimali, seleziona dimensioni di codifica tali che il video sorgente sia un multiplo di tutti i video codificati.

Per calcolare questo rapporto, si divide la larghezza dell'origine per la larghezza codificata per ottenere il rapporto di larghezza. Quindi, per ottenere il rapporto di altezza, dividi l’altezza sorgente per altezza codificata.

Se il rapporto risultante è un numero intero, significa che il video è ridimensionato in modo ottimale. Se il rapporto risultante non è un numero intero, influisce sulla qualità video lasciando sul display gli artefatti di pixel rimanenti. Questo effetto è più evidente quando il video contiene del testo.

Ad esempio, supponiamo che il video sorgente sia 1920 × 1080. Nella tabella seguente, i tre video codificati forniscono le impostazioni di codifica ottimali da utilizzare.

Formato file video codificato encoded-video-file-format

Dynamic Media consiglia di utilizzare i predefiniti di codifica video MP4 H.264. Poiché i file MP4 utilizzano il codec video H.264, questo offre video di alta qualità ma in dimensioni di file compressi.

Visualizzare rapporti video viewing-video-reports

I report video visualizzano diverse metriche aggregate in un determinato periodo di tempo per aiutarti a monitorare che video pubblicati singoli e aggregati stiano ottenendo le prestazioni previste. I seguenti dati sulle metriche principali sono aggregati per tutti i video pubblicati sull’intero sito web:

È inoltre presente una tabella di tutti i video pubblicati che ti consente di tenere traccia dei video visualizzati più in alto sul tuo sito Web in base al totale degli avvii dei video.

Quando selezioni un nome video nell’elenco, viene visualizzato il rapporto di conservazione del pubblico (a discesa) del video sotto forma di un grafico a linee. Il grafico mostra il numero di visualizzazioni per un dato momento della riproduzione video. Quando si riproduce il video, la barra verticale viene sincronizzata con l'indicatore di tempo nel lettore. Le cadute nei dati del grafico a linee indicano dove il pubblico abbandona il disinteresse.

Se il video è stato codificato al di fuori di Adobe Experience Manager Dynamic Media, il grafico di mantenimento del pubblico (a discesa) e i dati della percentuale di riproduzione nella tabella non sono disponibili.

Vedi anche Configurare i servizi cloud per elementi multimediali dinamici.

Per impostazione predefinita, la prima volta che si immettono i rapporti video, il rapporto visualizza i dati video a partire dal primo del mese corrente e termina con la data del mese corrente. Tuttavia, puoi sovrascrivere l’intervallo di date predefinito specificando un intervallo di date personalizzato. Alla successiva immissione di Report video, viene utilizzato l'intervallo di date specificato.

Affinché i rapporti video funzionino correttamente, viene creato automaticamente un ID suite di rapporti quando viene configurato Dynamic Media Cloud Services. Allo stesso tempo, l’ID suite di rapporti viene inviato al server di pubblicazione, in modo che sia disponibile per la funzione Copia URL quando visualizzi l’anteprima delle risorse. Tuttavia, questa funzionalità richiede che il server di pubblicazione sia già configurato. Se il server di pubblicazione non è configurato, puoi comunque eseguire la pubblicazione per visualizzare il rapporto video. Tuttavia, devi tornare alla configurazione cloud di Dynamic Media e selezionare OK.

Per visualizzare i report video:

Visualizzare rapporti video basati su un visualizzatore video creato con Dynamic Media HTML5 Viewer SDK viewing-video-reports-based-on-a-video-viewer-that-you-created-using-the-scene-hmtl-viewer-sdk

Se utilizzi un visualizzatore video predefinito fornito da Dynamic Media, o se hai creato un predefinito visualizzatore personalizzato basato su un visualizzatore video predefinito, non sono necessari passaggi aggiuntivi per visualizzare i rapporti video. Tuttavia, se hai creato un visualizzatore video personalizzato basato sull’API SDK del visualizzatore di HTML5, procedi come segue per assicurarti che il visualizzatore video invii eventi di tracciamento ai rapporti video Dynamic Media.

Utilizza la Guida di riferimento per i visualizzatori Dynamic Media di Adobe e l'API HTML5 Viewer SDK per creare visualizzatori video personalizzati.

Per visualizzare i report video basati su un visualizzatore video creato con il visualizzatore Dynamic Media HTML5 SDK:

Informazioni sul supporto di più didascalie e tracce audio per video in Dynamic Media about-msma

Grazie alla funzionalità di didascalia multipla e traccia audio in Dynamic Media, è possibile aggiungere facilmente più sottotitoli e tracce audio a un video principale. Grazie a questa funzionalità, i video sono accessibili a un pubblico globale. È possibile personalizzare un singolo video principale pubblicato per un pubblico globale in più lingue e rispettare le linee guida sull’accessibilità per diverse aree geografiche. Gli autori possono anche gestire i sottotitoli e le tracce audio da una singola scheda nell’interfaccia utente.

Scheda

Alcuni dei casi d’uso da considerare per aggiungere più didascalie e tracce audio al video principale sono i seguenti:

Tutti i formati video supportati in Dynamic Media e tutti i visualizzatori video Dynamic Media, ad eccezione del visualizzatore Video_360 di Dynamic Media, sono supportati per l'utilizzo con più didascalie e tracce audio.

Aggiungere più didascalie e tracce audio al video add-msma

Prima di aggiungere più didascalie e tracce audio al video, assicurati di avere già le seguenti informazioni:

Le didascalie e i sottotitoli aggiunti sono supportati nei formati WebVTT e Adobe .vtt. Inoltre, i file di traccia audio aggiunti sono supportati con il formato MP3.

Per aggiungere più didascalie e tracce audio al video:

Informazioni sull'aggiunta di file di didascalia e traccia audio a un video già pubblicato

Il caricamento di ulteriori file di didascalia o di tracce audio in un video già pubblicato determina l'assegnazione dello stato Processed a tali file. Questo stato viene applicato dopo la preparazione dei file dopo il caricamento. A questo punto, puoi visualizzare in anteprima il video in Dynamic Media per vedere o ascoltare i file appena caricati.

Dopo l'anteprima, tuttavia, è necessario pubblicare di nuovo il video per pubblicare anche i file di didascalia o di traccia audio appena aggiunti. Dopo la pubblicazione, i sottotitoli o l’audio diventano disponibili con l’URL pubblico di Dynamic Media.

Se hai configurato Dynamic Media per la pubblicazione immediata, il caricamento di file di didascalia o audio aggiuntivi attiva immediatamente la pubblicazione del video in seguito al caricamento di file di didascalia o audio.

Aggiungere più sottotitoli a un video che ha un URL esistente con modificatore sottotitoli

Dynamic Media supporta l’aggiunta di una didascalia singola con video tramite un modificatore URL. Vedi Aggiungere didascalie al video.

Le modifiche apportate a più sottotitoli hanno la precedenza su una didascalia aggiunta tramite un modificatore URL per i video pubblicati.

Per aggiungere più sottotitoli a un video che ha un URL esistente con modificatore di sottotitoli:

Visualizzare lo stato del ciclo di vita dei file di didascalia e traccia audio caricati lifecycle-status-video

Puoi osservare lo stato del ciclo di vita di qualsiasi file di didascalia o traccia audio caricato nel video principale. Puoi farlo dalla scheda Sottotitoli e tracce audio di Proprietà.

Per visualizzare lo stato del ciclo di vita di un video:

Stato del ciclo di vita di ogni didascalia e file di traccia audio caricati.

Impostare l'audio predefinito per un video con più tracce audio

Per impostazione predefinita, l'audio originale di un video è impostato come audio predefinito da riprodurre.

Tuttavia, tutti i file di traccia audio caricati possono essere impostati come audio predefinito da riprodurre dopo il caricamento di un video nel visualizzatore. Nell'interfaccia utente Proprietà, nella scheda Sottotitoli e tracce audio, l'etichetta Default viene applicata a destra del file di traccia audio per la riproduzione video.

Per impostare l'audio predefinito per un video con più tracce audio:

Anteprima di un video con più didascalie e tracce audio preview-video-audio-subtitle

Dopo aver caricato i file di didascalia e di traccia audio in un video ed elaborato, è possibile utilizzare il visualizzatore video Dynamic Media (o altri tipi di visualizzatore, se necessario) per visualizzare in anteprima tutte le diverse tracce. L'anteprima consente di vedere l'aspetto e l'audio del video per i clienti e di assicurarsi che si comporti come previsto.

Se il video è soddisfacente, puoi pubblicarlo utilizzando uno dei seguenti metodi.

Vedi Incorporare il visualizzatore di video o immagini in una pagina Web.
Consulta Collegare gli URL all'applicazione Web. Il metodo di collegamento basato su URL non è possibile se il contenuto interattivo presenta collegamenti con URL relativi, in particolare collegamenti a pagine Experience Manager Sites.
Consulta Aggiungere Dynamic Media Assets alle pagine.

Per visualizzare in anteprima un video con più didascalie e tracce audio:

Eliminare i file di didascalia o di traccia audio da un video

Potete eliminare file di didascalia o di traccia audio da un video. L’eliminazione dei file di didascalia o di traccia audio pubblicati si riflette automaticamente nell’URL pubblicato del video.

Non è possibile eliminare la traccia audio originale estratta da un video principale.

Per eliminare i file di didascalia o di traccia audio da un video:

Scarica i file di didascalia o di traccia audio caricati in un video

Puoi scaricare uno o più file di didascalia o di traccia audio caricati per l'utilizzo con un video. È possibile scaricare tutti i file selezionati come file.zip o creare una cartella di download separata per ciascun file.

Non è possibile scaricare la traccia audio originale estratta da un file principale.

Per scaricare i file di didascalia o di traccia audio da un video:

Aggiungere sottotitoli codificati a un video adding-captions-to-video

Puoi estendere la portata dei tuoi video ai mercati globali aggiungendo sottotitoli ai singoli video o ai set di video adattivi. Aggiungendo i sottotitoli, si evita di duplicare l'audio o di utilizzare madrelingua per registrare nuovamente l'audio per ogni lingua. Il video viene riprodotto nella lingua in cui è stato registrato. I sottotitoli delle lingue straniere vengono visualizzati in modo che persone di lingue diverse possano ancora comprendere la porzione audio.

I sottotitoli codificati consentono inoltre una maggiore accessibilità alle persone non udenti o ipoudenti.

Vedi anche Accessibilità in Dynamic Media.

Dynamic Media converte i file di didascalia in formato JSON (JavaScript Object Notation). Questa conversione ti consente di incorporare il testo JSON in una pagina web come trascrizione nascosta ma completa del video. I motori di ricerca possono quindi eseguire la ricerca per indicizzazione e indicizzare il contenuto per rendere i video più facilmente individuabili e fornire ai clienti ulteriori dettagli sul contenuto video.

Per ulteriori informazioni sull'utilizzo della funzione JSON in un URL, vedere Fornire contenuto statico (non immagine).

Per aggiungere sottotitoli codificati a un video:

Aggiungere marcatori capitolo al video adding-chapter-markers-to-video

Per semplificare la visualizzazione e la navigazione dei video lunghi, aggiungi marcatori capitolo ai singoli video o ai set di video adattivi. Quando un utente riproduce il video, può fare clic sui contrassegni dei capitoli sulla timeline del video (nota anche come scorrimento video) per spostarsi facilmente nel punto di interesse. In alternativa, è possibile passare immediatamente a nuovi contenuti, dimostrazioni e tutorial.

Se lo desideri, puoi creare un visualizzatore video personalizzato con i capitoli e aggiungerlo al tuo marchio, invece di utilizzare un predefinito visualizzatore video. Per istruzioni sulla creazione di un visualizzatore HTML5 personalizzato con navigazione dei capitoli, nell'API SDK del visualizzatore Adobe HTML5, fare riferimento all'intestazione "Personalizzazione del comportamento con i modificatori" nelle classi s7sdk.video.VideoPlayer e s7sdk.video.VideoScrubber. Consulta la documentazione dell'API SDK del visualizzatore di HTML5.

Per creare un elenco di capitoli per il video è necessario seguire le stesse procedure utilizzate per creare i sottotitoli. In altre parole, si crea un file WebVTT. Si noti, tuttavia, che questo file deve essere separato da qualsiasi file di sottotitoli WebVTT che si sta utilizzando anche; non è possibile combinare sottotitoli e capitoli in un unico file WebVTT.

L'esempio seguente può essere utilizzato come esempio del formato utilizzato per creare un file WebVTT con navigazione nei capitoli:

File WebVTT con navigazione capitolo video webvtt-file-with-video-chapter-navigation

WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.

Nell'esempio precedente, Chapter 1 è l'identificatore del cue ed è facoltativo. L'ora di cue di 00:00:000 --> 01:04:364 specifica l'ora di inizio e l'ora di fine del capitolo, nel formato 00:00:000. Le ultime tre cifre sono millisecondi e possono essere lasciate come 000, se lo si desidera. Il titolo del capitolo di The bicycle store behind it all è la descrizione effettiva del contenuto del capitolo. L'identificatore del cue, il tempo di cue iniziale e il titolo del capitolo vengono visualizzati in una finestra a comparsa del lettore video quando un utente passa il puntatore del mouse su un punto di cue visivo nella timeline del video.

Poiché si utilizza un visualizzatore video HTML5, assicurarsi che il file del capitolo creato segua lo standard WebVTT (Web Video Text Tracks). L'estensione del nome file del capitolo è .vtt. Ulteriori informazioni sullo standard per i sottotitoli WebVTT.

Vedere WebVTT: formato delle tracce di testo per video Web

Per aggiungere la navigazione del capitolo video:

Informazioni sulle miniature video in modalità Dynamic Media - Scene7 about-video-thumbnails-in-dynamic-media-scene-mode

Una miniatura video è una versione di dimensioni ridotte di un fotogramma video o di una risorsa immagine che rappresenta il video per il cliente. La miniatura serve a incoraggiare un cliente a selezionare il video.

A tutti i video in Experience Manager deve essere associata una miniatura; per eliminarla è necessario sostituirla. Per impostazione predefinita, quando caricate un video in Experience Manager, il primo fotogramma viene utilizzato come miniatura. Tuttavia, puoi personalizzare la miniatura a scopo di branding o di ricerca visiva, ad esempio. Quando si personalizza una miniatura video, è possibile riprodurre il video e metterlo in pausa sul fotogramma che si desidera utilizzare. In alternativa, puoi selezionare una risorsa immagine che hai già caricato e pubblicato nel tuo gestore di risorse digitali.

Un’immagine di miniatura video personalizzata selezionata da un video non viene estratta e salvata in DAM come risorsa separata e distinta. Tuttavia, una miniatura video personalizzata selezionata da una risorsa immagine esistente viene salvata in JCR. Il percorso della risorsa selezionata viene memorizzato nel nodo della risorsa video come nell’esempio di percorso seguente:

/content/dam/*<folder_name*>/<*video_name*>/jcr:content/manualThumbnail

La possibilità di personalizzare una miniatura video è disponibile solo dopo aver applicato un profilo video alla cartella in cui si trova il video.

Vedi anche Informazioni sulle miniature video in Dynamic Media - Modalità ibrida.

Aggiungi una miniatura video personalizzata adding-a-custom-video-thumbnail

Questi passaggi si applicano solo a Dynamic Media in esecuzione in modalità "Dynamicmedia_Scene7".

Per aggiungere una miniatura video personalizzata:

Informazioni sulle miniature video in Dynamic Media: modalità ibrida about-video-thumbnails-in-dynamic-media-hybrid-mode

Puoi scegliere una delle dieci immagini in miniatura generate automaticamente da Dynamic Media da aggiungere al video. Il lettore video mostra la miniatura selezionata quando una risorsa video viene utilizzata con il componente Dynamic Media nell’ambiente di authoring di Experience Manager Sites, Experience Manager Mobile o Experience Manager Screens. La miniatura funge da immagine statica che rappresenta al meglio il contenuto dell’intero video e incoraggia ulteriormente gli utenti a fare clic sul pulsante Play.

In base al tempo totale del video, Dynamic Media acquisisce dieci miniature (predefinite). Il sistema acquisisce le immagini ai seguenti intervalli video:

Le dieci miniature persistono, il che significa che se decidi di scegliere un’altra miniatura in un secondo momento, non è necessario rigenerare la serie. Puoi visualizzare in anteprima le dieci immagini in miniatura e quindi selezionare quella che desideri usare con il video. Se desideri impostare l’impostazione predefinita, puoi utilizzare CRXDE Lite per configurare l’intervallo di tempo in cui vengono generate le immagini in miniatura. Ad esempio, se desideri generare solo una serie di quattro immagini miniatura con spaziatura uniforme dal video, puoi configurare l’intervallo in modo che sia compreso tra 24%, 49%, 74% e 99%.

Idealmente, puoi aggiungere una miniatura video in qualsiasi momento dopo aver caricato il video, ma prima di pubblicarlo sul sito web.

Se lo desideri, puoi scegliere di caricare una miniatura personalizzata per rappresentare il video invece di utilizzare una miniatura generata da Dynamic Media. Ad esempio, puoi creare un’immagine miniatura personalizzata con il titolo del video, un’immagine di apertura accattivante o un’immagine specifica acquisita dal video. L’immagine miniatura video personalizzata caricata deve avere una risoluzione massima di 1280 × 720 pixel (larghezza minima di 640 pixel) e non superare i 2 MB.

Vedi anche Informazioni sulle miniature video in Dynamic Media - Modalità Scene7.

Aggiungi una miniatura video adding-a-video-thumbnail

Questi passaggi si applicano solo a Dynamic Media in esecuzione in modalità ibrida.

Per aggiungere una miniatura video:

Configura l'intervallo di tempo predefinito per la generazione delle miniature video configuring-the-default-time-interval-that-video-thumbnails-are-generated

Quando configuri e salvi il nuovo intervallo di tempo predefinito, la modifica viene applicata automaticamente solo ai video caricati in futuro. Il nuovo predefinito non viene applicato automaticamente ai video caricati in precedenza. Per i video esistenti, è necessario rigenerare le miniature.

Vedi Aggiungere una miniatura video.

Per configurare l'intervallo di tempo predefinito per la generazione delle miniature video:

Aggiungi una miniatura video personalizzata adding-a-custom-video-thumbnail-1

Questi passaggi si applicano solo a Dynamic Media in esecuzione in modalità ibrida.

Per aggiungere una miniatura video personalizzata:

Modificare l’URL di Dynamic Media per le risorse Dynamic Media manifest-urls

I video elaborati in Dynamic Media possono essere utilizzati con visualizzatori predefiniti. Oppure, accedendo agli URL del manifesto e riproducendoli in visualizzatori personalizzati. Di seguito è riportata l’API per recuperare gli URL del manifesto di un video.

Informazioni sull’API getVideoManifestURI

L'API getVideoManifestURIè esposta tramite cq-scene7-api:com.day.cq.dam.scene7.api e può essere utilizzata per generare i seguenti URL manifesto:

/**
* Returns the manifest url for videos
* @param resource video resource
* @param manifestType type of video streaming manifest being requested
* @param onlyIfPublished return a manifest only if the video is published
* @return the manifest url for videos
*
* @throws Exception
*/
@Nullable
String getVideoManifestURI(Resource resource, ManifestType manifestType, boolean onlyIfPublished) throws Exception;

Parametri API getVideoManifestURI

Questa API accetta i tre parametri seguenti:

Per recuperare gli URL del manifesto per i video utilizzando il metodo descritto sopra, aggiungere un profilo di codifica video a una cartella "carica video". Dynamic Media elabora questi video in base alle codifiche trovate nel file di codifica video assegnato alla cartella. Ora puoi richiamare la precedente API per recuperare gli URL del manifesto per i video caricati.

Scenari di errore

L’API restituisce null in caso di errori. Le eccezioni vengono registrate nei registri di errore di Experience Manager. Tutti gli errori registrati iniziano con Could not generate Video Manifest URI. Gli errori possono verificarsi nei seguenti scenari:

Di seguito è riportato un esempio dell'API precedente che utilizza i servlet scritti nella specifica HTTPWhiteBoard. Seleziona ogni scheda per la sintassi del codice.

dependency>
     <groupId>com.day.cq.dam</groupId>
     <artifactId>cq-scene7-api</artifactId>
     <version>5.12.64</version>
     <scope>provided</scope>
</dependency>

@Component
        service = Servlet.class
)
@HttpWhiteboardServletPattern(value = ManifestServlet.SERVLET_PATTERN)
@HttpWhiteboardContextSelect(value = Constants.SERVLET_CONTEXT_SELECTOR)
public class ManifestServlet extends HttpServlet {

   private static final Logger LOGGER = LoggerFactory.getLogger(ManifestServlet.class);

   private final ObjectMapper objectMapper;

    @Reference
    private Scene7Service scene7Service;

   public static final String SERVLET_PATTERN = Constants.VIDEO_API_PREFIX + "/manifestUrl";

   public ManifestServlet() {
         this.objectMapper = new ObjectMapper();
         objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
   }

   @Override

   protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        final ResourceResolver resolver = getResourceResolver(request);
        String assetPath = request.getParameter("assetPath");
        String manifest = request.getParameter("manifestType");
        String onlyIfPublished = request.getParameter("onlyIfPublished");
        Resource resource = resolver.getResource(assetPath);
        response.setCharacterEncoding(StandardCharsets.UTF_8.toString());
        response.setContentType("application/json");
        if(resource == null) {
            LOGGER.info("could not retrieve the resource from JCR");
            error("could not retrieve the resource from JCR", response);
            return;
        }

        String manifestUri = null;

        try{
            ManifestType manifestType =  ManifestType.DASH;
            if(manifest != null) {
                manifestType = ManifestType.valueOf(manifest);
            }
            manifestUri = scene7Service.getVideoManifestURI(resource, manifestType, onlyIfPublished != null);
            objectMapper.writeValue(response.getWriter(), new ManifestUrl(manifestUri));
            response.setContentType("application/json");
        } catch (Exception e) {
            LOGGER.error(e.getMessage(), e);
            error(String.format("Unable to get the manifest url for %s. %s", assetPath, e.getMessage()), response);
        }
    }

    private ResourceResolver getResourceResolver(HttpServletRequest request) {
        Object rr = request.getAttribute(AuthenticationSupport.REQUEST_ATTRIBUTE_RESOLVER);
        if (!(rr instanceof ResourceResolver)) {
            throw new IllegalStateException(
                    "The request does not seem to have been created via Apache Sling's authentication mechanism.");
        } else {
            return (ResourceResolver) rr;
        }
    }

    private void error(String errorMessage, HttpServletResponse response) throws IOException {
        ManifestUrl errorManifest = new ManifestUrl(null);
        errorManifest.setErrorMessage(errorMessage);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        objectMapper.writeValue(response.getWriter(), errorManifest);
    }
}

public class ManifestUrl extends VideoResponse {
     String manifestUrl;
     public ManifestUrl(String manifestUrl) {
         this.manifestUrl = manifestUrl;
     }
     public String getManifestUrl() {
         return manifestUrl;
     }
}

public abstract class VideoResponse {
     String errorString;

     public String getErrorString() {
         return errorString;
     }

     public void setErrorMessage(String errorString) {
         this.errorString = errorString;
     }
}

public final class Constants {

     private Constants() {
     }

     public static final String VIDEO_API_PREFIX = "/dynamicmedia/video";
     public static final String SERVLET_CONTEXT_SELECTOR = "(" + HttpWhiteboardConstants.HTTP_WHITEBOARD_CONTEXT_NAME + "=" +
             DMSampleApiHttpContext.CONTEXT_NAME + ")";

 }

public class DMSampleApiHttpContext extends ServletContextHelper {

 public static final String CONTEXT_NAME = "com.adobe.dmSample";
 public static final String CONTEXT_PATH = "/dmSample";

 private final MimeTypeService mimeTypeService;

 private final AuthenticationSupport authenticationSupport;

 /**
  * Constructs a new context that will use the given dependencies.
  *
  * @param mimeTypeService Used when providing mime type of requests.
  * @param authenticationSupport Used to authenticate requests with sling.
  */
 @Activate
 public DMSampleApiHttpContext(@Reference final MimeTypeService mimeTypeService,
                               @Reference final AuthenticationSupport authenticationSupport) {
     this.mimeTypeService = mimeTypeService;
     this.authenticationSupport = authenticationSupport;
 }

 // ---------- HttpContext interface ----------------------------------------
 /**
  * Returns the MIME type as resolved by the <code>MimeTypeService</code> or
  * <code>null</code> if the service is not available.
  */
 @Override
 public String getMimeType(String name) {
     MimeTypeService mtservice = mimeTypeService;
     if (mtservice != null) {
         return mtservice.getMimeType(name);
     }
     return null;
 }

 /**
  * Returns the real context path that is used to mount this context.
  * @param req servlet request
  * @return the context path
  */
 public static String getRealContextPath(HttpServletRequest req) {
     final String path = req.getContextPath();
     if (path.equals(CONTEXT_PATH)) {
         return "";
     }
     return path.substring(CONTEXT_PATH.length());
 }

 /**
  * Returns a request wrapper that transforms the context path back to the original one
  * @param req request
  * @return the request wrapper
  */
 public static HttpServletRequest createContextPathAdapterRequest(HttpServletRequest req) {
     return new HttpServletRequestWrapper(req) {

         @Override
         public String getContextPath() {
             return getRealContextPath((HttpServletRequest) getRequest());
         }

     };

 }

 /**
  * Always returns <code>null</code> because resources are all provided
  * through individual endpoint implementations.
  */
 @Override
 public URL getResource(String name) {
     return null;
 }

 /**
  * Tries to authenticate the request using the
  * <code>SlingAuthenticator</code>. If the authenticator or the Repository
  * is missing this method returns <code>false</code> and sends a 503/SERVICE
  * UNAVAILABLE status back to the client.
  */
 @Override
 public boolean handleSecurity(HttpServletRequest request,
                               HttpServletResponse response) throws IOException {

     final AuthenticationSupport authenticator = this.authenticationSupport;
     if (authenticator != null) {
         return authenticator.handleSecurity(createContextPathAdapterRequest(request), response);
     }

     // send 503/SERVICE UNAVAILABLE, flush to ensure delivery
     response.sendError(HttpServletResponse.SC_SERVICE_UNAVAILABLE,
             "AuthenticationSupport service missing. Cannot authenticate request.");
     response.flushBuffer();

     // terminate this request now
     return false;
 }
}

Utilizza il servlet di esempio

Il servlet viene richiamato eseguendo un'operazione GET in /dmSample/dynamicmedia/video/manifestUrl. Vengono passati i seguenti parametri di query:

In questo esempio, si supponga di effettuare le seguenti operazioni di impostazione:

Puoi richiamare il servlet nei seguenti modi: