 |
|
Adding Shockmachine parameters to your HTML file
Once you've generated an HTML file, you can add optional Shockmachine parameters to it. With these parameters, you can do the following:
 |
Specify a custom picon for your movie |
|
Specify a title for your movie |
|
Choose a category for your movie |
|
Specify a package file |
|
A package file is recommended when the content of your Shockmachine title consists of multiple files. A package file tells the Shockmachine Save feature which files need to be saved. |
|
You can also specify the total size, in bytes, of all the content that needs to be downloaded. |
|
Specify a URL for the Shockmachine Send feature. |
Within the EMBED tag and/or OBJECT tag, a single parameter (name/value pair) controls all Shockmachine functionality and has separate subparameters, as shown in the following example. The parameter name is swRemote ; it appears as follows in an HTML tag designed to work with both Microsoft Internet Explorer and Netscape Navigator. (For more information, see Netscape's applet and plug-in documentation.)
This example contains both EMBED and OBJECT tags. It includes the swRemote parameter, along with two subparameters: one that specifies a custom picon for the movie, and another that suggests a Shockmachine category for the movie. The subparameters of swRemote are explained in the table that follows this example. |
|
|
|
<OBJECT
classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://active.macromedia.com/flash2/cabs/swflash.cab#version=4,0,0,0"
ID=flashfilename WIDTH=550 HEIGHT=400>
<PARAM NAME=movie VALUE="flashfilename.swf">
<PARAM NAME=swRemote VALUE="swPicon='http://directory/picon.bmp' swCategory='Games'">
<EMBED
src="flashfilename.swf" WIDTH=550 HEIGHT=400
swRemote="swPicon='http://directory/picon.bmp' swCategory='Games'"
TYPE="application/x-shockwave-flash"
PLUGINSPAGE="http://www.macromedia.com/shockwave/download/
index.cgi?P1_Prod_Version=ShockwaveFlash">
</OBJECT>
|
|
|
|
Note that the swRemote parameter and its value are duplicated: this name/value pair is used once for the EMBED tag and once for the OBJECT tag. To specify an swRemote parameter, use a structure like this:
"NAME='VALUE' NAME='VALUE'"
The following table lists the optional subparameters you can specify in the HTML OBJECT and EMBED tags to improve both the Shockmachine save process and the content's playback in Shockmachine.
| Subparameter |
Notes |
swPicon |
A fully qualified URL to a picon BMP or GIF file. The image should be a 64 x 64 pixels, 8-bit image and use the Web system palette.
If a picon is not specified, one will be generated automatically, but Macromedia strongly recommends that you provide custom art. |
swPackage |
A fully qualified or relative URL (relative to the primary movie) of a package text file. This text file, in XML format, provides a list of URLs of all the files that need to be downloaded for a complete save of this piece.
For more information about package files, see Saving titles with multiple movies or external media. |
swTitle |
A text string that provides the Shockwave movie's title; this title appears in the Name field of the Save to Shockmachine dialog box when a user saves your movie to Shockmachine. The text string can include spaces.
If you do not provide a title, one is generated based on the movie's file name, but Macromedia strongly recommends that you provide a title. |
swTotalSize |
For content with packages (see swPackage , above), specifies the size, in bytes, of all the content that needs to be downloaded for the piece to save successfully. The size should include the movie currently being saved, even though it's already in the cache. If nothing is specified, an estimate is calculated based on URLs already downloaded. |
swCategory |
Specifies the category that will appear in the Category field of the Save to Shockmachine dialog box when a user saves your movie to Shockmachine.
If a category is not specified or is unavailable, the category that comes first alphabetically will be chosen. |
swSendUrl |
Specifies the URL to be sent when the user clicks the Shockmachine Send button. Typically, the URL is the location of the Web page that contains your movie. |
|
|
|
|
