È possibile fornire informazioni sullo stile per i brani con sottotitoli codificati utilizzando la classe ClosedCaptionStyles. Imposta lo stile per i sottotitoli che vengono visualizzati dal lettore.
Questa classe racchiude informazioni sullo stile dei sottotitoli codificati, ad esempio il tipo di carattere, la dimensione, il colore e l'opacità dello sfondo. Una classe helper associata, ClosedCaptionStylesBuilder
, facilita l'utilizzo delle impostazioni di stile sottotitoli.
È possibile applicare uno stile al testo con sottotitoli codificati con i metodi TVSDK.
Attendere che MediaPlayer abbia almeno lo stato READY (vedere Attesa di uno stato valido).
Per modificare le impostazioni di stile, effettuate una delle seguenti operazioni:
ClosedCaptionStylesBuilder
classe helper (funziona su ClosedCaptionStyles
dietro le quinte).ClosedCaptionStyles
direttamente in classe.L'impostazione dello stile dei sottotitoli è un'operazione asincrona e potrebbe richiedere alcuni secondi prima che le modifiche vengano visualizzate sullo schermo.
È possibile fornire informazioni sullo stile delle tracce di sottotitoli codificati utilizzando ClosedCaptionStyles
classe. Imposta lo stile per i sottotitoli che vengono 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 utilizzata quando la didascalia è stata originariamente specificata.
Formato | Descrizione |
---|---|
Font | Tipo di carattere. Può essere impostato solo su un valore definito da ClosedCaptionStyles.FONT e rappresenta, ad esempio, a spaziatura fissa con o senza serif.
Suggerimento: i tipi di carattere effettivi disponibili su un dispositivo possono variare e, se necessario, vengono utilizzate sostituzioni. Il monospazio con serifs è tipicamente usato come sostituto, anche se questa sostituzione può essere specifica per il sistema. |
Dimensione | Dimensione della didascalia. Può essere impostato solo su un valore definito da ClosedCaptionStyles.FONT_SIZE array:
Suggerimento: è possibile modificare la dimensione del carattere dei sottotitoli WebVTT modificando il parametro di dimensione per Impostazione DefaultMediaPlayer.ccStyles funzione. |
Bordo font | Effetto utilizzato per il bordo del font, ad esempio in rilievo o nessuno. Può essere impostato solo su un valore definito da ClosedCaptionStyles.FONT_EDGE array.
|
Colore font | Colore del carattere. Può essere impostato solo su un valore definito da ClosedCaptionStyles.COLOR array.
|
Colore bordo | Colore dell'effetto bordo. Può essere impostato su uno qualsiasi dei valori disponibili per il colore del carattere. |
Colore di sfondo | Colore della cella del carattere di sfondo. Può essere impostato solo sui valori disponibili per il colore del carattere. |
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 carattere. Importante: questo non si applica ai sottotitoli WebVTT, perché WebVTT non utilizza questa funzione. |
Opacità font | Opacità del testo. Espresso in percentuale da 0 (completamente trasparente) a 100 (completamente opaco). DEFAULT_OPACITY il carattere è 100. |
Opacità 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à 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;
...