Usare il componente FLVPlaybackCaptioning

Il componente FLVPlaybackCaptioning viene usato con uno o più componenti FLVPlayback. Nel caso più semplice, si trascina un componente FLVPlayback nello stage, quindi un componente FLVPlaybackCaptioning nello stesso stage, si identifica l'URL della didascalia e infine si imposta la visualizzazione delle didascalie. Inoltre, per personalizzare le didascalie del componente FLVPlayback, potete impostare diversi parametri.

Aggiungere didascalie al componente FLVPlayback

Potete aggiungere il componente FLVPlaybackCaptioning a qualsiasi componente FLVPlayback. Per informazioni sull'aggiunta dei componenti FLVPlayback all'applicazione, vedete Creare un'applicazione con il componente FLVPlayback .

Aggiungere il componente FLVPlaybackCaptioning dal pannello Componenti:

  1. Nel pannello Componenti, aprite la cartella Video.

  2. Trascinate il componente FLVPlaybackCaptioning (o fate doppio clic su di esso) e aggiungetelo nello stesso stage del componente FLVPlayback a cui desiderate aggiungere le didascalie.

    Nota: Adobe offre due file di esempio per apprendere più velocemente l'uso del componente FLVPlaybackCaptioning: caption_video.flv (un esempio di FLVPlayback) e caption_video.xml (un esempio di captioning). I file sono reperibili agli indirizzi www.helpexamples.com/flash/video/caption_video.flv e www.helpexamples.com/flash/video/caption_video.xml .
  3. (Opzionale) Trascinate il componente CaptionButton nello stesso stage dei componenti FLVPlayback e FLVPlaybackCaptioning. Il componente CaptionButton consente all'utente di attivare e disattivare l'inserimento di didascalie.

    Nota: per attivare il componente CaptionButton, dovete trascinarlo nello stesso stage dei componenti FLVPlayback e FLVPlaybackCaptioning.
  4. Dopo aver selezionato il componente FLVPlaybackCaptioning sullo stage, specificate le seguenti informazioni obbligatorie nella scheda Parametri della finestra di ispezione Proprietà:

    • Impostate showCaptions su true .

    • Specificate il parametro source del file XML Timed Text da scaricare.

      Mentre provate le didascalie in Flash, impostate la proprietà showCaptions su true . Tuttavia, se includete il componente CaptionButton per consentire agli utenti di attivare e disattivare le didascalie, impostate la proprietà showCaptions su false .

    Sono disponibili altri parametri che consentono di personalizzare il componente FLVPlaybackCaptioning. Per ulteriori informazioni, vedete Personalizzare il componente FLVPlaybackCaptioning e la Guida di riferimento di ActionScript 3.0 per Flash Professional .

  5. Selezionate Controllo > Prova filmato per avviare il video.

Creare un'istanza in modo dinamico mediante ActionScript:

  1. Trascinate il componente FLVPlayback dal pannello Componenti alla libreria (Finestra > Libreria).

  2. Trascinate il componente FLVPlaybackCaptioning dal pannello Componenti al pannello Libreria.

  3. Aggiungere il codice seguente nel pannello Azioni al fotogramma 1 nella linea temporale.

    import fl.video.*; 
    var my_FLVPlybk = new FLVPlayback(); 
    my_FLVPlybk.x = 100; 
    my_FLVPlybk.y = 100; 
    addChild(my_FLVPlybk); 
    my_FLVPlybk.skin = "install_drive:/Program Files/Adobe/Adobe Flash CS5/en/Configuration/FLVPlayback Skins/ActionScript 3.0/SkinUnderPlaySeekCaption.swf"; 
    my_FLVPlybk.source = "http://www.helpexamples.com/flash/video/caption_video.flv"; 
    var my_FLVPlybkcap = new FLVPlaybackCaptioning(); 
    addChild (my_FLVPlybkcap); 
    my_FLVPlybkcap.source = "http://www.helpexamples.com/flash/video/caption_video.xml"; 
    my_FLVPlybkcap.showCaptions = true; 
    
  4. Sostituite install_drive con l'unità in cui avete installato Flash e modificate il percorso in modo che rifletta la posizione della cartella Skins nell'installazione locale:

    Nota: se create un'istanza FLVPlayback con ActionScript, dovete assegnarle uno skin mediante l'impostazione in modo dinamico della proprietà skin con ActionScript. Uno skin applicato con ActionScript non viene pubblicato automaticamente con il file SWF. Copiate il file SWF dello skin e il file SWF dell'applicazione sul server, altrimenti il file SWF dello skin non sarà disponibile quando viene eseguito dall'utente.

Impostare i parametri del componente FLVPlaybackCaptioning

Per ogni istanza del componente FLVPlaybackCaptioning potete impostare i seguenti parametri nella finestra di ispezione Proprietà o nella finestra di ispezione dei componenti per personalizzare ulteriormente il componente. Nell'elenco seguente sono identificate le proprietà e viene fornita una breve spiegazione:

autoLayout
Determina se il componente FLVPlaybackCaptioning controlla le dimensioni dell'area delle didascalie. Il valore predefinito è true .

captionTargetName
Identifica il nome dell'istanza TextField o di MovieClip che contiene le didascalie. Il valore predefinito è auto.

flvPlaybackName
Identifica il nome dell'istanza FLVPlayback a cui desiderate aggiungere delle didascalie. Il valore predefinito è auto.

simpleFormatting
Quando è impostata su true, limita le istruzioni di formattazione del file XML Timed Text. Il valore predefinito è false .

showCaptions
Determina la visualizzazione delle didascalie. Il valore predefinito è true .

source
Identifica il percorso del file XML Timed Text.

Per ulteriori informazioni su tutti i parametri di FLVPlaybackCaptioning, vedete la Guida di riferimento di ActionScript 3.0 per Flash Professional .

Specificare il parametro source di

Il parametro source consente di specificare il nome e il percorso del file XML Timed Text che contiene le didascalie per il filmato. Inserite il percorso URL direttamente nella cella source nella finestra di ispezione dei componenti.

Visualizzare le didascalie

Per visualizzare le didascalie, impostate il parametro showCaptions su true .

Per ulteriori informazioni su tutti i parametri del componente FLVPlaybackCaptioning, vedete la Guida di riferimento di ActionScript 3.0 per Flash Professional .

Negli esempi precedenti avete appreso come creare e attivare il componente FLVPlaybackCaptioning per visualizzare le didascalie. Potete utilizzare due origini per le didascalie: (1) un file XML Timed Text contenente le didascalie oppure (2) un XML con il testo delle didascalie da associare con i cue point di eventi incorporati.