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

개요

이 가이드는 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로 설정한 다음 liveBroadcast 리소스를 식별합니다. 이 리소스는 API 응답에서 isDefaultBroadcast 속성 값이 true인 리소스입니다.

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

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

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

기본 스트림에서 마이그레이션

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

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

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

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

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

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

브로드캐스트를 스트림에 연결하려면 liveBroadcasts.bind 메서드를 호출합니다. 자세한 내용은 '브로드캐스트 수명 주기' 가이드의 1.3단계를 참조하세요.

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

브로드캐스트 테스트

기본 브로드캐스트를 사용하지 않는 경우 브로드캐스트를 테스트할 수 있습니다. 테스트를 실행하려면 YouTube 시청자에게 표시되는 대로 브로드캐스트 동영상을 미리 볼 수 있는 플레이어를 삽입합니다. 하지만 다른 시청자에게는 브로드캐스트가 표시되지 않습니다.

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

스트림을 테스트하려면 브로드캐스트를 삽입할 때 contentDetails.monitorStream.enableMonitorStream 속성을 true로 설정하고 contentDetails.enableAutoStart 속성을 false로 설정해야 합니다. 이러한 속성의 기본값입니다.

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

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

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

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