MediaPlayer.RenderSubtitlesToSurface メソッド

  • リファレンス

定義

名前空間:
Windows.Media.Playback

オーバーロード

RenderSubtitlesToSurface(IDirect3DSurface)

指定された IDirect3DSurface に現在のサブタイトル テキストをレンダリングするようにシステムに要求します。
RenderSubtitlesToSurface(IDirect3DSurface, Rect)

指定された IDirect3DSurface 内の指定したターゲット四角形に現在のサブタイトル テキストをレンダリングするようにシステムに要求します。

RenderSubtitlesToSurface(IDirect3DSurface)

編集

指定された IDirect3DSurface に現在のサブタイトル テキストをレンダリングするようにシステムに要求します。

public:
 virtual bool RenderSubtitlesToSurface(IDirect3DSurface ^ destination) = RenderSubtitlesToSurface;
/// [Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurface")]
bool RenderSubtitlesToSurface(IDirect3DSurface const& destination);
[Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurface")]
public bool RenderSubtitlesToSurface(IDirect3DSurface destination);
function renderSubtitlesToSurface(destination)
Public Function RenderSubtitlesToSurface (destination As IDirect3DSurface) As Boolean

パラメーター

destination
IDirect3DSurface

サブタイトル テキストがレンダリングされる IDirect3DSurface を実装する オブジェクト。

戻り値

Boolean

bool

True を指定すると、システムはサブタイトルをサーフェスにレンダリングします。それ以外の場合は false。

属性
OverloadAttribute

Windows の要件

デバイス ファミリ
Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

SubtitleFrameChanged イベントを処理して、字幕コンテンツが変更されたことを示す通知を受け取ります。 戻り値を確認して、字幕がレンダリングされたかどうかを確認します。 メソッドが false を返す場合、サブタイトルはレンダリングされませんでした。 この場合は、UI でサブタイトル レンダリング画面を非表示にすることを決定できます。

この機能を使用するには、IsVideoFrameServerEnabled を true に設定して MediaPlayer をフレーム サーバー モードにする必要があります。また、再生中のメディア コンテンツには、プレゼンテーション モードが PlatformPresented に設定され、MediaPlaybackTimedMetadataTrackList.SetPresentationMode の呼び出しで少なくとも 1 つのタイミングメタデータ トラックが必要です。 フレーム サーバー モードでの MediaPlayer の使用の詳細については、「 MediaPlayer でオーディオとビデオを再生する」を参照してください。 メタデータ トラックの操作の詳細については、「 メディアアイテム、プレイリスト、トラック」を参照してください。

適用対象

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

編集

指定された IDirect3DSurface 内の指定したターゲット四角形に現在のサブタイトル テキストをレンダリングするようにシステムに要求します。

public:
 virtual bool RenderSubtitlesToSurface(IDirect3DSurface ^ destination, Rect targetRectangle) = RenderSubtitlesToSurface;
/// [Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurfaceWithTargetRectangle")]
bool RenderSubtitlesToSurface(IDirect3DSurface const& destination, Rect const& targetRectangle);
[Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurfaceWithTargetRectangle")]
public bool RenderSubtitlesToSurface(IDirect3DSurface destination, Rect targetRectangle);
function renderSubtitlesToSurface(destination, targetRectangle)
Public Function RenderSubtitlesToSurface (destination As IDirect3DSurface, targetRectangle As Rect) As Boolean

パラメーター

destination
IDirect3DSurface

サブタイトル テキストがレンダリングされる IDirect3DSurface を実装する オブジェクト。

targetRectangle
Rect

サブタイトルがレンダリングされる、指定されたサーフェス内の四角形。

戻り値

Boolean

bool

True を指定すると、システムはサブタイトルをサーフェスにレンダリングします。それ以外の場合は false。

属性
OverloadAttribute

Windows の要件

デバイス ファミリ
Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

このメソッドは RenderSubtitleToSurface の他のオーバーロードよりも効率が低くなりますが、字幕に別のサーフェスを必要とするのではなく、ビデオと字幕のレンダリングに同じサーフェスを使用できます。

SubtitleFrameChanged イベントを処理して、字幕コンテンツが変更されたことを示す通知を受け取ります。 戻り値を確認して、字幕がレンダリングされたかどうかを確認します。

この機能を使用するには、IsVideoFrameServerEnabled を true に設定して MediaPlayer をフレーム サーバー モードにする必要があります。また、再生中のメディア コンテンツには、プレゼンテーション モードが PlatformPresented に設定され、MediaPlaybackTimedMetadataTrackList.SetPresentationMode の呼び出しで少なくとも 1 つのタイミングメタデータ トラックが必要です。 フレーム サーバー モードでの MediaPlayer の使用の詳細については、「 MediaPlayer でオーディオとビデオを再生する」を参照してください。 メタデータ トラックの操作の詳細については、「 メディアアイテム、プレイリスト、トラック」を参照してください。

適用対象