Share via


Proprietà IWMPSettings::rate

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La proprietà rate ottiene o imposta la frequenza di riproduzione corrente per il video.

Sintassi

public System.Double rate {get; set;}

Public Property rate As System.Double

Valore proprietà

System.Double che corrisponde alla frequenza di riproduzione, con un valore predefinito pari a 1,0.

Commenti

Il valore recuperato da questa proprietà funge da valore moltiplicatore che consente di riprodurre un elemento multimediale a una velocità più veloce o più lenta. Il valore predefinito 1.0 indica la velocità creata.

Si noti che una traccia audio diventa difficile da comprendere a tassi inferiori a 0,5 o superiori a 1,5. Una frequenza di riproduzione pari a 2 indica due volte la normale velocità di riproduzione.

Lettore multimediale Windows tenterà di usare la modalità di riproduzione più efficace delle seguenti quattro diverse modalità di riproduzione

  • Riproduzione video uniforme con passo audio mantenuto
  • Riproduzione video uniforme con il passo audio non gestito
  • Riproduzione video uniforme senza audio
  • Riproduzione video del fotogramma chiave senza audio

La modalità scelta da Lettore multimediale Windows dipende da numerosi fattori, tra cui il tipo di file e la posizione, il sistema operativo, la rete e il server.

Altre considerazioni si applicano anche, a seconda del formato multimediale digitale usato per creare il contenuto:

  • Windows Media Video (WMV) e ASF. I valori ottimali per la proprietà rate sono da 1 a 10 o da 1 a 10 per il gioco inverso. I valori da 0,5 a 1,0 o da -0,5 a -1.0 possono funzionare bene anche nei casi in cui l'audio pitch può essere mantenuto, ad esempio durante la riproduzione di file nel computer locale. I valori con una grandezza assoluta maggiore di 10 sono consentiti, ma non sono molto significativi.
  • Altri formati video. La proprietà rate può variare da 0 a 9. I valori negativi non sono consentiti. I valori inferiori a 1 rappresentano il movimento lento. I valori superiori a 9 sono consentiti, ma non sono molto significativi.

Il metodo IWMPControls.fastForward modifica il valore della frequenza su 5.0, mentre il metodo IWMPControls.fastReverse modifica il valore della frequenza su 5,0.

Impossibile modificare la frequenza di riproduzione di alcuni formati multimediali digitali. Usare la proprietà IWMPSettings.isAvailable (in C# il metodo IWMPSettings.get_isAvailable ) per individuare se questa proprietà può essere specificata per un determinato elemento multimediale.

Esempio

Nell'esempio seguente viene usato un controllo updown numerico che consente all'utente di modificare la velocità di riproduzione del supporto corrente. Quando l'utente fa clic sulle frecce su o giù del controllo, la proprietà rate viene impostata sul nuovo valore. L'intervallo possibile di valori nel controllo è pari a 0,5 (mezza velocità) a 2,0 (doppia velocità). L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void playbackRate_Click(object sender, System.EventArgs e)
{
    // Get the new value of the control, and cast it from decimal to double.
    double newRate = (double)((System.Windows.Forms.NumericUpDown)sender).Value;

    // Test whether playback rate can be set. 
    if( player.settings.get_isAvailable("Rate") )
    {
        // Set the playback rate to the new value.
        player.settings.rate = newRate;
    }
}

Public Sub playbackRate_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playbackRate.Click

    '  Get the new value of the control as a double.
    Dim nUpDown As System.Windows.Forms.NumericUpDown = sender
    Dim newRate As Double = nUpDown.Value

    '  Test whether playback rate can be set. 
    If (player.settings.isAvailable("Rate")) Then

        '  Set the playback rate to the new value.
        player.settings.rate = newRate

    End If

End Sub

Requisiti

Requisito Valore
Versione
Lettore multimediale Windows serie 9 o versioni successive
Spazio dei nomi
WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

IWMPControls.fastForward (VB e C#)

IWMPControls.fastReverse (VB e C#)

Interfaccia IWMPSettings (VB e C#)

IWMPSettings.isAvailable (VB e C#)

IWMPSettings.mute (VB e C#)