È possibile fornire informazioni sullo stile per le tracce a didascalia chiusa utilizzando la classe ClosedCaptionStyles. Questo imposta lo stile dei sottotitoli codificati visualizzati dal lettore.
Questa classe racchiude informazioni sullo stile dei sottotitoli, quali tipo di font, dimensioni, colore e opacità dello sfondo. Una classe helper associata, ClosedCaptionStylesBuilder
, facilita l'utilizzo delle impostazioni di stile dei sottotitoli.
È possibile personalizzare lo stile del testo a didascalia chiusa con i metodi TVSDK.
Attendi che MediaPlayer disponga almeno dello stato PREPARATO (vedi Attendi uno stato valido).
Per modificare le impostazioni di stile, effettuare una delle seguenti operazioni:
ClosedCaptionStylesBuilder
(che funziona su ClosedCaptionStyles
dietro le quinte).ClosedCaptionStyles
.L’impostazione dello stile dei sottotitoli è un’operazione asincrona, pertanto potrebbero essere necessari fino a pochi secondi affinché le modifiche vengano visualizzate sullo schermo.
È possibile fornire informazioni sullo stile per le tracce a didascalia chiusa utilizzando la classe ClosedCaptionStyles
. Questo imposta lo stile dei sottotitoli codificati visualizzati dal lettore.
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)
Nelle opzioni che definiscono i valori predefiniti (ad esempio, DEFAULT
), tale valore si riferisce all’impostazione quando la didascalia è stata originariamente specificata.
Formato | Descrizione |
---|---|
Font | Tipo di carattere. Può essere impostato solo su un valore definito dall'array ClosedCaptionStyles.FONT e rappresenta, ad esempio, la spaziatura con o senza serifs.
Suggerimento: I font effettivi disponibili su un dispositivo possono variare e vengono utilizzati sostituzioni quando necessario. Monospazio con i sieri viene generalmente utilizzato come sostituto, anche se questa sostituzione può essere specifica del sistema. |
Dimensione | Dimensione della didascalia. Può essere impostato solo su un valore definito dall'array ClosedCaptionStyles.FONT_SIZE :
Suggerimento: È possibile modificare la dimensione del font delle didascalie WebVTT modificando il parametro size per la funzione DefaultMediaPlayer.ccStyles setter . |
Bordo font | Effetto utilizzato per lo spigolo del font, ad esempio sollevato o nessuno. Può essere impostato solo su un valore definito dalla matrice ClosedCaptionStyles.FONT_EDGE .
|
Colore font | Il colore del font. Può essere impostato solo su un valore definito dall'array ClosedCaptionStyles.COLOR .
|
Colore bordo | Colore dell'effetto bordo. Può essere impostato su uno qualsiasi dei valori disponibili per il colore del font. |
Colore di sfondo | Colore della cella del carattere di sfondo. Può essere impostato solo sui valori disponibili per il colore del font. |
Colore riempimento | Colore dello sfondo della finestra in cui si trova il testo. Può essere impostato su uno qualsiasi dei valori disponibili per il colore del font. Importante: Questo non si applica alle didascalie WebVTT, perché WebVTT non utilizza questa funzione. |
opacità del carattere | opacità del testo. Espresso in percentuale da 0 (completamente trasparente) a 100 (completamente opaco). DEFAULT_OPACITY per il font è 100. |
Opacità di sfondo | opacità della cella del carattere di sfondo. Espresso in percentuale da 0 (completamente trasparente) a 100 (completamente opaco). DEFAULT_OPACITY per lo sfondo è 100. |
Opacità di riempimento | opacità dello sfondo della finestra della didascalia. Espresso in percentuale da 0 (completamente trasparente) a 100 (completamente opaco). DEFAULT_OPACITY per il riempimento è 0. |
È possibile specificare la formattazione dei sottotitoli.
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;
...