지원 문의
시스템 상태소개
그리고, Playback API 웹 페이지 또는 모바일 앱에서 비디오 또는 재생 목록 데이터를 가져 오는 데 클라이언트 측에서 사용하기 위해 만들어진 대기 시간이 짧은 API입니다. 그것은 지원 통합에 사용할 일반 미디어 관리 API Video Cloud CMS 또는 다른 시스템과 함께 사용하면 CMS API.
그리고, Playback API 재생 가능한 동영상 만 반환하도록 결과가 필터링됩니다 (상태 = ACTIVE, 처리 완료 플래그 = true, 예약 된 경우 올바른 데이터 / 시간). 이것은 player 다른 사람이 아직 처리 중이더라도 하나의 변환이 존재하자마자 비디오를 재생할 수 있습니다. 현재 재생할 수없는 비디오를 가져와야하는 경우 다시 CMS API 대신.
또한 성능을 극대화하기 위해 Playback API 짧은 기간 동안 캐시됩니다. 캐시 된 특정 데이터 세트 ID의 기간은 다양하지만 최대 20 분입니다.
또한 API 참조.
사용 사례
그리고, Brightcove Player 그리고 Brightcove SDK players 의 방법과 동일한 카탈로그 방법을 포함하십시오. Playback API, 그리고 대부분의 경우 런타임에 재생할 비디오 나 재생 목록을 검색하는 경우에 사용할 수 있습니다.
그러나 모바일 앱 화면에서 비디오 또는 재생 목록보기를 제공 할 수 있습니다. player 존재합니다.
또한 동영상이나 재생 목록을 검색하여 동영상이나 재생 목록에 대한 정보를 표시하려는 경우가있을 수 있습니다. player 예를 들어 동영상 포털의 방문 페이지로
그리고, Playback API 이 경우 유용합니다.
일반 정보
기본 URL
의 기본 URL Playback API 입니다
https://edge.api.brightcove.com/playback/v1
계정 경로
모든 경우에있어 요청은 특정 Video Cloud 계정. 그래서, 당신은 항상 용어를 추가 할 것입니다. accounts 계정 ID가 기본 URL에 이어집니다.
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}
인증
요청은 다음 세 가지 방법 중 하나로 전달 될 수있는 정책 키에 의해 인증됩니다.
- 에 대한 논쟁에서
Accept헤더:Accept: application/json;pk={policy_key}이것은 브라우저 기반 클라이언트에 권장되는 방법입니다. 브라우저 CORS의 "비행 전"검사의 일환으로 추가 요청없이 먼저 요청을 진행할 수 있기 때문입니다. 이렇게하면 브라우저 요청이 처음으로 생성 될 때 대기 시간이 절약됩니다.
- 에서
Authorizationrealm 키워드를 사용한 헤더BCOV-Policy:Authorization: BCOV-Policy {policy_key} - 안에
BCOV-Policy헤더:BCOV-Policy: {policy_key}
정책 키 얻기
정책 키를 얻는 방법에는 세 가지가 있습니다.
- 모든 브라이트 코브 player 자동으로 할당됩니다. 당신은에 대한 지침을 찾을 수 있습니다 player의 정책 키 이 문서. 정책 키는 계정 전체에 적합하기 때문에 정책 키와 관계없이 사용할 수 있습니다. player 페이지에 포함되어 있습니다.
- 다음을 사용하여 기본 정책 키를 생성 할 수 있습니다. 정책 키 빠른 시작
- 당신은에 요청할 수 있습니다. Policy API
토큰 인증
HLS 및 DASH 내용에 대한 토큰 인증이 지원됩니다. 토큰 인증이 필요한 경우 계정 관리자에게 토큰 인증을 사용하도록 설정하는 방법을 문의하십시오.
하드 코딩 된 URL 피하기
미리보기 이미지, 포스터, 비디오 파일 및 기타 미디어의 URL은 페이지 나 응용 프로그램에 하드 코드되어서는 안됩니다. 그만큼 Playback API 미디어 파일 용 최신 캐시 버전의 URL을 반환하지만 URL 자체는 변경 될 수 있습니다. 당신은 CMS API (또는 Playback API ) 페이지가로드 될 때마다 이러한 URL을 검색하도록 요청하거나 6 시간 이상 캐시하지 않습니다.
비디오 및 이미지 URL 캐싱
동영상 및 이미지의 URL을 캐시하여 페이지 성능을 향상시킬 수 있지만 캐시를 정기적으로 새로 고쳐야합니다. 검색 한 URL을 캐시하여 페이지 성능을 향상 시키려면 6 시간마다 한 번 이상 API 호출을 반복하여 캐시를 새로 고쳐야합니다.
행동 양식
API는 다음 유형의 다음 GET 요청 만 지원합니다.
동영상 요청
단일 비디오 객체는 비디오 ID 또는 참조 ID를 사용하여 검색 할 수 있습니다.
ID별로 비디오 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}
예
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/38467382999
샘플 응답
{
"account_id": "107767373999",
"ad_keys": null,
"created_at": "2010-07-12T22:37:34.760Z",
"description": "Avatar_MakingAScene_Featurette",
"duration": 595560,
"id": "38467382999",
"long_description": null,
"name": "Avatar_MakingAScene_Featurette",
"published_at": "2010-07-12T22:37:34.760Z",
"reference_id": "AvatarMakingShort",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"tags": [
"copied"
],
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
}, ... 6 more sources ...
]
}
참조 ID로 동영상보기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}
예
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/ref:nature_2010-07-12
샘플 응답
{
"account_id": "107767373999",
"ad_keys": null,
"created_at": "2010-07-12T22:37:34.760Z",
"description": "Avatar_MakingAScene_Featurette",
"duration": 595560,
"id": "38467382999",
"long_description": null,
"name": "Avatar_MakingAScene_Featurette",
"published_at": "2010-07-12T22:37:34.760Z",
"reference_id": "nature_2010-07-12",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"tags": [
"copied"
],
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
}, ... 6 more sources ...
]
}
동영상 검색
당신은 검색 가능 정책 키,를 사용하여 동영상을 검색 할 때 Playback API. 자세한 내용은 Playback API 참고 문서를 참조하시기 바랍니다.
매개 변수
모든 매개 변수는 선택. 그들은에 적용한다 GET Videos 요청 만.
| 매개 변수 | 설명 |
|---|---|
q |
검색어에 대한 검색어 문자열 - 자세한 내용은 검색 가이드 |
limit |
반환 할 동영상 수 - 1와 100 사이의 정수 여야합니다. 기본값 : 20 |
offset |
건너 뛸 비디오 수 (페이징 결과). 양의 정수 여야합니다. 기본값 : 0 |
sort |
정렬 할 필드를 지정하는 문자열. 로 시작 - 내림차순 정렬.에 대한 값이 q 가 제공되면 기본 정렬은 "점수"(검색 결과와 원래 쿼리의 관련성)입니다.값이없는 경우 q 이 제공되면 기본 정렬은 updated_at 내림차순.다음 필드는 정렬에 유효합니다. name, reference_id, created_at, published_at, updated_at, schedule_starts_at, schedule_ends_at, state, plays_total및 plays_trailing_week자세한 내용은 비디오 가져 오기 의 섹션 Playback API 참고 |
검색 매개 변수 사용
브라이트 코브 Playback API 귀하의 동영상을 검색 할 수있는 프로그램 방식을 제공합니다. Video Cloud 도서관.
비디오 데이터에 대한 기본 및 복잡한 검색을 수행하려면 q 매개 변수 :
https://edge.api.brightcove.com/playback/v1/accounts/1752604051111/videos?q={search terms}
동영상을 검색하는 방법에 대한 자세한 내용은 동영상 검색 문서를 참조하시기 바랍니다.
페이징 결과
사용 limit 매개 변수를 사용하여 요청에서 반환 할 항목 수를 지정합니다 (최대 100까지). 그런 다음 offset 매개 변수보다 큰 결과 집합을 페이징하는 매개 변수 limit. 그만큼 offset 건너 뛸 항목 수입니다.
예를 들어 다음 검색은 총 결과 집합에 적어도 51 개의 동영상이 있다고 가정하고 총 결과 집합의 동영상 75-75을 반환합니다.
/videos?q=updated_at:2014-01-01..2014-06-30&limit=25&offset=50
그리고, limit 및 offset 매개 변수는 동영상에만 사용할 수 있습니다.
페이징 모범 사례
결과 집합을 페이징 할 때 Playback API다음 단계를 따르는 것이 좋습니다.
- 사용
limit및offset매개 변수를 사용하여 결과 집합에서 데이터 그룹을 반환합니다./accounts/578380111111/videos?q=tags:nature&limit=20&offset=50 - 각 응답마다
count입력란에는 항상 결과 집합의 최대 동영상 수가 표시됩니다.{"count": 171, "videos": [ ... ] } - 전체
count첫 번째 요청의 동영상 수를 사용하여 요청해야하는 페이지의 수를 결정할 수 있습니다.
다른 방법으로,count각 응답과 함께count페이지 크기 곱하기보다 작거나 같음limit.count <= page-number * limit
동영상 검색 결과 정렬
매개 변수 사용 sort=field_name 결과를 정렬하는 방법을 지정합니다. 다음 비디오 필드를 정렬 할 수 있습니다.[1-1]
- 이름
- reference_id
- created_at
- published_at
- updated_at
- schedule_starts_at (참고 : 이것은 종류 분야 - 검색 필드
schedule.starts_at) - schedule_ends_at (참고 : 이것은 종류 분야 - 검색 필드
schedule.ends_at) - 상태
- plays_total[1-2]
- plays_trailing_week[1-2]
노트
- [1-1] 비디오 검색 호출에 정렬 값을 제공하지 않으면 결과는 관련성에 따라 정렬됩니다. 에 대한 정렬 값을 제공하지 않으면
GET동영상이 전화를 걸면 검색 결과는updated_at내림차순. - [1-2] 정렬 할 수 있습니다.
plays_totalorplays_trailing_week,이 필드는 결과에 포함되지 않습니다.
모든 동영상 및 대용량 데이터 세트
계정의 모든 동영상 또는 다수의 동영상을 검색하는 경우 알아 두어야 할 몇 가지 사항이 있습니다.
- 허용되는 최대 허용량을 사용하려고 할 수 있습니다.
limit(100)하지만 25 이하의 동영상을 검색하여 API 요청 시간이 초과 될 가능성을 최소화하는 것이 좋습니다 - 대용량 데이터 세트를 통해 페이징 할 때 작동 중에 비디오 데이터가 업데이트되어 항목이 응답에서 벗어날 수 있습니다.
- 연속되는 페이지에서 반복되는 항목을 볼 수 있습니다.
- 이전 응답 세트로 이동했기 때문에 항목을 놓칠 수 있습니다.
첫 번째 가능성을 설명하기 위해 동영상 검색을 마친 후에 앱에서 전체 항목 목록을 중복 제거해야합니다. 두 번째 가능성을 처리하려면 검색 한 총 항목 수 (중복 제거 후)를 예상 한 수와 비교 한 다음 요청을 다시 실행하고 last_modified_date (내림차순)로 결과를 정렬해야합니다. 누락 된 항목을 선택하기 위해 둘 이상의 배치를 검색하십시오.
- 반환 된 결과를 적절하게 정렬하여 이전 항목에서 시나리오의 가능성을 줄일 수 있습니다. 기본 정렬 기준 관련성 검색은 키워드, 태그 및 사용자 정의 필드 값의 조합을 찾는 복잡한 알고리즘을 기반으로합니다. 여러 키워드, 태그 및 / 또는 사용자 정의 필드를 기반으로 동영상을 검색하는 경우 관련성에 따른 정렬은 원하는 것입니다. 그러나 방금 또는 모든 동영상 세트를 검색하려는 경우
sort매개 변수를 명시 적으로 사용하면 반환 된 항목의 순서를보다 세부적으로 제어 할 수 있습니다.
비디오 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos
예
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos?q=tags:nature,name:nature
샘플 응답
{
"count": 123,
"videos":
[
{<video1 fields>},
{<video2 fields>},
...
]
}
오류 응답
검색이 가능하지 않은 정책 키와 함께 비디오 가져 오기 엔드 포인트를 사용하려고하면 다음 오류 메시지가 나타납니다. Playback API:
[
{
"api_call": "search",
"error_subcode": "API",
"error_code": "ACCESS_DENIED",
"message": "Access to this resource is forbidden by access policy."
}
]
관련 동영상 찾기
그리고, Playback API 지정된 동영상과 관련된 동영상을 계정에서 검색 할 수 있습니다. 를 기반으로 name 및 short description API는 지정된 동영상의 다음 부분에서 부분 일치를 검색합니다.
nameshort descriptionlong descriptiontags
지리적 제한이 적용되는 경우 결과의 전체 페이지를받지 못할 수 있습니다.
매개 변수
GET 관련 동영상 요청에는 다음 URL 매개 변수를 사용할 수 있습니다.
| 매개 변수 | 설명 |
|---|---|
limit |
반환 할 동영상 수 (기본값 = 20, 최대 = 100) |
ad_config_id |
반환 할 ad_config_id를 추가하십시오. SSAI가있는 비디오 |
기본적으로 응답에는 최대 20 개의 동영상이 포함됩니다. 귀하는 limit 매개 변수를 사용하여 최대 100 개의 동영상을 재생할 수 있으며 대기 시간이 길어질 수 있습니다.
아무런 offset 매개 변수를 사용하여 관련 동영상을 찾을 수 있으므로 동영상 결과를 페이지별로 볼 수 없습니다.
동영상 ID를 사용하여 관련 동영상 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}/related
예
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001/related
참조 ID를 사용하여 관련 동영상 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}/related
예
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/ref:nature/related
샘플 응답
아래의 응답에서 count 필드와는 달리 동영상 검색 응답.
{
"videos":
[
{<video1 fields>},
{<video2 fields>},
...
]
}
오류 응답
검색 할 수없는 정책 키와 함께 관련 엔드 포인트 찾기를 사용하려고하면 다음 오류 메시지가 표시됩니다. Playback API:
[
{
"api_call": "search",
"error_subcode": "API",
"error_code": "ACCESS_DENIED",
"message": "Access to this resource is forbidden by access policy."
}
]
SSAI의 비디오 요청
Brightcove 웹을 사용하지 않는 경우에도 player 또는 애플리케이션의 Brightcove Native SDK를 사용하더라도 SSAI (Server-Side Ad Insertion)를 자체적으로 사용할 수 있습니다 player.
SSAI로 비디오보기
SSAI로 동영상을 반환하려면 광고 구성 ID를 URL 매개 변수로 추가하십시오. Playback API 의뢰. 이 요청을 통해 동영상 ID 또는 동영상 참조 ID를 사용할 수 있습니다.
URL 매개 변수가있는 끝점
당신을 추가하십시오 ad_config_id 끝까지 Playback API 요청 :
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}?ad_config_id={ad_config_id}
예
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001?ad_config_id=1234abcd
아래 샘플 응답에서 다음 사항을 알 수 있습니다.
- 응답은 광고 설정 ID를 포함하지 않은 경우와 유사합니다.
- 의 요소
sources배열에 새 속성이 포함됩니다.vmap. - 콘텐츠에 광고가있는 위치를 알고 싶으면 해당 위치에 링크 된 VMAP 파일을 읽을 수 있습니다.
vmap재산. - 그리고,
src재산 내의sources배열에는 HLS 또는 DASH 소스에 대한 URL이 포함됩니다. 이는 광고 설정 ID가 사용되지 않았을 때의 응답과 동일하지만src주요 콘텐츠와 함께 광고가 스티치됩니다.
샘플 응답
{
"description": "The story of a giant rabbit with a heart bigger than himself. ",
"poster_sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/3723496277001/dd5bd69c-e962-4a43-9dbd-94faaaba1785/main/1280x720/5m17s130ms/match/image.jpg"
}
],
"tags": [],
"cue_points": [],
"custom_fields": {},
"account_id": "3723496277001",
"sources": [
{
"ext_x_version": "4",
"vmap": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/content.vmap?bc_token=NTllMTMxYjNfMTdkOTY2YThhNjU5MDk5ZTQ3NDBkNmUxOTYyOGRkNzM0ZjBiM2RjMGEwOThjOGFkYjk1MWQxMzFmNGYzMjA5YQ%3D%3D",
"type": "application/x-mpegURL",
"src": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/master.m3u8?bc_token=NTllMTMxYjNfZGM5ZDg0NGM2ZGJjZDcxZTFjOGYyODBlMzM2NmNmMmJkMWNhZDczNWViNzRiMjIwNjg5MjkzZGM0ZmJlMTc1Yw%3D%3D"
},
...
],
"created_at": "2017-05-15T17:09:11.171Z"
}
ad_config_id 필요
를 사용하여 Policy API, 정책 키를 생성 할 수 있습니다. ad_config_id 요청을 할 때 URL 매개 변수 Playback API. 이 기능 설정에 대한 자세한 내용은 Policy API 참고 문서를 참조하시기 바랍니다.
정책 키가 필요로 설정되면 ad_config_id, 당신은 그것을 Playback API 요청하면 다음 오류가 발생합니다.
[
{
"error_subcode": "AD_CONFIG",
"error_code": "ACCESS_DENIED",
"message": "Missing required ad_config_id parameter"
}
]
재생 목록 요청
재생 목록 동영상 개체는 재생 목록 ID 또는 참조 ID를 사용하여 검색 할 수 있습니다.
매개 변수
다음 URL 매개 변수는 재생 목록 요청에 사용될 수 있습니다.
| 매개 변수 | 설명 |
|---|---|
| 제한 | 반환 할 동영상 수 (기본값 = 20, 최대 = 100) |
| 오프셋 | 건너 뛸 비디오 수 (재생 목록의 시작 부분에서 기본값 = 0) |
예를 들어, 귀하의 요청에 추가 된 이러한 매개 변수는 -? limit = 40 & offset = 20 - 재생 목록에 동영상 21-60을 반환합니다 (그 수가 많다고 가정).
ID별로 재생 목록 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/{playlist_id}
예
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/38467382999
샘플 응답
참조 ID별로 재생 목록 가져 오기
종점
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/ref:{reference_id}
예
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/ref:nature_2010-07-12
샘플 응답
캡션
자막은 동영상에 액세스하려는 개인에게 추가 정보를 제공합니다. 캡션은 청각 장애인 및 청각 장애인이 비디오의 오디오 부분에 액세스하는 데 필요합니다. 새로운 자막 인 경우 개요 : 비디오에 자막 추가 문서를 참조하시기 바랍니다.
외부 WebVTT
외부 WebVTT 캡션은 비디오와 별도의 텍스트 파일입니다. 다음과 같이 캡션 파일을 비디오와 연결할 수 있습니다.
샘플 응답
다음은 Playback API 여기서 WebVTT 캡션 파일이 Media 모듈을 사용하여 비디오에 추가되었습니다. 텍스트 트랙 src 속성은 외부 캡션 파일을 가리 킵니다.
{
"text_tracks": [
{
"mime_type": null,
"account_id": "20318290001",
"default": true,
"sources": [
{
"src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856"
}
],
"src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856",
"asset_id": null,
"label": "English",
"id": "13d66def-d004-4e75-b160-4ac693eff7d7",
"kind": "captions",
"srclang": "en"
}
],
}
In-manifest WebVTT
In-manifest WebVTT 캡션이 비디오와 함께 처리됩니다. 이 작업은 비디오를 처음 처리하거나 비디오를 처리 한 후에 수행 할 수 있습니다. 다음과 같이 매니페스트 내부 캡션을 만들 수 있습니다.
샘플 응답
다음은 Playback API WebVTT 캡션 파일이 Dynamic Ingest API. 텍스트 트랙 src 속성은 내부 Brightcove 파일을 가리 킵니다.
{
"text_tracks": [
{
"mime_type": "text/webvtt",
"account_id": "1752604059001",
"default": false,
"sources": [
{
"src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
},
{
"src": "https://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
}
],
"src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173",
"asset_id": null,
"label": "EN",
"id": "92cb36a7-c836-4506-a87f-f649316c0cdf",
"kind": "captions",
"in_band_metadata_track_dispatch_type": "",
"srclang": "en"
}
],
}
적하 목록
HLS 또는 DASH 비디오 파일의 매니페스트에는 WebVTT 캡션을 포함하는 데 필요한 정보도 들어 있습니다.
HLS
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-0",NAME="en (Main)",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/8b12c808-c5ea-47f3-abfa-c23b023db297/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfNzAwNTczOWM4MWQ4Mzk2NjFkYjVjYmFhYjQwNzY2MWUzM2MyNDM5ZDA5ZGExYTFkMzRmYzA0MDdhOTlmZWJhMw%3D%3D"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="EN",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/rendition.m3u8?fastly_token=NWE3YjU3ZThfNDYzOThkZGJiZTU1NTlhOTdkYzA5OTA3M2UzZGRlYTgzMmRkZmUxMGIxYTJkY2Y5ZDQ1ODFiNTEyMmNiZDVhMw%3D%3D"
#EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=519200,CODECS="mp4a.40.2,avc1.420015",RESOLUTION=480x270,AUDIO="audio-0",CLOSED-CAPTIONS=NONE,SUBTITLES="subtitles-0"
https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/5f7850d9-9a65-4eee-8810-86a1e18e05fb/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfY2Q5YmE2ODc2OWFiNTgyZjUxMjc1MzRhNmQxMzA0ZmJmY2RlMGU4ZjBiNDExZGRmNjc3YjQ0OGQ5N2RiOTVmMA%3D%3D
DASH
<AdaptationSet mimeType="text/vtt" lang="en">
<Representation bandwidth="256" id="92cb36a7-c836-4506-a87f-f649316c0cdf">
<BaseURL>http://bcboltbde696aa-a.akamaihd.net/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf.vtt?akamai_token=exp=1518032494~acl=/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a*~hmac=3e2edc412c273f1255f2c18bbbcee7afc6a2edb74573f9295b0f05feda69f0e2</BaseURL>
</Representation>
</AdaptationSet>