Occurs when a synchronized command or URL is received.
Syntax
MediaPlayer_ScriptCommand( scType, Param )
Parameters
scType
A String value specifying the type of script command.
Param
A String value specifying the value of the script command.
Remarks
Commands can be embedded among the sounds and images of an .asf file. The commands are a pair of Unicode strings associated with a designated time in the stream. When the stream reaches the time associated with the command the Media Player control sends a ScriptCommand event with two parameters, one parameter specifying the type of command being sent and one parameter specifying the command. The type parameter is used to determine how the command parameter will be processed. Any type of command can be embedded in an ASF stream to be handled by the ScriptCommand event.
One type of command is a URL (Uniform Resource Locator). URL-type commands received by the Player control are invoked automatically in your default Internet browser if the InvokeURLs property is True.
The Player control always processes incoming URL-type commands in the following manner:
When authoring an .asf file, you can specify which frame the new URL is displayed in by concatenating two ampersands and the name of the frame in the parameter field. The example below illustrates typical ScriptCommand parameters. It specifies that the URL mypage should be launched in the myframe frame.
Type = "URL"
Param = http://myweb/mypage.html&&myframe
The only other type of script commands automatically processed by the Player control at this time are FILENAME-type commands. When the Player control receives a command with a FILENAME type, it resets the FileName parameter, attempts to open the file named, and begins playing the new stream immediately.
You can embed any other type of command as long as you provide reciprocal code to handle the command. Though unknown commands are ignored by the Player control, they are still handed off to the ScriptCommand event.
This event does not get called if the file is being scanned (fast forwarded or fast reversed).
The following example checks first to see whether the received command is a URL. If it's not, it displays the command in a text box. This example could be used to display text captions embedded in an .asf file. With a small amount of modification, you could check for commands of type "CAPTION" and then author .asf files by using the "CAPTION" tag wherever you wanted to insert captions. You could also send VBScript commands through an .asf file and then build ActiveX HTML pages on the fly.
Example
The example code shows the ScriptCommand event procedure.
Sub MediaPlayer_ScriptCommand(Type, Param)
If Not (Type = "URL") Then 'Not URL?
TextBox.Text = Type + ": " + Param 'Show command
End If
End Sub