지원 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    이미지와 Dynamic Ingest API

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

    소개

    XNUMX 가지 유형의 이미지를 수집하여 Video Cloud 동영상 :

    포스터
    포스터 이미지가 Brightcove Player 사용자가 동영상을 재생하기 전에 일반적으로 비디오에서 캡처 한 프레임이지만 반드시 그럴 필요는 없습니다.
    미리보기
    썸네일 이미지는 재생 목록, 종료 화면 등에 표시됩니다. 일반적으로 비디오에서 캡처 한 프레임이지만 반드시 그럴 필요는 없습니다.
    초상화
    일반적으로 전화 및 기타 장치에서 세로 모드의 포스터로 사용되는 이미지입니다. 필수 Brightcove Beacon. 사양에 대한 자세한 내용은 테이블 아래.
    광장
    일반적으로 채널 로고 또는 격자 표시로 사용되는 이미지. 필수 Brightcove Beacon. 사양에 대한 자세한 내용은 테이블 아래.
    넓은
    일반적으로 전화 및 기타 장치에서 가로 모드로 포스터로 사용되는 이미지입니다. 필수 Brightcove Beacon. 사양에 대한 자세한 내용은 테이블 아래.
    초광각
    일반적으로 TV와 같은 초광각 디스플레이에서 포스터로 사용되는 이미지입니다. 필수 Brightcove Beacon. 사양에 대한 자세한 내용은 테이블 아래.

    사양

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

    이미지 세부 사항 표
    거래증명방식 형성 종횡비 (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:

    • 이미지 캡처 트랜스 코딩 중 비디오의 중간 지점에서
    • 자신이 찍은 이미지를 동시에 섭취하거나 별도로 섭취하십시오.

    설정

    Dynamic Ingest 요청 설정은 비디오, 이미지, WebVTT 파일 또는 이들 모두를 처리하는 것과 동일합니다.

    요청 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에서 다이나믹 인제 스트 사용하기 자세한 내용은.

    다국어 변형

    다른 언어에 사용할 다른 버전의 이미지를 제공 할 수 있습니다. 이것은 다음에 의해 처리됩니다 Brightcove Beacon ...에 대한 Brightcove Beacon 앱. 의 일반적인 구현 Brightcove Player 현재는 맞춤형 개발이 필요합니다.

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

    이미지 수집

    동영상에 맞춤 이미지를 추가하는 방법은 다음과 같습니다.

    요청 본문의 이미지 필드

    수집 요청 본문의 이미지는 객체의 배열로 지정됩니다. 객체 속성은 다음 표에 자세히 설명되어 있습니다.

    이미지 객체 속성
    비즈니스 재산 강의 개요 거래증명방식 필수
    url 그 URL Video Cloud 에서 이미지를 검색 할 수 있습니다 가능 https://mysite.com/videos/video123/images/poster.png
    language 하위 태그의 이미지에 대한 언어 코드 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry (Brightcove 지원 센터에 문의하여 계정의 기본값을 설정할 수 있음) No
    variant 이 이미지의 유형 : poster | thumbnail | portrait | square | wide | ultra-wide 가능 wide
    height 번호 No 2160
    width 번호 No 3840
    {
          "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
            }
          ]
        }

    자동 크기 조정

    사용자 정의 포스터 및 / 또는 축소판 이미지를 Studio 또는 Dynamic Ingest API, 기본적으로 Video Cloud 계정의 기본 수신 프로필에 정의 된 이미지 크기와 일치하도록이 크기를 조정합니다.

    크기 조정 및 패딩은 유일한 수정 사항입니다. Video Cloud or Brightcove Beacon. 이미지가 잘리지 않습니다.

    재정의 자동 크기 조정

    이 동작을 무시하고 Video Cloud 실제 이미지 크기를 유지하려면 다음 단계를 따르십시오.

    1. 새 사용자 정의 인제 스트 프로파일 만들기 계정 용 (또는 기존 사용자 정의 프로파일 수정)
    2. 가지고있는 게시물 및 미리보기 이미지에 대한 이미지 번역 포함 정확하게 이들 widthheight 값 :
          {
            "media_type": "image",
            "format": "jpg",
            "label": "poster",
            "width": 9999,
            "height": 9999
          },
          {
            "media_type": "image",
            "format": "jpg",
            "label": "thumbnail",
            "width": 9999,
            "height": 9999
          }
    3. 이것을 기본 프로필로 설정하십시오. 항상 원래 크기로 이미지를 저장하려는 경우 계정 용으로

    이제 Studio 또는 Dynamic Ingest를 통해 사용자 정의 이미지를 추가하면 소스 이미지의 원래 크기가 적용됩니다.

    이미지 캡처

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

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

    또한 capture-images 귀하의 요청 데이터에서 true 트랜스 코딩 중 비디오에서 포스터 및 썸네일을 캡처하려는 경우 이것이 기본값입니다. if 선택된 프로파일은 이미지 표현을 포함한다. (프로파일에 이미지 변환이 없으면 capture-images is false.)

    샘플 요청 데이터 :

          {
            "master": { "url": "http://learning-services-media.brightcove.com/videos/mp4/Bird_Titmouse.mp4" },
            "profile": "multi-platform-standard-static",
            "capture-images": true
          }

    수집 프로파일의 이미지

    다음은 이미지 변환이 수집 프로파일에서 지정되는 방법에 대한 세부 사항입니다.

    비즈니스 재산 가치관
    media_type "영상"
    label "포스터"또는 "미리보기 이미지"(각각에 대한 번역 필요)
    format "png"또는 "jpg"
    width 숫자 (픽셀)
    height 숫자 (픽셀)

    다음은 두 가지 표현에 대한 샘플 데이터입니다.

                {
                  "media_type": "image",
                  "format": "jpg",
                  "label": "poster",
                  "width": 1280,
                  "height": 720
                },
                {
                  "media_type": "image",
                  "format": "jpg",
                  "label": "thumbnail",
                  "width": 160,
                  "height": 90
                }

    이미지 데이터 검색

    를 사용하여 이미지 데이터를 검색 할 수 있습니다 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, 지원 by Playback API 비디오 요청.

    12 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지