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

    개요 : Ingest Profiles API

    이 항목에서는 Ingest Profiles API. 그만큼 Ingest Profiles API 당신을위한 렌 디션 프로파일을 생성, 검색, 업데이트 및 삭제할 수 있습니다. Video Cloud 계정입니다.

    수집 프로파일 관리

    인제 스트 프로필은 동영상을 업로드하거나 다시 트랜스 코딩 할 때 트랜스 코딩의 사양으로 사용됩니다. 이 프로필을 관리하려면 Ingest Profiles API.

    용어 해설

    JSON 프로파일

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

    프로필 ID

    A profile id 다음 중 하나 일 수 있습니다. id or 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

    A reference_id 프로필 내의 렌 디션을 고유하게 식별합니다. 참조 ID는 DRM 패키징에 사용되며 앞으로 다른 용도로 사용될 수 있습니다. 프로필 내에서 고유 한 것 외에도 참조 ID는 모든 문자열이 될 수 있습니다. 공백을 포함해서는 안됩니다. 예를 들어 다음과 같이 렌 디션의 형식을 쉽게 식별 할 수있는 체계를 사용하는 것이 좋습니다. mp4_1, mp4_2, hls1, hls2

    프로필 버전

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

    활성 프로필

    프로필은 active 업로드에 사용할 수있는 경우 예를 들어, 프로파일을 갱신하면, 증가 된 v 전 x 호가 활성이고 이전 v 전이 비활성 상태가되는 새 프로파일이 생성됩니다.

    표준 프로필

    프로필은 standard Brightcove에서 사용하도록 제공된 경우 (즉, 단일 계정에 특정한 사용자 지정 프로필이 아님).

    기본 프로필

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

    기본 URL

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

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

    권한 부여

    API 인증은 Brightcove의 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_secretOAuth UI로 이동하여 앱을 등록해야합니다.

    CURL 또는 Postman을 통해 자격 증명을 얻을 수도 있습니다. - 참조 :

    클라이언트 자격 증명을 사용하여 API 호출을 허용하는 액세스 토큰을 얻습니다. 액세스 토큰은 Authorization 헤더에 전달됩니다.

        Authorization: Bearer {your_access_token}

    을 참조 Oauth 섹션 문의주시기 바랍니다.

    최대 번역

    인제 스트 프로파일에서 정의 할 수있는 최대 표현 수는 25입니다. 해당 숫자 이상을 정의하면 요청은 409 응답 오류를 반환합니다. 프로필 재생 횟수가 구성된 재생 제한을 초과합니다.

    조건부 출력

    섭취하는 동영상의 품질이 크게 다른 경우 (예 : 동영상에 품질이 낮은 카메라가있는 휴대 전화에서 생성 된 사용자 제작 콘텐츠가 포함될 수 있음) - 비트 전송률 또는 일부 다른 속성에 대해 조건부로 변환을 생성 할 수 있습니다. 소스 비디오. 이렇게하면 중복 변환이 생성되고 저장되지 않습니다. 만나다 조건부 출력 이 작업을 수행하는 방법에 대한 자세한 내용은

    계정 운영

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

    종점

        /accounts/{account_id}/profiles

    모든 프로필 가져 오기

    계정의 모든 프로필을 가져 오려면 (를 포함하여 표준 프로필), 위의 엔드 포인트에 GET 요청을 제출하십시오.

    프로필 만들기

    새 프로파일을 작성하려면 프로파일의 JSON 데이터를 요청 본문으로 포함하여 위에 표시된 엔드 포인트에 POST 요청을 제출하십시오. 자세한 내용은 샘플 프로필 아래 JSON 데이터 예제 및 프로필 필드 참조 허용되는 필드에 대해.

    단일 프로필 작업

    개별 프로파일의 경우, 이름 또는 ID로 프로파일을 가져오고, 프로파일을 바 Y 고, 프로파일을 h 제할 수 있습니다.

    종점

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

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

    • 이름 (예 : 균형 잡힌 고화질)
    • generated id (e.g. 54de14cce4b0a6d2bf9cb08a)

    ID별로 프로필 가져 오기

    단일 프로파일을 검색하려면 위의 엔드 포인트에 GET 요청을 작성하십시오.

    프로필 업데이트

    프로파일을 갱신하려면, 위의 엔드 포인트에 대해 PUT 요청을 작성하십시오. 완전한 요청 본문의 프로필에 대한 JSON 데이터

    프로필 삭제

    프로파일을 h 제하려면 위의 엔드 포인트에 DELETE 요청을 작성하십시오.

    이 작업은 뒤집을 수 없는

    기본 프로필 작업

    엔드 포인트를 사용하여 계정의 기본 주문형 비디오 및 라이브 비디오 프로파일을 다운로드, 설정 또는 업데이트 할 수 있습니다.

        /accounts/{account_id}/configuration

    기본 프로필 가져 오기

    위의 엔드 포인트에 GET 요청을 작성하여 계정의 기본 프로파일을 검색하십시오.

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

    기본 프로필 설정

    기본 프로파일을 설정하려면 요청 본문의 JSON을 포함하여 위에 표시된 엔드 포인트에 POST 요청을하십시오.

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

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

    • 이름 (예 : 균형 잡힌 고화질)
    • generated id (e.g. 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"
                }
              ]
          }, ...

    을 참조


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