Controlla lo stile dei sottotitoli

Ultimo aggiornamento: 2023-09-21

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

Imposta stili sottotitoli codificati

È possibile applicare uno stile al testo con sottotitoli codificati con i metodi TVSDK.

  1. Attendere che MediaPlayer abbia almeno lo stato READY (vedere Attesa di uno stato valido).

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

    • Utilizza il ClosedCaptionStylesBuilder classe helper (funziona su ClosedCaptionStyles dietro le quinte).
    • Utilizza il ClosedCaptionStyles direttamente in classe.
NOTA

L'impostazione dello stile dei sottotitoli è un'operazione asincrona e potrebbe richiedere alcuni secondi prima che le modifiche vengano visualizzate sullo schermo.

Opzioni di stile sottotitoli codificati

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

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

  • MEDIA - Formato standard
  • GRANDE - Circa il 30% più grande del medio
  • PICCOLO - Circa il 30% più piccolo del medio
  • PREDEFINITO : dimensione predefinita per la didascalia, uguale a media

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

Colore del carattere.

Può essere impostato solo su un valore definito da ClosedCaptionStyles.COLOR array. 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 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.

Esempi: Formattazione dei sottotitoli

È 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