포함(embed)된 동영상 및 라이브 방송 플레이어

포함(embed)된 동영상 플레이어를 사용하면 Facebook 동영상 및 Facebook 라이브 방송을 쉽게 웹사이트에 추가할 수 있습니다. 페이지 또는 사용자가 게시한 전체 공개 동영상 게시물을 동영상 또는 라이브 방송 소스로 사용할 수 있습니다.

포함(embed)된 동영상 플레이어 구성 도구 코드 예시 설정 수동으로 코드 추가하기

단계별 안내

1. URL 또는 페이지 선택하기

포함(embed)할 Facebook 동영상의 URL을 선택합니다.

2. 코드 구성 도구

코드 구성 도구에 URL을 붙여넣고 '코드 가져오기' 버튼을 클릭하여 포함(embed)된 동영상 플레이어 코드를 생성합니다.

3. HTML 픽셀 코드 복사하여 붙여넣기

랜딩 페이지 웹사이트의 HTML에 픽셀 코드를 복사하여 붙여넣습니다.

포함(embed)된 동영상 플레이어 구성 도구

동영상 URL

동영상의 픽셀 너비

전체 게시물 포함

코드 받기

전체 코드 예시

코드 예시를 복사하여 웹사이트에 붙여넣습니다. 동영상 URL에 맞게 data-href 값을 조정합니다. data-width 속성을 사용하여 플레이어 크기를 조절합니다.

<html>
<head>
  <title>Your Website Title</title> 
</head>
<body>

  <!-- Load Facebook SDK for JavaScript -->
  <div id="fb-root"></div>
  <script async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v3.2"></script>

  <!-- Your embedded video player code -->
  <div class="fb-video" data-href="https://www.facebook.com/facebook/videos/10153231379946729/" data-width="500" data-show-text="false">
    <div class="fb-xfbml-parse-ignore">
      <blockquote cite="https://www.facebook.com/facebook/videos/10153231379946729/">
        <a href="https://www.facebook.com/facebook/videos/10153231379946729/">How to Share With Just Friends</a>
        <p>How to share with just friends.</p>
        Posted by <a href="https://www.facebook.com/facebook/">Facebook</a> on Friday, December 5, 2014
      </blockquote>
    </div>
  </div>

</body>
</html>

설정

위의 구성 도구에는 포함(embed)된 동영상 플레이어에 대한 모든 설정이 포함되어 있지 않습니다. 다음과 같은 설정도 변경할 수 있습니다.

설정	설명	기본값
`data-href`	동영상의 절대 URL입니다.	`n/a`
`data-allowfullscreen`	전체 화면 모드에서 동영상을 재생할 수 있습니다. `false` 또는 `true`일 수 있습니다.	`false`
`data-autoplay`	페이지를 읽어들이면 동영상이 자동으로 재생을 시작합니다. 소리 없이(음소거) 동영상이 재생됩니다. 동영상 플레이어 컨트롤을 통해 소리를 켤 수 있습니다. 모바일 기기에서는 이 설정이 적용되지 않습니다. `false` 또는 `true`일 수 있습니다.	`false`
`data-lazy`	`true`로 설정하면 `loading="lazy"` iframe 속성을 설정하여 브라우저의 지연 로딩 메커니즘을 사용합니다. 플러그인이 뷰포트와 가깝지 않아서 전혀 보이지 않을 수 있는 경우 브라우저가 플러그인을 렌더링하지 않는 효과가 있습니다. `true` 또는 `false`(기본값)일 수 있습니다.	`false`
`data-width`	동영상 컨테이너의 너비입니다. 최솟값은 `220px`입니다.	`auto`
`data-show-text`	동영상과 연결된 Facebook 게시물의 텍스트를 포함하려면 `true`로 설정하세요. 데스크톱 사이트에만 사용할 수 있습니다.	`false`
`data-show-captions`	기본적으로 캡션을 표시하려면(사용할 수 있는 경우) `true`로 설정하세요. 캡션은 데스크톱에서만 사용할 수 있습니다.	`false`

구성 예시

<div class="fb-video"
  data-href="https://www.facebook.com/FacebookDevelopers/posts/10151471074398553"
  data-width="500"
  data-allowfullscreen="true"
  data-autoplay="true"
  data-show-captions="true"></div>

동영상 게시물에서 코드 가져오기

1. 동영상 게시물로 이동

전체 공개 동영상을 게시하는 경우(FAQ 참조) 동영상 게시물에서 퍼가기 코드를 바로 가져올 수 있습니다.

옵션 메뉴에서 Embed Video를 선택합니다.

또는 전체 페이지 보기에서 동영상을 볼 때, 오른쪽 하단의 Embed Video 버튼을 선택합니다.

페이지만 해당

페이지에 전체 공개 동영상을 게시할 때(FAQ 참조) 타임라인에서 직접 퍼가기 코드를 가져올 수 있습니다. Facebook에서 게시물의 오른쪽 상단에 표시되는 아이콘을 클릭합니다.

드롭다운 메뉴에서 Embed Video를 선택합니다.(페이지만 해당)

2. 코드를 복사하여 붙여넣기

동영상 게시물을 포함할 코드가 있는 대화 상자가 표시됩니다. 웹페이지에서 표시할 위치로 이 코드를 복사하여 붙여넣습니다.

자세한 기술적 내용은 수동으로 코드 추가하기 섹션을 참조하세요.

수동으로 코드 추가하기

코드 생성기를 사용하는 것 외에도 수동으로 코드를 포함(embed)할 수 있습니다.

1. 동영상 게시물의 URL 가져오기

먼저 공유할 동영상 게시물의 URL을 가져와야 합니다. 동영상은 반드시 전체 공개 상태여야 하며(FAQ 참조), 이는 게시물의 게시 시간 바로 옆에 회색의 지구본 아이콘으로 표시됩니다.

테스트를 위해 다음 예제 URL을 사용할 수 있습니다.

"https://www.facebook.com/FacebookDevelopers/videos/10152454700553553/"

2. JavaScript SDK 읽어들이기

포함(embed)된 동영상 플레이어 플러그인 또는 다른 소셜 플러그인을 사용하려면 웹사이트에 Facebook JavaScript SDK를 추가해야 합니다. 페이지에서 단 한 번만 SDK를 읽어들여야 합니다. 열린 <body> 태그 바로 다음에 삽입하는 것이 가장 좋습니다.

<div id="fb-root"></div>
<script async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v3.2"></script>

JavaScript SDK - 빠른 시작에는 JavaScript SDK를 구현하는 방법에 대한 추가 도움말이 있습니다.

3. 포함(embed)된 동영상 플레이어 태그 배치

다음으로 포함(embed)된 동영상 플레이어 태그를 웹사이트의 원하는 위치에 삽입합니다. {your-video-post-url}을 게시물의 URL로 바꿉니다.

<div class="fb-video" data-href="{your-video-post-url}"  
  data-allowfullscreen="true" data-width="500"></div>

4. 테스트

이러한 단계를 완료하고 나면 포함(embed)된 동영상 플레이어를 테스트할 수 있습니다. 통합하고 나면 다음과 같이 표시됩니다.

<html>
  <title>My Website</title>
<body>
  <div id="fb-root"></div>
  <script async defer src="https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v3.2"></script>
  <h1>My Video Player</h1>
  <div class="fb-video"
    data-href="https://www.facebook.com/FacebookDevelopers/posts/10151471074398553"
    data-width="500"
    data-allowfullscreen="true"></div>
</body>
</html>

테스트 예제의 결과가 아래 스크린샷에 표시됩니다.

5. 맞춤 설정

이 페이지 아래에 있는 안내에 따라 크기, 언어 및 기타 설정을 조정합니다.

동영상 게시물의 URL 가져오기

CMS에서 퍼가기 코드를 만들고 원본 게시물 URL만 필요한 경우가 있습니다. 게시물의 URL을 가져오는 방법은 다음 2가지입니다.

브라우저 주소 표시줄에서 고유 링크의 URL을 복사합니다.
게시물의 게시 시간을 마우스 오른쪽 버튼으로 클릭하고 링크 주소를 복사합니다.

아래 스크린샷에서 두 방법 모두 빨간색으로 강조 표시됩니다.

그래프 API 사용

포함(embed)된 동영상 플레이어를 자동으로 웹사이트에 통합하려면 그래프 API를 사용하여 동영상을 취합해야 합니다. 예를 들어 페이지 동영상 API 엔드포인트를 사용하면 다음 형식(단축)으로 요청에 대한 응답을 /{page-id}/videos에 보냅니다.

{
  "data": [
    {
      "id": "1234567890",
      "created_time": "2015-02-25T23:22:06+0000",
      "description": "My Video Caption",
      "embed_html": "<iframe src=\"https://www.facebook.com/video/embed?video_id=1234567890\" width=\"1280\" height=\"720\" frameborder=\"0\"></iframe>",
      "format": []
    }
   ]
}

동영상의 URL을 가져오려면 다음 단계를 따르세요.

id 값을 사용하여 다음과 같은 구조로 URL을 만듭니다.

"https://www.facebook.com/video.php?v={id}"

동영상을 포함(embed)하기 위해 embed_html 속성을 사용하지 마세요. 이 주제에 대한 자세한 내용은 FAQ 섹션을 참조하세요.

데스크톱의 레이아웃

아래 예제처럼 포함(embed)된 동영상 플레이어 태그의 data-width 속성을 통해 데스크톱에 표시될 포함(embed)된 동영상 플레이어의 너비를 조정할 수 있습니다. 이 값은 220 이상이어야 합니다. 이 값에 대한 상한값은 없지만 플레이어가 상위 요소보다 커질 수는 없습니다.

CSS 스타일 태그로 플러그인의 크기를 조정하지 마세요. 디스플레이 오류가 발생할 수 있습니다.

<!-- WRONG! -->
<style type="text/css">
.fb-video {
  width: 500px;
}
</style>
<div class="fb-post" data-href="{your-video-post-url}"></div>

<!-- CORRECT -->
<div class="fb-video" data-href="{your-video-post-url}"
  data-allowfullscreen="true" data-width="500"></div>

전체 화면

전체 화면 모드에서 동영상을 재생할 수 있도록 data-allowfullscreen="true" 속성을 추가할 수 있습니다.

모바일 웹의 레이아웃

모바일 웹에서는 포함(embed)된 동영상 플레이어가 상위 요소의 내부 너비까지 자동 확대됩니다.

언어 변경

Facebook JavaScript SDK의 현지화된 버전을 읽어들여 포함(embed)된 동영상 플레이어 플러그인의 언어를 변경할 수 있습니다. SDK를 읽어들일 때 개발자의 언어를 사용하도록 src 값을 변경합니다. en_US를 자신의 로캘로 바꿉니다. 예를 들어 프랑스 개발자의 경우 fr_FR(프랑스어)로 변경합니다.

src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&amp;version=v3.2"

다른 언어에서도 사용할 수 있도록 소셜 플러그인의 너비를 조정해야 할 수도 있습니다. 자세한 정보는 현지화 및 번역 페이지에서 확인할 수 있습니다.

Wordpress

Wordpress 사이트에서 이미 JavaScript용 Facebook SDK를 사용 중인 경우 fb-video 태그를 게시물에 추가하기만 하면 포함(embed)된 동영상 플레이어 플러그인을 사용할 수 있습니다.

<div class="fb-video" data-href="https://www.facebook.com/video.php?v=10152795258318553" 
  data-width="500" data-allowfullscreen="true"></div>

JavaScript용 Facebook SDK를 사용하지 않고 각 동영상 게시물에서 얻을 수 있는 복사하여 붙여넣기 픽셀 코드를 통해 동영상을 포함(embed)하는 경우, Wordpress에서 모든 & 문자를 #038;으로 변환하여 플레이어가 중단되므로 포함(embed)된 동영상 플레이어 플러그인이 렌더링되지 않을 가능성이 큽니다.

대신 다음 코드를 사용하여 플러그인을 추가합니다.

<script>window.fbAsyncInit = function() {
  FB.init({
    xfbml      : true,
    version    : 'v3.2'
  });
  }; (function(d, s, id){
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) {return;}
    js = d.createElement(s); js.id = id;
    js.src = "https://connect.facebook.net/en_US/sdk.js";
    fjs.parentNode.insertBefore(js, fjs);
  }(document, 'script', 'facebook-jssdk'));</script>
<div class="fb-video" data-href="https://www.facebook.com/video.php?v=10152795258318553" data-width="500" data-allowfullscreen="true"></div>

사용하기 쉬운 새 Wordpress 통합이 곧 출시될 예정입니다.

FAQ

그래프 API `video` 속성 `embed_html`을 사용할 수 있나요?

아니요, embed_html 속성을 사용하지 않아야 합니다. 대신 포함(embed)된 동영상 플레이어 플러그인을 사용하세요!

`embed_html` 속성에 대한 정보:

그래프 API 엔드포인트 video에서 embed_html이라는 속성을 제공합니다. 속성의 값에는 요청된 동영상을 재생하기 위해 웹페이지에 포함(embed)할 수 있는 HTML 요소가 포함됩니다.

이 값을 포함(embed)된 동영상 플레이어 플러그인과 혼동하지 않아야 합니다. 더 이상 이 속성을 사용하지 않는 것이 좋습니다. 대신 포함(embed)된 동영상 플레이어 플러그인을 사용하세요!

embed_html 속성의 값을 사용하는 경우 동영상 플레이어에 다음과 같은 문제가 있을 수 있습니다.

모바일 기기와 태블릿에서 작동하지 않음
보기, 동영상 제목 등과 같은 추가 정보를 포함하지 않음

`embed_html` 속성의 예제(사용 중단됨)

{
  "embed_html": 
    "<iframe 
      src=\"https://www.facebook.com/video/embed?video_id=1234567890\"
      width=\"1280\" 
      height=\"720\"
      frameborder=\"0\">
    </iframe>"
}