Control del estilo de los subtítulos

Puede proporcionar información de estilo para las pistas de subtítulos mediante la clase ClosedCaptionStyles. Esto establece el estilo de cualquier subtítulo cerrado que muestre el reproductor.

Esta clase encapsula información de estilo de subtítulos cerrados como el tipo de fuente, el tamaño, el color y la opacidad del fondo. Una clase de ayuda asociada, ClosedCaptionStylesBuilder, facilita el trabajo con la configuración de estilo de subtítulos.

Establecer estilos de subtítulos

Puede aplicar estilo al texto de los subtítulos con métodos TVSDK.

  1. Espere a que MediaPlayer tenga al menos el estado PREPARADO (consulte Espera a un estado válido).

  2. Para cambiar la configuración del estilo, realice una de las siguientes acciones:

    • Utilice la clase de ayuda ClosedCaptionStylesBuilder (funciona en ClosedCaptionStyles entre bastidores).
    • Utilice la clase ClosedCaptionStyles directamente.
NOTA

La configuración del estilo de subtítulos es una operación asincrónica, por lo que los cambios pueden tardar hasta unos segundos en aparecer en la pantalla.

Opciones de estilo de subtítulos

Puede proporcionar información de estilo para las pistas de subtítulos mediante la clase ClosedCaptionStyles. Esto establece el estilo de cualquier subtítulo cerrado que muestre el reproductor.

public function TextFormat(
   font:String = default,
   size:String = default,
   fontEdge:String = default,
   fontColor:String = default,
   backgroundColor:String = default,
   fillColor:String = default,
   edgeColor:String = default,
   fontOpacity:int,
   backgroundOpacity:int,
   fillOpacity:int)
SUGERENCIA

En las opciones que definen los valores predeterminados (por ejemplo, DEFAULT), ese valor hace referencia a la configuración cuando se especificó originalmente el rótulo.

Formato Descripción
Fuente

Tipo de fuente.

Solo se puede establecer en un valor que esté definido por la matriz ClosedCaptionStyles.FONT y que represente, por ejemplo, espaciado con o sin serifs. public static const FONT :Array = [  AVCaptionStyle.DEFAULT,  AVCaptionStyle.MONOSPACE_WITH_SERIFS,  AVCaptionStyle.MONOSPACED_WITHOUT_SERIFS,  AVCaptionStyle.PROPORTIONAL_WITH_SERIFS,  AVCaptionStyle.PROPORTIONAL_WITHOUT_SERIFS,  AVCaptionStyle.CASUAL,  AVCaptionStyle.CURSIVE,  AVCaptionStyle.SMALL_CAPITALS  ];

Sugerencia: Las fuentes disponibles en un dispositivo pueden variar y se utilizan sustituciones cuando es necesario. Monospace con serifs se suele utilizar como sustituto, aunque esta sustitución puede ser específica del sistema.

Tamaño

El tamaño del rótulo.

Solo se puede establecer en un valor definido por la matriz ClosedCaptionStyles.FONT_SIZE :

  • MEDIO - Tamaño estándar
  • GRANDE - Aproximadamente un 30% mayor que medio
  • PEQUEÑO - Aproximadamente un 30% menor que medio
  • PREDETERMINADO: el tamaño predeterminado del rótulo; igual que medium

Sugerencia: Puede cambiar el tamaño de fuente de los subtítulos WebVTT cambiando el parámetro de tamaño de la función predeterminadaMediaPlayer.ccStyles del establecedor.

Borde de fuente

El efecto utilizado para el borde de la fuente, como elevado o ninguno.

Solo se puede establecer en un valor definido por la matriz ClosedCaptionStyles.FONT_EDGE . public static const FONT_EDGE :Array = [     AVCaptionStyle.DEFAULT,     AVCaptionStyle.NONE,     AVCaptionStyle.RAISED,     AVCaptionStyle.DEPRESSED,     AVCaptionStyle.UNIFORM,     AVCaptionStyle.LEFT_DROP_SHADOW,     AVCaptionStyle.RIGHT_DROP_SHADOW  ];

Color de fuente

El color de la fuente.

Solo se puede establecer en un valor definido por la matriz ClosedCaptionStyles.COLOR . public static const COLOR :Array = [     AVCaptionStyle.DEFAULT,     AVCaptionStyle.BLACK,     AVCaptionStyle.GRAY,     AVCaptionStyle.WHITE,     AVCaptionStyle.BRIGHT_WHITE,     AVCaptionStyle.RED,     AVCaptionStyle.DARK_RED,     AVCaptionStyle.BRIGHT_RED,     AVCaptionStyle.GREEN,     AVCaptionStyle.DARK_GREEN,     AVCaptionStyle.BRIGHT_GREEN,     AVCaptionStyle.BLUE,     AVCaptionStyle.DARK_BLUE,     AVCaptionStyle.BRIGHT_BLUE,     AVCaptionStyle.YELLOW,     AVCaptionStyle.DARK_YELLOW,     AVCaptionStyle.BRIGHT_YELLOW,     AVCaptionStyle.MAGENTA,     AVCaptionStyle.DARK_MAGENTA,     AVCaptionStyle.BRIGHT_MAGENTA,     AVCaptionStyle.CYAN,     AVCaptionStyle.DARK_CYAN,     AVCaptionStyle.BRIGHT_CYAN   ];

Color de borde

Color del efecto de borde.

Se puede establecer en cualquiera de los valores disponibles para el color de fuente.

Color de fondo

El color de la celda del carácter de fondo.

Solo se puede establecer en valores disponibles para el color de fuente.

Color de relleno

Color del fondo de la ventana en la que se encuentra el texto.

Se puede establecer en cualquiera de los valores disponibles para el color de fuente.

Importante: Esto no se aplica a los subtítulos WebVTT, ya que WebVTT no utiliza esta función.

Opacidad de fuente

La opacidad del texto.

Se expresa como porcentaje de 0 (totalmente transparente) a 100 (totalmente opaco). DEFAULT_OPACITY para la fuente es 100.

Opacidad del fondo

La opacidad de la celda del carácter de fondo.

Se expresa como porcentaje de 0 (totalmente transparente) a 100 (totalmente opaco). DEFAULT_OPACITY para el fondo es 100.

Opacidad de relleno

La opacidad del fondo de la ventana del rótulo.

Se expresa como porcentaje de 0 (totalmente transparente) a 100 (totalmente opaco). DEFAULT_OPACITY para rellenar es 0.

Ejemplos: Formato de rótulo

Puede especificar el formato de subtítulos.

Ejemplo 1: Especificar valores de formato explícitamente

private function onStatusChanged(event:MediaPlayerStatusChangeEvent):void {
    var formatBuilder:TextFormatBuilder = new TextFormatBuilder();
    formatBuilder.font = Font.DEFAULT,
    formatBuilder.fontSize = FontSize.DEFAULT,
    formatBuilder.fontEdge = FontEdge.DEFAULT,
    formatBuilder.fontColor = Color.DEFAULT,
    formatBuilder.backgroundColor = Color.DEFAULT,
    formatBuilder.fillColor = Color.DEFAULT,
    formatBuilder.edgeColor = Color.DEFAULT,
    formatBuilder.fontOpacity = .DEFAULT_OPACITY,
    formatBuilder.backgroundOpacity = Font.DEFAULT_OPACITY,
    formatBuilder.fillOpacity = TextFormat.DEFAULT_OPACITY
    mediaPlayer.set CCStyle(formatBuilder.toTextFormat());
}

Ejemplo 2: Especificar valores de formato en los parámetros

/**
* Constructor using parameters to initialize a TextFormat.
*
* @param font
* The desired font.
* @param fontSize
* The desired text size.
* @param fontEdge
* The desired font edge.
* @param fontColor
* The desired font color.
* @param backgroundColor
* The desired background color.
* @param fillColor
* The desired fill color.
* @param edgeColor
* The desired color to draw the text edges.
* @param fontOpacity
* The desired font opacity.
* @param backgroundOpacity
* The desired background opacity.
* @param fillOpacity
* The desired fill opacity.
*/
public function TextFormatBuilder(font:Font, fontSize:FontSize, fontEdge:FontEdge,
                                  fontColor:Color, backgroundColor:Color,
                                  fillColor:Color, edgeColor:Color, fontOpacity:int,
                                  backgroundOpacity:int, fillOpacity:int);
/**
* Creates a TextFormat with the parameters supplied to this builder.
*/
public function toTextFormat():TextFormat;
...

En esta página