기본 브로드캐스트 및 스트림의 지원 중단 관련 이전 가이드

개요

이 가이드는 YouTube 채널의 기본 liveStream 및 liveBroadcast 리소스를 사용하여 실시간 콘텐츠를 스트리밍하는 API 클라이언트 애플리케이션 개발자를 대상으로 합니다. 이 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가지 속성이 포함되어 있습니다. 이 목록에는 기본 속성에서 각 속성에 사용하는 값이 표시됩니다. 기본 스트림 사용을 이전하는 경우 클라이언트 애플리케이션에서 사용할 수 있는 설정일 수 있습니다.

브로드캐스트를 스트림에 결합

각 liveBroadcast 리소스는 YouTube의 실시간 방송이 실제로 시작되기 전에 정확히 하나의 스트림에 결합되어야 합니다. (브로드캐스트는 생성 시점의 어떠한 스트림에도 바인딩되지 않습니다.)

기본 스트림에 대해 결합 프로세스가 자동으로 처리되었으며 이는 기본 스트림에 결합할 수 없었습니다. 하지만 지원 중단 날짜 이후에는 클라이언트 애플리케이션에서 모든 브로드캐스트의 프로세스를 관리해야 합니다.

방송을 스트림에 결합하려면 '방송의 수명' 가이드의 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단계를 참고하세요.