Configuration Issues for LiveStream Resources

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

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

구성 문제

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

일부 설명에는 실제 라이브 스트림에 대한 데이터를 반영하기 위해 채워지는 변수가 포함되어 있습니다. 아래 설명에서 <code> 스타일의 텍스트(예: %(actual_gop).1f)는 각 라이브 스트림에 맞게 맞춤설정된 오류 메시지의 일부를 나타냅니다. 코드는 왼쪽 열에 있는 문제 유형을 기준으로 해야 합니다.

구성 문제
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(Group of Pictures, 영상 그룹)'로 변경하세요. 현재 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)입니다.