Settings.rate

  • [アーティクル]

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

rate プロパティは、ビデオ メディアの現在の再生速度を指定または取得します。

構文

player.settings.rate

指定できる値

このプロパティは、既定値が 1.0 の読み取り/書き込み 数値 (double) です。

解説

このプロパティは、クリップを高速または低速の速度で再生できる乗数の値として機能します。 既定値の 1.0 は、作成された速度を示します。 オーディオ トラックは、0.5 より低いレートまたは 1.5 より高いレートでは理解しにくくなる点に注意してください。 2 の再生速度は、通常の再生速度の 2 倍に相当します。

Windows メディア プレーヤーは、4 つの異なる再生モードの中で最も効果的なモードの使用を試みます。 これらのモードは、オーディオ ピッチが維持されたスムーズなビデオ再生、オーディオ ピッチが維持されないスムーズなビデオ再生、オーディオなしのスムーズなビデオ再生、オーディオなしのキーフレーム ビデオ再生です。 プレーヤーによって選択されるモードは、ファイルの種類と場所、オペレーティング システム、ネットワーク、サーバーなど、さまざまな要因によって異なります。

メディアの種類に応じて、その他の考慮事項も適用されます。

  • Windows Media Format (WMV) ファイルと ASF ファイル: このプロパティの最適な値は 1 から 10、逆再生の場合は 1 から 10 です。 0.5 から 1.0、または -0.5 から -1.0 までの値は、オーディオ ピッチを維持できる場合 (たとえば、ローカル コンピューター上のファイルを再生する場合など) にも適しています。 絶対大きさが 10 を超える値は許可されますが、あまり意味がありません。
  • その他のビデオ メディアの種類: このプロパティの範囲は 0 から 9 です。 負の値は使用できません。 1 未満の値はスロー モーションを表します。 9 より上の値は許可されますが、あまり意味がありません。

コントロール。fastForward メソッドは rate の値を 5.0 に変更し、 Controls を使用します。fastReverse メソッドはレートを 5.0 に変更します。

一部のメディアタイプの再生速度は変更できません。 [設定] を使用します。isAvailable メソッドを使用して、特定のメディア アイテムに対してこのプロパティを指定できるかどうかを判断します。

Windows メディア プレーヤー 10 Mobile: このプロパティは、-5.0、1.0、または 5.0 の値のみを受け入れるか返します。

例

次の例では、ユーザーが現在のメディアの再生速度を変更できるようにする HTML SELECT 要素を作成します。 SELECTオプションは、通常の速度、半速、二重速度の再生速度を提供します。 Player オブジェクトは ID = "Player" で作成されました。

<!-- Create the HTML SELECT element. -->
<SELECT  ID = pbRATE  NAME = "pbRATE"  LANGUAGE="JScript"
         onChange="
                   /* Test whether playback rate can be set. */
                   if(Player.settings.IsAvailable('Rate'))

                   /* Set the playback rate based on the current
                      value of the SELECT element. */
                   Player.settings.rate = this.value
">

/* Create the OPTION list. */
<OPTION VALUE = 1>NORMAL</OPTION>
<OPTION VALUE = .5>half speed</OPTION>
<OPTION VALUE = 2>2 speed</OPTION>
</SELECT>

必要条件

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

関連項目

Controls.fastForward

Controls.fastReverse

Settings オブジェクト

Settings.isAvailable