Aplique los atributos de etiquetas OBJECT y EMBED en Adobe Flash Professional

Este documento enumera los atributos de las etiquetas OBJECT y EMBED que se utilizan para publicar contenido SWF (compatible con Flash) en páginas HTML para su visualización en navegadores web. Los atributos permiten especificar determinados parámetros que controlan la manera y el lugar en que Flash Player muestra el archivo SWF en el navegador.

También puede encontrar información sobre cómo incluir contenido compatible con Flash (archivos SWF) en páginas Web en la TechNote Sintaxis de la etiqueta OBJECT | Flash (tn_4150).

Atributos requeridos

Los siguientes atributos se requieren dentro de las etiquetas OBJECT y EMBED al agregar un archivo SWF a una página HTML. El comando Publicar de Flash Professional crea archivos HTML con los atributos requeridos especificados. 

Nota: los valores entre paréntesis y en cursiva indican que el desarrollador elige el valor.

Requeridos para OBJECT y EMBED:

• width: especifica la anchura del contenido SWF en píxeles o el porcentaje de la ventana del navegador.
• height: especifica la altura del contenido SWF en píxeles o el porcentaje de la ventana del navegador.

Requeridos solo para la etiqueta OBJECT:

• classid: identifica el control ActiveX para el navegador. Consulte el código de ejemplo en Sintaxis de la etiqueta OBJECT | Flash (tn_4150) para el valor correcto.
• codebase: identifica la ubicación del control ActiveX de Flash Player de modo que el navegador pueda descargarlo de forma automática si no lo tiene instalado. Consulte el código de ejemplo en Sintaxis de la etiqueta OBJECT | Flash (tn_4150) para el valor correcto.
• movie (param): especifica la ubicación de origen (URL) del archivo SWF que se debe cargar.

Requeridos solo para la etiqueta EMBED:

• src: especifica la ubicación de origen (URL) del archivo SWF que se debe cargar.
• pluginspage: identifica la ubicación del complemento de Flash Player de modo que el usuario pueda descargarlo si no lo tiene instalado.

Atributos opcionales

Los siguientes atributos son opcionales al definir las etiquetas OBJECT y EMBED. Para OBJECT, todos los atributos se definen en etiquetas param, a menos que se especifique lo contrario:

• id (atributo para la etiqueta OBJECT) y name (atributo para la etiqueta EMBED): identificador del archivo SWF. Identifica el archivo SWF para el navegador web, lo cual permite hacer referencia al contenido SWF mediante lenguajes de secuencias de comandos de navegador (por ejemplo JavaScript). Para garantizar la compatibilidad con varios navegadores, asegúrese de que id y name tengan el mismo valor.
• play: valores posibles: true, false. Especifica si la reproducción de un archivo SWF basado en línea de tiempo se inicia de forma inmediata una vez cargado en el navegador. Si se omite este atributo, true aparecerá como valor predeterminado.
• loop: valores posibles: true, false. Especifica si un archivo SWF basado en línea de tiempo se repite indefinidamente o se detiene cuando llega al último fotograma. Si se omite este atributo, true aparecerá como valor predeterminado.
• menu: valores posibles: true, false. Especifica si hay controles de reproducción de película disponibles en el menú contextual de Flash Player.
  • true muestra un menú completo que proporciona controles de reproducción de película ampliados (por ejemplo, Zoom, Calidad, Reproducir, Reproducir indefinidamente, Rebobinar, Avanzar, Atrás).
  • false muestra un menú que oculta los controles de reproducción de película (por ejemplo, Zoom, Calidad, Reproducir, Reproducir indefinidamente, Rebobinar, Avanzar, Atrás). Este atributo resulta útil para el contenido SWF que no depende de la línea de tiempo, como el contenido controlado por ActionScript. El menú reducido incluye los elementos de menú "Configuración" y "Acerca de Flash Player".
• quality: valores posibles: low, autolow, autohigh, medium, high, best. Especifica la calidad de representación del escenario de la lista de visualización. Si se establece la propiedad Stage.quality a través de ActionScript, se anula este valor.
  • low favorece la velocidad de reproducción ante el aspecto y nunca utiliza la visualización suavizada.
  • autolow da más importancia primero a la velocidad, pero mejora el aspecto siempre que sea posible. La opción Reproducción empieza con la visualización suavizada desactivada. Si Flash Player detecta que el procesador puede gestionarla, se activará la visualización suavizada.
  • autohigh da la misma importancia a la velocidad y al aspecto de la reproducción primero, pero sacrifica el aspecto por la velocidad si es necesario. La opción Reproducción empieza con la visualización suavizada activada. Si la velocidad real de los fotogramas es inferior a la velocidad especificada, la visualización suavizada se desactiva con el objeto de mejorar la velocidad de reproducción. Utilice esta configuración para emular la opción Vista > Suavizar ajuste en Flash Professional.
  • medium aplica un cierto grado de suavizado y no suaviza los mapas de bits. Da una mejor calidad que la configuración Low, pero menor calidad que la configuración High.
  • highDa más importancia al aspecto ante la velocidad de reproducción y siempre utiliza la visualización suavizada. Si la película no contiene animación, los mapas de bits se suavizan; de lo contrario, no se suavizan.
  • best proporciona la mejor calidad de visualización y no tiene en cuenta la velocidad de reproducción. Todas las imágenes resultantes y los mapas de bits se suavizan.
• scale: valores posibles: showall, noborder, exactfit, noscale. Especifica cómo Flash Player cambia la escala del contenido SWF para ajustarlo al área de píxeles especificada por la etiqueta OBJECT o EMBED.
  • default (Mostrar todo) permite ver todo el archivo SWF en el área especificada sin distorsión, al mismo tiempo que mantiene la proporción original de la película. Es posible que aparezcan bordes a ambos lados de la película.
  • noborder cambia la escala del archivo SWF para rellenar el área especificada, al mismo tiempo que mantiene la proporción original del archivo. Flash Player puede recortar el contenido, aunque no se producen distorsiones.
  • exactfit hace que todo el archivo SWF sea visible en el área especificada sin intentar mantener la proporción original. Puede ocurrir una distorsión.
  • noscale no permite que se cambie la escala del archivo SWF para ajustarlo al área de la etiqueta OBJECT o EMBED. Puede que se produzcan recortes.
• align (atributo para Object): valores posibles: l, t, r.
  • El valor predeterminado centra la película en la ventana del navegador y recorta los bordes si la ventana del navegador es más pequeña que la película.
  • l (izquierda) r (derecha) y t (arriba) alinean la película a lo largo del borde correspondiente de la ventana del navegador y recortan los otros tres lados según sea necesario.
• salign: valores posibles: l, t, r, tl, tr.
  • l, r y t alinean la película con el borde izquierdo, derecho o superior de la ventana del navegador y recortan los otros lados según sea necesario.
  • tl y tr alinean la película con la esquina superior izquierda o esquina superior derecha de la ventana del navegador y recortan la parte inferior y el otro lado según sea necesario.
• wmode: valores posibles: window, direct, opaque, transparent, gpu. Establece la propiedad de Modo de ventana del archivo SWF para la transparencia, organización en capas, colocación y representación en el navegador. Si se omite este atributo, "window" aparecerá como valor predeterminado. Para obtener más información, consulte Uso de valores del Modo de ventana (wmode) más adelante.
  • window: el contenido SWF se reproduce en su propio rectángulo (ventana) en una página Web. El navegador determina cómo se organiza en capas el contenido SWF con relación a otros elementos HTML. Con este valor, no se puede especificar de manera explícita si el contenido SWF aparece encima o debajo de otros elementos HTML de la página.  
  • direct: se usa representación de ruta directa. Este atributo omite la composición en el búfer de pantalla y representa el contenido SWF directamente en la pantalla. Se recomienda usar este valor de wmode para proporcionar el mejor rendimiento de reproducción. Permite la presentación acelerada por hardware del contenido SWF que utiliza Stage Video o Stage 3D.
  • opaque: el contenido SWF se organiza por capas junto con otros elementos HTML de la página. El archivo SWF es opaco y oculta todas las capas ocultas detrás del mismo en la página. Esta opción reduce el rendimiento de reproducción en comparación con wmode=window o wmode=direct.
  • transparent: el contenido SWF se organiza por capas junto con otros elementos HTML de la página. El color de fondo del archivo SWF (color de escenario) es transparente. Los elementos HTML situados debajo del archivo SWF pueden verse a través de cualquier área transparente del archivo SWF, con mezcla alfa. Esta opción reduce el rendimiento de reproducción en comparación con wmode=window o wmode=direct.
  • gpu: se utiliza aceleración de hardware adicional en algunos televisores conectados a Internet y dispositivos móviles. A diferencia de lo que ocurre con otros valores de wmode, no se garantiza la fidelidad de píxeles para los gráficos de lista de visualización. Aparte de esta diferencia, este valor es similar a wmode=direct.

• bgcolor: [valor RGB hexadecimal] en el formato #RRGGBB. Especifica el color de fondo del contenido SWF. Utilice este atributo para anular el ajuste del color de fondo (color de escenario) especificado en el archivo SWF. (Este atributo no afecta al color de fondo de la página HTML).
• base - [directorio base] o [URL]. Especifica el directorio base o la URL que se utiliza para resolver todas las sentencias de ruta relativa incluidas en el archivo SWF. Este atributo es de gran ayuda cuando el archivo SWF se guarda en un directorio diferente de los demás archivos.
• allowFullScreen: valores posibles: true, false. Si este valor se establece en true, el archivo SWF puede entrar en el modo de pantalla completa a través de ActionScript. Para obtener más información, consulte Exploring full screen mode in Flash Player. Si se omite este atributo, true aparecerá como valor predeterminado.
• fullScreenAspectRatio: valores posibles: portrait o landscape. Se utiliza para controlar cómo aparece el contenido SWF a pantalla completa en los dispositivos móviles que admiten rotación de pantalla automática, como teléfonos y tabletas. Si se especifica este atributo, Flash Player utiliza la rotación de pantalla especificada (vertical u horizontal) cuando se ve el archivo SWF en el modo de pantalla completa. No importa la orientación del dispositivo. Si no se especifica este atributo, la orientación del contenido en el modo de pantalla completa sigue la orientación de pantalla del navegador. 
  
• flashvars: variables definidas como una cadena de parejas de clave=valor que se pasan al archivo SWF.
  • Utilice flashvars para especificar variables de nivel raíz en el archivo SWF. El formato de la cadena es un conjunto de combinaciones de clave=valor separadas por el carácter '&'.
  • Los navegadores admiten tamaños de cadena de hasta 64 KB (65535 bytes) de longitud.
  • Para obtener más información sobre el uso de flashvars, consulte Uso de FlashVars para pasar variables a un SWF (tn_16417).
• browserzoom: las siguientes etiquetas OBJECT y EMBED están disponibles en Flash Player para cambiar el tamaño del contenido de Flash como respuesta a un cambio de factor de zoom del navegador:
  
  • scale: activa el comportamiento de factor de zoom del navegador
  • noscale: desactiva el comportamiento de factor de zoom del navegador

Uso de valores del Modo de ventana (wmode) 

Los desarrolladores pueden definir la propiedad de Modo de ventana (wmode) del contenido SWF para controlar la organización en capas y la transparencia del contenido en el navegador. Independientemente del valor de wmode, Flash Player muestra el contenido visualizado en modo de pantalla completa a través de representación de ruta directa. Esto permite utilizar recursos de presentación acelerada por hardware como Stage Video y Stage 3D.

Para ofrecer el mejor rendimiento de reproducción de contenido compatible con Flash en el navegador, utilice wmode=direct. Este atributo permite utilizar recursos de presentación acelerada por hardware como Stage Video y Stage 3D. Evite que se superpongan el contenido SWF y los elementos HTML (por ejemplo, menús emergentes basados en HTML) que deben aparecer sobre el archivo SWF. Solo algunos navegadores modernos admiten control de capas explícito (consulte la tabla que se ofrece a continuación). En otros navegadores, el contenido SWF siempre aparece sobre otros elementos HTML.

Si necesita control de capas explícito, transparencia o que los elementos HTML floten sobre el contenido SWF, use wmode=opaque o wmode=transparent. De este modo, podrá controlar la organización en capas con relación a otros elementos de la página a través de HTML. Sin embargo, estos modos sin ventanas reducen el rendimiento de reproducción en comparación con wmode=window (valor predeterminado) o wmode=direct.

Compatibilidad de navegadores con los valores del Modo de ventana (wmode)

Los distintos navegadores utilizan técnicas diferentes para representar el contenido de las páginas web y gestionan los valores de wmode de distinta manera. La tabla anterior resume cuándo deben usarse los distintos valores de wmode. La tabla siguiente muestra los comportamientos específicos que pueden esperarse en cada navegador.

C = Se admiten capas HTML. Los elementos HTML pueden superponerse con contenido SWF. Admite control de capas explícito con relación a otros elementos HTML.

H = Se admite presentación acelerada por hardware, como Stage Video y Stage 3D.

A = Se admite accesibilidad.

Información relacionada

• Sintaxis de la etiqueta OBJECT
• El archivo SWF ignora el orden de apilamiento, se reproduce sobre las capas DHTML

Palabras clave: código; valor; atributo; etiquetas; atributos; param; parámetro; play; loop; quality; bgcolor; scale; salign; base; menu; width; height; src; pluginspage; movie; classid; codebase; color de fondo; tn_12701