Este documento lista os atributos das marcas OBJECT e EMBED usados para publicar conteúdo em SWF (ativado por Flash) em páginas HTML para exibição em navegadores da Web. Os atributos permitem que você especifique determinados parâmetros que controlam os detalhes de como e onde o Flash Player exibe o arquivo SWF no navegador.

Informações sobre inclusão de conteúdo ativado por Flash (arquivo SWF) em páginas da Web também estão disponíveis na TechNote Sintaxe da marca OBJECT | Flash (tn_4150).

Atributos necessários

Os seguintes atributos são necessários dentro das marcas OBJECT e EMBED ao adicionar um arquivo SWF a uma página HTML. O comando Publicar no Flash Professional cria arquivos HTML com os atributos necessários especificados por você. 

Observação: os valores entre parênteses e em itálico indicam que o desenvolvedor escolhe o valor.

Necessário para OBJECT e EMBED:

• width - Especifica a largura do conteúdo SWF em pixels ou em porcentagem da janela do navegador.
• height - Especifica a altura do conteúdo SWF em pixels ou em porcentagem da janela do navegador.

Necessário somente para a marca OBJECT:

• classid - Identifica o controle ActiveX para o navegador. Para obter o valor correto, consulte o código de exemplo em Sintaxe da marca OBJECT | Flash (tn_4150).
• codebase - Identifica a localização do controle ActiveX do Flash Player para que o navegador possa fazer o download automaticamente se o programa não estiver instalado. Para obter o valor correto, confira o código de exemplo em Sintaxe da marca OBJECT | Flash (tn_4150).
• movie (param) - Especifica o local de origem (URL) do arquivo SWF a ser carregado.

Necessário somente para a marca EMBED

• src - Especifica o local de origem (URL) do arquivo SWF a ser carregado.
• pluginspage - Identifica a localização do plug-in do Flash Player para que o usuário possa fazer o download se o programa não estiver instalado.

Atributos opcionais

Os seguintes atributos são opcionais ao definir as marcas OBJECT e EMBED. Para OBJECT, todos os atributos são definidos em marcas de parâmetro, a não ser que seja especificado de outro modo:

• id (atributo para a marca OBJECT) e name (atributo para a marca EMBED) - Identificador do arquivo SWF. Identifica o arquivo SWF para o navegador da Web, permitindo que linguagens de script do navegador (por exemplo, JavaScript) façam referência ao conteúdo do SWF. Para compatibilidade entre navegadores, certifique-se de que id e name tenham o mesmo valor definido.
• reproduzir - Valores possíveis: verdadeiro, falso. Especifica se um arquivo SWF baseado na linha de tempo começa a ser reproduzido imediatamente após o navegador ser carregado. Se este atributo for omitido, o valor padrão é verdadeiro.
• loop - Valores possíveis: verdadeiro, falso. Especifica se o arquivo SWF baseado na linha de tempo é repetido indefinidamente ou interrompido ao atingir o último quadro. Se este atributo for omitido, o valor padrão é verdadeiro.
• menu - Valores possíveis: verdadeiro, falso. Especifica se os controles de reprodução de filme estão disponíveis no menu de contexto do Flash Player.
  • true exibe um menu completo que fornece controles de reprodução de filme expandidos (por exemplo, Zoom, Qualidade, Reproduzir, Loop, Retroceder, Avançar, Voltar).
  • false exibe um menu que oculta controles de reprodução de filme (por exemplo, Zoom, Qualidade, Reproduzir, Loop, Retroceder, Avançar, Voltar). Este atributo é útil para conteúdo SWF que não depende da linha de tempo, como conteúdo controlado totalmente por ActionScript. O menu curto inclui itens de menu "Configurações" e "Sobre o Flash Player".
• quality - Valores possíveis: baixo, autobaixo, autoalto, médio, alto, ótimo. Especifica a qualidade de renderização de palco da lista de exibição. A definição da propriedade Stage.quality via ActionScript substitui este valor.
  • low melhora a velocidade da reprodução e reduz a aparência, nunca usando suavização de borda.
  • autolow a princípio enfatiza a velocidade, mas melhora a aparência sempre que possível. A reprodução começa com a suavização de borda desativada. Se o Flash Player detectar que o processador pode utilizar a suavização de borda, ela é ativada.
  • A princípio enfatiza tanto a velocidade de reprodução como a aparência, mas, se necessário, sacrifica a aparência para melhorar a velocidade de reprodução. A reprodução começa com a suavização de borda ativada. Se a taxa de quadros real ficar abaixo da taxa de quadros especificada, a suavização de borda é desativada para melhorar a velocidade de reprodução. Use isto para emular a configuração Exibir > Suavização de borda do Flash Professional.
  • midium aplica suavização de borda e não suaviza bitmaps. Produz uma qualidade intermediária entre baixa e alta.
  • high melhora a aparência em relação à velocidade de reprodução e sempre aplica suavização de borda. Se o filme não contiver animação, os bitmaps serão suavizados; se o filme contiver animação, os bitmaps não serão suavizados.
  • best oferece a melhor qualidade de exibição e não leva em consideração a velocidade de reprodução. Toda a saída tem suavização de borda e os bitmaps são suavizados.
• scale - Valores possíveis: showall, noborder, exactfit, noscale. Especifica como o Flash Player dimensiona o conteúdo SWF para ajustar-se à área de pixels especificada pela marca OBJECT ou EMBED.
  • default (Mostrar tudo) torna todo o conteúdo SWF visível na área especificada sem distorção e ao mesmo tempo mantém a proporção original do filme. As bordas podem aparecer nos dois lados do filme.
  • noborder dimensiona o arquivo SWF para preencher a área especificada e ao mesmo tempo mantém a proporção original do arquivo. O Flash Player pode cortar o conteúdo, mas não ocorre qualquer distorção.
  • exactfit torna todo o arquivo SWF visível na área especificada sem tentar preservar a proporção original. Pode ocorrer distorção.
  • noscale impede que o arquivo SWF seja dimensionado para ajustar-se à área da marca OBJECT ou EMBED. Pode ocorrer corte.
• alinhar (atributo do Object) - Valores possíveis: l, t, r.
  • O padrão centraliza o filme na janela do navegador e corta as bordas se a janela do navegador for menor que o filme.
  • l (esquerda), r (direita) e t (parte superior) alinham o filme ao longo da borda correspondente da janela do navegador e cortam os três lados restantes conforme necessário.
• salign - Valores possíveis: l, t, r, tl, tr.
  • l, r e t alinham o aplicativo ao longo da borda esquerda, direita ou superior da janela do navegador e corta os lados restantes conforme necessário.
  • tl e tr alinham o filme na esquerda superior e no canto superior da janela do navegador, cortando a parte inferior e o lado restante conforme necessário.
• wmode - Valores possíveis: janela, direto, opaco, transparente, gpu. Define a propriedade do modo Janela do arquivo SWF para transparência, camada, posicionamento e renderização no navegador. Se este atributo for omitido, o valor padrão é "janela". Para obter mais informações, consulte Usar valores do modo Janela (wmode) abaixo.
  • window - O conteúdo SWF é reproduzido em seu próprio retângulo ("janela") em uma página da Web. O navegador determina como o conteúdo SWF é disposto em camadas contra outros elementos HTML. Com este valor, não é possível especificar explicitamente se o conteúdo SWF aparecerá acima ou abaixo de outros elementos HTML na página.  
  • direct - Use direto para a renderização do caminho. Este atributo ignora a composição no buffer da tela e renderiza o conteúdo SWF diretamente na tela. Recomenda-se o valor wmode para fornecer o melhor desempenho para a reprodução de conteúdo. Ele permite a apresentação acelerada por hardware de conteúdo SWF que usa Stage Video ou Stage 3D.
  • opaque - O conteúdo SWF é disposto em camadas junto com outros elementos HTML na página. O arquivo SWF é opaco e oculta tudo que esteja em camadas atrás dele na página. Esta opção reduz o desempenho da reprodução em comparação com wmode=window ou wmode=direct.
  • transparent - O conteúdo SWF é disposto em camadas junto com outros elementos HTML na página. A cor do plano de fundo do arquivo SWF (cor de palco) é transparente. Os elementos HTML sob o arquivo SWF são visíveis através de qualquer área transparente do SWF, com combinação alfa. Esta opção reduz o desempenho da reprodução em comparação com wmode=window ou wmode=direct.
  • gpu - Use aceleração de hardware adicional em alguns aparelhos de TV ou dispositivos móveis conectados à Internet. Em contraste com outros valores de wmode, a fidelidade de pixel para gráfico de lista de exibição não é garantida. De outra forma, este valor é semelhante a wmode=direct.

• bgcolor - [valor RGB hexadecimal] no formato #RRGGBB. Especifica a cor de plano de fundo do conteúdo SWF. Use este atributo para sobrescrever a configuração da cor de plano de fundo (cor de Stage) especificada no arquivo SWF. (Esse atributo não afeta a cor de plano de fundo da página HTML.)
• base - [diretório base] ou [URL]. Especifica o diretório-base ou URL usados para resolver todas as instruções de caminho no arquivo SWF. Este atributo é útil quando o arquivo SWF é armazenado em um diretório diferente de outros arquivos.
• allowFullScreen - Valores possíveis: verdadeiro ou falso. Definir este valor como verdadeiro permite que o arquivo SWF entre no modo de tela inteira via ActionScript. Para obter mais informações, consulte Explorar o modo de tela inteira no Flash Player. Se este atributo for omitido, o valor padrão é falso.
• fullScreenAspectRatio - Valores possíveis: retrato ou paisagem. Usado para controlar como conteúdo SWF de tela inteira SWF aparece em dispositivos móveis que oferecem suporte para rotaão automática de tela, como telefones e tablets. Se este atributo estiver especificado, o Flash Player usa a orientação de tela especificada (retrato ou paisagem) quando o SWF é exibido no modo de tela inteira. Não importa o modo como o dispositivo é orientado. Se este atributo não estiver especificado, a orientação de conteúdo no modo de tela inteira segue a orientação de tela usada pelo navegador. 
  
• flashvars - Variáveis, definadas como uma seqüência de caracteres de pares chave=valor, que são passados para o arquivo SWF.
  • Use flashvars para especificar variáveis do nível raiz no arquivo SWF. O formato da seqüência de caracteres é um conjunto de combinações de chave=valor separadas pelo caractere "&".
  • Há suporte nos navegadores para tamanhos de seqüência de caracteres com um comprimento de até 64 KB (65535 bytes).
  • Para obter mais informações sobre o uso de flashvars, consulte Usar FlashVars para passar variáveis para um SWF (tn_16417).
• browserzoom - os seguintes identificadores OBJECT e EMBED estão disponíveis no Flash Player para alterar o tamanho do conteúdo Flash em resposta à alteração no fator de zoom do navegador:
  
  • scale: ativa o comportamento do fator de zoom do navegador
  • noscale: desativa o comportamento do fator de zoom do navegador

Usar valores do modo Janela (wmode) 

Os desenvolvedores pode definir a propriedade do modo Janela (wmode) do conteúdo SWF para controlar as camadas e a transparência do conteúdo no navegador. Independentemente do valor de wmode, o Flash Player exibe conteúdo no modo de tela inteira usando renderização de caminho direto. O uso de renderização de caminho direto ativa as capacidades de apresentação acelerada por hardware, como Stage Video e Stage 3D.

Para obter a reprodução do mais alto desempenho de conteúdo ativado por Flash no navegador, use wmode=direct. Este atributo ativa as capacidades de apresentação acelerada por hardware, incluindo Stage Video e Stage 3D. Evite a sobreposição de conteúdo SWF com elementos HTML (por exemplo, menus pop-up baseados em HTML) destinados a aparecer acima do arquivo SWF. O controle explícito de disposição de camadas tem suporte somente em alguns navegadores modernos (consulte o quadro abaixo). Em outros navegadores, o conteúdo SWF sempre aparece acima de outro elementos HTML.

Se você precisar de controle explícito de disposição de camadas, transparência, ou de elementos HTML que flutuem acima do conteúdo SWF , use wmode=opaque ou wmode=transparent. Você poderá então controlar a disposição de camadas em relação a outros elementos na página através de HTML. No entanto, esses modos "sem janela" reduzem o desempenho a reprodução, em comparação com wmode=window (o padrão) e wmode=direct.

Suporte de navegador para valores do modo Janela (wmode)

Diferentes navegadores dependem de diferentes abordagens para renderizar valores de conteúdo de páginas da Web e alças wmode de maneiras diferentes. O quadro acima resume quando usar wmodes diferentes. A matriz abaixo detalha os comportamentos específicos que você pode esperar de cada navegador.

L = Suporte a camadas HTML. Elementos HTML podem sobrepor-se a conteúdo SWF. Oferece suporte a controle explícito de disposição de camadas em relação a outros elementos HTML.

H = Suporte a apresentação acelerada por hardware, incluindo Stage Video e Stage 3D.

A = Suporte a acessibilidade.

Informações relacionadas

• Sintaxe da marca OBJECT
• O arquivo SWF ignora ordem de empilhamento, reproduz sobre camadas DHTML

Palavras-chave: código; valor; atributo; identificadores; atributos; param; parâmetro; reproduzir; loop; qualidade; bgcolor; escala; salign; base; menu; largura; altura; src; pluginspage; filme; classid; codebase; cor de plano de fundo; cor de fundo; tn_12701