Evento Player.ScriptCommand

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O evento ScriptCommand ocorre quando um comando ou URL sincronizado é recebido.

Sintaxe

Player.ScriptCommand(
  scType,
  Param
)

Parâmetros

scType

Cadeia de caracteres que especifica o tipo de comando de script.

Parâmetro

Cadeia de caracteres especificando o comando de script.

Retornar valor

Esse evento não retorna um valor.

Comentários

Os comandos podem ser inseridos entre os sons e imagens de um arquivo ou fluxo do Windows Media. Os comandos são um par de cadeias de caracteres Unicode associadas a uma hora designada no fluxo. Quando o fluxo atinge o tempo associado ao comando, o controle Reprodutor Multimídia do Windows envia um evento ScriptCommand com dois parâmetros. Um parâmetro especifica o tipo de comando que está sendo enviado e o outro parâmetro especifica o comando . O tipo de parâmetro é usado para determinar como o parâmetro de comando é processado. Qualquer tipo de comando pode ser inserido em um arquivo ou fluxo a ser manipulado pelo evento ScriptCommand .

A tabela a seguir lista os tipos de comando de script que são processados automaticamente por Reprodutor Multimídia do Windows.

Type	Descrição
CAPTION	O controle exibe o texto associado no DIV especificado por ClosedCaption. captioningID.
EVENTO	Informa ao controle para executar instruções definidas para o evento especificado.
FILENAME	O controle redefine sua propriedade de URL , tenta abrir o arquivo especificado e começa a reproduzir o novo fluxo imediatamente.
OPENEVENT	Armazena em buffer o comando event type associado para execução oportuna do script EVENT.
SYNCHRONIZEDLYRICLYRIC	O parâmetro Param contém o texto lírico sincronizado. Reprodutor Multimídia do Windows exibe o texto lírico na área de legenda fechada do recurso Agora Jogando.
TEXT	O controle exibe o texto associado no DIV especificado por ClosedCaption. captioningID.
URL	O controle abre automaticamente a URL especificada usando o navegador da Internet padrão se as Configurações. A propriedade invokeURLs é definida como true.

Você pode inserir qualquer outro tipo de comando, desde que forneça código recíproco para manipular o comando. Embora comandos desconhecidos sejam ignorados pelo controle Reprodutor Multimídia do Windows, eles ainda são entregues ao evento ScriptCommand.

Os comandos de URL recebidos pelo controle Reprodutor Multimídia do Windows são invocados automaticamente no navegador da Web padrão se as Configurações.A propriedade invokeURLs é definida como true. Você pode usar as Configurações. propriedade defaultFrame para especificar o quadro de destino no qual a página da Web é exibida.

A URL enviada para Reprodutor Multimídia do Windows é processada em relação à URL base especificada pelas Configurações.propriedade baseURL. A URL base é concatenada com a URL relativamente especificada, resultando em uma URL totalmente especificada que é passada como o parâmetro de comando pelo evento ScriptCommand .

O controle Reprodutor Multimídia do Windows sempre processa comandos do tipo URL de entrada da seguinte maneira:

1. Um comando do tipo URL é recebido.
2. Configurações. baseURL é usado para criar uma URL completa com base na URL relativa especificada no comando script.
3. ScriptCommand é chamado.
4. Depois que ScriptCommand retornar, Configurações. invokeURLs está marcado.
5. Se Configurações. invokeURLs é true e o comando é um tipo de URL, a URL especificada é invocada. Se Configurações. invokeURLs é false ou, se o comando não for um tipo de URL, o comando será ignorado.

Ao criar um arquivo do Windows Media, você pode especificar em qual quadro a nova URL é exibida concatenando dois e comercials e o nome do quadro no campo de parâmetro. O exemplo a seguir ilustra parâmetros típicos de ScriptCommand . Ele especifica que a URL mypage deve ser iniciada no quadro myframe .

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

O evento ScriptCommand não será chamado se o arquivo estiver sendo verificado (encaminhado rapidamente ou invertido rapidamente).

O valor dos parâmetros de evento é especificado por Reprodutor Multimídia do Windows e pode ser acessado ou passado para um método em um arquivo JScript importado usando o nome do parâmetro fornecido. Esse nome de parâmetro deve ser digitado exatamente como mostrado, incluindo maiúsculas.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Player

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs