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

    이미지와 Dynamic Ingest API

    이 항목에서는 이미지를 캡처하거나 가져 오는 방법에 대해 설명합니다.

    소개

    사진을 사용하여 동영상에 포스터 및 미리보기 이미지를 추가하는 두 가지 방법이 있습니다. 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에서 다이나믹 인제 스트 사용하기 자세한 내용은.

    이미지 캡처

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

    사용자 지정 렌더링의 경우 이미지 캡처를 사용하려면 사용중인 수집 프로필에 두 개의 특수 변환을 추가해야합니다. 새 렌 디션에는 다음과 같은 속성이 있어야합니다.

    비즈니스 재산 가치관
    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
        }

    또한 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
        }

    비디오가 수집 된 후 이미지를 추가하기위한 샘플 요청 데이터

        {
            "profile": "multi-platform-standard-static",
            "thumbnail": {
                "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-thumbnail.png",
                "width": 160,
                "height": 90
            },
            "poster": {
                "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-poster.png",
                "width": 1280,
                "height": 720
            }
        }

    이미지 수집

    또한 Dynamic Ingest 요청 본문에 사용하는 JSON의 URL을 참조하여 맞춤 포스터와 내 축소 이미지를 동영상에 추가하거나 추가 할 수 있습니다.

        {
            "poster": {
                "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-poster.png",
                "width": 1280,
                "height": 720
            },
            "thumbnail": {
                "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-thumbnail.png",
                "width": 160,
                "height": 90
            }
        }

    자동 크기 조정

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

    재정의 자동 크기 조정

    이 동작을 무시하고 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를 통해 사용자 정의 이미지를 추가하면 소스 이미지의 원래 크기가 적용됩니다.

    제한 사항

    • 처리 시스템에서 동일한 동영상에서 동시 작업을 허용하지 않습니다. 따라서 비디오를 처리하거나 다시 트랜스 코딩하는 동안 이미지를 업로드하려고하면 이미지 업로드가 실패합니다.

    페이지 마지막 업데이트 : 24 Oct 2020