Controllare lo stile dei sottotitoli

È possibile fornire informazioni sullo stile per le tracce di didascalia chiusa utilizzando la classe TextFormat, che imposta lo stile per le didascalie chiuse visualizzate dal lettore.

Questa classe racchiude informazioni sullo stile dei sottotitoli codificati quali tipo di font, dimensioni, colore e opacità dello sfondo.

Impostare gli stili di sottotitoli

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

1. Attendi che il lettore multimediale sia almeno nello stato PREPARED.

2. Crea un'istanza TextFormatBuilder.

   Ora puoi fornire tutti i parametri di stile dei sottotitoli o impostarli in un secondo momento.

   TVSDK incapsula le informazioni sullo stile dei sottotitoli nell'interfaccia TextFormat. La classe TextFormatBuilder crea oggetti che implementano questa interfaccia.

   public TextFormatBuilder(
      TextFormat.Font font,
      TextFormat.Size size,
      TextFormat.FontEdge fontEdge,
      java.lang.String fontColor,
      java.lang.String backgroundColor,
      java.lang.String fillColor,
      java.lang.String edgeColor,
      int fontOpacity,
      int backgroundOpacity,
      int fillOpacity
      java.lang.String bottomInset,
      java.lang.String safeArea)
   

3. Per ottenere un riferimento a un oggetto che implementa l'interfaccia TextFormat, chiamare il metodo pubblico TextFormatBuilder.toTextFormat .

   NOTA

   Restituisce un oggetto TextFormat che può essere applicato al lettore multimediale.

   public TextFormat toTextFormat()
   

4. Facoltativamente, ottenere le impostazioni correnti dello stile dei sottotitoli codificati eseguendo una delle operazioni seguenti:

   • Ottieni tutte le impostazioni di stile con MediaPlayer.getCCStyle Il valore restituito è un'istanza dell'interfaccia TextFormat.

     /**
     * @return the current closed captioning style.
     * If no style was previously set, it returns a TextFormat object
     * with default values for each attribute.
     * @throws MediaPlayerException if media player was already released.
     */
     public TextFormat getCCStyle() throws MediaPlayerException;
     

   • Ottieni le impostazioni una alla volta tramite i metodi getter dell'interfaccia TextFormat .

     public java.lang.String getFontColor();
     public java.lang.String getBackgroundColor();
     public java.lang.String getFillColor(); // retrieve the font fill color
     public java.lang.String getEdgeColor(); // retrieve the font edge color
     public TextFormat.Size getSize(); // retrieve the font size
     public TextFormat.FontEdge getFontEdge(); // retrieve the font edge type
     public TextFormat.Font getFont(); // retrieve the font type
     public int getFontOpacity();
     public int getBackgroundOpacity();
     public java.lang.String getBottomInset(java.lang.String bi);
     public java.lang.String getSafeArea(java.lang.String sa);
     

5. Per modificare le impostazioni dello stile, effettuare una delle seguenti operazioni:

   • Utilizzare il metodo setter MediaPlayer.setCCStyle, passando un'istanza dell'interfaccia TextFormat:

     /**
     * Sets the closed captioning style. Used to control the closed captioning font,
     * size, color, edge and opacity.
     *
     * This method is safe to use even if the current media stream doesn't have closed
     * captions.
     *
     * @param textFormat
     * @throws MediaPlayerException
     */
     public void setCCStyle(TextFormat textFormat) throws MediaPlayerException;
     

   • Utilizzare la classe TextFormatBuilder, che definisce i singoli metodi di setter.

     L'interfaccia TextFormat definisce un oggetto immutabile in modo che esistano solo metodi getter e senza setter. È possibile impostare i parametri di stile dei sottotitoli solo con la classe TextFormatBuilder :

     // set font type
     public void setFont(Font font)
     public void setBackgroundColor(String backgroundColor)
     public void setFillColor(String fillColor)
     // set the font-edge color
     public void setEdgeColor(String edgeColor)
     // set the font size
     public void setSize(Size size)
     // set the font edge type
     public void setFontEdge(FontEdge fontEdge)
     public void setFontOpacity(int fontOpacity)
     public void setBackgroundOpacity(int backgroundOpacity)
     // set the font-fill opacity level
     public void setFillOpacity(int fillOpacity)
     public void setFontColor(String fontColor)
     public void setBottomInset(String bi)
     public void setSafeArea(String sa)
     public void setTreatSpaceAsAlphaNum(bool)
     

     IMPORTANTE

     Impostazioni colore: in Android TVSDK 2.X, è stato migliorato lo stile del colore dei sottotitoli codificati. Il miglioramento consente di impostare i colori dei sottotitoli utilizzando una stringa esadecimale che rappresenta i valori di colore RGB. La rappresentazione del colore esadecimale RGB è la nota stringa a 6 byte utilizzata in applicazioni come Photoshop:

     • FFFF = nero
     • 000000 = Bianco
     • FF0000 = rosso
     • 00FF00 = Verde
     • 0000FF = Blu

     e così via.

     Nell'applicazione, ogni volta che trasmetti informazioni sullo stile del colore a TextFormatBuilder, utilizzi comunque l'enumerazione Color come prima, ma ora devi aggiungere getValue() al colore per ottenere il valore come stringa. Ad esempio:

     tfb = tfb.setBackgroundColor(TextFormat.Color.RED <b>.getValue()</b>);
      

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 specificare diverse opzioni di stile per le didascalie e queste opzioni sostituiscono le opzioni di stile nelle didascalie originali.

public TextFormatBuilder(
   Font font,
   Size size,
   FontEdge fontEdge,
   String fontColor,
   String backgroundColor,
   String fillColor,
   String edgeColor,
   int fontOpacity,
   int backgroundOpacity,
   int fillOpacity,
   String bottomInset
   String safeArea)

Esempi di formattazione delle didascalie

Di seguito sono riportati alcuni esempi che mostrano come specificare la formattazione dei sottotitoli codificati.

Esempio 1: Specificare esplicitamente i valori di formato

private final MediaPlayer.PlaybackEventListener _playbackEventListener =
  new MediaPlayer.PlaybackEventListener() {
    @Override
    public void onPrepared() {
        // Set CC style.
        TextFormat tf = new TextFormatBuilder(
            TextFormat.Font.DEFAULT,
            TextFormat.Size.DEFAULT,
            TextFormat.FontEdge.DEFAULT,
            TextFormat.Color.DEFAULT.getValue(),
            TextFormat.Color.DEFAULT.getValue(),
            TextFormat.Color.DEFAULT.getValue(),
            TextFormat.Color.DEFAULT.getValue(),
            TextFormat.DEFAULT_OPACITY,
            TextFormat.DEFAULT_OPACITY,
            TextFormat.DEFAULT_OPACITY).toTextFormat();

        mediaPlayer.setCCStyle(tf);
        ...
    }
}

Esempio 2: Specificare i valori di formato nei parametri

/**
* Constructor using parameters to initialize a TextFormat.
*
* @param font
* The desired font.
* @param size
* 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
<b>TextFormatBuilder</b>(
    Font font, Size size, FontEdge fontEdge,
    String fontColor, String backgroundColor,
    String fillColor, String edgeColor,
    int fontOpacity, int backgroundOpacity,
    int fillOpacity);
/**
* Creates a TextFormat with the parameters supplied to this builder.
*/
public TextFormat
<b>toTextFormat</b>();
/**
* Sets the text font.
* @param font The desired font
* @return This builder object to allow chaining calls
*/
public
<b>TextFormatBuilder</b> setFont(Font font);
...

Risorse Business.Adobe.com