Embedding Sound with Flash, Part III: Streams: Checking for the Player Version - Doc JavaScript | WebReference

Embedding Sound with Flash, Part III: Streams: Checking for the Player Version - Doc JavaScript


Embedding Sound with Flash, Part III: Streams

Checking for the Player Version

With the accelerated development of the Flash player, you may want to access version-specific features. FlashSound JavaScript API supports the playerVersion static property. It is a property of the FlashSound object. To alert its value, you write:

FlashSound.playerVersion

This property should be treated as read only. Although you can assign its value (and read it back), assigning a value to playerVersion can cause errors. To get playerVersion you don't need anything else but to include the FlashSound JavaScript code, flashsound.js. Mouse over the following link to alert the player version:

What's the Player Version?

Here is the source code:

<HTML>
<HEAD>
<SCRIPT SRC="flashsound.js"></SCRIPT>
</HEAD>
<BODY>
<P><A HREF="javascript://"
  onmouseover="alert(FlashSound.playerVersion)">
    What's the Player Version?</A></P>
</BODY>
</HTML>

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.

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 is 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>

Next: How to set the minimum player version number

http://www.internet.com


Produced by Yehuda Shiran and Tomer Shiran
All Rights Reserved. Legal Notices.
Created: May 7, 2001
Revised: May 7, 2001

URL: http://www.webreference.com/js/column83/10.html