Evento Player.ScriptCommand

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di 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.

L'evento ScriptCommand si verifica quando viene ricevuto un comando o un URL sincronizzato.

Sintassi

Player.ScriptCommand(
  scType,
  Param
)

Parametri

scType

Stringa che specifica il tipo di comando script.

Param

Stringa che specifica il comando script.

Valore restituito

Questo evento non restituisce un valore.

Commenti

I comandi possono essere incorporati tra i suoni e le immagini di un file o flusso di Windows Media. I comandi sono una coppia di stringhe Unicode associate a un'ora designata nel flusso. Quando il flusso raggiunge l'ora associata al comando, il controllo Lettore multimediale Windows invia un evento ScriptCommand con due parametri. Un parametro specifica il tipo di comando inviato e l'altro parametro specifica il comando. Il tipo di parametro viene usato per determinare la modalità di elaborazione del parametro di comando. Qualsiasi tipo di comando può essere incorporato in un file o in un flusso da gestire dall'evento ScriptCommand .

Nella tabella seguente sono elencati i tipi di comando script elaborati automaticamente da Lettore multimediale Windows.

Tipo	Descrizione
CAPTION	Il controllo visualizza il testo associato nella diV specificata da ClosedCaption. captioningID.
EVENTO	Indica al controllo di eseguire le istruzioni definite per l'evento specificato.
FILENAME	Il controllo reimposta la proprietà URL , tenta di aprire il file specificato e inizia immediatamente a riprodurre il nuovo flusso.
OPENEVENT	Memorizza nel buffer il comando di tipo EVENT associato per l'esecuzione tempestiva dello script EVENT.
SYNCHRONIZEDLYRICLYRIC	Il parametro Param contiene il testo lirico sincronizzato. Lettore multimediale Windows visualizza il testo lirico nell'area didascalia chiusa della funzionalità Now Playing.
TEXT	Il controllo visualizza il testo associato nella diV specificata da ClosedCaption. captioningID.
URL	Il controllo apre automaticamente l'URL specificato utilizzando il browser Internet predefinito se impostazioni. La proprietà invokeURLs è impostata su true.

È possibile incorporare qualsiasi altro tipo di comando purché si fornisca codice reciproco per gestire il comando. Anche se i comandi sconosciuti vengono ignorati dal controllo Lettore multimediale Windows, vengono comunque passati all'evento ScriptCommand.

I comandi URL ricevuti dal controllo Lettore multimediale Windows vengono richiamati automaticamente nel Web browser predefinito se le impostazioni.La proprietà invokeURLs è impostata su true. È possibile usare le impostazioni. proprietà defaultFrame per specificare il frame di destinazione in cui viene visualizzata la pagina Web.

L'URL inviato a Lettore multimediale Windows viene elaborato in relazione all'URL di base specificato dalle impostazioni.proprietà baseURL. L'URL di base è concatenato con l'URL relativamente specificato, generando un URL completamente specificato passato come parametro di comando dall'evento ScriptCommand .

Il controllo Lettore multimediale Windows elabora sempre i comandi di tipo URL in ingresso nel modo seguente:

1. Viene ricevuto un comando di tipo URL.
2. Impostazioni. baseURL viene usato per creare un URL completo dall'URL relativo specificato nel comando script.
3. Viene chiamato ScriptCommand .
4. Dopo la restituzione di ScriptCommand , Impostazioni. invokeURLs è selezionato.
5. Se impostazioni. invokeURLs è true e il comando è di tipo URL, viene richiamato l'URL specificato. Se impostazioni. invokeURLs è false o se il comando non è di tipo URL, il comando viene ignorato.

Quando si crea un file Windows Media, è possibile specificare il frame in cui viene visualizzato il nuovo URL concatenando due e commerciale e il nome del frame nel campo del parametro. L'esempio seguente illustra i parametri ScriptCommand tipici. Specifica che l'URL mypage deve essere avviato nel frame myframe .

scType = "URL"
Param = https://myweb/mypage.html&&myframe

L'evento ScriptCommand non viene chiamato se il file viene analizzato (inoltrato rapidamente o invertito rapidamente).

Il valore dei parametri di evento viene specificato da Lettore multimediale Windows e può essere accessibile o passato a un metodo in un file JScript importato usando il nome del parametro specificato. Questo nome di parametro deve essere digitato esattamente come illustrato, inclusa la maiuscola.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto Player

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs