개요: 채널 API

채널 관리자 엔드포인트를 사용하여 Cloud Playout 채널을 생성하고 자산을 추가할 수 있습니다. & 라이브 이벤트를 재생 목록에 추가한 다음 채널을 활성화, 시작, 중지 및 삭제합니다.

요구 사항

비디오 클라우드에서 Cloud Playout API 인증 범위가 활성화된 등록된 애플리케이션입니다.( Studio UI -> Admin -> API Authentication )

CloudPlayoutChannelManager 워크플로 만들기

다음은 일반적인 Cloud Playout 채널 관리 워크플로입니다.

채널 만들기
재생 목록에 자산 및 라이브 이벤트 추가
채널 활성화
채널 시작
채널 중지
채널 삭제

이 외에도 Get channel은 채널 정보 확인에 도움이 됩니다. & 채널 상태.

채널 만들기

채널을 만들려면 채널 이름, 시작 시간, 입력과 같은 필수 속성이 필요합니다. & 출력 그룹, 지역 및 live_profile. DateTime 값은 ISO 8601 날짜 형식(UTC 또는 시간 오프셋 포함)에서 선호됩니다.

샘플 요청

요청

다음 주소로POST요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels

헤더

Content-Type: application/json
Authorization: Bearer {token}

요청 본문 - 일반적인 예

{
  "name": "channel name",
  "start_time": "2021-06-29T08:30:50.344Z",
  "input_group": [
    {
      "input_type": "playlist (or rtmp or slate)",
      "input_id": "dummy",
      "loop_on_completion": false
    }
  ],
  "live_profile": "your live profile",
  "output_group": [
    {
      "type": "rtmp or rtp",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "location": "bc_live or any live channel from your account"
        }
      ]
    },
    {
      "type": "s3",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "location": "s3 credential id"
        }
      ]
    }
  ],
  "region": "aws region"
}

요청 본문 - 기본 슬레이트를 사용하는 예

{
  "input_group": [
    {
      "input_type": "slate"
    },
    {
      "input_type": "rtmp"
    }
  ]
}

요청 본문 - 사용자 지정 슬레이트를 사용하는 예

{
  "input_group": [
    {
      "input_type": "slate",
      "input_id": "slate_asset_id OR https_slate_mp4_url"
    },
    {
      "input_type": "rtmp"
    }
  ]
}

샘플 응답

{
  "public_id": "79f0e7503fd64af3b7d2b0f825100f28",
  "name": "channel name",
  "description": "",
  "account_id": "Your account id",
  "state": "DRAFT",
  "status": null,
  "start_time": "2021-06-29 08:30:50 UTC",
  "stop_time": null,
  "input_groups": "playlist",
  "output_groups": "rtmp:s3",
  "loop_playlist": false,
  "playlist_id": "1703814612527248093",
  "channel_class": "single-pipeline",
  "ssai_enabled": true,
  "aws_region": "aws region",
  "message": null,
  "created_at": "2021-06-28 12:43:55 UTC",
  "updated_at": "2021-06-28 12:43:55 UTC",
  "image_url": "https://bc-cloudplayout-prod.s3.amazonaws.com/default_channel_image.png",
  "output_destinations": [
    "Brightcove Live"
  ],
  "channel_created_at": "2021-06-28 12:43:55 UTC",
  "channel_updated_at": "2021-06-28 12:43:55 UTC",
  "channel_created_by": "username@brightcove.com",
  "channel_updated_by": "username@brightcove.com"
}

필수 필드 외에도,,,,, 다음과 같이description설정할 수 있는 필드가 있습니다. stop_timessai_enabledimage_idmid_roll_import_enabledmid_roll_slot_time , 등. 다른 구성으로 채널을 생성하려면 Channels API 참조 의 예제를 참조하십시오.

라이브 리던던시가 있는 채널

라이브 모듈에서 Brightcove Live 중복 그룹 만들기

라이브 중복 그룹을 생성하려면 라이브 중복 사용을 참조하십시오. 위의 문서를 사용하여 중복 그룹을 생성하면 Cloud Playout에서 사용할 수 있습니다.

중복 그룹 자격 기준

Cloud Playout 채널 대상으로 사용할 수 있으려면 중복 그룹이 다음 기준을 충족해야 합니다.

중복 그룹에는 정확히 2개의 라이브 작업이 포함되어야 합니다.
중복 그룹의 두 라이브 작업은 모두 정적 진입점 유형이어야 합니다.
중복 그룹(및 그 안의 작업)은 대기 상태여야 합니다.
Cloud Playout 채널이 SSAI를 지원하는 경우 중복 그룹도 RTP-FEC 프로토콜을 사용하여 SSAI를 지원해야 합니다.

사용 가능 Brightcove Live 중복 그룹

계정에서 사용 가능한 Brightcove Live 중복 그룹 목록을 검색하려면 다음 주소로GET요청하십시오.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/bc_channels?redundancy=true

결과를 SSAI에 사용할 수 있는 중복 그룹으로 제한하려면ssai=true매개변수를 추가합니다.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/bc_channels?redundancy=true&ssai=true

Live redundancy로 채널 생성

요청 본문의output_group필드를 사용하여 Brightcove Live 리던던시 지원 채널을 만들 수 있습니다.

샘플 요청 본문

{
  "name": "channel name",
  "start_time": "2021-06-29T08:30:50.344Z",
  "input_group": [
    {
      "input_type": "playlist or rtmp or slate",
      "input_id": "dummy",
      "loop_on_completion": false
    }
  ],
  "live_profile": "your live profile",
  "output_group": [
    {
      "type": "rtmp or rtp",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "redundancy": true,
          "location": "bc_live/{EXISTING_BC_REDUNDANT_GROUP_ID}"
        }
      ]
    }
  ],
  "region": "aws region"
}

샘플 응답

{
  "public_id": "79f0e7503fd64af3b7d2b0f825100f28",
  "name": "channel name",
  "description": "",
  "account_id": "Your account id",
  "state": "DRAFT",
  "status": null,
  "start_time": "2021-06-29 08:30:50 UTC",
  "stop_time": null,
  "input_groups": "playlist",
  "output_groups": "rtmp",
  "loop_playlist": false,
  "playlist_id": "1703814612527248093",
  "channel_class": "single-pipeline",
  "ssai_enabled": true,
  "aws_region": "aws region",
  "message": null,
  "created_at": "2021-06-28 12:43:55 UTC",
  "updated_at": "2021-06-28 12:43:55 UTC",
  "image_url": "https://bc-cloudplayout-prod.s3.amazonaws.com/default_channel_image.png",
  "output_destinations": [
    "Brightcove Live with Redundancy"
  ],
  "channel_created_at": "2021-06-28 12:43:55 UTC",
  "channel_updated_at": "2021-06-28 12:43:55 UTC",
  "channel_created_by": "username@brightcove.com",
  "channel_updated_by": "username@brightcove.com"
}

라이브 중복을 활성화 또는 비활성화하도록 채널 업데이트

기존 채널에 대한 중복성을 활성화하거나 비활성화할 수도 있습니다. 핵심은redundancy에 플래그ingest_locations물체. 리던던시를 활성화하려면 로 설정해야 하며true , 채널의 리던던시를 비활성화하려면 디폴트false값이므로 리던던시를false설정하거나 아예 생략할 수 있습니다.

샘플 요청 본문

중복 활성화

{
  "output_group": [
    {
      "type": "rtmp or rtp",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "redundancy": true,
          "location": "bc_live/{EXISTING_BC_REDUNDANT_GROUP_ID}"
        }
      ]
    }
  ]
}

중복 비활성화

{
  "output_group": [
    {
      "type": "rtmp or rtp",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "location": "bc_live/{EXISTING_BC_REDUNDANT_GROUP_ID}"
        }
      ]
    }
  ]
}

redundancy위의 누락된 내용을 참고하십시오. 또는:

{
  "output_group": [
    {
      "type": "rtmp or rtp",
      "ingest_locations": [
        {
          "pipeline_id": 1,
          "redundancy": false,
          "location": "bc_live/{EXISTING_BC_REDUNDANT_GROUP_ID}"
        }
      ]
    }
  ]
}

채널 세부정보 가져오기

채널 세부 정보를 확인하고 중복성을 사용하고 있는지 확인하려면 다음 주소로GET요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}

샘플 응답(초안 상태)

{
  "public_id": "a7a58da9794a484a90a60c6c9b3a04a2",
  "name": "redundancy",
  "description": "test_cloudplayout_roebuck",
  "account_id": "70701684277202",
  "state": "DRAFT",
  "status": "",
  "start_time": "2022-02-17 12:53:48 UTC",
  "stop_time": null,
  "input_groups": "playlist",
  "output_groups": "rtmp",
  "loop_playlist": false,
  "playlist_id": "1725014456212124545",
  "channel_class": "single-pipeline",
  "ssai_enabled": null,
  "aws_region": "us-east-1",
  "message": "",
  "created_at": "2022-02-17 12:46:22 UTC",
  "updated_at": "2022-02-17 13:01:55 UTC",
  "image_url": "https://bc-cloudplayout-prod.s3.amazonaws.com/default_channel_image.png",
  "output_destinations": [
      "Brightcove Live with Redundancy"
  ],
  "channel_created_at": "2022-02-17 12:46:22 UTC",
  "channel_updated_at": "2022-02-17 12:46:22 UTC",
  "channel_created_by": "user@brightcove.com",
  "channel_updated_by": "user@brightcove.com",
  "import_captions_enabled": true,
  "live_profile": {
      "display_name": "Premium Live HD 1080p - Tier 2",
      "name": "premium-live-hd-1080p-tier-2",
      "date_created": "2018-06-04 18:16:44 UTC",
      "date_modified": "2018-06-04 18:16:44 UTC"
  },
  "channel_data": {
      "input_group": [
          {
              "input_type": "playlist",
              "value": "redundancy_testing_local",
              "description": "cloudplayout",
              "public_id": "1725014456212124545"
          }
      ],
      "output_groups": [
          {
              "type": "rtmp",
              "redundancy": true,
              "location": "bc_live/${Existing redundant group id}",
              "destination": "Brightcove Live with Redundancy"
          }
      ]
  }
}

샘플 응답(예약된 상태)

channel_data및 에 있는 여러 목적지를 확인하십시오outputs .

{
  "public_id": "e2d38b8304c84601b27630ae05b764b8",
  "name": "redundancy",
  "description": "test_cloudplayout_roebuck",
  "account_id": "70701684277202",
  "state": "SCHEDULED",
  "status": "Scheduled for start",
  "start_time": "2022-02-10 05:57:10 UTC",
  "stop_time": null,
  "input_groups": "playlist",
  "output_groups": "rtmp",
  "loop_playlist": false,
  "playlist_id": "1724281533777310596",
  "channel_class": "single-pipeline",
  "ssai_enabled": null,
  "aws_region": "us-east-1",
  "message": "",
  "created_at": "2022-02-09 10:36:51 UTC",
  "updated_at": "2022-02-09 10:49:03 UTC",
  "image_url": "https://bc-cloudplayout-prod.s3.amazonaws.com/default_channel_image.png",
  "output_destinations": [
      "Brightcove Live with Redundancy"
  ],
  "channel_created_at": "2022-02-09 10:36:51 UTC",
  "channel_updated_at": "2022-02-09 10:36:51 UTC",
  "channel_created_by": "Created by API",
  "channel_updated_by": "Updated by API",
  "import_captions_enabled": true,
  "live_profile": {
      "display_name": "Premium Live HD 1080p - Tier 2",
      "name": "premium-live-hd-1080p-tier-2",
      "date_created": "2018-06-04 18:16:44 UTC",
      "date_modified": "2018-06-04 18:16:44 UTC"
  },
  "channel_data": {
      "destinations": [
          {
              "id": "dest-rtmp-0",
              "url": "rtmp://d42f9b597f9f4cff90f3d48ddc665a02.sep-qa.a-live.io:1935/d42f9b597f9f4cff90f3d48ddc665a02",
              "stream_name": "alive"
          },
          {
              "id": "dest-rtmp-1",
              "url": "rtmp://2f84603cc5bf45babfc92e58f444eb0b.sep-qa.a-live.io:1935/2f84603cc5bf45babfc92e58f444eb0b",
              "stream_name": "alive"
          },
          {
              "id": "framecapture",
              "url": "s3://cloudplayout-preview/framecapture/e2d38b8304c84601b27630ae05b764b8/image",
              "stream_name": null
          }
      ],
      "input_specification": {
          "codec": "AVC",
          "maximum_bitrate": "MAX_20_MBPS",
          "resolution": "HD"
      },
      "output_groups": [
          {
              "type": "preview",
              "destination_url": "s3://cloudplayout-preview/framecapture/e2d38b8304c84601b27630ae05b764b8/image",
              "encoder_settings": [
                  {
                      "width": 640,
                      "height": 360,
                      "capture_interval": 5,
                      "capture_interval_units": "SECONDS"
                  }
              ]
          },
          {
              "type": "rtmp",
              "location_id": "374d4846292042af82c4c573e58bba39",
              "location": "redundancy_testing_local_group",
              "destination": "Brightcove Live with Redundancy",
              "playback_url": "https://playback-qa.a-live.io/r374d4846292042af82c4c573e58bba39/us-east-1/NA/playlist.m3u8",
              "playback_url_dvr": "https://playback-qa.a-live.io/r374d4846292042af82c4c573e58bba39/us-east-1/NA/playlist_dvr.m3u8",
              "outputs": [
                  {
                      "destination_url": "rtmp://d42f9b597f9f4cff90f3d48ddc665a02.sep-qa.a-live.io:1935/d42f9b597f9f4cff90f3d48ddc665a02/alive",
                      "location_id": "d42f9b597f9f4cff90f3d48ddc665a02",
                      "location": "redundancy_testing_local_2",
                      "encoder_settings": [
                          {
                              "width": 1920,
                              "height": 1080,
                              "bitrate": 4000000,
                              "gop_size": 60.0,
                              "gop_size_units": "FRAMES",
                              "profile": "HIGH",
                              "level": "H264_LEVEL_AUTO",
                              "scan_type": "PROGRESSIVE",
                              "framerate_control": "SPECIFIED"
                          }
                      ],
                      "stream_url": "rtmp://d42f9b597f9f4cff90f3d48ddc665a02.sep-qa.a-live.io:1935/d42f9b597f9f4cff90f3d48ddc665a02/alive",
                      "static": true,
                      "playback_url": "https://playback-qa.a-live.io/d42f9b597f9f4cff90f3d48ddc665a02/us-west-2/NA/playlist.m3u8",
                      "playback_url_dvr": "https://playback-qa.a-live.io/d42f9b597f9f4cff90f3d48ddc665a02/us-west-2/NA/playlist_dvr.m3u8"
                  },
                  {
                      "destination_url": "rtmp://2f84603cc5bf45babfc92e58f444eb0b.sep-qa.a-live.io:1935/2f84603cc5bf45babfc92e58f444eb0b/alive",
                      "location_id": "2f84603cc5bf45babfc92e58f444eb0b",
                      "location": "redundancy_testing_local_1",
                      "encoder_settings": [
                          {
                              "width": 1920,
                              "height": 1080,
                              "bitrate": 4000000,
                              "gop_size": 60.0,
                              "gop_size_units": "FRAMES",
                              "profile": "HIGH",
                              "level": "H264_LEVEL_AUTO",
                              "scan_type": "PROGRESSIVE",
                              "framerate_control": "SPECIFIED"
                          }
                      ],
                      "stream_url": "rtmp://2f84603cc5bf45babfc92e58f444eb0b.sep-qa.a-live.io:1935/2f84603cc5bf45babfc92e58f444eb0b/alive",
                      "static": true,
                      "playback_url": "https://playback-qa.a-live.io/2f84603cc5bf45babfc92e58f444eb0b/us-east-1/NA/playlist.m3u8",
                      "playback_url_dvr": "https://playback-qa.a-live.io/2f84603cc5bf45babfc92e58f444eb0b/us-east-1/NA/playlist_dvr.m3u8"
                  }
              ]
          }
      ],
      "input_group": [
          {
              "input_type": "playlist",
              "value": "redundancy_testing_local_cc",
              "description": "cloudplayout",
              "public_id": "1724281533777310596"
          }
      ]
  }
}

SSAI용 채널 활성화

SSAI (서버 측 광고 삽입) 를 위한 채널을 활성화하려면 채널을 만들 때 요청 본문에ssai_enabled: true포함시키세요. 계정에 SSAI가 활성화되어 있으면 VOD 및/또는 라이브 스트리밍 콘텐츠를 포함하는 채널에 사용할 수 있습니다.

재생 목록에 콘텐츠 추가

다음 단계는 채널 콘텐츠에 콘텐츠를 추가하는 것입니다. 이를 위해 CMS API를 사용합니다(이는 Cloud Playout과 관련된 작업 및 Cloud Playout에 더 적합한 설명이 포함된 전체 CMS API 참조 의 축약 버전임).

채널의 playlist_id를 가져옵니다(채널 생성 요청에 대한 응답 또는 채널 가져오기 요청에서). Cloud Playout 채널의 자산을 관리하는 재생 목록입니다.

샘플 요청

요청

업데이트 비디오 요청은 콘텐츠를 추가하는 데 사용됩니다. 아래 샘플에서는 수동 재생목록을 만들기 위해 동영상 ID 모음이 추가되었지만 동영상 태그 등을 기반으로 스마트 재생목록을 만들 수도 있습니다.

다음 주소로PATCH요청하세요.

https://cms.api.brightcove.com/v1/accounts/{account_id}/playlists/{playlist_id}

헤더

Content-Type: application/json
Authorization: Bearer {token}

요청 본문

{
  "video_ids": [
    "70702887566202",
    "70702887586202",
    "70702260704202",
    "70702260706202"
  ]
}

샘플 응답

{
  "id": "1701632459864392160",
  "account_id": "Your account id",
  "created_at": "2021-06-04T10:39:32.934Z",
  "updated_at": "2021-06-04T12:29:06.793Z",
  "description": "cloudplayout",
  "favorite": false,
  "name": "cloudplayout_dvfdb",
  "reference_id": null,
  "type": "EXPLICIT",
  "video_ids": [
    "70702887566202",
    "70702887586202",
    "70702260704202",
    "70702260706202"
  ],
  "state": "READY"
}

라이브 이벤트 추가

라이브 이벤트를 채널에 추가하려면 CMS API에 비디오 생성 요청을 만들고 이를 Cloud Playout 라이브 이벤트로 식별하는 몇 가지 특수 태그를 포함하도록 주의합니다.

샘플 요청

요청

다음 주소로POST요청하세요.

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos

헤더

Content-Type: application/json
Authorization: Bearer {token}

요청 본문

{
  "name": "Name of the event",
  
    "tags": [
      "cp-live-placeholder",
      "duration-00:40:00"
    ]
  ,
  "description": "Description of the event"
}

샘플 응답

{
  "id": "70702834583294",
  "account_id": "Your account id",
  "ad_keys": null,
  "clip_source_video_id": null,
  "complete": false,
  "created_at": "2021-06-04T11:00:48.551Z",
  "created_by": {
    "type": "user",
    "id": "76072843583",
    "email": "username@brightcove.com"
  },
  "cue_points": [
  ],
  "custom_fields": {
  },
  "delivery_type": "unknown",
  "description": "test description",
  "digital_master_id": null,
  "duration": null,
  "economics": "AD_SUPPORTED",
  "folder_id": null,
  "geo": null,
  "has_digital_master": false,
  "images": {
  },
  "link": null,
  "long_description": null,
  "name": "test live event",
  "original_filename": null,
  "projection": null,
  "published_at": "2021-06-04T11:00:48.565Z",
  "reference_id": null,
  "schedule": null,
  "sharing": null,
  "state": "ACTIVE",
  "tags": [
    "cp-live-placeholder",
    "duration-00:05:00"
  ],
  "text_tracks": [
  ],
  "updated_at": "2021-06-04T11:00:48.572Z",
  "updated_by": {
    "type": "user",
    "id": "76076294383",
    "email": "username@brightcove.com"
  },
  "playback_rights_id": "primary"
}

Cloud Playout에서 자산 관리와 관련된 더 많은 예제는 Cloud Playout용 CMS API 참조를 참조하십시오.

오버레이 추가/관리

Cloud Playout은 두 가지 종류의 오버레이를 지원합니다.

각 유형에 대한 워크플로는 다음과 같습니다.

오버레이 자산 만들기
정적 또는 동적 이미지에 대한 공개 URL을 제공해야 합니다. 동적 오버레이인"type": "dynamic"경우 반드시 포함해야 합니다.
오버레이를 채널과 연결합니다. 정적 오버레이와 동적 오버레이를 연결하기 위한 별도의 엔드포인트가 있습니다.
- 정적 오버레이 연결
- 동적 오버레이 연결

사용자 지정 슬레이트 추가/관리

슬레이트는 광고 콘텐츠가 광고 시간의 지속 시간을 완전히 채우지 않아 발생할 수 있는 채널 재생의 데드 타임을 채우거나 하드 시작 시간이 설정된 경우 시간을 채우는 데 사용됩니다. Brightcove는 모든 채널에 사용할 수 있는 기본 슬레이트를 제공하지만 필요에 따라 자동으로 반복되는 MP4 비디오 형식의 기본 슬레이트를 제공할 수 있습니다.

맞춤 슬레이트는 자산으로 추가하거나(모든 채널에서 재사용 가능) 채널을 만들 때 URL로 지정할 수 있습니다(위의 샘플 요청 본문 참조).

사용자 지정 슬레이트를 계정 자산으로 추가하는 방법에 대한 자세한 내용은 API 참조를 참조하세요.

채널 가져오기

이 끝점을 사용하여 채널 세부 정보 및 채널 상태를 확인할 수 있습니다.

샘플 요청

요청

다음 주소로GET요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}

헤더

Content-Type: application/json
Authorization: Bearer {token}

샘플 응답

{
  "public_id": "channel id",
  "name": "channel name",
  "description": "Channel created for testing Cloud Playout",
  "account_id": "Your account id",
  "state": "DRAFT",
  "status": null,
  "start_time": "2020-12-17 06:00:00 UTC",
  "stop_time": "2020-12-17 07:00:00 UTC",
  "input_groups": "playlist",
  "output_groups": "rtmp",
  "loop_playlist": true,
  "playlist_id": "1686204667297382886",
  "channel_class": "single-pipeline",
  "ssai_enabled": false,
  "aws_region": "us-east-1",
  "message": null,
  "created_at": "2020-12-16 03:41:22 UTC",
  "updated_at": "2020-12-17 04:53:30 UTC",
  "image_url": "https://bc-cloudplayout-prod.s3.amazonaws.com/default_channel_image.png",
  "output_destinations": [
    "Brightcove Live"
  ],
  "channel_created_at": "2020-12-16 03:41:22 UTC",
  "channel_updated_at": "2020-12-17 04:53:30 UTC",
  "channel_created_by": "username@brightcove.com",
  "channel_updated_by": "username@brightcove.com",
  "live_profile": {
    "display_name": "Standard Live HD 720p - Tier 1",
    "name": "standard-live-hd-720p-tier-1",
    "date_created": "2018-06-04 18:16:44 UTC",
    "date_modified": "2018-06-04 18:16:44 UTC"
  },
  "channel_data": {
    "input_group": [
      {
        "input_type": "playlist",
        "value": "cloudplayout_testChannel",
        "description": "Playlist created for Cloud Playout",
        "public_id": "1686204667297382886"
      }
    ],
    "output_groups": [
      {
        "type": "rtmp",
        "location": "bc_live",
        "destination": "Brightcove Live"
      }
    ]
  }
}

채널 활성화

아래 요청을 작성하여 채널을 활성화하십시오. 요청 본문이 필요하지 않습니다.

샘플 요청

요청

다음 주소로POST요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}/create

헤더

Content-Type: application/json
  Authorization: Bearer {token}

샘플 응답

{
  "message":"Channel activation initiated"
}

채널 상태를 확인하려면 위의 채널 가져오기 섹션을 참조하십시오.

채널 시작

아래 요청을 통해 채널을 시작하세요. 요청 본문이 필요하지 않습니다.

샘플 요청

요청

다음 주소로POST요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}/start

헤더

Content-Type: application/json
  Authorization: Bearer {token}

샘플 응답

{
  "message":"Channel start initiated"
}

채널 상태를 확인하려면 위의 채널 가져오기 섹션을 참조하십시오.

채널 중지

아래 요청을 작성하여 채널을 중지하십시오. 요청 본문이 필요하지 않습니다.

샘플 요청

요청

다음 주소로POST요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}/stop

헤더

Content-Type: application/json
  Authorization: Bearer {token}

샘플 응답

{
  "message":"Channel stop initiated"
}

채널 상태를 확인하려면 위의 채널 가져오기 섹션을 참조하십시오. 채널이 중지되면 DRAFT 상태가 됩니다.

채널 삭제

아래 요청을 통해 채널을 삭제하세요. 요청 본문이 필요하지 않습니다.

샘플 요청

요청

다음 주소로DELETE요청하세요.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}

헤더

Content-Type: application/json
  Authorization: Bearer {token}

샘플 응답

{
  "message":"Delete initiated"
}

채널 상태를 확인하려면 위의 채널 가져오기 섹션을 참조하십시오. 채널이 삭제되면 get channel by id 요청의 채널 정보가 더 이상 표시되지 않습니다.

As-Run 로그 가져오기

As-run 로그는 전날 Cloud Playout 채널에서 실제로 전송된 콘텐츠(광고 및 범퍼 포함)에 대한 기록을 제공합니다. As-run 로그는 감사 목적 및 기록 보관에 유용합니다.

다음 주소로GET요청을 보내 JSON, XML 또는 CSV 형식의 채널에 대한 실행 시 로그를 검색할 수 있습니다.

https://cm.cloudplayout.brightcove.com/accounts/{account_id}/cp_channels/{channel_id}/as_run_logs?format={format}

의 가치format반드시json (기본), xml , 또는csv

참고 사항

로그는 채널의 현재 상태에 관계없이 구성됩니다.
로그는 전날(24시간) 기록을 제공합니다. 예.현재 날짜가2021-09-22 05:30:00 UTC인 경우 실행 시 로깅은 채널에서2021-09-21 00:00:00 UTC까지의 채널 재생 데이터를 제공합니다2021-09-22 00:00:00 UTC .
미드롤이 재생되는 저작물은 분할되어 다음과 같이 데이터에 표시됩니다.
1. VOD 자산
2. 미드롤 애셋(예: 45초 재생)
3. VOD 자산은 해당 자산이 이어지는 포지션을 말합니다. playhead_start_time = 00:00:45

샘플 로그: JSON

{
  "account_id": "Account ID",
  "channel_id": "62713ed768434ffbac9ce2ff974c9cb9",
  "channel_name": "TestChannelName",
  "from": "Query start time (UTC)",
  "to": "Query end time (UTC)",
  "events": [
    {
      "name": "Video Cloud Asset name",
      "id": "Video cloud video ID",
      "type": "LIVE | AD | VIDEO | PRE_ROLL_BUMPER | POST_ROLL_BUMPER | MIDROLL",
      "start_time": "2021-07-30 00:00:00.0 UTC",
      "end_time": "2021-07-30 01:00:00.0 UTC"
    },
    {
      "name": "AD Placeholder",
      "id": "Video cloud video ID",
      "type": "AD",
      "start_time": "2021-07-30 01:00:00.0 UTC",
      "end_time": "2021-07-30 01:05:00.0 UTC"
    },
    {
      "name": "Asset with a Midroll AD",
      "id": "6246656690001",
      "type": "VIDEO",
      "start_time": "2021-07-30 01:05:00.0 UTC",
      "end_time": "2021-07-30 01:10:00.0 UTC"
    },
    {
      "name": "Asset with a Midroll AD",
      "id": "6246656690001",
      "type": "MIDROLL",
      "start_time": "2021-07-30 01:10:00.0 UTC",
      "end_time": "2021-07-30 01:10:30.0 UTC"
    },
    {
      "name": "Asset with a Midroll AD",
      "id": "6246656690001",
      "type": "VIDEO",
      "start_time": "2021-07-30 01:10:30.0 UTC",
      "end_time": "2021-07-30 01:20:00.0 UTC",
      "playhead_start_time": "00:05:00"
    }
  ]
}

샘플 로그: XML


   Account ID 
  62713ed768434ffbac9ce2ff974c9cb9
  TestChannelName
  Query start time (UTC)
  Query end time (UTC)


  Video Cloud Asset name
  Video cloud video ID
   LIVE | AD | VIDEO | PRE_ROLL_BUMPER | POST_ROLL_BUMPER | MIDROLL 
  2021-07-30 00:00:00.0 UTC
  2021-07-30 01:00:00.0 UTC


  AD Placeholder
  Video cloud video ID
  AD
  2021-07-30 01:00:00.0 UTC
  2021-07-30 01:05:00.0 UTC


  Asset with a Midroll AD
  6246656690001
  VIDEO
  2021-07-30 01:05:00.0 UTC
  2021-07-30 01:10:00.0 UTC


  Asset with a Midroll AD
  6246656690001
  MIDROLL
  2021-07-30 01:10:00.0 UTC
  2021-07-30 01:10:30.0 UTC


  Asset with a Midroll AD
  6246656690001
  VIDEO
  2021-07-30 01:10:30.0 UTC
  2021-07-30 01:20:00.0 UTC
  00:05:00

샘플 응답: CSV

계정_ID, 채널_ID, 채널_이름, 보낸 사람, 받는 사람, 이벤트:이름, 이벤트:ID, 이벤트:유형, 이벤트:시작_시간, 이벤트:종료_시간, 이벤트:재생헤드_시작_시간