플레이어 구성 가이드

계정 아이디

플레이어와 연결된 비디오 클라우드 계정 ID입니다. 이 값은수정할 수 없습니다 .

구성ID

ad_config_id정보:

• 데이터 형식: 문자열
• 기본값: undefined
• 동적 전송 SSAI의 광고 구성 ID입니다. 플레이어 구성에서 설정하는 것 외에도 iframe 플레이어의 AdConfigID 쿼리 문자열 매개 변수 또는 페이지 내 플레이어의 data-ad-config-id 특성을 통해 런타임에 설정할 수 있습니다. 이 중 하나는 플레이어 구성의 모든 값을 무시합니다.

값을 설정하는 다른 방법:

ad_페일오버

ad_failover정보:

• 데이터 유형: 부울
• 기본값: undefined
• 광고 장애 조치 동작을 사용하려면 true로 설정합니다. 이 구성은 다음에 따라 여러 부분으로 구성된 구성입니다.
  • 플레이어에서 IMA3 및 SSAI플러그인을 모두 구성해야 합니다.
  • 를 사용할 수ad_config_id있어야 합니다. 그렇지 않으면 SSAI를 사용할 수 없습니다.

true 로 설정하면 플레이어는 광고 차단 감지가 결정을 내릴 때까지 자동 초기화 프로세스를 지연합니다. 이로 인해 플레이어 초기화가 최대 100밀리초 정도 지연될 수 있습니다.

응용 프로그램 ID

application_id정보:

• 데이터 형식: 문자열
• 기본값: undefined
• 응용 프로그램 ID는 메트릭에서 단일 플레이어의 여러 용도를 구별하는 데 사용됩니다. 사용자에게 보이지 않습니다.

값을 설정하는 다른 방법:

오디오 전용 재생

오디오 자산을 함께 사용할 때 Brightcove Player플레이어를 사용자 정의하는 두 가지 옵션이 있습니다.

• 오디오 전용 모드

  이 모드에서는 컨트롤 바를 제외한 모든 플레이어 UI가 숨겨집니다.

• 오디오 포스터 모드

  이 모드에서는 재생 중에 포스터 이미지가 영구적으로 표시됩니다. 플레이어 크기는 이 모드에서 비디오 플레이어와 동일하게 유지됩니다.

두 모드를 동시에 활성화할 수 없습니다.

• 플레이어 구성에서audio_only_mode및audio_poster_mode를 모두 true로 설정하면오디오 전용 모드가우선 적용됩니다.
• player.audioOnlyMode(true)또는 를 통해 프로그래밍 방식으로 한 모드를player.audioPosterMode(true)활성화하면 다른 모드가 활성화되어 있는 경우 다른 모드가 비활성화됩니다.

구현 세부 정보는 Brightcove Player 문서의 오디오 전용을 참조하십시오.

자동 사전

autoadvance정보:

• 데이터 형식: 문자열
• 기본값: 처음에 활성화되지 않음
• 재생 목록과 함께 사용되며 재생 목록의 자동 진행 동작을 설정합니다.

자세한 내용은 아래의재생 목록섹션과재생 목록 API문서를 참조하십시오.

자동 재생

autoplay정보:

• 데이터 형식: 부울 또는 문자열
• 기본값: false
• 플레이어가 허용되는 플랫폼에서 즉시 플레이를 시작해야 함을 나타냅니다.

autoplay가 부울 값으로 설정된 경우 브라우저의 기본 자동 재생 동작이 사용됩니다. 다음 세 가지 유효한 문자열 값 중 하나로 설정된 경우 다음과 같은 결과가 발생합니다.

• play : 플레이어는 수동으로 플레이를 호출하려고 시도합니다.
• muted : 플레이어는 수동으로 플레이어를 음소거하고 재생을 호출합니다.
• any : 플레이어는 먼저 플레이를 호출하려고합니다. 실패하면 플레이어를 음소거하고 재생을 호출합니다.

위 중 하나라도 실패하면 자동 재생이 false로 설정된 것처럼 플레이어는 “빅 플레이 버튼”을 표시합니다.

다음은autoplay값을 설정하는 curl 문을 보여줍니다.

부울 값을 사용하는 예

  curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
      "autoplay": true
      }' \
  https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

문자열 값을 사용하는 예

  curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
      "autoplay": "muted"
      }' \
  https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

자동 재생에 비디오를 가져 오는 것은 복잡한 상황이 될 수 있습니다. 자세한 내용은자동 실행 고려 사항문서를 참조하십시오.

값을 설정하는 다른 방법:

block_robots

block_robots정보:

• 데이터 유형: 부울
• 기본값: undefined
• Brightcove Player 6.51.0 이상에서만 사용할 수 있습니다.
• 참이면 다음을 추가합니다. <메타> 태그를 iframe 내장 HTML에 추가하여 Google 크롤러와 같은 로봇이 iframe 내장 HTML의 콘텐츠를 인덱싱하지 못하도록 합니다.

true 인 경우 다음이 추가됩니다.

<meta name="robots" content="noindex,nofollow">

china_proxy_domain

china_proxy_domain정보:

• 데이터 형식: 문자열
• 기본값: undefined
• 제공된 경우 이 도메인은 플레이어가 대체 호스트 이름을 통해 Brightcove 서비스에 대한 요청을 라우팅하는 데 사용됩니다. 예를 들면 다음과 같습니다.

  "china_proxy_domain": "china.example.com"

context_menu

context_menu정보:

• 데이터 유형: 부울 또는 개체
• 기본값: true
• true 또는 객체인 경우 플레이어는 마우스 오른쪽 버튼을 두 번 클릭하거나 길게 터치할 때마다 활성화되는 상황에 맞는 메뉴를 포함합니다. 이 상황에 맞는 메뉴는 플레이어 정보 모달 또는 Brightcove 기업 웹사이트 링크를 열 수 있습니다. 상황에 맞는 메뉴 사용에 대한 자세한 내용은 Brightcove Player 정보 모달 문서를 참조하십시오.

  개체인 경우 다음 속성이 지원됩니다.

  부동산	효과
  brightcove_branding	로 설정할 수 있습니다. 거짓제거하기 위해 명시적으로브라이트코브 소개사용자 정의 상황에 맞는 메뉴에서 링크.

  예:

  "context_menu": {
    "brightcove_branding": false
  }

교차 원점

crossorigin정보:

• 데이터 유형: 부울
• 기본값: 거짓
• true의경우, 기본< 비디오 > 요소는교차 원산지 = “익명”이됩니다 . 즉, 플레이어로 가져온 모든 비디오 또는 텍스트 트랙에는 CORS 헤더가 있어야합니다.

값을 설정하는 다른 방법:

CSS 색상 재정의

플레이어의 색상을 재정의하는 데 사용할 수있는 세 가지 속성이 있습니다. 그들은 다음과 같습니다:

• controlColor : 버튼과 텍스트의 색상 (예: 재생 헤드 위치 및 비디오 지속 시간)
• controlBarColor : 컨트롤 바의 배경색과 큰 재생 버튼
• progressColor : 진행률 표시 줄의 색상

유효한 CSS 색상 (예: 16 진수 색상 포함) 은 이러한 속성에 허용되는 값입니다.

다음은 CSS 속성 세 가지를 모두 녹색으로 설정하고 결과를 표시하는 스크린 샷을 설정하는 curl 문입니다.

  curl \
  --header "Content-Type: application/json" \
  --user $EMAIL \
  --request PATCH \
  --data '{
      "css": {
        "controlColor": "green",
        "controlBarColor": "green",
        "progressColor": "green"
      }
  }' \
  https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

디버그

debug정보:

• 데이터 유형: 부울
• 기본값: false
• true 이면 플레이어가 디버그 모드에 놓입니다. 이것은 재생 엔진 및 분석과 같은 다양한 플레이어 구성 요소에 대한 로깅을 켜는 데 사용할 수 있습니다.

디버거

이 속성은 더 이상 사용되지 않습니다. context_menu 를 참조하세요.

delivery_config_id

delivery_config_id정보:

• 데이터 형식: 문자열
• 기본값: undefined
• Dynamic Delivery Rules 구성 ID입니다.

값을 설정하는 다른 방법:

도크

dock정보:

• 데이터 유형: 부울
• 기본값: 참
• 명시 적으로false , 플레이어는 비디오 제목과 설명을 표시 할 수있는 소위독을포함하지 않습니다.

임베디드_id

embed_id정보:

• 데이터 형식: 문자열
• 기본값: undefined
• 이 플레이어와 연결된 비디오 클라우드 임베드 ID입니다. 값이 인default경우 플레이어가 하위 플레이어가 아니라는 것을 의미합니다. 값이 아닌default경우 플레이어의 부모를 나타내는 값입니다.

값을 설정하는 다른 방법:

오류

errors정보:

• 데이터 유형: 오브젝트 또는 부울
• 기본값: 참
• 명시 적으로 설정false플레이어가 videojs 오류 , 오류 메시지 플러그인입니다. 이 값을 false로 설정하면 오류가 발생할 때 플레이어가 최종 사용자에게 자세한 오류 메시지를 표시하지 않습니다. 재생을 방해하는 오류는 웹 개발자 콘솔에 계속 표시됩니다.

fullscreen_control(또는 fullscreenControl)

fullscreen_control정보:

• 데이터 유형: 부울
• 기본값: 참
• 컨트롤 막대에 전체 화면 컨트롤을 표시할지 여부를 나타냅니다. false 인 경우 두 번 클릭하여 전체 화면으로 전환하는 작업도 비활성화됩니다.

다음은fullscreen_control값을 설정하는 curl 문을 보여줍니다.

  curl \
  --header "Content-Type: application/json" \
  --user $EMAIL \
  --request PATCH \
  --data '{
    "autoplay": true,
    "fullscreen_control": false
    }' \
  https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

다음 두 개의 스크린 샷은 전체 화면 컨트롤이 있거나없는 플레이어를 보여줍니다.

HLS

hls정보:

• 데이터 유형: 오브젝트 또는 부울
• 기본값: {}
• 만약false , 플레이어는비디오 HTTP-스트리밍을포함하지 않습니다. 그렇지 않으면 객체가비디오 - HTTP 스트리밍을위한옵션으로 전달됩니다.

initial_bandwidth

initial_bandwidth정보:

• 데이터 유형: 숫자
• 기본값: undefined
• 6.53.0 이상에서만 사용 가능
• 낮은 대역폭 또는 높은 대역폭 시나리오를 선호하도록 재생 엔진의 렌디션 선택을 프라이밍하는 데 사용되는 초당 비트 수 값을 설정합니다.

언어

language정보:

• 데이터 형식: 문자열
• 기본값: undefined
• 를 설정하기 위해 제공될 수 있습니다. lang의 속성<html> iframe 삽입의 요소 및 따라서 플레이어의 언어입니다.

값을 설정하는 다른 방법:

언어

languages정보:

• 데이터 유형: 문자열 배열
• 기본값: undefined
• 지정된 언어가 플레이어에 포함되도록 하는 문자열 배열일 수 있습니다. 유효한 언어는 Video.js 포함된 언어뿐입니다. 자세한 내용은브라이트코브 플레이어 현지화문서를 참조하십시오.

값을 설정하는 다른 방법:

루프

loop정보:

• true 이면 비디오가 끝나자마자 다시 시작됩니다.

값을 설정하는 다른 방법:

미디어

media속성은 객체 또는 객체 배열일 수 있으며 다음 표와 같이 하위 속성을 가집니다.

예

단일 소스 예:

"media": {
  "height": "300px",
  "poster": {
    "highres": "//path/to/poster.jpg"
  },
  "src": "//path/to/some/media-file.mp4",
  "width": "600px"
}

여러 소스 예:

"media": {
  "height": "300px",
  "poster": {
    "highres": "//path/to/poster.jpg"
  },
  "sources": [{
    "src": "//path/to/some/media-file.mp4",
    "type": "video/mp4"
  }, {
    "src": "//path/to/some/media-file.webm",
    "type": "video/webm"
  }],
  "width": "600px"
}

다중 미디어 개체 예:

"media": [{
  "height": "300px",
  "src": "//path/to/some/media-file.mp4",
  "width": "600px"
}, {
  "height": "300px",
  "sources": [{
    "src": "//path/to/some/media-file.mp4",
    "type": "video/mp4"
  }, {
    "src": "//path/to/some/media-file.webm",
    "type": "video/webm"
  }],
  "width": "600px"
}]

실제로 재생되는 소스에 대한 자세한 내용은 재생할 렌디션 결정 문서를 참조하십시오.

이currentSrc()기능을 사용하여 재생 중인 소스를 확인할 수 있습니다. 다음 스크린 샷은 브라우저 콘솔에서 기능을 사용하는 방법을 보여줍니다.

트랙이 있는 미디어 개체 예:

"media": {
  "height": "300px",
  "poster": {
    "highres": "//path/to/poster.jpg"
  },
  "sources": [{
    "src": "//path/to/some/media-file.mp4",
    "type": "video/mp4"
  }, {
    "src": "//path/to/some/media-file.webm",
    "type": "video/webm"
  }],
  "tracks": [{
    "src": "//path/to/captions.vtt",
    "srclang": "en",
    "label": "English"
  }],
  "width": "600px"
}

다음 JSON에서 다음을 포함하는media속성을 볼 수 있습니다.

• 포스터.하이어속성
• 두 개의 소스 객체를 포함하는 소스 속성 (하나는 HLS 비디오용이고 하나는 MP4 비디오용입니다)

  "media": {
    "poster": {
      "highres": "http://solutions.brightcove.com/bcls/assets/images/Tiger.jpg"
    },
    "sources": [{
      "type": "application/x-mpegURL",
      "src": "http://solutions.brightcove.com/bcls/assets/videos/Tiger.m3u8"
    }, {
      "type": "video/mp4",
      "src": "http://solutions.brightcove.com/bcls/assets/videos/Tiger.mp4"
    }]
  },

음소거

muted정보:

• 데이터 유형: 부울
• 기본값: 거짓
• 플레이어가 로드될 때 사운드가 음소거되는지 여부를 결정합니다.

값을 설정하는 다른 방법:

그림 컨트롤

picture_in_picture_control정보:

• 데이터 유형: 부울
• 기본값: 참
• 기본 제공 화면 속 화면 컨트롤을 컨트롤 막대에 표시할지 여부를 나타냅니다.

재생 버튼

play_button정보:

• 데이터 유형: 개체
• 기본값: undefined
• 사용자 지정 플레이어 버튼 스타일에 대한 CSS 클래스 추가, Brightcove Player 버전 5+ 전용

개체 속성:

플레이백 레이트

playback_rates정보:

• 데이터 유형: 어레이
• 기본값: 없음
• 재생 속도 컨트롤에 표시할 재생 속도의 배열입니다.

값을 읽은 다음 플레이어의 컨트롤 바에 있는 재생 속도 컨트롤에 표시됩니다.

Studio 또는 curl을 사용하여 속성 값을 변경할 수 있습니다.

  curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
        "playback_rates": [0.1,1,2.5,6]
       }' \
    https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

플레이어

player정보:

• 데이터 유형: 객체
• 기본값: 플레이어 특정 정보로 채우기
• 이 플레이어에 대한 다양한 메타 데이터가 포함되어 있으며 가장 관련성이 높은 항목은 다음 표에 나열되어 있습니다.

부동산	유형	효과
비활성	부울	true 인 경우 플레이어는 콘텐츠 소유자가 플레이어를 비활성화했음을 설명하는 오류 메시지와 함께 회색 상자로 표시됩니다. 자세한 내용은 이 표 아래의 비활성 세부 정보 내용을 참조하십시오.
템플릿 버전	끈	플레이어가 빌드된 템플릿 버전 번호입니다. 다음을 사용하여 플레이어 버전을 수동으로 설정할 수 있습니다. 선수기준 치수 JSON 편집기 .
in_page_embed_url	끈	인페이지 삽입에 사용되는 기본 URL

비활성 세부 정보

플레이어를 비활성 상태로 만들 수 있습니다. 이렇게 하면 플레이어가 콘텐츠 제공을 중지할 수 있지만 삭제된 플레이어를 찾아볼 경우 404 오류가 나타나지 않도록 할 수 있습니다.

플레이어를 비활성화하려면 다음과 같이player필드의inactive속성을 로 설정합니다. true

            curl \
            --header "Content-Type: application/json" \
            --user $EMAIL \
            --request PATCH \
            --data '{
              "player": {
                  "inactive": true
              }
            }' \
            https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

물론 플레이어를 활성화하려면inactive속성을 로 설정할 수false있습니다.

플레이어가 비활성화되면 사용자가 플레이어를 탐색하면 다음과 같은 메시지가 나타납니다.

플레이어_이드

player_id정보:

• 데이터 형식: 문자열
• 플레이어와 연결된 비디오 클라우드 플레이어 ID

값을 설정하는 다른 방법:

플레이어 이름

player_name정보:

• 데이터 형식: 문자열
• 플레이어와 연결된 Video Cloud 플레이어 이름

플레이싱라인

playsinline정보:

• 데이터 유형: 부울
• 기본값: 거짓
• 인라인/비네이티브 플레이어 재생(예: iOS)에 대해 playsinline 속성이 필요한 플랫폼에서 플레이어가 인라인 재생을 허용할지 여부를 결정합니다.

값을 설정하는 다른 방법:

플러그인

plugins배열은 video.js 플러그인을 초기화하는 순서와 해당 플러그인에 적용할 사용자 지정 설정을 지정합니다. 플러그인은 해당scripts속성 URL 항목과 필요한 경우 지원stylesheets URL에 의해 지원되어야합니다. plugins배열의 각 요소는name속성을 가진 객체입니다.

예를 들어 플러그인 속성이 다음과 같이 나타나는 경우:

"plugins": [{
  "name": "foo",
  "options": {
    "bar": true
  }
}]

런타임에 foo 플러그인은 제공된 옵션으로 초기화됩니다.

player.foo({bar: true});

플러그인 개체에 포함된 모든 스크립트 또는 스타일시트는 최상위 스크립트 또는 스타일시트와 동일한 방식으로 인라인됩니다. 최상위 자산 앞에 인라인됩니다.

옵션 속성 세부 정보

이options하위 속성에서는 초기화할 때 사용할 데이터를 전달합니다. 다음 JSON은 의 단일 객체를 전달합니다options .

  "plugins": [{
    "name": "navigateOnVideoEnd",
    "options" : {"redirectURL": "http://docs.brightcove.com"}
  }]

이렇게하면 플레이어 구성을 통해 플러그인에 데이터를 전달할 수 있습니다. 예를 들어 위에 표시된redirectURL객체를 사용하려면 플러그인 자체에서 다음을 수행합니다.

  videojs.registerPlugin('navigateOnVideoEnd', function (options) {
    var myPlayer = this;
    myPlayer.on("ended", function () {
      window.location.href = options.redirectURL;
    });
  });

참고: 표준 플러그인 구현을 사용하지만 익명 함수에서는 매개options변수로 사용합니다. 그런 다음options.propertyName표기법을 사용하여 값에 액세스 할 수 있습니다.

브라이트코브가 제공하는 일부 플러그인은 플러그인 레지스트리를 사용하며 구성은 여기에 표시된 것과 다릅니다. 개요 보기: 자세한 내용은 플러그인 레지스트리문서를 참조하십시오.

프리로드

preload정보:

• 데이터 형식: 문자열
• 기본값: none
• preload 속성은 비디오 태그가로드되는 즉시 비디오 데이터 다운로드를 시작해야하는지 여부를 브라우저에 알립니다. 옵션은자동 , 메타데이터및없음입니다 .

옵션 세부정보

• 자동 : 사용자가 결국 비디오를 보지 않더라도 전체 비디오 파일을 다운로드 할 수 있음을 나타냅니다. 긍정적 인 측면에서 시청자가 비디오를 재생하면 즉시 재생을 시작할 수 있습니다. 부정적인 측면에서이 옵션은 시청자가 비디오를 재생하지 않더라도 프리로드/로드가 발생하므로 대역폭 소비를 증가시킵니다.

• 메타데이터 (기본값): 비디오의 지속 시간 및 크기와 같은 정보를 포함하는 비디오의 메타 데이터를로드합니다. 이 설정은 몇 초의 비디오 데이터도 로드합니다.

• 없음 : 비디오 데이터를 미리 로드하지 마십시오. 사용자가 재생을 클릭하여 다운로드를 시작할 때까지 대기합니다.

값을 설정하는 다른 방법:

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

쿼리 문자열_to_창

query_string_to_window정보:

1. • 이름: query_string_to_window.target
   • 데이터 형식: 문자열
   • 설명: 창에 생성 할 대상 객체이며 구문 분석 된 전체 쿼리 문자열로 채워집니다. 예를 들어, 플레이어 구성에서query_string_to_window.target다음과 같은 사용:

       {
       "query_string_to_window": {"target": "queryStringParams"}
       }

     다음 쿼리 문자열이 주어졌습니다.

       ?foo=bar&nums=1&nums=2

     는 플레이어와 플러그인에서 다음과 같은window.queryStringParams전역 객체를 사용할 수 있습니다.

       {
       foo: 'bar',
       nums: ['1', '2']
       }

2. • 이름: query_string_to_window.globals
   • 데이터 유형: 어레이
   • 설명: 쿼리 문자열에있는 값으로 채워질 창 객체의 속성 이름의 배열입니다. window객체 또는 프로토 타입 체인에 이미 존재하는 일치하는 속성은 설정되지 않습니다. 예를 들어, 플레이어 구성에서query_string_to_window.globals다음과 같은 사용:

       {
       "query_string_to_window": {
         "globals": [
           "foo",
           "nums",
           "self"
         ]
       }
       }

     를 호출하고 다음 쿼리 문자열을 제공하십시오.

       ?foo=bar&nums=1&nums=2&self=not-allowed

     다음과 같은 속성이 추가 된 다음window전역 객체를 생성합니다.

       window.foo; // 'bar'
       window.nums; // ['1', '2']
       
       // Because `self` already exists on the `window` object, it will not be set
       // and a warning will be logged to the browser console.
       window.self; // window

반복

repeat정보:

• 데이터 유형은boolean
• 플레이어가 재생 목록 플레이어인 경우 재생 목록이 반복됩니다. 즉, playlist 속성을 사용하는 경우입니다.
• 플레이어 구성의 최상위 레벨에서 설정합니다.

스크립트

scripts정보:

• 데이터 유형은 플레이어에 포함 된 JavaScript 파일을 참조하는 문자열의 배열입니다
• 기본값 없음
• 플레이어가 빌드 될 때 이러한 파일은 다운로드되고 결과 출력에 인라인되므로 런타임에 이후에 가져올 필요가 없습니다.
• 스크립트는 scripts 배열에 지정된 순서대로 인라인됩니다.

  "scripts": [
    "https://example.com/script.js",
    "https://example.com/depends-on-script.js"
  ]

• 스크립트는 지정된 순서로 인라인되므로 서로 의존하는 스크립트를 안전하게 포함할 수 있습니다.

피부

skin정보:

• 데이터 형식: 부울 또는 문자열
• 기본값: 정의되지 않음
• 플레이어가 사용할 비주얼 스타일 변형을 결정합니다. 이 값은 브라우저에서 전역적으로 액세스할 수 있는bc.SKIN속성에도 반영됩니다. 다음 값을 인식합니다.

  값	기원전 스킨	설명
  “흑연”	“흑연”	이전 브라이트코브 플레이어 스타일과 일부 호환성 해킹을 사용합니다.
  거짓	“없음”	모든 브라이트코브 플레이어 스타일을 비활성화합니다. 이 옵션은 처음부터 고도로 사용자 지정된 UI에 사용할 수 있는 옵션입니다.
  미정	루나 (소설)	이undefined설정을 그대로 두면 플레이어가 기본 스킨 (일명 루나).
  "사파이어"	"사파이어"	Video Cloud Studio를 사용하여 플레이어를 생성할 때의 기본 스킨이지만 플레이어 자체의 기본값은 아닙니다.

스타일시트

stylesheets정보:

• 플레이어에 포함되어야하는 CSS 파일을 참조하는 URL 문자열 배열
• 플레이어가 빌드 될 때 추가 스타일 시트가 다운로드되어 플레이어에 인라인되므로 런타임에 가져올 필요가 없습니다.
• 스타일시트는 스타일시트 배열에서 지정하는 순서대로 포함됩니다.

  "stylesheets": [
    "https://example.com/layout.css",
    "https://example.com/skin.css"
  ]

suppress_not_supported_error

suppress_not_supported_error정보:

• 데이터 유형: 부울
• 기본값: 정의되지 않음
• true 인 경우 소스를 재생할 수 없다는 초기 오류는 첫 번째 사용자 상호 작용까지 연기됩니다. 비디오를 재생할 수 없는 브라우저(예: Googlebot)의 오류를 숨기는 데 유용합니다.

tech_order(또는 techOrder)

tech_order정보:

• 데이터 유형: 어레이
• 기본값: ['html5', '플래시']
• 기본적으로 브라이트코브 플레이어는 비디오를 재생하기 위해 소스/기술 조합을 검색할 때 기술우선주문을 수행합니다. 즉, 소스가 두 개이고 기술자가 두 개인 경우 플레이어는 다음 재생 기술을 시도하기 전에tech_order옵션 속성의 첫 번째 기술로 각 비디오를 재생하려고 시도합니다. 가이드 보기: 자세한 내용은 재생 기술문서를 참조하십시오.

다음 curl 문을 사용하여 의tech_order기본값에서 로 변경할['html5','flash']수 있습니다['flash','html5'] .

  curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
        "tech_order": "['flash','html']"
       }' \
    https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

음

umd (Universal Module Definition)정보:

• 데이터 유형: 부울
• 기본값: 참
• Brightcove Player 6.53.0 이상에서만 사용 가능
• true 인 경우 RequireJS와 같은 모듈 시스템과 함께 사용하기 위해 플레이어 주위에 UMD(Universal Module Definition) 상용구를 추가합니다. 명시적으로 false 로 설정하면 플레이어는 모듈 로더와 함께 작동하지 않고 단순히 bc 전역 변수를 노출합니다.

볼륨 방향

volume_orientation정보:

• 데이터 형식: 문자열
• 기본값: 수평
• Brightcove Player 6.32.0 이상에서만 사용 가능
• 볼륨 레벨 슬라이더가 수평 또는 수직 방향인지 여부를 결정한다. volume_orientation

  

  

유효한 값은 다음과 같습니다.

Studio 또는 curl을 사용하여 속성 값을 변경할 수 있습니다.

  curl \
    --header "Content-Type: application/json" \
    --user $EMAIL \
    --request PATCH \
    --data '{
        "volume_orientation": "vertical"
       }' \
    https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

vttjs

vttjs정보:

• 데이터 형식: 문자열
• 기본 설정: CDN
• 이는 표준 Video.js 옵션 vtt.js 와 동일합니다. Brightcove Player는 플레이어 관리 API에서 점으로 구분된 속성 이름이 불가능하고 다른 곳에서 문제가 될 수 있으므로 대신 vttjs를 사용합니다.
• 플레이어 구성에서 data-vttjs 속성, vttjs iframe 쿼리 매개변수, vttjs 설정 옵션 또는 vttjs 로 설정할 수 있습니다.

대기 차단 탐지

wait_for_ad_block_detect정보:

• 데이터 유형: 부울
• 기본값: 정의되지 않음
• 로true설정하면 광고 블록 탐지가 결정을 내릴 때까지 플레이어는 자동 초기화 프로세스를 지연합니다. 이로 인해 플레이어 초기화가 최대 100밀리초 정도 지연될 수 있습니다. 다음으로 설정할 필요가 없습니다. true사용할 때ad_failover두 경우 모두 지연 동작이 발생합니다.