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."]]],[]]
