이 페이지는 이동했습니다. 3초 후에 새 위치 로 이동합니다. 북마크를 업데이트하세요!

라이브 API: 정적 진입 점

이 항목에서는 정적 진입 점과 Live API를 사용하여 구현하는 방법에 대해 설명합니다.

서문

정적 진입점 (SEP) 기능을 사용하면 진입점 URL 및 재생 URL을 정적으로 유지하고 재사용 가능한 상태로 유지하면서 활성화 및 비활성화할 수 있는 장기 실행 라이브 작업을 수행할 수 있습니다. 이 기능을 통해 고객은 시설 또는 현장에서 인코더를 구성할 수 있으며, 고객은 라이브 채널 또는 프로그램에 대한 자체 일정 로직을 만들 수 있습니다.

DVR 및 SEP

DVR 기능은 정적 진입 점에서 사용할 수 있지만 SEP가활성화 .

정적 진입 점 만들기

표준작업 생성 operation이 사용되지만 정적 진입 점을 추가하려면 작업 요청에 속성을 추가해야합니다.

"static": true

이 작업에서 응답하는 RTMP URL은 정적이므로 아래 섹션에 설명 된 작업으로 작업을 활성화 / 비활성화하여 재사용 할 수 있습니다. 이 문서 끝에 나열된 제한 사항을 읽고 이해하십시오.

최대 대기 시간

SEP 작업이 활성화 된 후 인코더가 시작되지 않으면 잠시 후 자동으로 비활성화됩니다. 규칙은 다음과 같습니다.

  • 만약event_length값이 30 분보다 크면 작업이 기본적으로 30 분 후에 자동으로 종료됩니다. 대기 시간을 변경하려면 지원팀에 문의해야합니다. 자동 비활성화는 비활성화 할 수 없습니다.
  • 만약event_length 값이reconnect_time , 작업은에 설정된 시간에 종료됩니다. event_length .

SEP 라이브 스트림 활성화

정적 진입 점 라이브 스트림을 활성화하려면 Live API에 다음 요청을 보냅니다.

활성 SEP 스트림
방법 PUT
끝점
https://api.bcovlive.io/v1/jobs/{jobID}/activate

요청 본문이 필요하지 않습니다.

SEP 라이브 스트림 비활성화

정적 진입 점 라이브 스트림을 비활성화하려면 Live API에 다음 요청을 보냅니다.

활성 SEP 스트림
방법 PUT
끝점
https://api.bcovlive.io/v1/jobs/{jobID}/deactivate

요청 본문이 필요하지 않습니다.

SEP 작업 취소

정적 진입 점 작업을 영구적으로 중지하려면 모든 라이브 작업과 마찬가지로 작업을 취소 할 수 있습니다. PUT엔드 포인트 요청/jobs/{job_id}/cancel . 참조 API 참조자세한 내용은.

제한 사항

  • 완료시 스트림을 보관하도록 Live to VOD를 설정할 수 없습니다.

    대안:

    • 클리핑을사용하여 전체 라이브 이벤트를 VOD로 보관합니다. 클리핑 창은 이벤트 후 또는 SEP의 다음 활성화 (둘 중 더 짧은 기간) 까지 표준 기간 동안 사용할 수 있습니다.
  • 작업 설정은 수정할 수 없습니다. 현재 SEP를 처음 생성 한 설정과 연결되어 있습니다.
  • 스트림을 활성화하는 데 진입 점을 사용할 수 있으려면 최대 60 초가 걸릴 수 있습니다.

    모범 사례:

    SEP 작업이 실제로 준비 될 때 실시간 업데이트를 받기 위해 작업 상태 변경에 대한 라이브 플랫폼의 알림을 구현합니다.

    대안:

    1. 인코더를 시작하기 최소 60 초 전에 스트림을 활성화합니다.
    2. 인코더에 내장 재시도 (Wirecast, Elemental 등)가있는 경우 스트림을 즉시 연결할 수 있으며 (일부 오류가있을 수 있음) 진입 점이 사용 가능 해지는 즉시 인코더가 다시 연결됩니다.
  • Reconnect_time은 인코더 연결 해제시 SEP 작업에 계속 적용됩니다. 재 연결 시간에 도달하면 SEP 작업이 비활성화 된 상태로 돌아갑니다.

    모범 사례:

    작업이 완료되면 항상 API를 통해 스트림을 비활성화하고 연결 해제시 대기 할 허용 가능한 시간 창으로 재 연결 시간을 설정하십시오 (이 대기 기간 동안 입력 시간 비용이 발생 함).

  • 각 계정에는 사용 가능한 SEP 작업 3 개만 할당됩니다. 지역별 . 한도에 도달하면취소새 작업을 생성하기 전에 SEP 작업 중 하나를 선택하십시오.

    최대 SEP 작업 수에 도달하고 다른 작업을 만들려고하면 다음 오류가 반환됩니다.

    {
      "error": "You've reached the number of static entry points jobs you can create for your account"
    }
  • 한 번에 5개 이상의 SEP 작업을 활성화하려고 하면 다음과 같은 오류가 발생합니다.
    {
      “message”:“Allocating additional streaming capacity to the region. Please retry your request.: no_streaming_capacity_in_region”,
      “statusCode”:500,
      “name”:“ApiError”,
      “isApiError”:true
    }

    요청을 다시 시도하기 전에 일부 작업이 활성화를 완료할 때까지 기다려야 합니다.

참고 사항

비활성화 후 SEP 작업 클리핑
사용자는 스트림이 다음 활성화 될 때까지 또는 7 일 중 더 짧은 기간 동안 클립을 만들 수 있습니다. 스트림이 다시 활성화되면 이전 레코딩 세션이 서버에서 제거되어 더 이상 클리핑할 수 없습니다.
SEP를 사용할 때 stream_start_time 필드의 타이밍은 어떻게됩니까?
SEP가 활성화되면 시작 시간으로 간주됩니다.