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

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

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

단계별 안내

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

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

2. 코드 구성 도구에서 코드 생성하기

코드 구성 도구에 URL을 붙여넣고 "Get Code" 버튼을 클릭하여 포함(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>(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 = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.6";
    fjs.parentNode.insertBefore(js, fjs);
  }(document, 'script', 'facebook-jssdk'));</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-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)된 코드를 바로 가져올 수 있습니다.

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

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

페이지만 해당

페이지에 전체 공개 동영상을 게시할 때(FAQ 참조) 타임라인에서 직접 포함(embed) 코드를 가져올 수 있습니다. 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>(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 = "//connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.5";
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</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>(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 = "//connect.facebook.net/en_US/sdk.js#xfbml=1&amp;version=v2.5";
    fjs.parentNode.insertBefore(js, fjs);
  }(document, 'script', 'facebook-jssdk'));</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에서 포함(embed)된 코드를 만드는 시나리오에서는 원본 게시물 URL만 있으면 됩니다. 게시물의 URL을 가져오는 방법은 다음 2가지입니다.

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

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

그래프 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를 로딩할 때 개발자의 언어를 사용하도록 js.src 값을 조정합니다. en_US는 개발자의 언어로 대체하면 됩니다. 예를 들면 프랑스 개발자는 fr_FR(프랑스어)로 변경합니다.

js.src = "//connect.facebook.net/fr_FR/sdk.js#xfbml=1&amp;version=v2.5";

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

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

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

<script>window.fbAsyncInit = function() {
  FB.init({
    xfbml      : true,
    version    : 'v2.5'
  });
  }; (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 = "//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이라는 특성을 제공합니다. 속성의 값에는 요청된 동영상을 재생하기 위해 웹 페이지에 포함할 수 있는 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>"
}