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.
Puede aplicar estilo al texto de los subtítulos con métodos TVSDK.
Espere a que MediaPlayer tenga al menos el estado PREPARADO (consulte Espera a un estado válido).
Para cambiar la configuración del estilo, realice una de las siguientes acciones:
ClosedCaptionStylesBuilder
(funciona en ClosedCaptionStyles
entre bastidores).ClosedCaptionStyles
directamente.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.
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)
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.
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 :
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 .
|
Color de fuente | El color de la fuente. Solo se puede establecer en un valor definido por la matriz ClosedCaptionStyles.COLOR .
|
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. |
Puede especificar el formato de subtítulos.
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());
}
/**
* 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;
...