Controllare lo stile dei sottotitoli

È 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.

Impostare gli stili di sottotitoli

È possibile personalizzare lo stile del testo a didascalia chiusa con i metodi TVSDK.

  1. Attendi che MediaPlayer disponga almeno dello stato PREPARATO (vedi Attendi uno stato valido).

  2. Per modificare le impostazioni di stile, effettuare una delle seguenti operazioni:

    • Utilizza la classe di supporto ClosedCaptionStylesBuilder (che funziona su ClosedCaptionStyles dietro le quinte).
    • Utilizza direttamente la classe ClosedCaptionStyles .
NOTA

L’impostazione dello stile dei sottotitoli è un’operazione asincrona, pertanto potrebbero essere necessari fino a pochi secondi affinché le modifiche vengano visualizzate sullo schermo.

Opzioni per lo stile dei sottotitoli

È 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)
SUGGERIMENTO

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. 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  ];

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 :

  • MEDIA - Dimensione standard
  • GRANDE - Circa il 30% più grande del medio
  • PICCOLO - Circa il 30% inferiore rispetto al medio
  • PREDEFINITO - Dimensione predefinita della didascalia; uguale al mezzo

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 . public static const FONT_EDGE :Array = [     AVCaptionStyle.DEFAULT,     AVCaptionStyle.NONE,     AVCaptionStyle.RAISED,     AVCaptionStyle.DEPRESSED,     AVCaptionStyle.UNIFORM,     AVCaptionStyle.LEFT_DROP_SHADOW,     AVCaptionStyle.RIGHT_DROP_SHADOW  ];

Colore font

Il colore del font.

Può essere impostato solo su un valore definito dall'array 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   ];

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.

Esempi: Formattazione didascalia

È possibile specificare la formattazione dei sottotitoli.

Esempio 1: Specificare esplicitamente i valori di formato

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());
}

Esempio 2: Specificare i valori di formato nei parametri

/**
* 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;
...

In questa pagina