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:
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:
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
Produced by Yehuda Shiran and Tomer Shiran
All Rights Reserved. Legal Notices.
Created: May 7, 2001
Revised: May 7, 2001
URL: https://www.webreference.com/js/column83/10.html