이미지 및 동적 인제스트 API

이 항목에서는 비디오 용 이미지를 캡처하거나 수집하는 방법에 대해 설명합니다.

서문

두 가지 범주의 이미지를 수집할 수 있습니다.

  • 요청 본문에 다음과 같이 정의된 기본/기본 포스터 및 썸네일 이미지poster그리고thumbnail객체(필드 및 구문 세부 정보는 아래에 있음)
  • 객체images배열에 정의된 다국어 변형 이미지 (필드 및 구문 세부 정보는 아래 참조)

다국어 변형 이미지에는 다음과 같은 6가지 유형이 있습니다.

포스터
사용자가 비디오를 재생하기 전에 포스터 이미지가 Brightcove Player에 표시됩니다. 일반적으로 비디오에서 캡처 된 프레임이지만 반드시 그럴 필요는 없습니다.
썸네일
썸네일 이미지는 재생 목록, 최종 화면 등에 표시됩니다. 일반적으로 비디오에서 캡처 된 프레임이지만 반드시 그럴 필요는 없습니다.
초상화
일반적으로 휴대 전화 및 기타 기기에서 세로 모드의 포스터로 사용되는 이미지입니다. 브라이트코브 비콘에 필요합니다 . 사양의 세부 사항은테이블아래에.
광장
일반적으로 채널 로고 또는 그리드 디스플레이로 사용되는 이미지입니다. 브라이트코브 비콘에 필요합니다 . 사양의 세부 사항은테이블아래에.
넓은
일반적으로 휴대 전화 및 기타 기기에서 가로 모드의 포스터로 사용되는 이미지입니다. 브라이트코브 비콘에 필요합니다 . 사양의 세부 사항은테이블아래에.
초광각
일반적으로 TV와 같은 초광각 디스플레이의 포스터로 사용되는 이미지입니다. 브라이트코브 비콘에 필요합니다 . 사양의 세부 사항은테이블아래에.

사양

아래 표는 이미지 사양을 제공합니다.

기본 이미지 세부정보
유형 포맷 종횡비 (W / H) 최소 너비 (픽셀)
포스터 png 또는 jpg 16:9 또는 4:3 640
썸네일 png 또는 jpg 16:9 또는 4:3 160
다국어 변형 이미지 세부정보
유형 포맷 종횡비 (W / H) 최소 너비 (픽셀)
포스터 jpg 또는 png 경기 비디오 없음
썸네일 jpg 또는 png 경기 비디오 없음
초상화 jpg 또는 png 0.6667 (2x3) 500
광장 jpg 또는 png 1.0 (1x1) 500
넓은 jpg 또는 png 1.7778 (16x9) 2000
초광각 jpg 또는 png 2.3333 21x9 2000

Dynamic Ingest API를 사용하여 동영상에 기본 포스터 및 썸네일 이미지를 추가하는 두 가지 방법이 있습니다.

  • 트랜스코딩 중에 비디오의 중간지점에서 이미지를 캡처합니다 (현재는poster및thumbnail이미지에 적용됩니다. 다른 유형은 섭취해야 함). 기본 포스터 및 썸네일의 캡처 이미지는 다국어 변형을 위해 수집된 이미지와 함께 사용할 수 있습니다.
  • 비디오를 수집하는 동시에 또는 별도로 자신의 이미지를 수집합니다. 비디오를 수집한 후 이미지를 수집하는 경우 이미지를 수집하기 전에 비디오 처리가 완료될 때까지 기다려야 합니다.

설정

비디오, 이미지, WebVTT 파일 또는 다음 모두를 수집하는지 여부에 관계없이 Dynamic Ingest 요청 설정은 동일합니다.

요청 URL
    https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
인증
인증에는 다음으로 전달된 액세스 토큰이 필요합니다. Bearer토큰Authorization머리글: 
    Authorization: Bearer {access_token}

S3에 대한 참고 사항

보호 된 S3 버킷에서 이미지를 가져 오는 경우 Video Cloud가 파일에 액세스 할 수 있도록 버킷 정책을 설정해야합니다. 자세한 내용은 S3에서의 동적 인제스트사용을참조하십시오.

다국어 변형

다른 언어에 사용할 다른 버전의 이미지를 제공 할 수 있습니다. 이는브라이트코브 Beacon앱용 브라이트코브 Beacon에서 처리합니다. Brightcove Player의 일반 구현에는 현재 사용자 정의 개발이 필요합니다.

이미지의 언어는 다음 섹션에서 자세히 설명하는language속성에 지정되어 있습니다.

이미지 수집

다음은 비디오에 대한 사용자 지정 이미지 추가에 대한 세부 정보입니다.

요청 본문의 이미지 필드

위에서 언급한 것처럼 기본 포스터 및 축소판 이미지는 요청 본문의 최상위 개체로 지정됩니다. 수집 요청 본문의 다국어 변형 이미지는 객체 배열로 지정됩니다. 개체 속성은 다음 표에 자세히 설명되어 있습니다.

기본 포스터 및 썸네일 이미지
부동산 설명 유형 필수 예
url 이미지를 검색할 수 있는 공개 URL 스트링 https://some.site.com/images/celtic-lullaby-large.png
width 화상의 폭 (픽셀 단위) 숫자 1920
Height 이미지의 높이 (픽셀 단위) 숫자 1080
다국어 이미지 개체 속성
부동산 설명 유형 필수 예
url Video Cloud가 이미지를 검색 할 수있는 URL 끈 https://mysite.com/videos/video123/images/poster.png
language https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry 하위 태그의 이미지 언어 코드 (Brightcove 지원팀에 문의하여 계정에 기본값을 설정할 수 있음). 포함되지 않은 경우 계정의 기본 언어가 사용됩니다. 끈
variant 이 이미지의 유형: poster | | thumbnailportrait | square | wide | ultra-wide 끈 wide
height 숫자 2160
width 숫자 3840

샘플 요청 본문

아래 샘플 요청 본문에는 이미지 필드만 포함되어 있습니다. 다른 수집 필드도 포함될 수 있습니다.

{
			"poster": {
				"url": "https://some.site.com/images/celtic-lullaby-large.png",
				"width": 1400,
				"height": 1400
			},
			"thumbnail": {
				"url": "https://some.site.com/images/celtic-lullaby-large.png",
				"width": 160,
				"height": 90
			},
	    "images":[
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/poster.jpg",
            "variant": "poster",
            "height": 1080,
            "width": 1920
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/thumbnail.jpg",
            "variant": "thumbnail",
            "height": 108,
            "width": 292
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/square.jpg",
            "language": "de",
            "variant": "square",
            "height": 570,
            "width": 570
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/wide.jpg",
            "language": "fr",
            "variant": "wide",
            "height": 1440,
            "width": 2560
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/portrait.jpg",
            "language": "es",
            "variant": "portrait",
            "height": 1200,
            "width": 800
        },
        {
            "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/ultra-wide.jpg",
            "language": "hi",
            "variant": "ultra-wide",
            "height": 1646,
            "width": 3840
        }
      ]
    }
샘플 응답

아래는 CMS API Get Video Images 요청 에 대한 응답입니다. 아래의 이미지 데이터 검색을 참조하십시오.

{
  "thumbnail.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
        "height": 108,
        "width": 292
      }
    ]
  },
  "ultra-wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
        "height": 857,
        "width": 2000
      }
    ]
  },
  "wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
        "height": 1125,
        "width": 2000
      }
    ]
  },
  "portrait.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
        "height": 750,
        "width": 500
      }
    ]
  },
  "poster.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
        "height": 1080,
        "width": 1920
      }
    ]
  },
  "square.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
        "height": 500,
        "width": 500
      }
    ]
  },
  "poster": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
        "height": 1400,
        "width": 1400
      }
    ]
  },
  "thumbnail": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
        "height": 90,
        "width": 160
      }
    ]
  },
  "ultra-wide.hi": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
        "height": 1646,
        "width": 3840
      }
    ]
  },
  "wide.fr": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
        "height": 1440,
        "width": 2560
      }
    ]
  },
  "portrait.es": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
        "height": 1200,
        "width": 800
      }
    ]
  },
  "square.de": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
        "height": 570,
        "width": 570
      }
    ]
  }
}

자동 크기 조정

Studio 또는 Dynamic Ingest API를 통해 커스텀 포스터 및 / 또는 썸네일 이미지를 추가하면 기본적으로 Video Cloud는 계정의 기본 인제 스트 프로필에 정의 된 이미지 크기와 일치하도록 크기를 조정합니다.

크기 조정 및 패딩은 비디오 클라우드 또는브라이트코브 Beacon의 유일한 수정 사항이라는 점에유의하십시오. 이미지는 잘리지 않습니다.

이미지 캡처

트랜스 코딩 중에 Video Cloud는 중간 지점에서 비디오의 스냅 샷을 캡처하여 포스터 및 썸네일 이미지로 저장할 수 있습니다.

사용자 정의 수집 프로파일의 경우 이미지 캡처를 사용하려면 사용중인 수집 프로파일에 두 개의 특수 변환을 추가해야합니다. 보다수집 프로필의 이미지아래에.

당신은 또한 설정해야합니다capture-images요청 데이터에 플래그를 지정하여true트랜스코딩 중에 비디오에서 포스터와 썸네일을 캡처하려는 경우(기본값임) 만약에선택한 프로필에는 이미지 변환이 포함됩니다. (프로필에 이미지 변환이 없는 경우 기본값은capture-images입니다false .)

샘플 요청 데이터:

      {
        "master": { "url": "https://some.site.com/videos/mp4/Bird_Titmouse.mp4" },
        "profile": "multi-platform-standard-static",
        "capture-images": true
      }

수집 프로필의 이미지

poster및thumbnail이미지의 경우에만 인제스트 프로필에 이미지 변환을 포함해야 합니다. 비디오를 인제스트할 때 사용하든 나중에 트랜스코딩할 때 사용하든 관계없이 자동 캡처를 위한 것입니다. 이미지 변환은 모든 표준 수집 프로필에 포함되므로 이 섹션은 사용자 지정 수집 프로필에만 적용됩니다.

다음은 수집 프로필에서 이미지 변환을 지정하는 방법에 대한 세부 정보입니다.

부동산 값
media_type “이미지”
label “포스터” 또는 “축소판” (각각에 대해 변환이 필요함)
format “png”또는 “jpg”
width 숫자 (픽셀)
height 숫자 (픽셀)

다음은 변환에 대한 샘플 데이터입니다.

"images": [
	{
		"label": "square",
		"height": 500,
		"width": 500
	},
	{
		"label": "ultra-wide",
		"height": 1714,
		"width": 4000
	},
	{
		"label": "wide",
		"height": 2250,
		"width": 4000
	},
	{
		"label": "portrait",
		"height": 3000,
		"width": 2000
	},
	{
		"label": "thumbnail",
		"height": 90,
		"width": 160
	},
	{
		"label": "poster",
		"height": 1080,
		"width": 1920
	}
]

이미지 데이터 검색

CMS API를 사용하여 이미지 데이터를 검색할 수있습니다.

그만큼CMS API이미지 데이터를GET요청하다https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}또는 이미지 데이터만 원하는 경우https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/images

두 경우 모두 응답의 이미지 데이터는 다음과 같습니다.

{
  "thumbnail": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
        "height": 90,
        "width": 160
      }
    ]
  },
  "poster": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
        "height": 720,
        "width": 1280
      }
    ]
  },
  "portrait.es": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
        "height": 1200,
        "width": 800
      }
    ]
  },
  "thumbnail.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
        "height": 108,
        "width": 292
      }
    ]
  },
  "poster.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
        "height": 1080,
        "width": 1920
      }
    ]
  },
  "square.de": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
        "height": 570,
        "width": 570
      }
    ]
  },
  "ultra-wide.hi": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
        "height": 1646,
        "width": 3840
      }
    ]
  },
  "wide.fr": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
        "height": 1440,
        "width": 2560
      }
    ]
  }
}

제한 사항

  • 처리 시스템에서는 동일한 비디오에서 동시 작업을 수행할 수 없습니다 .
  • 현재 와이드, 정사각형, 세로 및 초광각 변형에 대한 이미지 데이터는 CMS API에서만 반환됩니다. 아니 Playback API 비디오 요청에 의해.