Uso de puntos de referencia con ActionScript

Los puntos de referencia permiten interactuar con un vídeo; por ejemplo, es posible alterar la reproducción de un archivo FLV o mostrar texto en momentos concretos del vídeo. Si no se dispone de un archivo XML de texto temporizado para utilizarlo con un archivo FLV, es posible incorporar puntos de referencia de eventos en un archivo FLV y asociar dichos puntos de referencia al texto. En esta sección se ofrece información sobre las normas de puntos de referencia del componente FLVPlaybackCaptioning, así como una breve información general sobre cómo asociar estos puntos de referencia al texto en la subtitulación. Para más información sobre cómo incorporar puntos de referencia con el asistente de importación de vídeo o Flash Video Encoder, consulte el Capítulo 16, "Trabajo con vídeo", en Uso de Flash .

Aspectos básicos de las normas de puntos de referencia de FLVPlaybackCaptioning

En los metadatos del archivo FLV, un punto de referencia se representa como un objeto con las siguientes propiedades: name , time , type y parameters Los puntos de referencia de ActionScript para FLVPlaybackCaptioning tienen los siguientes atributos:

name
La propiedad name es una cadena que contiene el nombre asignado del punto de referencia. La propiedad name debe comenzar con el prefijo fl.video.caption.2.0. y contener una cadena a continuación. La cadena es una serie de enteros positivos que van incrementando para que cada nombre sea exclusivo. El prefijo contiene el número de versión, que coincide con el número de versión del componente FLVPlayback. En Adobe Flash CS4 y posterior, debe establecerse el número de versión 2.0 .

time
La propiedad time representa el tiempo en el que debe mostrarse el texto.

type
La propiedad type es una cadena cuyo valor es "event" .

parameters
La propiedad parameters es un conjunto que admite los siguientes pares nombre-valor:
text:String
El texto del subtítulo con formato HTML. Este texto se pasa directamente a la propiedad TextField.htmlText. El componente FLVPlaybackCaptioning admite una propiedad text: n opcional, que admite el uso de varias pistas de lenguaje. Para más información, consulte Uso de varias pistas de idioma con puntos de referencia incorporados .

endTime:Number
El tiempo en el que debe desaparecer el texto. Si no se especifica esta propiedad , el componente FLVPlaybackCaptioning presupone que no es un número (NaN) y se muestra un texto hasta que finaliza el archivo FLV (la instancia de FLVPlayback distribuye el evento VideoEvent.COMPLETE ) . Especifique la propiedad endTime:Number en segundos.

backgroundColor:uint
Este parámetro establece TextField.backgroundColor . Esta propiedad es opcional.

backgroundColorAlpha:Boolean
Si el valor de alfa de backgroundColor es 0%, el parámetro establece TextField.background = !backgroundColor . Esta propiedad es opcional.

wrapOption:Boolean
Este parámetro establece TextField.wordWrap. Esta propiedad es opcional.

Aspectos básicos de la subtitulación para puntos de referencia de eventos incorporados

Si no se dispone de un archivo XML de texto temporizado que contenga textos para el archivo FLV, es posible asociar el archivo XML que contiene la subtitulación con puntos de referencia de eventos incorporados con el fin de crear subtitulación. En la muestra de XML se presupone que se han realizado los siguientes pasos para crear puntos de referencia de eventos incorporados en el vídeo:

  • Añada los puntos de referencia de eventos (según las normas de FLVPlaybackCaptioning) y codifique el vídeo.

  • En Flash, arrastre un componente FLVPlayback y un componente FLVPlaybackCaptioning al escenario.

  • Defina las propiedades de origen de los componentes FLVPlayback y FLVPlaybackCaptioning (es decir, la ubicación del archivo FLV y la ubicación del archivo XML).

  • Realice la publicación.

    En el siguiente ejemplo se importa XML en Encoder: 

    <?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<FLVCoreCuePoints> 
 
    <CuePoint> 
        <Time>9136</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index1</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the first cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>19327</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index2</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the second cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>24247</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index3</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the third cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
    <CuePoint> 
        <Time>36546</Time> 
        <Type>event</Type> 
        <Name>fl.video.caption.2.0.index4</Name> 
        <Parameters> 
            <Parameter> 
                <Name>text</Name> 
                <Value><![CDATA[Captioning text for the fourth cue point]]></Value> 
            </Parameter> 
        </Parameters> 
    </CuePoint> 
 
</FLVCoreCuePoints>

    El componente FLVPlaybackCaptioning también admite el uso de varias pistas de idioma con puntos de referencia incorporados. Para más información, consulte Uso de varias pistas de idioma con puntos de referencia incorporados .

Uso de varias pistas de idioma con puntos de referencia incorporados

La propiedad track de FLVPlaybackCaptioning admite varias pistas de idioma con puntos de referencia incorporados, siempre y cuando el archivo XML de texto temporizado siga las normas de puntos de referencia de FLVPlaybackCaptioning. (Para más información, consulte Aspectos básicos de las normas de puntos de referencia de FLVPlaybackCaptioning ). Sin embargo, el componente FLVPlaybackCaptioning no admite varias pistas de idioma en distintos archivos XML. Para utilizar la propiedad track , establezca en ella un valor que no sea 0. Por ejemplo, si establece la propiedad track en 1 ( track == 1) , el componente FLVPlaybackCaptioning buscará los parámetros de puntos de referencia. Si no se encuentra ninguna coincidencia, se utiliza la propiedad text en los parámetros de puntos de referencia. Para obtener más información, consulte la propiedad track en la Referencia de ActionScript 3.0 para Flash Professional .