システムの字幕設定を適用する

Android TV には、ユーザーが独自の字幕スタイルを定義できる設定が用意されています。 このガイドでは、システム提供のトークンをアプリが取得して適用する方法について説明します。 設定します。

字幕オプションは [設定] >システム >ユーザー補助 >キャプション:

ATV_Caption_Settings

CaptioningManager を取得する

アクティビティから、Context を使用して字幕サービスを取得できます。 CaptioningManager:

CaptioningManager captioningManager = (CaptioningManager)context.getSystemService(Context.CAPTIONING_SERVICE);

字幕スタイルの変更を処理する

次に、CaptioningChangeListener を実装して、字幕スタイルの変更を処理します。

if (captioningManager != null) {
 
// Define a class to store the CaptionStyle details.
 
CurrentCaptionStyle currentCaptionStyle = new CurrentCaptionStyle;
 
// Define the listeners.
  captioningManager
.addCaptioningChangeListener(new CaptioningChangeListener() {

   
@Override
   
public void onEnabledChanged(boolean enabled) {
     
super.onEnabledChanged(enabled);
     
Log.d(TAG, "onEnabledChanged");
      currentCaptionStyle
.isEnabled = enabled;
   
}

   
@Override
   
public void onLocaleChanged(@Nullable Locale locale) {
     
super.onLocaleChanged(locale);
     
Log.d(TAG, "onLocaleChanged");
      currentCaptionStyle
.locale = locale;
   
}

   
@Override
   
public void onFontScaleChanged(float fontScale) {
     
super.onFontScaleChanged(fontScale);
     
Log.d(TAG, "onFontScaleChanged");
      currentCaptionStyle
.fontScale = fontScale;
   
}

   
@Override
   
public void onUserStyleChanged(@NonNull CaptionStyle userStyle) {
     
super.onUserStyleChanged(userStyle);
     
Log.d(TAG, "onUserStyleChanged");
      currentCaptionStyle
.hasBackgroundColor = userStyle.hasBackgroundColor();
      currentCaptionStyle
.backgroundColor = userStyle.backgroundColor;
      currentCaptionStyle
.backgroundOpcity = userStyle.backgroundColor >>> 24;
      currentCaptionStyle
.hasForegroundColor = userStyle.hasForegroundColor();
      currentCaptionStyle
.foregroundColor = userStyle.foregroundColor;
      currentCaptionStyle
.foregroundOpacity = userStyle.foregroundColor >>> 24;
      currentCaptionStyle
.hasWindowColor = userStyle.hasWindowColor();
      currentCaptionStyle
.windowColor = userStyle.windowColor;
      currentCaptionStyle
.windowOpcity = userStyle.windowColor >>> 24;
      currentCaptionStyle
.hasEdgeColor = userStyle.hasEdgeColor();
      currentCaptionStyle
.edgeColor = userStyle.edgeColor;
      currentCaptionStyle
.hasEdgeType = userStyle.hasEdgeType();
      currentCaptionStyle
.edgeType = userStyle.edgeType;
      currentCaptionStyle
.typeFace = userStyle.getTypeface();
   
}

 
});

システムの CaptionStyle を取得するには、getUserStyle() を呼び出します。 直接:

CaptionStyle systemCaptionStyle = captioningManager.getUserStyle();