ClosedCaption.SAMIFileName

  • [アーティクル]

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

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

player.closedCaption.SAMIFileName

指定できる値

このプロパティは、読み取り/書き込み 文字列です。

解説

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

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

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

特定のメディア項目に関連付けられた SAMI ファイルを使用して Windows メディア プレーヤーに戻すには、次のメディア項目を再生する前に、空の文字列 ("") と等しい SAMIFileName の値を指定します。

Windows メディア プレーヤー 10 Mobile: このプロパティは読み取り専用であり、常に空の文字列を返します。

例

次の 3 つの JScript の例では、ClosedCaption を使用します。閉じたキャプションテキスト ファイルの名前を指定する SAMIFileName。 Player オブジェクトは ID = "Player" で作成されました。

// Display the closed captions from a website.
Player.closedCaption.SAMIFileName="https://www.proseware.com/ccsample.smi";

// Display the closed captions from a local network.
// You must add an escape sequence of a backslash for every original backslash.
Player.closedCaption.SAMIFileName="\\\\yourservername\\Public\\ccsample.smi";

// Display the closed captions from a file on a local drive.
// Be sure to add the appropriate escape sequences.
Player.closedCaption.SAMIFileName="C:\\WMSDK\\WMPSDK9\\samples\\media\\ccsample.smi";

要件

要件 値
Version
 バージョン 7.0 以降Windows メディア プレーヤー。
[DLL]
Wmp.dll

関連項目

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

ClosedCaption オブジェクト

Player.close