이 문서에는 웹 브라우저에 표시할 HTML 페이지의 SWF(Flash 사용) 컨텐트를 게시하는 데 사용된 OBJECT 및 EMBED 태그의 특성이 나열되어 있습니다. 이러한 특성을 사용하여 Flash Player가 브라우저에서 SWF 파일을 표시하는 방법 및 위치에 대한 세부 사항을 제어하는 특정 매개 변수를 지정할 수 있습니다.

웹 페이지 내에 Flash를 사용한(SWF 파일) 컨텐트 포함에 대한 정보는 TechNote OBJECT 태그 구문 | Flash(tn_4150)에서도 확인할 수 있습니다.

필수 특성

SWF 파일을 HTML 페이지에 추가할 때 OBJECT 및 EMBED 태그 내에 다음 특성이 필요합니다. Flash Professional의 [게시] 명령은 지정된 필수 특성으로 HTML 파일을 만듭니다. 

참고: 괄호 안에 이탤릭체로 되어 있는 값은 개발자가 해당 값을 선택했음을 나타냅니다.

OBJECT와 EMBED에 모두 필요함:

  • width - SWF 컨텐트의 너비를 픽셀 또는 브라우저 창의 비율로 지정합니다.
  • height - SWF 컨텐트의 높이를 픽셀 또는 브라우저 창의 비율로 지정합니다.

OBJECT 태그에만 필요함:

  • classid - 브라우저에 대한 ActiveX 컨트롤을 확인합니다. 올바른 값에 대해서는 OBJECT 태그 구문 | Flash(tn_4150)의 예제 코드를 참조하십시오.
  • codebase - Flash Player ActiveX 컨트롤이 아직 설치되지 않은 경우에 브라우저가 이 컨트롤을 자동으로 다운로드할 수 있도록 컨트롤의 위치를 확인합니다. 올바른 값에 대해서는 OBJECT 태그 구문 | Flash(tn_4150)의 예제 코드를 참조하십시오.
  • movie (param) - 로드할 SWF 파일의 원본 위치(URL)를 지정합니다.

EMBED 태그에만 필요함

  • src - 로드할 SWF 파일의 원본 위치(URL)를 지정합니다.
  • pluginspage - Flash Player 플러그인이 아직 설치되지 않은 경우 사용자가 이를 다운로드할 수 있도록 이 플러그인의 위치를 식별합니다.

선택적 특성

OBJECT 및 EMBED 태그를 정의할 때 다음 특성은 선택 사항입니다. OBJECT의 경우 모든 특성은 달리 지정되어 있지 않으면 param 태그에 정의되어 있습니다.

  • id(OBJECT 태그에 대한 특성) 및 name(EMBED 태그에 대한 특성) - SWF 파일 ID. 웹 브라우저에 대한 SWF 파일을 식별하여 브라우저 스크립팅 언어(예: JavaScript)가 SWF 컨텐트를 참조하도록 합니다. 브라우저 간 호환을 위해 idname이 같은 값으로 설정되었는지 확인합니다.
  • play - 가능한 값: true, false. 타임라인 기반 SWF 파일이 브라우저에서 로드 시 바로 재생을 시작하는지 여부를 지정합니다. 이 특성을 생략하는 경우 기본값은 true입니다.
  • loop - 가능한 값: true, false. 타임라인 기반 SWF 파일이 마지막 프레임에 도달했을 때 무한정 반복되도록 할 것인지 아니면 중지되도록 할 것인지를 지정합니다. 이 특성을 생략하는 경우 기본값은 true입니다.
  • menu - 가능한 값: true, false. 동영상 재생 컨트롤을 Flash Player 상황에 맞는 메뉴에서 사용할 수 있는지 여부를 지정합니다.
    • true는 확장된 동영상 재생 컨트롤(예: 확대/축소, 품질, 재생, 반복 재생, 되감기, 앞으로 감기, 뒤로)을 제공하는 전체 메뉴를 표시합니다.
    • false는 동영상 재생 컨트롤(예: 확대/축소, 품질, 재생, 반복 재생, 되감기, 앞으로 감기, 뒤로)을 숨긴 메뉴를 표시합니다. 이 특성은 ActionScript에서 완전히 제어하는 컨텐트처럼 타임라인을 따르지 않는 SWF 콘텐트에 유용합니다. 짧은 메뉴에 "설정" 및 "Flash Player 정보" 메뉴 항목이 포함되어 있습니다.
  • quality - 가능한 값: low, autolow, autohigh, medium, high, best. 표시 목록 단계 렌더링 품질을 지정합니다. ActionScript를 통해 Stage.quality 속성을 설정하면 이 값이 재정의됩니다.
    • low는 모양보다 재생 속도에 중점을 두어 앤티앨리어싱을 사용하지 않습니다.
    • autolow는 속도를 우선적으로 강조하지만 가능한 경우 모양도 향상시킵니다. 이 경우에는 앤티앨리어싱이 해제된 상태로 재생이 시작됩니다. Flash Player가 프로세서에서 앤티앨리어싱을 처리할 수 있음을 감지하면 앤티앨리어싱이 설정됩니다.
    • autohigh는 처음에 재생 속도와 모양을 똑같이 강조하지만, 필요한 경우 모양보다 재생 속도를 우선적으로 고려합니다. 이 경우에는 앤티앨리어싱이 설정된 상태로 재생이 시작됩니다. 실제 프레임 속도가 지정된 프레임 속도 아래로 떨어지면 앤티앨리어싱이 해제되어 재생 속도가 향상됩니다. 이 설정을 사용하여 Flash Professional에서 [보기] > [앤티앨리어스] 설정을 에뮬레이트합니다.
    • medium은 앤티앨리어싱을 일부 적용하고 비트맵은 다듬지 않습니다. 이 옵션의 품질은 [낮음] 설정보다는 좋지만 [높음] 설정보다는 나쁩니다.
    • high는 재생 속도보다 모양에 중점을 두어 항상 앤티앨리어싱을 적용합니다. 동영상에 애니메이션이 포함되어 있지 않으면 비트맵이 다듬어지지만, 애니메이션이 포함되어 있으면 비트맵이 다듬어지지 않습니다.
    • best는 최상의 품질로 표시하고 재생 속도는 고려하지 않습니다. 모든 출력이 앤티앨리어싱되며 모든 비트맵이 다듬어집니다.
  • scale - 가능한 값: showall, noborder, exactfit, noscale. Flash Player가 OBJECT 또는 EMBED 태그로 지정한 픽셀 영역에 맞게 SWF 컨텐트의 크기를 조절하는 방법을 지정합니다.
    • default(모두 표시)는 동영상의 원래 종횡비를 유지하면서 전체 SWF 파일이 왜곡 없이 지정한 영역에 표시되도록 합니다. 동영상의 양쪽에 테두리가 표시될 수 있습니다.
    • noborder는 파일의 원래 종횡비를 유지하면서 SWF 파일의 크기를 조절하여 지정한 영역에 채웁니다. Flash Player에서 콘텐트를 자를 수 있지만 왜곡이 발생하지 않습니다.
    • exactfit은 원래 종횡비를 유지하지 않고 전체 SWF 파일이 지정한 영역에 표시되도록 합니다. 내용이 찌그러질 수 있습니다.
    • noscale은 OBJECT 또는 EMBED 태그 영역에 맞게 SWF 파일의 크기를 조절하지 않습니다. 자르기가 발생할 수 있습니다.
  • align(개체에 대한 특성) - 가능한 값: l, t, r.
    • 기본값은 동영상을 브라우저 창 중앙에 배치하고, 브라우저 창이 동영상보다 작으면 가장자리를 자릅니다.
    • l(왼쪽), r(오른쪽) 및 t(위쪽)는 동영상을 브라우저 창의 해당 가장자리에 맞추고, 필요에 따라 나머지 세 면을 자릅니다.
  • salign - 가능한 값: l, t, r, tl, tr.
    • l, r 및 t는 동영상을 브라우저 창의 왼쪽, 오른쪽 또는 위쪽에 맞추고, 필요에 따라 나머지 세 면을 자릅니다.
    • tltr은 동영상을 브라우저 창의 왼쪽 상단과 맨 위쪽 모서리에 맞추고, 필요에 따라 나머지 면을 자릅니다.
  • wmode - 가능한 값: window, direct, opaque, transparent, gpu. 브라우저에서 투명도, 계층화, 위치 지정 및 렌더링에 대한 SWF 파일의 창 모드 속성을 설정합니다. 이 특성을 생략하는 경우 기본값은 "window"입니다. 자세한 내용은 아래의 창 모드(wmode) 값 사용을 참조하십시오.
    • window - SWF 콘텐트는 웹 페이지의 고유한 직사각형("window")에서 재생됩니다. 브라우저에서는 SWF 콘텐트가 다른 HTML 요소에 계층화되는 방식을 결정합니다. 이 값을 사용하면 SWF 콘텐트가 페이지에서 다른 HTML 요소 위나 아래에 표시되는지 여부를 명시적으로 지정할 수 없습니다.  
    • direct - 경로 렌더링에 직접 사용합니다. 이 특성은 화면 버퍼에서 합성을 생략하고 SWF 콘텐트를 화면에 직접 렌더링합니다. 콘텐트 재생에 최상의 성능을 제공하려면 이 wmode 값을 사용하는 것이 좋습니다. 단계 비디오 또는 단계 3D를 사용하는 SWF 콘텐트의 하드웨어 가속화 프레젠테이션을 사용하도록 설정합니다.
    • opaque - SWF 콘텐트가 페이지에서 다른 HTML 요소와 함께 계층화됩니다. SWF 파일은 불투명하므로 페이지에서 그 뒤에 계층화된 모든 것을 숨깁니다. 이 옵션은 wmode=window 또는 wmode=direct에 비해 재생 성능이 저하됩니다.
    • transparent - SWF 콘텐트가 페이지에서 다른 HTML 요소와 함께 계층화됩니다. SWF 파일 배경색(단계 색상)은 투명합니다. SWF 파일 아래에 있는 HTML 요소는 알파 혼합을 사용하여 SWF의 투명한 영역을 통해 볼 수 있습니다. 이 옵션은 wmode=window 또는 wmode=direct에 비해 재생 성능이 저하됩니다.
    • gpu - 인터넷에 연결된 일부 TV 및 모바일 장치에서 추가 하드웨어 가속을 사용합니다. 다른 wmode 값에 비해 표시 목록 그래픽에 대한 픽셀 정확도가 보장되지 않습니다. 그 외에는 이 값이 wmode=direct와 비슷합니다.
  • bgcolor - #RRGGBB 형식의 [16진수 RGB 값]. SWF 콘텐트의 배경색을 지정합니다. SWF 파일에 지정된 배경색(단계 색상) 설정을 재정의하려면 이 특성을 사용합니다. (이 특성은 HTML 페이지의 배경색에 영향을 주지 않습니다.)
  • base[기본 디렉토리] 또는 [URL]. SWF 파일의 모든 상대 경로 문을 확인하는 데 사용되는 기본 디렉토리 또는 URL을 지정합니다. 이 특성은 SWF 파일을 다른 파일과 다른 디렉토리에 보관하는 경우 유용합니다.
  • allowFullScreen - 가능한 값: true 또는 false. 이 값을 true로 설정하면 ActionScript를 통해 SWF 파일이 전체 화면 모드로 전환될 수 있습니다. 자세한 내용은 Flash Player의 전체 화면 모드 탐색을 참조하십시오. 이 특성을 생략하는 경우 기본값은 false입니다.
  • fullScreenAspectRatio - 가능한 값: portrait 또는 landscape. 휴대폰 및 태블릿처럼 자동 화면 회전을 지원하는 모바일 장치에 전체 화면 SWF 콘텐트를 표시하는 방법을 제어하는 데 사용됩니다. 이 특성을 지정하면 SWF를 전체 화면 모드로 볼 때 Flash Player가 지정된 화면 방향(세로 또는 가로)을 사용합니다. 장치의 방향을 지정하는 방법은 문제되지 않습니다. 이 특성을 지정하지 않으면 전체 화면 모드에 있는 콘텐트의 방향이 브라우저에 사용된 화면 방향을 따릅니다. 
  • flashvars - SWF 파일에 전달된 키=값 쌍 문자열로 정의된 변수.
    • SWF 파일에서 루트 수준의 변수를 지정하려면 flashvars를 사용합니다. 문자열 형식은 '&' 문자로 구분된 키=값 조합 세트입니다.
    • 브라우저는 길이가 최대 64KB(65535바이트) 문자열을 지원합니다.
    • flashvars 사용에 대한 자세한 내용은 FlashVars를 사용하여 SWF에 변수 전달(tn_16417)을 참조하십시오.
  • browserzoom - 다음 OBJECT 및 EMBED 태그는 Flash Player에서 브라우저 확대/축소 비율의 변경에 대한 응답으로 Flash 콘텐트의 크기를 변경하는 데 사용할 수 있습니다.
    • scale: 브라우저 확대/축소 비율 동작 켜기
    • noscale: 브라우저 확대/축소 비율 동작 끄기

창 모드(wmode) 값 사용 

개발자는 브라우저에서 콘텐트의 계층화 및 투명도를 제어하도록 SWF 콘텐트의 창 모드(wmode) 속성을 설정할 수 있습니다. Flash Player는 wmode 값에 관계없이 직접 경로 렌더링을 사용하여 전체 화면 모드로 본 콘텐트를 표시합니다. 직접 경로 렌더링을 사용하면 단계 비디오 또는 단계 3D와 같은 하드웨어 가속화 프레젠테이션 기능을 사용할 수 있습니다.

브라우저에서 Flash 사용 콘텐트를 최고 성능으로 재생하려면 wmode=direct를 사용합니다. 이 특성을 사용하면 단계 비디오 또는 단계 3D를 포함한 하드웨어 가속화 프레젠테이션 기능을 사용할 수 있습니다. SWF 콘텐트를 SWF 파일 위에 표시하려는 HTML 요소(예: HTML 기반 팝업 메뉴)와 겹치지 마십시오. 명시적 계층화 제어는 일부 최신 브라우저에서만 지원됩니다(아래 표 참조). 다른 브라우저에서 SWF 콘텐트는 항상 다른 HTML 요소 위에 표시됩니다.

명시적 계층화 제어, 투명도 또는 SWF 콘텐트 위에 떠 있는 HTML 요소가 필요한 경우 wmode=opaque 또는 wmode=transparent를 사용합니다. 그러면 HTML을 통해 페이지에서 다른 요소를 기준으로 계층화를 제어할 수 있습니다. 하지만 이러한 "windowless" 모드는 wmode=window(기본값) 및 wmode=direct에 비해 재생 성능을 저하시킵니다.

사용 사례 권장되는 wmode
하드웨어 가속화 단계 비디오 및 단계 3D 지원을 포함하여 최적의 성능. wmode=direct
겹치는 HTML 요소가 HTML 요소를 기준으로 하여(모든 브라우저에서) SWF 콘텐트, 투명도 또는 명시적 계층화 제어 위에 표시되어야 합니다. wmode=opaque 또는 wmode=transparent

브라우저에서 창 모드(wmode) 값 지원

브라우저마다 웹 페이지 콘텐트를 렌더링하는 방법과 wmode 값을 처리하는 방법이 다릅니다. 위의 표는 다른 wmodes 사용 시기를 요약한 것입니다. 아래 매트릭스는 각 브라우저에서 예상할 수 있는 특정 동작을 자세히 설명한 것입니다.

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 요소에 대한 투명도 및 알파 혼합이 지원됩니다. 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 최상의 성능. 단계 비디오 및 단계 3D를 포함한 하드웨어 가속화 프레젠테이션(모든 브라우저). -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-
gpu 인터넷에 연결된 일부 TV 및 모바일 장치에서 추가 하드웨어 가속. -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-

L = HTML 계층화가 지원됩니다. HTML 요소는 SWF 콘텐트를 겹칠 수 있습니다. 다른 HTML 요소와 관련된 계층화의 명시적 제어를 지원합니다.

H = 단계 비디오 및 단계 3D를 포함한 하드웨어 가속화 프레젠테이션이 지원됩니다.

A = 액세스 가능성이 지원됩니다.

키워드: 코드; 값; 특성; 태그; 특성; param; 매개 변수; 재생; 반복 재생; 품질; bgcolor; 비율; salign; 기본; 메뉴; 너비; 높이; src; pluginspage; 동영상; classid; 코드베이스; 배경색; 배경 색상; tn_12701

이 작업에는 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License의 라이센스가 부여되었습니다.  Twitter™ 및 Facebook 게시물은 Creative Commons 약관을 적용받지 않습니다.

법적 고지 사항   |   온라인 개인 정보 보호 정책