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)입니다. |
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2023-02-22(UTC)
[null,null,["최종 업데이트: 2023-02-22(UTC)"],[[["The `status.healthStatus.configurationIssues[]` object in a liveStream resource identifies configuration problems affecting the quality of live video streams, and is used for troubleshooting."],["The document lists various configuration issues that can affect live video streams, detailing the issue type, a brief error description, and an explanation of how to rectify it."],["Configuration issues are categorized into different types, including problems with audio, video, bitrate, framerate, codecs, keyframe frequencies, and inconsistencies between primary and backup streams."],["Many descriptions of the configuration issues include variables, like `%(actual)` or `%(expected)s`, which are customized to reflect the specific details of each live stream's errors."],["Resolutions are based on the \"issue type\", for example: `audioBitrateLow`, `bitrateHigh`, `gopSizeLong`, allowing developers to build solutions based on these type of errors."]]],["Live streams may have configuration issues that impact quality. The `configurationIssues` object lists these problems, detailing the issue type, a short description, and a longer explanation for resolution. Issues include bitrate, codec, sample rate, and channel problems for audio; and bitrate, framerate, GOP, resolution, and codec issues for video. Mismatches between primary and backup streams are also noted. Actions to take involve checking settings, ensuring correct formats, and matching properties between streams.\n"]]
