HTML 미디어 요소(예: <video>
및 <audio>
)를 디버깅하기는 어려울 수 있습니다. 특히 재생이 특정 코덱의 난해한 기능을 사용하는 경우에는 디코더 구현이 오류로 간주되는 요소를 다르기 때문에(하드웨어 디코더가 일반적으로 가장 엄격함) 디버깅이 어려울 수 있습니다. 다행히 Google에서 도움을 줄 수 있는 다양한 도구가 있습니다.
미디어 재생 오류를 디버깅할 때 일반적으로 가장 먼저 확인해야 하는 것은 HTML 미디어 요소의 MediaError error
속성입니다. 이 속성은 미디어 재생 오류의 원인에 대한 대략적인 힌트입니다. MediaError.code
속성은 미디어 요소에서 발생한 오류의 종류를 나타내는 숫자 값을 반환합니다. 다른 속성 MediaError.message
는 브라우저의 일부 진단 정보가 포함된 문자열을 제공할 수 있습니다.
const video = document.querySelector('video');
video.addEventListener('error', () => {
console.log('Error code: ' + video.error.code);
console.log('Error message: ' + video.error.message);
});
이러한 속성은 텔레메트리 분석에 가장 유용하며 재생 오류를 디버그하기에 충분한 정보를 제공하지 않을 수도 있습니다. 개인 정보 보호를 위해 전체 오류 텍스트를 생략해야 하는 경우도 있습니다.
전체 오류 정보에 액세스하려면 Chrome DevTools '미디어 패널'을 사용하여 미디어 로그를 확인하세요. 이벤트, 경고, 오류 메시지 등 미디어 재생 오류에 관한 유용한 힌트를 제공하는 다양한 정보를 찾을 수 있습니다.
<ph type="x-smartling-placeholder">![Chrome DevTools의 미디어 패널 스크린샷](https://web.developers.google.cn/static/articles/debug-playback-errors/image/screenshot-the-media-pan-96619b7be4c41.png?authuser=19&hl=ko)
다음 명령어로 FFmpeg 무료 애플리케이션을 사용하여 미디어 파일 무결성을 확인할 수도 있습니다.
ffmpeg -err_detect explode -i <file> -f null -
코덱이 잘못된 동영상 파일에서 이 명령어를 사용할 경우 다음과 같은 오류가 발생할 수 있습니다.
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x7fc62df05380] Could not find codec parameters for stream 0 (Video: none (zzzz / 0x7A7A7A7A), none(smpte170m/smpte170m/bt709, progressive), 320x240, 4 kb/s): unknown codec
Consider increasing the value for the 'analyzeduration' (0) and 'probesize' (5000000) options
[matroska,webm @ 0x7fd45b705380] Unknown EBML doctype '0000'
[matroska,webm @ 0x7f8d17904d40] Element at 0x8b ending at 0x10400000095 exceeds containing master element ending at 0x9b
Truncating packet of size 9069 to 94
MP4Box.js / ISOBMFF Box Structure Viewer는 비트스트림 문제를 디버깅하는 데 유용한 도구입니다. 하지만 MP4를 사용하려면 이미 MP4를 이해해야 합니다.
마지막으로 VQAnalyzer, Elecard StreamEye, Codecian CodecVisa와 같은 동영상 스트림 분석 전문 도구는 비용 대비 효과가 높습니다.