Exemplos do SWFObject

O exemplo acima exposto é o necessário para o uso mínimo do SWFObject, mas, se você deseja usar outros parâmetros suportados pelo plug-in do Flash, o SWFObject facilita seu trabalho. Os exemplos abaixo mostram vários métodos diferentes que você pode desejar para inserir seu conteúdo em Flash.

Um exemplo simples de adição de parâmetros extras:

<script type=”text/javascript”> var so = new SWFObject(“movie.swf”, “mymovie”, “200″, “100%”, “7″, “#336699″); so.addParam(“quality”, “low”); so.addParam(“wmode”, “transparent”); so.addParam(“salign”, “t”); so.write(“flashcontent”); </script>

Aqui está uma lista completa dos parâmetros atuais e seus possíveis valores da macromedia.com.

Passando variáveis para seus filmes usando parâmetros “Flashvars”

O uso de Flashvars é o modo mais fácil de pegar dados do HTML dentro do filme Flash, mas os dados são passados só uma vez, assim que o filme carrega. Normalmente, você adicionaria um parâmetro chamado “flashvars” e, para o valor, passaria uma string de pares nome/valor como esta: variavel1=valor1&variavel2=valor2&variavel3=valor3 e assim por diante. O SWFObject facilita isso, permitindo que sejam adicionadas tantas variáveis quanto você deseja, num modo similar ao que você usaria para passar parâmetros adicionais. Aqui está um exemplo de como passar valores para o seu filme Flash usando Flashvars:

<script type=”text/javascript”> var so = new SWFObject(“movie.swf”, “mymovie”, “200″, “100″, “7″, “#336699″); so.addVariable(“variavel1″, “valor1″); so.addVariable(“variavel2″, “valor2″); so.addVariable(“variavel3″, “valor3″); so.write(“flashcontent”); </script>

Fazendo isso, todas as variáveis que você passar estarão imediatamente disponíveis dentro do seu filme em Flash, na linha de tempo _root.

O script SWFObject também tem uma função extra que lhe permite buscar variáveis da URL. Por exemplo, suponha que você tenha a seguinte URL: http://www.example.com/page.html?variavel1=valor1&variavel2=valor2. Usando a função getQueryParamValue(), você pode facilmente pegar esses valores da URL e passá-los ao seu filme em Flash. Aqui está um exemplo para a supracitada URL:

<script type=”text/javascript”> var so = new SWFObject(“movie.swf”, “mymovie”, “200″, “100″, “7″, “#336699″); so.addVariable(“variavel1″, getQueryParamValue(“variavel1″)); so.addVariable(“variavel2″, getQueryParamValue(“variavel2″)); so.write(“flashcontent”); </script>

A função

getQueryParamValue()

também suporta a leitura de variáveis do

location.hash

, que às vezes são usadas para criar links profundos (deep links) para as suas aplicações Flash. Um exemplo de como criar links profundos para seus filmes Flash usando location.hash, veja este exemplo do Slideshow Pro, que usa inserção via SWFObject.

Usando o ExpressInstall

O SWFObject tem suporte completo ao recurso Macromedia Flash Player Express Install. Junto com o script SWFObject existe um arquivo actionscript que funciona com o SWFObject, para dar início a um processo de atualização de plug-in nos seus filmes Flash. Seus usuários nunca terão que deixar seu site para atualizar seus players, e quando a atualização estiver completa, eles serão redirecionados de volta à página que iniciou a atualização.

Para usar o ExpressInstall, você precisa primeiro incluir o arquivo expressinstall.as no seu .fla e, no início do seu filme, fazer uma simples checagem para ver se o plug-in do usuário precisa ser atualizado:

#include "expressinstall.as"var ExpressInstall = new ExpressInstall();

// se o usuario precisa ser atualizado, mostra o botao “iniciar atualizacao”
if (ExpressInstall.needsUpdate) {

// isto eh opcional, vc pode tambem iniciar a atualizacao automaticamente,
// chamando ExpressInstall.init() aqui, ao inves das seguintes linhas

// anexa a msg personalizada de atualizacao, centralizada
var upgradeMsg = attachMovie("upgradeMsg_src", "upgradeMsg", 1);
upgradeMsg._x = Stage.width / 2;
upgradeMsg._y = Stage.height / 2;