비디오 필드 참조

이것은 재생 API에서 반환한 비디오 필드에 대한 참조입니다.

기본 필드

표 1: 기본 필드
필드 유형 기본값 설명
id 문자열 없음 비디오 ID
account_id 문자열 없음 계정의 ID
created_at ISO 8601 날짜-시간 문자열 없음 동영상이 계정에 추가 된 날짜-시간입니다. 예: “2014-12-09T 06:07:11 .877Z”
cue_points cue_point 객체 배열 빈 배열 플레이어 API를 통해 생성 될 미드 롤 광고 요청 또는 기타 작업에 대한 마커
custom_fields 객체 빈 개체 사용자 지정 필드 이름 맵: 값 쌍, 값이 있는 필드만 포함
description 문자열 널 비디오에 대한 간략한 설명 - 최대 250자의 싱글바이트 문자
duration 번호 널 비디오 길이 (밀리 초)
economics 문자열 AD_SUPPORTED 동영상에 대한 광고 요청이 허용되는지 여부를 나타냅니다. 값: AD_SUPPORTED또는FREE
labels 문자열 배열 널 동영상에 할당된 라벨 배열
link 링크 개체 널 관련 링크
long_description 문자열 널 최대 5000개의 싱글바이트 문자
name 문자열 없음 동영상 제목-필수 입력란 (최대 256 자)
poster 문자열 널 포스터 이미지 URL
poster_sources 어레이 [] 동영상 포스터에 해당하는 개체의 배열입니다. 현재 포스터는 하나뿐이므로 하나의 개체가 있습니다. 객체에는src값이 포스터 이미지의 URL인 단일 속성이 있습니다.
published_at ISO 8601 날짜-시간 문자열 없음 동영상이 게시 된 날짜-시간입니다. 예: “2014-12-09T 06:07:11 .877Z”
reference_id 문자열 널 계정 내에서 고유 한 모든 값 (최대 150 자)
sources 어레이 비어 있는 배열 비디오 소스 객체 배열
tags 어레이 비어 있는 배열 동영상에 추가 된 태그 (문자열) 배열 (태그 당 최대 128 자)
text_tracks 텍스트_트랙 객체의 배열 비어 있는 배열 비디오와 관련된 WebVTT 캡션 데이터
thumbnail 문자열 널 썸네일 이미지 URL
thumbnail_sources 어레이 [] 동영상의 미리보기 이미지에 해당하는 개체의 배열입니다. 현재는 썸네일이 하나뿐이므로 하나의 개체가 있습니다. 객체에는src값이 썸네일 이미지의 URL인 단일 속성이 있습니다.
updated_at ISO 8601 날짜-시간 문자열 없음 동영상이 마지막으로 수정된 날짜/시간. [1-2] 예: “2015-01-13T 17:45:21 .977Z”
variants 정렬 [] 동영상에 대한 다국어 메타데이터를 포함하는 객체 배열

참고 사항

  • [1-2] 사용자 또는 Video Cloud 시스템에 의해 수정되었을 수 있습니다.

소스 개체

표 2: 소스 오브젝트 필드
필드 유형 기본값 설명
asset_id 문자열 없음 Video Cloud의 변환 ID
app_name 문자열 없음 RTMP 스트림의 RTMP 주소
avg_bitrate 정수 없음 변환의 평균 비트 전송률
codec 문자열 없음 비디오 코덱
container 문자열 없음 비디오 컨테이너 유형
duration 정수 없음 기간 (밀리 초)
key_systems 객체 없음 DRM 사양 개체 -이 개체가 정의 된 경우 해당 소스는 콘텐츠가 보호됩니다.
size 정수 없음 크기 (바이트)
src 문자열 없음 소스 URL
stream_name 문자열 없음 RTMP 스트림의 스트림 이름
type 문자열 없음 사용되는 통신 프로토콜을 정의하는 비디오 MIME 유형 - 값:
  • HLS: application/x-mpegURL
  • HLS: application/vnd.apple.mpegurl
  • 대시: application/dash+xml
  • MP4: video/mp4
width 정수 없음 변환의 픽셀 너비

cue_point 객체

표 3: 큐 포인트 개체 필드
필드 유형 기본값 설명
id 문자열 없음 큐 포인트 ID
name 문자열 널 큐 포인트의 선택적 이름 (최대 128 자)
type 문자열 AD 값: AD또는CODE
time 번호 없음 큐 포인트의 시간 (초)입니다. 예: 10.527
metadata 문자열 널 선택적 메타데이터 문자열 (1바이트 문자 최대 512자)
force-stop 부울 false 비디오가 큐 포인트에서 강제 중지되었는지 여부
표 4: 링크 객체 필드
필드 유형 기본값 설명
text 문자열 널 링크에 대한 텍스트 표시
url 문자열 널 링크 URL

text_track 객체

표 5: 텍스트 트랙 필드
필드 유형 기본값 설명
src 문자열 (URL) 널 .vtt 파일이있는 URL
srclang ISO-639-1 언어 코드 널 캡션 언어
label 문자열 널 플레이어 메뉴에서 사용할 레이블-캡션과 동일한 언어 여야합니다.
kind 스트링 널

트랙 사용 방법: subtitles , captionsdescriptions , chapters , metadata

이러한 값에 대한 자세한 내용은 미디어 모듈 문서를 사용하여 비디오에 캡션 추가를 참조하십시오.
mime_type 문자열 널 캡션의 mime_type [9-1]
default 부울 false 이 값을 true로 설정하면 플레이어 메뉴의 기본 캡션 파일이 됩니다.

참고

  • [9-1] mime_type 설정은 선택 사항이지만 캡션은 UTF-8로 인코딩되어야하며 mime_type은 "text / vtt"여야합니다.

key_systems오브젝트

key_systems 객체에는 각 DRM 키 이름마다 하나씩 객체 목록이 들어 있습니다. 이 개체가 정의 된 경우 해당 소스는 콘텐츠가 보호됩니다.

표 4: 키_시스템 오브젝트
필드 유형 기본값 설명
키 이름 객체 널 DRM 타입을 지정하는 오브젝트 이름 — 유효한 키는 다음과

같습니다.* FairPlay: com.apple.fps.1_0
* PlayReady: com.microsoft.playready
* Widevine: com.widevine.alpha
페어플레이 용도key_request_url및certificate_url
기타 용도license_url		 문자열 널 DRM 라이선스 또는 인증서가있는 URL
 

예 1:

    "key_systems": {
      "com.apple.fps.1_0": {
        "key_request_url": "https://....",
        "certificate_url": "https://..."
      }
    }

예 2:

    "key_systems": {
      "com.microsoft.playready": {
        "license_url": "https://..."
      },
      "com.widevine.alpha": {
        "license_url": "https://..."
      }
    },

variant객체

각variant버전에는 특정 언어의 비디오 메타데이터 버전이 들어 있습니다.

표 5: 변형 개체
필드 유형 기본값 설명
language 스트링 없음 언어-국가 형식의 이형 상품 언어 (예: ja-JA
name 문자열 없음 번역된 제목
description 끈 없음 번역된 설명
long_description 끈 없음 번역된 long_description
custom_fields 물체 {} 사용자 정의 필드에 대한 키-값 쌍의 맵

예

{
  "language": "ja-JA",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}