此文件會列出 OBJECT 和 EMBED 標籤屬性,可用於 HTML 頁面發佈 SWF (使用 Flash) 內容以顯示於網頁瀏覽器。這些屬性可讓您指定特定參數,以控制 Flash Player 於瀏覽器中顯示 SWF 檔的方式和位置之細節。
有關在網頁中使用 Flash (SWF 檔) 內容之資訊,也可參閱 TechNote 文章 OBJECT 標籤語法 | Flash (tn_4150)。
下列為新增 SWF 檔至 HTML 頁面時,OBJECT 和 EMBED 標籤中必要的屬性。Flash Professional 中的「發佈」命令會建立 HTML 檔案與針對您所指定的必要屬性。
附註: 括號中的值與斜體字為開發人員所選擇的值。
- classid - 識別瀏覽器的 ActiveX 控制項。請參閱 OBJECT 標籤語法 | Flash (tn_4150) 中的範例程式碼,以瞭解正確的值。
- codebase - 識別 Flash Player ActiveX 控制項的位置,以便在尚未安裝該控制項時,讓瀏覽器自動加以下載。請參閱 OBJECT 標籤語法 | Flash (tn_4150) 中的範例程式碼,以瞭解正確的值。
- movie (param) - 指定載入 SWF 檔的來源位置 (URL)。
下列項目為定義 OBJECT 和 EMBED 標籤時可選用的屬性。如為 OBJECT,則所有屬性皆會定義於 param 標籤中,除非另外指定為:
- id (OBJECT 標籤的屬性) 和 name (EMBED 標籤的屬性) - SWF 檔識別碼。識別網頁瀏覽器的 SWF 檔,以允許瀏覽器指令碼語言 (例如,JavaScript) 參考 SWF 內容。為確保跨瀏覽器相容性,請確認 id 和 name 皆設定為相同的值。
- play - 可能的值為: true、false。指定以時間軸為基礎的 SWF 檔是否會在瀏覽器載入時立即播放。如果忽略此屬性,則預設值為 true。
- loop - 可能的值為: true、false。指定以時間軸為基礎的 SWF 檔是否會在播放完最後畫面後無限重複播放或停止。如果忽略此屬性,則預設值為 true。
- menu - 可能的值為: true、false。指定影片播放控制項是否開放於 Flash Player 內容選單中使用。
- 如指定為 true,則會顯示完整選單,提供展開的影片播放控制項 (例如,縮放、畫質、播放、重複播放、倒帶、快轉、後退)。
- 如指定 false,則會顯示隱藏影片播放控制項 (例如,縮放縮放、畫質、播放、重複播放、倒帶、快轉、後退) 的選單。此屬性對於不仰賴時間軸的 SWF 內容相當實用,例如由 ActionScript 完整控制的內容。簡短選單中包括「設定」和「關於 Flash Player」選單項目。
- quality - 可能的值為: low、autolow、autohigh、medium、high、best。指定顯示清單 Stage 的渲染品質。透過 ActionScript 設定 Stage.quality 屬性會覆寫此值。
- 如指定為 low,則會將播放速度的優先順序放在外觀之前,而且絕對不使用消除鋸齒。
- 如指定為 autolow,則會先偏重速度,但會盡可能改善外觀。開始播放時,會先關閉消除鋸齒功能。 若 Flash Player 偵測到處理器可以應付,便會啟用消除鋸齒功能。
- 如指定為 autohigh,則會在開始時同時偏重播放速度和外觀,但在需要時會犧牲外觀以增加播放速度。開始播放時,會先開啟消除鋸齒功能。如果實際的影格速率低於指定的影格速率,便會將消除鋸齒功能關閉,以改善播放速度。使用此設定以模擬 Flash Professional 中的「檢視 > 消除鋸齒」設定。
- 如指定為 medium,則會套用部分消除鋸齒功能,但不會平滑化點陣圖。這個選項產生的品質比 Low 設定好,但比 High 設定來得差。
- 如指定為 high,會將外觀的優先順序放在播放速度之前,而且一定會套用消除鋸齒功能。如果影片並未包含動畫,就會將點陣圖平滑化;如果影片包含動畫,就不會將點陣圖平滑化。
- 如指定為 best,則會提供最好的顯示品質,而且不考慮播放速度。所有的輸出都會消除鋸齒,所有的點陣圖也會被平滑化。
- scale - 可能的值為: showall、noborder、exactfit、noscale。指定 Flash Player 縮放 SWF 內容的方式,以符合 OBJECT 或 EMBED 標籤所指定的像素區域。
- 如指定為 default (顯示全部),則會在指定區域內顯示完整的 SWF 檔 (不會造成扭曲情形),同時維持影片的原始比例。影片的兩邊可能會出現邊框。
- 如指定為 noborder,則會縮放 SWF 檔以填滿指定區域,同時維持檔案的原始比例。Flash Player 會裁切內容,但不會發生扭曲情形。
- 如指定為 exactfit,則會在指定區域內顯示完整的 SWF 檔,但不會嘗試保留原始比例。影片可能會發生扭曲。
- 如指定為 noscale,則不會縮放 SWF 檔使其符合 OBJECT 或 EMBED 標籤的區域,而是將該檔案裁切。
- align (Object 的屬性) - 可能的值為: l、t、r。
- 將影片放在瀏覽器視窗的預設中心,但是如果瀏覽器視窗小於影片,則會裁切邊緣。
- l (靠左)、r (靠右) 和 t (靠頂端) 會將影片對齊於瀏覽器視窗的對應邊緣,並會視需要裁切其餘三邊。
- salign - 可能的值為: l、t、r、tl、tr。
- l、r 和 t 會將影片靠瀏覽器視窗左側、右側或頂端邊緣對齊,並會視需要裁切其餘邊緣。
- tl 和 tr 會將影片靠瀏覽器視窗左上側和頂端角落對齊,並會視需要裁切底部和其餘邊緣。
- wmode - 可能的值為: window、direct、opaque、transparent、gpu。會設定 SWF 檔在瀏覽器中的透明度、圖層、定位和渲染的「視窗模式」屬性。如果忽略此屬性,則預設值為「window」。如需詳細資訊,請參閱以下使用視窗模式 (wmode) 值。
- window - SWF 內容會在網頁中的矩形 (「視窗」) 內播放。瀏覽器會決定如何針對其他 HTML 元素將 SWF 內容分層。如使用此值,您將無法明確指定 SWF 內容顯示於頁面中其他 HTML 元素的上方或下方。
- direct - 使用 direct 直接建立渲染路徑。此屬性會忽略螢幕緩衝區的轉譯緩衝處理,直接將 SWF 內容呈現在螢幕上。建議使用此 wmode 值,以提供最佳的內容播放效能。此值能夠啟用硬體加速呈現使用 Stage Video 或 Stage 3D 的 SWF 內容。
- opaque - SWF 內容會與頁面中的其他 HTML 元素共同分層。SWF 檔會呈現不透明效果,且會隱藏頁面上檔案後方各個分層的項目。相對於 wmode=window 或 wmode=direct,此選項會降低播放效能。
- transparent - SWF 內容會與頁面中的其他 HTML 元素共同分層。SWF 檔背景顏色 (Stage 顏色) 為透明。HTML 元素位於 SWF 檔下方,可透過 SWF 的任何透明區域看見,且使用 alpha 混色。相對於 wmode=window 或 wmode=direct,此選項會降低播放效能。
- gpu - 在部分連接網際網路的電視或行動裝置上使用額外硬體加速功能。相對於其他 wmode 值,此值無法保證顯示清單圖形的像素真實性。但是,此值與 wmode=direct 類似。
- bgcolor - #RRGGBB 格式中的 [十六進位 RGB 值]。指定 SWF 內容的背景顏色。使用此屬性覆寫 SWF 檔中指定的背景顏色 (Stage 顏色) 設定。(此屬性不會影響 HTML 頁面的背景顏色。)
- base - [根目錄] 或 [URL]。指定用來解析 SWF 檔中所有相對路徑陳述式的根目錄或 URL。當您的 SWF 檔案存放在與其他檔案不同的目錄時,此屬性即可發揮作用。
- allowFullScreen - 可能的值為: true 或 false。設定此值為 true 可讓 SWF 檔透過 ActionScript 進入全螢幕模式。如需詳細資訊,請參閱探索 Flash Player 中的全螢幕模式。如果忽略此屬性,則預設值為 false。
- fullScreenAspectRatio - 可能的值為: portrait 或 landscape。用於控制全螢幕 SWF 內容於支援自動螢幕旋轉功能之行動裝置 (例如,手機和平板電腦) 上的顯示方式。如果指定此屬性,則當您使用全螢幕模式檢視 SWF 時,Flash Player 會使用指定的螢幕方向 (縱向或橫向) 顯示,裝置所使用的螢幕方向不會造成影響。如果未指定此屬性,則使用全螢幕模式的內容顯示方向將依據瀏覽器所使用的螢幕方向顯示。
- flashvars - 傳遞至 SWF 檔的變數 (定義為一串 key=value pair [機碼=值組])。
- 使用 flashvars 指定 SWF 檔中的根層級變數。字串格式為一組 key=value 組合,以「&」字元分隔。
- 瀏覽器支援長度 64 KB (65535 位元組) 大小以下的字串。
- 如需有關使用 flashvars 的詳細資訊,請參閱使用 FlashVars 傳遞變數至 SWF (tn_16417)。
- browserzoom - 下列為 Flash Player 中可用於變更 Flash 內容尺寸 (視瀏覽器縮放係數的變更) 的 OBJECT 和 EMBED 標籤:
- scale: 開啟瀏覽器縮放係數行為
- noscale: 關閉瀏覽器縮放係數行為
開發人員可設定 SWF 內容的「視窗模式」(wmode) 屬性,以控制瀏覽器中內容的圖層和透明度。然而無論 wmode 值為何,Flash Player 皆可透過直接路徑渲染技術顯示使用全螢幕模式檢視的內容。透過直接路徑渲染技術,即可啟用硬體加速呈現功能,例如 Stage Video 和 Stage 3D。
若要在瀏覽器中呈現最高效能的 Flash 內容播放,請使用 wmode=direct。此屬性可啟用硬體加速呈現功能,包括 Stage Video 和 Stage 3D。避免將 SWF 內容與用於顯示在 SWF 檔上的 HTML 元素 (例如,以 HTML 為基礎的蹦現功能表) 重疊。明確圖層控制僅支援部分現代瀏覽器 (請參閱下表)。在其他瀏覽器中,SWF 內容會一律顯示在 其他 HTML 元素上方。
如果您需要使用明確圖層控制、透明度,或浮動於 SWF 內容上方的 HTML 元素,請使用 wmode=opaque 或 wmode=transparent。接著,您可以透過 HTML 在頁面上控制與其他元素相關的圖層。但是,相對於 wmode=window (預設) 和 wmode=direct,這些「無視窗」模式會降低播放效能。
使用案例 | 建議的 wmode |
最佳效能,包括支援硬體加速的 Stage Video 和 Stage 3D。 | wmode=direct |
須重疊 HTML 元素以在其 (跨所有瀏覽器) 相關的 SWF 內容、透明度或明確圖層控制上方顯示。 | wmode=opaque 或 wmode=transparent |
Wmode | 優點 | IE 6、7 和 8 Win | IE 9 Win | Firefox Win | Chrome Win | Firefox 3 Mac (OSX 10.5 和更新版本) | Firefox 4 Mac (OSX 10.6 和更新版本) | Safari 3 (OSX 10.5) | Safari 4 (OSX 10.6 和更新版本) | Chrome Mac (OSX 10.5) | Chrome Mac (OSX 10.6 和更新版本) |
window | 最廣泛的協助功能支援 | -/-/A | -/-/A | -/-/A | -/-/A | -/-/- | L/-/- | -/-/- | L/-/- | -/-/- | L/-/- |
透明 | 支援 HTML 元素的透明度與 alpha 混色。HTML 元素可重疊 SWF 內容。明確圖層控制 (所有瀏覽器) | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- |
不透明 | HTML 元素可重疊 SWF 內容。明確圖層控制 (所有瀏覽器)。 | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- | L/-/- |
direct | 最佳效能。硬體加速呈現功能,包括 Stage Video 和 Stage 3D (所有瀏覽器)。 | -/H/A | L/H/- | -/H/A | -/H/A | -/H/- | L/H/- | -/H/- | L/H/- | -/H/- | L/H/- |
gpu | 在部分連接網際網路的電視或行動裝置上使用額外硬體加速功能。 | -/H/A | L/H/- | -/H/A | -/H/A | -/H/- | L/H/- | -/H/- | L/H/- | -/H/- | L/H/- |