控制隱藏字幕樣式

您可以使用ClosedCaptionStyles類別，提供隱藏字幕軌道的樣式資訊。 如此可設定播放器所顯示之隱藏字幕的樣式。

此類別封裝隱藏字幕樣式資訊，例如字型類型、大小、色彩和背景不透明度。 關聯的幫助類ClosedCaptionStylesBuilder便於使用隱藏字幕樣式設定。

設定隱藏字幕樣式

您可以使用TVSDK方法來設定隱藏字幕文字的樣式。

  1. 等待MediaPlayer至少擁有PREPARED狀態（請參閱等待有效狀態）。

  2. 若要變更樣式設定，請執行下列其中一項作業：

    • 使用ClosedCaptionStylesBuilder幫助類（在後台運行ClosedCaptionStyles）。
    • 直接使用ClosedCaptionStyles類。
注意

設定隱藏字幕樣式是非同步操作，因此變更可能需要數秒鐘才會顯示在畫面上。

隱藏字幕樣式選項

您可以使用ClosedCaptionStyles類別，提供隱藏字幕音軌的樣式資訊。 如此可設定播放器所顯示之隱藏字幕的樣式。

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)
秘訣

在定義預設值的選項（例如DEFAULT）中，該值是指最初指定標題時的設定。

格式 說明
字型

字型類型。

只能設定為由 ClosedCaptionStyles.FONT 陣列定義的值，並表示例如帶有或不帶有序列的單間隔。 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  ];

提示： 裝置上的實際可用字型可能會有所不同，並會視需要使用替代。 單空間與serifs通常用作替代，儘管這種替代可以是系統特定的。

大小

字幕大小。

只能設定為由 ClosedCaptionStyles.FONT_SIZE 陣列定義的值：

  • 中 -標準尺寸
  • LARGE -大約30%（中）
  • 小 型——大約比中型小30%
  • DEFAULT -標題的預設大小；與介質相同

提示： 您可以變更 DefaultMediaPlayer.ccStyles setter 函式的size參數，以變更WebVTT標題的字型大小。

字型邊緣

用於字型邊緣的效果，例如凸起或無。

只能設定為由 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  ];

字型顏色

字型顏色。

只能設定為由 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   ];

邊緣顏色

邊緣效果的顏色。

可以設定為任何可用於字型顏色的值。

背景顏色

背景字元儲存格顏色。

只能設定為字型顏色可用的值。

填色顏色

文本所在窗口的背景顏色。

可以設定為任何可用於字型顏色的值。

重要： 這不適用於WebVTT標題，因為WebVTT不使用此功能。

字型不透明度

文字的不透明度。

以0（完全透明）到100（完全不透明）的百分比表示。 字型的DEFAULT_ OPACITY為100。

背景不透明度

背景字元儲存格的不透明度。

以0（完全透明）到100（完全不透明）的百分比表示。 背景的DEFAULT_ OPACITY為100。

填滿不透明度

標題視窗背景的不透明度。

以0（完全透明）到100（完全不透明）的百分比表示。 填色的DEFAULT_ OPACITY為0。

範例：標題格式

您可以指定隱藏字幕格式。

範例1:明確指定格式值

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

範例2:在參數中指定格式值

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

本頁內容