Programming Social Applications

Inserting Flash Movies in Your Gadget

The JavaScript feature libraries also offer you the capability to embed a .swf Flash video into your gadget. Doing so allows you to quickly, and with minimal code, include a standards-compliant Flash movie.

To integrate this feature, you need to take the following steps:

1. Within the ModulePrefs node of the gadget spec file, add a Require element to enable the JavaScript flash library.

   • Include: <Require feature="flash"/>

2. When you wish to insert a new Flash movie into your gadget, call the embedFlash() method of the gadgets.flash object.

   • Method call: gadgets.flash.embedFlash(...);

The flash library also includes several methods under gadgets.flash for working with and displaying Flash movies, listed in Table 4-2.

Table 4-2. Methods included under gadgets.flash

Method	Description
embedFlash	Embeds a .swf Flash movie, loaded from a provided URL, into a specified DOM node within the gadget. Parameters include: url (string) A URL to a .swf flash movie container (string) The ID of the container in which to insert the Flash movie params (object) Returns true if successful; false if unsuccessful
embedCachedFlash	Embeds a cached Flash movie into the specified DOM node. Parameters and return type are the same as embedFlash.
getMajorVersion()	Returns the major version of the Flash player or 0 if not available.

<Module> <ModulePrefs> <Require feature="flash" /> </ModulePrefs> <Content view="canvas"> <![CDATA[ <div id="insertFlash">Loading Flash Movie ...</div> <script type="text/javascript"> ...