표준 (iframe) 포함 코드에 사용할 수 있는 옵션

서문

그만큼 iframe플레이어 구현 코드는 플레이어를 하나의 포함 된 단위로 쉽게 사용할 수 있도록합니다. 이것은 종종 소셜 미디어 응용 프로그램 및 공유에 필요합니다.

용법

참고: Brightcove Player 고객 인 경우videoId쿼리 매개 변수를 사용하여 플레이어에 동영상을 할당합니다. 플레이어모듈에서 비디오를 할당하거나 컬을 사용합니다.

사용하려면 iframe코드는 다음 단계를 따릅니다.

플레이어 모듈을 사용하여 플레이어를만듭니다.
미디어모듈로 이동하여 새로 생성 된 플레이어를 사용하여 비디오를 게시하십시오.

복사표준 소스 코드. HTML은 다음과 유사합니다:

<iframe src="https://players.brightcove.net/.../index.html?videoId=6116779877001"
  allowfullscreen=""
  allow="encrypted-media"
  width="960" height="540"></iframe>

브라우저에서 HTML을 복사하여 전체 HTML body페이지의 에 붙여 넣습니다.
HTML 페이지를 탐색하여 플레이어가 작동하는 것을 확인합니다.

쿼리 매개 변수

다양한 검색어 매개 변수를 iframe태그를 사용하여 플레이어의 행동 방식에 대한 추가 정보를 제공합니다. 아래 표에는 사용 가능한 매개 변수가 자세히 나와 있습니다.

매개 변수	설명	데이터 유형
`adConfigId`	동적 전송 SSAI의 광고 구성 ID입니다.	스트링
`applicationId`	단일 플레이어를 재사용할 수 있지만 사이트별 또는 애플리케이션별로 분석을 차별화합니다. 자세한 내용은플레이어 임베드 코드에 응용 프로그램 ID 추가문서를 참조하십시오.	스트링
`autoplay`	플레이어가 허용되는 플랫폼에서 즉시 플레이를 시작해야 함을 나타냅니다. `autoplay`가 부울 값으로 설정된 경우 브라우저의 기본 자동 재생 동작이 사용됩니다. 다음 세 가지 유효한 문자열 값 중 하나로 설정된 경우 다음과 같은 결과가 발생합니다. `play` : 플레이어는 수동으로 플레이를 호출하려고 시도합니다. `muted` : 플레이어는 수동으로 플레이어를 음소거하고 재생을 호출합니다. `any` : 플레이어는 먼저 플레이를 호출하려고합니다. 실패하면 플레이어를 음소거하고 재생을 호출합니다. 위 중 하나라도 실패하면 자동 재생이 false로 설정된 것처럼 플레이어는 “빅 플레이 버튼”을 표시합니다. 자동 재생에 비디오를 가져 오는 것은 복잡한 상황이 될 수 있습니다. 자세한 내용은자동 실행 고려 사항문서를 참조하십시오. 만약자동 재생플레이어 수준에서 활성화 된 경우 (Studio 또는 Player Management API 사용) 비활성화 할 방법이 없습니다. 예를 들어`&autoplay=false`자동 재생이 중지되지 않습니다. 실제로 마지막 쿼리 매개 변수는 마치 URL에 문자열이 포함 된 것처럼 실제로 자동 재생을 켭니다. 자동 재생 , 어떤 값이 할당 되더라도 자동 재생이 활성화됩니다.	부울 또는 문자열
`crossorigin`	true의경우, 기본< 비디오 > 요소는교차 원산지 = “익명”이됩니다 . 즉, 플레이어로 가져온 모든 비디오 또는 텍스트 트랙에는 CORS 헤더가 있어야합니다. 참고: 이 기능은 모든 콘텐츠 (비디오 및 텍스트 트랙) 에 CORS 헤더가 적용된 경우에만 사용해야합니다.	부울
`deliveryConfigId`	Dynamic Delivery Rules 구성 ID	스트링
`language`	플레이어의 언어 (유효한 언어 코드, 일반적으로 두 글자 사용) 를 설정합니다.	문자열
`loop`	비디오가 종료되는 즉시 다시 시작하도록 합니다.	문자열
`muted`	비디오 사운드를 음소거합니다.	부울
`playlistId`	플레이어에서 재생 목록의 ID 또는 참조 ID를 설정합니다.	문자열
`playlistVideoId`	비디오에서 재생할 초기 비디오를 설정합니다. 이 비디오는 지정된 재생 목록에 있어야 합니다.	문자열
`playsinline`	플랫폼과 OS에서 허용하는 경우 플레이어의 재생 영역 내에 비디오 콘텐츠를 표시합니다. 즉, 전체 화면이나 크기 조정이 가능한 독립적 인 창에 표시되지 않습니다. iPhone 및 iPad에서 작동합니다.	부울
`preload`	비디오 태그가로드되는 즉시 비디오 데이터 다운로드를 시작할지 여부를 브라우저에 알립니다. 가능한 값은`none` , `metadata`또는`auto`입니다. 자세한 내용은 다음 섹션을 참조하십시오.	스트링
`referrer`	통과 할 수 있습니다`document.referrer` iframe에 대한 다른 매개 변수와 함께 동영상의 리퍼러 URL을 정확하게 추적 할 수 있습니다. 값을 URI 인코딩해야합니다. 예를 들면 다음과 같습니다. `referrer=http%3A%2F%2Ffoo.com` . 또한이 매개 변수는 플레이어의 6.25 버전 이상에서 사용할 수 있습니다.	문자열
`t`	비디오 재생을 시작할 시간 오프셋을 설정합니다. 자세한 내용은딥 링크문서를 참조하십시오.	문자열
`videoId`	플레이어에서 비디오의 ID 또는 참조 ID를 설정합니다.	문자열

미리로드 세부 정보

preload 매개 변수는 동영상 태그가로드되는 즉시 동영상 데이터 다운로드를 시작할지 여부를 브라우저에 알립니다. 옵션은자동 , 메타데이터및없음입니다 . HLS 재생 기술의 경우 설정은 약간 다른 것을 의미하며 아래에 나와 있습니다.

자동 (기본): 브라우저가 동의하는 경우 즉시 비디오를로드하십시오. iPhone 및 iPad와 같은 일부 모바일 장치는 사용자의 대역폭을 보호하기 위해 비디오를 미리 로드하지 않습니다. 이것이 값이auto라고부르며사실과같은 더 최종적인 것이 아닌 이유입니다.

HLS 재생 기술의 경우auto는플레이어가 m3u8 매니페스트 파일을 다운로드하고, 브라이트코브 플레이어 버전 5.3 이전의 경우처럼 3-4가 아닌 1세그먼트만 다운로드한다는 의미입니다.
메타 데이터 : 비디오의 지속 시간 및 크기와 같은 정보가 포함된 비디오의 메타 데이터만 로드합니다.

HLS 재생 기술의 경우메타데이터는자동과동일합니다.
없음 : 비디오 데이터를 미리 로드하지 마십시오. 사용자가 재생을 클릭하여 다운로드를 시작할 때까지 대기합니다. iOS에서는이 설정으로 세그먼트 다운로드가있을 수 있습니다. 자세한 내용은브라이트코브 플레이어 및 iOS문서를 참조하십시오.

HLS 재생 기술의 경우없음사용자가 재생을 누를 때까지 플레이어는 더 이상 m3u8 매니페스트를 포함하여 아무것도로드하지 않습니다.

      <video-js preload ...>
      or
      { "preload": "auto" }

참고: 서버측 광고 삽입 (SSAI를) 사용하는 경우 브라이트코브는 설정을 권장합니다preload=none . preload가auto또는metadata로 설정된 경우 비디오 스트림의 첫 번째 프레임이 요청되며, 사용자가 재생을 시작하지 않더라도 광고가 전달된 것으로 계산됩니다.