기본 브로드캐스트 및 스트림 지원 중단 마이그레이션 가이드

개요

이 가이드는 YouTube 채널의 기본 liveStream 및 liveBroadcast 리소스를 사용하여 라이브 콘텐츠를 스트리밍하는 API 클라이언트 애플리케이션의 개발자를 대상으로 합니다. 이 도구는 애플리케이션이 기본 브로드캐스트 및 기본 스트림의 지원 중단을 원활하게 처리하도록 지원하는 것을 목표로 하며, 다음 문장 중 하나라도 애플리케이션에 적용되는 경우 관련이 있습니다.

  • liveBroadcast 리소스의 isDefaultBroadcast 속성 값을 확인합니다.
  • liveStream 리소스의 isDefaultStream 속성 값을 확인합니다.

  • liveBroadcasts.list 메서드를 호출하고 broadcastType 매개변수 값을 persistent로 설정합니다. 지원 중단일 기준:

    • broadcastType 매개변수 값이 persistent이면 liveBroadcasts.list 메서드는 결과를 반환하지 않습니다.
    • broadcastType 매개변수 값이 all이면 liveBroadcasts.list 메서드는 그 전에 존재했던 지속적인 브로드캐스트를 반환하지 않습니다.

애플리케이션이 영향을 받는 경우 애플리케이션 업데이트 섹션을 참고하세요. 이 섹션에서는 이번 지원 중단으로 인해 애플리케이션에서 적용해야 할 절차상의 변경사항을 설명합니다. 이 섹션에서는 현재 기본 방송 및 스트림을 사용하는 경우 API 클라이언트가 일반적으로 따르지 않을 수 있는 방송 수명 주기 가이드의 구체적인 단계를 설명합니다.

현재 어떤 상황이 진행되고 있나요?

2015년부터 YouTube는 채널에서 실시간 스트리밍을 사용 설정하면 채널의 기본 스트림과 기본 브로드캐스트를 자동으로 생성했습니다. 기본 스트림이 무기한으로 존재하며 삭제할 수 없었습니다. 마찬가지로 기본 브로드캐스트는 영구적으로 간주되었습니다. 항상 존재했고, 시작 시간이나 종료 시간이 연결되어 있지 않았으며, 특정 이벤트에 바인딩되지 않았습니다.

위에서 언급한 지원 중단일부터 YouTube에서 더 이상 기본 스트림과 방송을 만들지 않습니다. 이 변경사항은 이러한 리소스를 사용하여 라이브 콘텐츠를 브로드캐스트하는 클라이언트 애플리케이션에 영향을 미칩니다. 또한 사용자 인터페이스가 채널 소유자가 만든 기본 리소스와 기타 브로드캐스트 및 스트림을 구분하도록 맞춤설정된 애플리케이션에도 영향을 미칩니다.

기본 리소스에 의존하는 대신 API 클라이언트는 liveBroadcast 및 liveStream 리소스를 만들고 관리하고 이러한 리소스를 함께 바인딩해야 합니다.

애플리케이션 업데이트

용어를 간단히 살펴보면 브로드캐스트는 YouTube에서 실시간으로 시청할 수 있는 이벤트를 나타내고 스트림은 실제 동영상 콘텐츠를 YouTube로 전송하는 메커니즘입니다. 브로드캐스트는 정확히 하나의 스트림에 바인딩될 수 있으며 바인딩되어야 합니다.

기본 브로드캐스트에서 이전

이 지원 중단 전에는 API 클라이언트가 채널의 기본 브로드캐스트를 사용하거나 이벤트별 브로드캐스트를 만들 수 있었습니다. 기본 브로드캐스트는 여러 이벤트에 재사용할 수 있는 영구 리소스인 반면 이벤트별 브로드캐스트 리소스는 YouTube 동영상 하나에 정확히 해당하는 일회용 리소스입니다.

클라이언트 애플리케이션이 liveBroadcasts.list 메서드를 호출하고 다음 중 하나를 실행하는 경우 기본 브로드캐스트를 사용합니다.

  • broadcastType 매개변수 값을 persistent로 설정합니다. 이 요청은 기본 브로드캐스트만 가져옵니다.
  • broadcastType 매개변수 값을 all으로 설정한 다음 isDefaultBroadcast 속성 값이 true인 API 응답에서 liveBroadcast 리소스를 식별합니다.

지원 중단 후에는 YouTube에서 이벤트별 방송만 지원합니다. 즉, 기본 브로드캐스트에 의존하는 대신 클라이언트 애플리케이션은 각 개별 브로드캐스팅 이벤트에 대해 liveBroadcast 리소스를 만들어야 합니다.

liveBroadcast 리소스를 만들려면 liveBroadcasts.insert 메서드를 호출합니다. 이 프로세스는 '브로드캐스트 수명' 가이드의 1.1단계에 설명되어 있습니다.

아직 제공하지 않는 경우 사용자 인터페이스는 사용자가 예정된 이벤트별 브로드캐스트를 구분하고 선택할 수 있는 메커니즘도 제공해야 합니다.

기본 스트림에서 이전

스트림을 사용하면 오디오-동영상 콘텐츠를 YouTube로 전송할 수 있으며, YouTube로 콘텐츠를 스트리밍하는 방법을 위한 설정을 정의합니다. 브로드캐스터가 여러 브로드캐스트가 서로 다른 시간에 발생하는 경우 동일한 스트림을 여러 브로드캐스트에 재사용하는 것이 일반적입니다.

애플리케이션에서 기본 스트림을 사용할 수 없더라도 각 브로드캐스트에 재사용할 수 있는 재사용 가능한 스트림을 만들 수 있습니다. liveStream 리소스를 만들려면 '브로드캐스트의 수명' 가이드의 1.2단계의 안내에 따라 liveStreams.insert 메서드를 호출합니다. 기본적으로 새로 만든 스트림은 재사용 가능합니다. 하지만 원하는 경우 contentDetails.isReusable 속성을 false로 설정하여 일회용 스트림을 만들고 브로드캐스트와 스트림 간에 일대일 관계를 설정할 수 있습니다.

다음 목록에는 새 스트림을 만들 때 설정할 수 있는 스트림 제목 및 스트림 설명 외 4가지 속성이 포함되어 있습니다. 목록에는 기본 스트림이 각 속성에 사용하는 값이 표시되며, 기본 스트림 사용에서 이전하는 경우 클라이언트 애플리케이션에서 사용하고 싶은 설정일 가능성이 높습니다.

스트림에 브로드캐스트 바인딩

YouTube에서 라이브 방송을 실제로 시작하려면 각 liveBroadcast 리소스가 정확히 하나의 스트림에 바인딩되어야 합니다. (브로드캐스트는 생성 시 스트림에 바인딩되지 않습니다.)

바인딩 프로세스는 기본 스트림에 불가분하게 바인딩된 기본 브로드캐스트에 대해 자동으로 처리되었습니다. 하지만 지원 중단 날짜가 지나면 클라이언트 애플리케이션이 모든 브로드캐스트에 대해 이 프로세스를 관리해야 합니다.

브로드캐스트를 스트림에 바인딩하려면 '브로드캐스트의 수명' 가이드의 1.3단계에 설명된 대로 liveBroadcasts.bind 메서드를 호출합니다.

  • 재사용 가능한 스트림을 사용하는 경우 스트림을 한 번 만든 다음 모든 브로드캐스트를 해당 스트림에 바인딩할 수 있습니다.
  • 재사용 가능한 스트림을 사용하지 않는 경우 브로드캐스트와 스트림을 만든 다음 이 두 가지를 함께 바인딩해야 합니다.

방송 테스트

기본 브로드캐스트를 사용하지 않는 경우 브로드캐스트를 테스트할 수 있습니다. 테스트를 진행하려면 YouTube 시청자에게 표시되는 것과 같은 방식으로 브로드캐스트 동영상을 미리 볼 수 있는 플레이어를 삽입해야 합니다. 이때 브로드캐스트는 다른 시청자에게 표시되지 않습니다.

API 클라이언트가 이전에 기본 브로드캐스트 및 스트림을 사용했고 스트리밍 프로세스에 테스트 단계를 추가하려면 '브로드캐스트 수명' 가이드의 3단계를 참고하세요.

스트림을 테스트하려면 방송을 삽입할 때 contentDetails.monitorStream.enableMonitorStream 속성을 true로 설정하고 contentDetails.enableAutoStart 속성을 false로 설정해야 합니다. 두 속성의 기본값은 다음과 같습니다.

자동 시작 및 자동 중지 기능 사용

기본 스트림에서 동영상 스트리밍을 시작할 때마다 기본 방송이 자동으로 시작되었습니다. 마찬가지로 동영상 스트리밍을 중지하면 기본 방송이 종료됩니다. 이러한 기본 리소스를 사용하는 각 스트리밍 세션은 이후 채널의 동영상이 되었습니다.

자동 시작 및 자동 중지 기능은 기본 브로드캐스트의 기본 동작이었지만, 다른 브로드캐스트의 경우 선택사항이며 사용 설정해야 합니다. 이 기능을 사용하려면 브로드캐스트를 삽입할 때 contentDetails.enableAutoStart 및 contentDetails.enableAutoStop 속성 값을 true로 설정해야 합니다. 이러한 기능은 독립적이므로 하나만 사용하고 다른 하나는 사용하지 않을 수 있습니다.

새 방송에 자동 시작 및 자동 중지 기능을 사용 설정하지 않으면 동영상 스트리밍을 시작하고 종료할 때 API 클라이언트가 liveBroadcasts.transition 메서드를 호출하여 방송의 상태를 업데이트해야 합니다. '브로드캐스트 수명 주기' 가이드의 4.3단계 및 5.2단계에서 브로드캐스트 시작과 끝에서 이러한 전환을 관리하는 방법을 알아보세요.