      *  the first frame to display.
      *  In the case of an HTTP download, Flex starts downloading the stream
      *  and shows the first frame.</p>
+     * 
+     *  If <code>playWhenHidden</code> is set to <code>false</code>, then 
+     *  <code>autoPlay</code> also affects what happens when the video 
+     *  comes back on stage and is enabled and visible.
      *  
      *  @default true
      *  

    {
        _isOnDisplayList = true;
        
        // if visiblity/onstage shouldn't effect whether we are playing or not, just return
        if (playWhenHidden)
            return;
        
        // if we should start autoPlaying and we're not, let's do that
        if (effectiveAutoPlay && !playing)
            play();
    }
    
    /**

    {
        _playWhenHidden = value;
        
        if (value)
            videoPlayer.autoPlay = autoPlay;
    }
    
    //----------------------------------
