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

    개요: 인제스트 프로파일 API

    이 주제에서는 Ingest Profiles API의 개요를 얻습니다. Ingest Profiles API를 사용하면 Video Cloud 계정에 대한 변환 프로필을 생성, 검색, 업데이트 및 삭제할 수 있습니다.

    수집 프로파일 관리

    인제 스트 프로파일은 비디오를 업로드하거나 다시 트랜스 코딩 할 때 트랜스 코딩을위한 사양으로 사용됩니다. Ingest Profiles API를 사용하여 이러한 프로필을 관리 할 수 있습니다.

    용어 설명

    프로필 JSON

    아래의 "프로필 JSON"이라는 용어는 프로필 개체의 JSON 표현을 의미합니다. 여기에는 최상위 프로필 필드와 rendition 개체 모음이 목록으로 포함됩니다. 보다표준 프로필모든 계정에 포함 된 표준 프로필에 대한 JSON을 확인하고콘텐츠 보안 (DRM 및 HLSe) DRM 패키징을 포함하는 샘플 프로필의 경우.

    프로필 ID

    profile id다음 중 하나 일 수 있습니다. id또는name프로필의 최상위 필드. 이 예에서 (프로필의 일부) :

        {
            "id": "5591b5ede4b0f7138939ad8c",
            "version": 4,
            "name": "screencast-1280",
            "description": "A high resolution profile optimized for screencasts with 1280 x 720 resolution.", ...

    "screencast-1280"또는 "5591b5ede4b0f7138939ad8c"는 모두 유효한 프로필 ID입니다. 처음으로 프로필을 만들 때 이름은 있지만 ID는없는 프로필을 제공하고 응답에는 해당 ID를 포함하여 만든 프로필이 포함됩니다. 그런 다음 후속 API 호출에서 둘 중 하나를 사용할 수 있습니다.

    참조 ID

    는 프로파일 내의 변환을reference_id고유하게 식별합니다. 참조 ID는 DRM 패키징에 사용되며 향후 다른 용도로 사용될 수 있습니다. 프로파일 내에서 고유 한 것 외에도 참조 ID는 임의의 문자열이 될 수 있습니다. 공백을 포함해서는 안됩니다. 변환 형식을 쉽게 식별 할 수있는 구성표를 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다. mp4_1 , mp4_2 , hls1 , hls2

    프로필 버전

    version A는 계정에 대한 프로파일의 개정 번호입니다. 긴 정수 값으로 표시됩니다. 참고 : JSON 표현에서는 인용되지 않습니다.

    활성 프로파일

    프로파일은 업로드에 사용할 수active있는지 여부입니다. 예를 들어, 프로필을 업데이트하면 활성화 된 버전 번호가 증가 된 새 프로필이 생성되고 이전 버전은 비활성화됩니다.

    표준 프로필

    프로필은 브라이트코브가 사용하도록 제공한standard경우 (즉, 단일 계정에만 적용되는 사용자 정의 프로필이 아님) 입니다.

    기본 프로필

    프로파일은default명시적으로 선택된 프로파일이 없을 때 사용되는 경우입니다. 계정 구성이 없거나 구성에 기본 프로필을 설정하지 않은 경우 Brightcove 중 하나standard계정 유형에 따라 프로필이 사용됩니다.

    기본 URL

    서비스 URL은 다음과 같습니다.

        https://ingestion.api.brightcove.com/v1/

    권한

    API에 대한 인증은 브라이트코브의 OAuth2 구현을 통해 이루어집니다. 계정에 대한 다음 작업에 대한 권한이있는 클라이언트 자격 증명 (클라이언트 ID 및 클라이언트 암호)이 필요합니다.

    • video-cloud/ingest-profiles/profile/read
    • video-cloud/ingest-profiles/profile/write
    • video-cloud/ingest-profiles/account/read
    • video-cloud/ingest-profiles/account/write

    client_idclient_secret를 얻으려면 OAuth UI로 이동하여 앱을 등록해야합니다.

    CURL 또는 우편 배달부를 통해 자격 증명을 얻을 수도 있습니다.

    클라이언트 자격 증명을 사용하여 API를 호출 할 수있는 액세스 토큰을 얻습니다. 액세스 토큰은 권한 부여 헤더에 전달됩니다.

        Authorization: Bearer {your_access_token}

    참조 Oauth 섹션자세한 내용은.

    최대 변환

    수집 프로필에서 정의 할 수있는 최대 변환 수는 25 개입니다. 이 수 이상을 정의하는 경우 요청은 오류 409 응답을 반환합니다. 프로필 변환 수가 구성된 변환 제한을 초과합니다.

    조건부 출력

    수집하는 비디오의 품질이 크게 다를 경우 (예 : 비디오에 저품질 카메라가 장착 된 휴대폰에서 만든 사용자 생성 콘텐츠가 포함될 수 있음) 일부 렌 디션 생성을 비트 전송률 또는 기타 속성 소스 비디오. 이렇게하면 중복 변환의 생성 및 저장이 방지됩니다. 보다조건부 출력이를 수행하는 방법에 대한 자세한 내용은

    계정 운영

    계정 수준에서 계정에 대한 모든 프로필을 가져 와서 새 프로필을 만들 수 있습니다.

    끝점

        /accounts/{account_id}/profiles

    모든 프로필 가져 오기

    계정에 대한 모든 프로필 (포함표준 프로필 ), 위에 표시된 엔드 포인트에 GET 요청을 제출합니다.

    프로파일 작성

    새 프로필을 생성하려면 요청 본문으로 프로필에 대한 JSON 데이터를 포함하여 위에 표시된 엔드 포인트에 POST 요청을 제출합니다. 참조샘플 프로필아래에 JSON 데이터의 예가 나와 있습니다. 프로필 필드 참조허용되는 필드.

    단일 프로필 작업

    개별 프로필의 경우 이름 또는 ID로 프로필을 가져오고 프로필을 교체하고 프로필을 삭제할 수 있습니다.

    끝점

        /accounts/{account_id}/profiles/{profile_id}

    에 대한profile_id , 다음 중 하나를 사용할 수 있습니다.

    • 이름 (예 : 균형 잡힌 고화질)
    • 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)

    아이디로 프로필 받기

    단일 프로필을 검색하려면 위에 표시된 엔드 포인트에 GET 요청을합니다.

    프로필 업데이트

    프로필을 업데이트하려면 다음을 포함하여 위의 끝점에 PUT 요청을합니다. 완전한요청 본문의 프로필에 대한 JSON 데이터입니다.

    프로필 삭제

    프로필을 삭제하려면 위의 엔드 포인트에 DELETE 요청을합니다.

    이 작업은뒤집을 수 없는

    기본 프로필 작업

    끝점을 사용하여 계정에 대한 기본 주문형 비디오 및 라이브 비디오 프로필을 가져 오거나 설정하거나 업데이트 할 수 있습니다.

        /accounts/{account_id}/configuration

    기본 프로필 가져 오기

    위의 끝점에 GET 요청을 수행하여 계정의 기본 프로필을 검색합니다.

    기본 프로필이 설정되지 않은 경우 시스템 기본 프로필이 반환됩니다.

    기본 프로필 설정

    기본 프로필을 설정하려면 요청 본문에 JSON을 포함하여 위에 표시된 엔드 포인트에 POST 요청을 수행합니다.

        {
          "account_id": {account_id},
          "default_profile_id": {default_profile_id}
        }

    에 대한default_profile_id , 다음 중 하나를 사용할 수 있습니다.

    • 이름 (예 : 균형 잡힌 고화질)
    • 생성 된 ID (예 : 54de14cce4b0a6d2bf9cb08a)

    기본 프로필 업데이트

    기본 프로필을 업데이트하려면 요청 본문에 다음 JSON을 포함하여 위에 표시된 엔드 포인트에 PUT 요청을 수행합니다.

        {
          "id": {configuration_id},
          "account_id": {account_id},
          "default_profile_id": {default_profile_id}
        }

    얻기configuration_id GET 또는 POST 요청에 대한 응답에서.

    기본 라이브 프로필 설정

    기본 라이브 프로필 설정은 요청 본문의 다음 변경 사항을 제외하고 기본 VOD 프로필 설정과 정확히 동일합니다.

        {
          "id": {configuration_id},
          "account_id": {account_id},
          "default_live_profile_id": {default_live_profile_id}
        }

    참고:

    • 존재하지 않는 프로필을 지정하면 요청이 실패합니다.

    샘플 프로필

    그만큼표준 프로필문서는 모든 Video Cloud 계정에 현재 존재하는 모든 기본 프로필을 보여줍니다.

    워터마크

    비디오에 워터 마크 (또는 로고 이미지)를 추가하려면 인제 스트 프로필에서 워터 마크 필드를 사용할 수 있습니다.

    다음은 워터 마크가있는 변환 프로필의 예입니다.

        ...
        "renditions": [
            {
              "media_type": "video",
              "id": "559697ece4b072e9641b8404",
              "reference_id": "mp0",
              "format": "mp4",
              "audio_codec": "aac",
              "audio_bitrate": 64,
              "video_codec": "h264",
              "speed": 3,
              "video_bitrate": 450,
              "decoder_bitrate_cap": 771,
              "decoder_buffer_size": 1028,
              "keyframe_rate": 0.5,
              "max_frame_rate": 30,
              "width": 480,
              "height": 270,
              "h264_profile": "baseline",
              "watermarks": [
                {
                  "y": "70%",
                  "width": "20%",
                  "url": "http://learning-services-media.brightcove.com/images/bc_logo.png"
                }
              ]
          }, ...

    필드에 대한 전체 설명은 <a href="https://zencoder.support.brightcove.com/encoding-settings/assets/encoding-settings-watermarks.html> 워터 마크 필드 참조 </a>를 참조하세요. </ p> </ section> </ article> <!-완전한 부트 스트랩 레이아웃-> </ div> <div class = "col-sm-2 right-side-bar">