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

    이미지 및 동적 인제스트 API

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

    서문

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

    • 트랜스 코딩 중에 비디오 중간 지점에서 이미지 캡처
    • 비디오를 수집하는 동시에 또는 개별적으로 자신의 이미지를 수집합니다.

    설정

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

    요청 URL
        https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
    인증
    인증에는 액세스 토큰이교군꾼토큰권한 부여머리글:
        권한 부여: 전달자 {access_token}

    S3에 대한 참고 사항

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

    이미지 캡처

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

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

    부동산
    매체 유형 “이미지”
    상표 “포스터” 또는 “축소판” (각각에 대해 변환이 필요함)
    체재 “png”또는 “jpg”
    숫자 (픽셀)
    신장 숫자 (픽셀)

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

        {
          “미디어 유형”: “이미지”,
          “형식”: “jpg”,
          “라벨”: “포스터”,
          “너비”: 1280,
          “높이”: 720
        },
        {
          “미디어 유형”: “이미지”,
          “형식”: “jpg”,
          “레이블”: “썸네일”,
          “ 너비”: 160,
          “높이”: 90
        }

    또한 설정해야캡처 이미지요청 데이터에 플래그 지정진실 , 그러나 이것이 기본값입니다. 만약선택한 프로필에는 이미지 변환이 포함됩니다. (프로필에 이미지 변환이없는 경우 기본값은캡처 이미지이다그릇된 .)

    샘플 요청 데이터 :

        {
          “마스터”: {“URL”: "http://learning-services-media.brightcove.com/videos/mp4/Bird_Titmouse.mp4"},
          “프로필”: “다중 플랫폼 - 표준 - 정적”,
          "캡처 이미지": 참
        }

    동영상이 수집 된 후 이미지를 추가하기위한 샘플 요청 데이터

        {
            “프로필”: “다중 플랫폼 - 표준 - 정적”,
            “썸네일”: {
                "url": "http : //bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-thumbnail.png",
                “ 너비”: 160,
                “높이”: 90
            },
            “포스터”: {
                "url": "http : //bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-poster.png",
                “ 너비”: 1280,
                “높이”: 720
            }
        }

    이미지 수집

    Dynamic Ingest 요청 본문에 사용하는 JSON에서 URL을 참조하여 동영상에 대한 맞춤 포스터 및 미리보기 이미지를 포함 (또는 추가) 할 수도 있습니다.

        {
            “포스터”: {
                "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-poster.png",
                “ 너비”: 1280,
                “높이”: 720
            },
            “썸네일”: {
                "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-thumbnail.png",
                “ 너비”: 160,
                “높이”: 90
            }
        }

    자동 크기 조정

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

    자동 크기 조정 무시

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

    1. 계정에 대한새 사용자 지정 인제스트 프로필 만들기 (또는 기존 사용자 지정 프로필 수정)
    2. 다음이 포함 된 게시물 및 썸네일에 대한 이미지 변환 포함바로 그거죠이들신장값 :
          {
            “미디어 유형”: “이미지”,
            “형식”: “jpg”,
            “라벨”: “포스터”,
            “ 너비”: 9999,
            “ 높이”: 9999 
          },
          {
            “미디어 유형”: “이미지”,
            “형식”: “jpg”,
            “레이블”: “썸네일”,
            “ 너비”: 9999,
            “ 높이”: 9999 
          }
    3. 이것을 기본 프로필로 설정항상 원래 크기로 이미지를 저장하려는 경우 계정에 대해.

    이제 Studio 또는 Dynamic Ingest를 통해 커스텀 이미지를 추가하면 소스 이미지의 원래 크기를 갖게됩니다.

    제한 사항

    • 수집 시스템은 동일한 비디오에서 동시 작업을 허용하지 않습니다. 따라서 비디오가 인제트되거나 다시 코드 변환되는 동안 이미지를 업로드하려고 하면 이미지 업로드가 실패합니다.