IWMPClosedCaption::SAMIFileName プロパティ

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

SAMIFileName プロパティは、クローズド キャプションに必要な情報を含むファイルの名前を取得または設定します。

構文

public System.String SAMIFileName {get; set;}

Public Property SAMIFileName As System.String

プロパティ値

同期されたアクセス可能なメディアインターチェンジ (SAMI) ファイルの名前である System.String 。

解説

SAMI ファイルでは、.smi または .sami ファイル名拡張子を使用する必要があります。

SAMIFileName を使用して値を設定しない場合、このプロパティは、現在のメディア アイテムに関連付けられている既定のファイル名または URL を含む文字列を取得します。 この関連付けは、sami URL パラメーター を使用して SAMI ファイルが指定されている場合、または SAMI ファイルの名前がデジタル メディア ファイルと同じ場合に自動的に発生する可能性があります (ファイル名拡張子を除く)。 現在のメディアに関連付けられている既定の SAMI ファイルがない場合、このプロパティは長さ 0 の文字列 ("") を取得します。

SAMIFileName を使用して値を設定すると、その値は新しい値を設定するまで (または sami URL パラメーターを使用して新しいメディア項目が開かれるまで) 保持されます。 そのため、新しいメディア項目を再生する前に、このプロパティの新しい値を設定する必要があります。 このようにすると、 SAMIFileName の新しい値は、次のメディア項目が開かれたときに (または AxWindowsMediaPlayer.close が呼び出されたときに) 有効になります。 SAMIFileName に新しい値を指定しても、現在のメディアには影響しません。

Windows メディア プレーヤーが特定のメディア項目に関連付けられている既定の SAMI ファイルを使用できるようにするには、次のメディア項目を再生する前に、SAMIFileName を長さ 0 の文字列 ("") に設定します。

要件

要件	値
Version	Windows メディア プレーヤー 9 シリーズ以降
名前空間	WMPLib
アセンブリ	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

関連項目

デジタル メディアへのクローズド キャプションの追加

AxWindowsMediaPlayer.close

IWMPClosedCaption インターフェイス (VB および C#)

IWMPClosedCaption2 インターフェイス (VB および C#)