Embedding Sound with Flash, Part III: Streams

Checking for the Player Readiness

The FlashSound JavaScript API's isPlayerReady() method returns true if the browser recognizes the player associated with the JavaScript object, and the SWF has loaded at least one frame. This method returns false otherwise. FlashSound API executes this method before all other API method calls, so don't bother using it again. But you do have to use isPlayerReady() whenever you call a Flash method that is not part of FlashSound JavaScript API.

Click the following link to play a Flash stream track that plays a tutorial on FlashSound. We put two alert statements. One that prints the value of isPlayerReady() before embedding the tutorial, and one that prints its value after embedding the tutorial SWF. Notice that the value of isPlayerReady() is false before embedding, and true after it:

Play the Tutorial

Here is the source code:

<HTML>
<HEAD>
<SCRIPT SRC="flashsound.js"></SCRIPT>
<SCRIPT>
  var mySoundObj = new FlashSound();
</SCRIPT>
</HEAD>
<BODY>
<P><A HREF="javascript://"
  onmouseover="mySoundObj.TGotoAndPlay('/',1)">
    Rewind and Play the Tutorial</A>
  <A HREF="javascript://"
  onmouseover="mySoundObj.TStopPlay('/')">Pause</A>
  <A HREF="javascript://"
  onmouseover="mySoundObj.TPlay('/')">Continue</A>
  <A HREF="javascript://"
  onmouseover="alert(mySoundObj.IsPlaying('/'))">
    Is Playing?</A></P>
<SCRIPT>
  alert("Before Embedding, isPlayerReady() returns " +
    mySoundObj.isPlayerReady());
  mySoundObj.autostart = false;
  mySoundObj.embedSWF("earsonly.swf");
  alert("After Embedding, isPlayerReady() returns " +
    mySoundObj.isPlayerReady());
</SCRIPT>
</BODY>
</HTML>