Configuration Issues for LiveStream Resources

liveStream 리소스에서 status.healthStatus.configurationIssues[] 객체에는 스트림에 영향을 미치는 구성 문제 목록이 포함됩니다. 이 정보는 실시간 동영상 스트림의 품질에 영향을 미치는 문제를 파악, 진단, 해결하는 데 도움이 됩니다.

이 문서에서는 API 응답에서 참조할 수 있는 구성 문제의 유형을 나열합니다. 각 문제에는 문제 유형, 간단한 오류 설명, 오류를 해결하는 방법을 설명하는 정보가 포함된 더 긴 설명이 포함됩니다.

구성 문제

아래 표에는 실시간 동영상 스트림에 영향을 줄 수 있는 구성 문제가 나와 있습니다. 왼쪽 열에는 문제 유형이 표시되고 오른쪽 열에는 문제 해결 방법에 관한 추가 세부정보가 표시됩니다.

일부 설명에는 실제 실시간 스트림에 대한 데이터가 반영되도록 게재되는 변수가 포함됩니다. 아래 설명에서 %(actual_gop).1f 같은 <code> 스타일의 텍스트는 각 실시간 스트림에 맞춤설정된 오류 메시지의 일부를 식별합니다. 코드는 왼쪽 열에 있는 문제 유형을 통해 입력되어야 합니다.

구성 관련 문제
audioBitrateHigh
이유:오디오 설정 확인
설명:오디오 스트림의 현재 비트 전송률이 %(actual)보다 높습니다. %(expected)s의 오디오 스트림 비트 전송률을 사용하는 것이 좋습니다.
audioBitrateLow
이유:오디오 설정 확인
설명:오디오 스트림의 현재 비트 전송률 (%(actual)s)이(가) 권장 비트 전송률보다 낮습니다. %(expected)s의 오디오 스트림 비트 전송률을 사용하는 것이 좋습니다.
audioBitrateMismatch
이유:보조 스트림 확인
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 오디오 비트 전송률이 다릅니다. 스트림이 동일한 오디오 비트 전송률을 갖도록 구성해야 합니다.
audioCodec
이유:오디오 설정 확인
설명:지원되지 않는 코덱으로 오디오 스트림이 인코딩되었습니다. 스트림의 오디오 코덱을 지원되는 코덱(AAC, MP3)으로 설정하세요.
audioCodecMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림이 서로 다른 오디오 코덱을 사용합니다. 동일한 오디오 코덱을 사용하도록 스트림을 구성해야 합니다.
audioSampleRate
이유:오디오 설정 확인
설명:현재 샘플링 레이트는 %(actual)입니다. 권장 샘플링 레이트는 44.1kHz 및 48kHz입니다.
audioSampleRateMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 오디오 샘플링 비율이 다릅니다. 스트림이 동일한 오디오 샘플링 레이트를 갖도록 구성해야 합니다.
audioStereoMismatch
이유:잘못된 보조 스트림
설명:현재 설정에서 동영상의 기본 및 백업 스트림이 서로 다른 오디오 채널을 사용합니다. 동일한 오디오 채널을 갖도록 스트림을 설정해야 합니다.
audioTooManyChannels
이유:오디오 설정 확인
설명:오디오에 채널이 3개 이상 있지만 1개 (모노) 또는 2개 (스테레오) 채널만 지원됩니다. 오디오 채널의 수를 수정하세요.
badContainer
이유:잘못된 동영상 설정
설명:동영상의 컨테이너 형식을 변경하세요. 현재 컨테이너 형식이 이 구성에 적합하지 않습니다.
bitrateHigh
이유:동영상 설정 확인
설명:스트림의 현재 비트 전송률 (%(actual)s)이(가) 권장 비트 전송률보다 높습니다. %(expected)s의 스트림 비트 전송률을 사용하는 것이 좋습니다.
bitrateLow
이유:동영상 출력 낮음
설명:스트림의 현재 비트 전송률 (%(actual)s)이(가) 권장 비트 전송률보다 낮습니다. %(expected)s의 스트림 비트 전송률을 사용하는 것이 좋습니다.
framerateMismatch
이유:보조 스트림 확인
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 프레임 속도가 다릅니다. 스트림이 동일한 프레임 속도를 갖도록 구성해야 합니다.
frameRateHigh
이유:프레임 속도 높음
설명:현재 프레임 속도가 너무 빠릅니다. 프레임 속도를 %(framerate)sfps 이하로 설정하세요.
gopMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 키프레임 빈도가 서로 다릅니다. 스트림이 동일한 키프레임 빈도를 갖도록 구성해야 합니다.
gopSizeLong
이유:잘못된 동영상 설정
설명:키프레임 빈도를 4초 이하로 사용하세요. 현재 키프레임이 충분한 빈도로 전송되지 않아 버퍼링이 발생할 수 있습니다. 현재 키프레임 빈도는 %(actual_gop).1f초입니다. 처리 오류로 인해 GOP(Group of Pictures, 화상 그룹) 크기가 잘못될 수 있다는 점에 유의하세요.
gopSizeOver
이유:동영상 설정 확인
설명:키프레임 빈도를 4초 이하로 사용하세요. 현재 키프레임이 충분히 전송되지 않아 버퍼링이 발생할 수 있습니다. 현재 키프레임 빈도는 %(actual_gop).1f초입니다. 처리 오류로 인해 GOP(Group of Pictures, 화상 그룹) 크기가 잘못될 수 있다는 점에 유의하세요.
gopSizeShort
이유:동영상 설정 확인
설명:GOP 크기가 너무 작아서 이미지 품질이 저하될 수 있습니다. 권장 키프레임 빈도는 4초이며, 현재 키프레임 빈도는 %(actual_gop).1f초입니다. 처리 오류로 인해 GOP 크기가 잘못될 수 있다는 점에 유의하세요.
multipleAudioStreams
이유:오디오 설정 확인
설명:처리 스트림에 오디오 스트림이 여러 개 포함되어 있습니다. 오디오 스트림은 정확히 1개만 있어야 합니다.
multipleVideoStreams
이유:잘못된 동영상 설정
설명:처리 스트림에 동영상 스트림이 여러 개 포함되어 있습니다. 동영상 스트림은 정확히 1개만 있어야 합니다.
noAudioStream
이유:오디오가 없음
설명:처리 스트림에 오디오 스트림이 포함되어 있지 않습니다. 오디오 스트림은 정확히 1개만 있어야 합니다.
noVideoStream
이유:동영상 없음
설명:처리 스트림에 동영상 스트림이 포함되어 있지 않습니다. 동영상 스트림은 정확히 1개만 있어야 합니다.
openGop
이유:잘못된 동영상 설정
설명:동영상 인코더의 구성을 '폐쇄 사진 그룹 (GOP)'으로 변경하세요. YouTube에서 지원하지 않는 'GOP 열기'로 설정되어 있습니다.
resolutionMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 해상도가 서로 다릅니다. 해상도가 동일하도록 스트림을 구성해야 합니다.
videoBitrateMismatch
이유:보조 스트림 확인
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 동영상 비트 전송률이 다릅니다. 스트림이 동일한 동영상 비트 전송률을 갖도록 구성해야 합니다.
videoCodec
이유:잘못된 동영상 설정
설명:지원되지 않는 코덱으로 동영상이 인코딩되었습니다. 스트림의 동영상 코덱을 지원되는 코덱(H.264)으로 설정하세요.
videoCodecMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림이 서로 다른 동영상 코덱을 사용합니다. 스트림이 동일한 동영상 코덱을 갖도록 구성해야 합니다.
videoIngestionStarved
이유:동영상 출력 낮음
설명:YouTube에서 원활한 스트리밍을 유지하기에 충분한 동영상을 수신하지 못하고 있습니다. 따라서 버퍼링이 발생합니다.
videoInterlaceMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 인터레이스가 다릅니다. 스트림의 인터레이스가 동일하도록 구성해야 합니다.
videoProfileMismatch
이유:잘못된 보조 스트림
설명:현재 구성에서는 동영상의 기본 스트림과 백업 스트림의 프로필이 다릅니다. 스트림이 동일한 프로필을 갖도록 구성해야 합니다.
videoResolutionSuboptimal
이유:해상도를 확인하세요.
설명:동영상 해상도를 확인하세요. 현재 해상도는 (%(actual_w)dx%(actual_h)d)이며 최적의 해상도가 아닙니다.
videoResolutionUnsupported
이유:지원되지 않는 해상도입니다.
설명:동영상 해상도를 변경해야 합니다. 현재 해상도는 (%(actual_w)dx%(actual_h)d)이며 이 구성에서 지원되지 않습니다. 예상 동영상 해상도는 (%(expected_w)dx%(expected_h)d)입니다.