May 8, 2001 - Handling Inadequate Player Version Number | WebReference

May 8, 2001 - Handling Inadequate Player Version Number

Yehuda Shiran May 8, 2001
Handling Inadequate Player Version Number
Tips: May 2001

Yehuda Shiran, Ph.D.
Doc JavaScript

Sometimes, you may want to limit your script to certain version numbers of the Flash player. You can do it with the setMinPlayer() method of the FlashSound object. FlashSound JavaScript API provides you with even more customer delight. You can specify a code to execute when the existing player version is less than the minimum player version.

As a reminder, in order to sonify your page, follow this recipe:

flashsound.js in the HEAD section. Download.
  • Create a flashsound object in the
    • HEAD section.
  • Embed your SWF file in the
    • BODY section.
  • Create an anchor tag and set the
    • onmouseover event handler to the TGotoAndPlay() method.

    Let's verify that indeed ifNotMinPlayer() is doing the job. Since the highest player version number is 5, we would test this method if we put 6 as the minimum version number. The method ifNotMinPlayer() should be used after the setMinPlayer() method. Click the following link to see a demo of the new method.

    Switch to the Demo

    The code if very static. We just set the minimum player to 6 with setMinPlayer(6), and then call ifNotMinPlayer() with a function name as it single argument. The function is downloadRecentPlayer(). It alerts the user to download a newer version.

    Here is the source code:

    <HTML>
<HEAD>
<SCRIPT SRC="flashsound.js"></SCRIPT>
</HEAD>
<BODY>
<SCRIPT LANGUAGE="JavaScript">
  function downloadRecentPlayer() {
    alert("You need to load a newer version of the Flash player");
  }
  FlashSound.setMinPlayer(6);
  FlashSound.ifNotMinPlayer('downloadRecentPlayer()');
</SCRIPT>
</BODY>
</HTML>

    Here is a link you can use to download flashsound.js:

    Download flashsound.js