브라이트코브 플레이어 5.22.0 버전에는 추가 오류 코드가 도입되었습니다. 비디오 플레이어에서 오류란 재생을 계속할 수 없는 상태를 말하며, 다시 시작하려면 플레이어 외부에서 일부 조치가 필요합니다.
새로운 오류 코드를 사용하면 재생이 차단되는 여러 가지 일반적인(그리고 종종 의도적인) 상황을 보다 쉽게 감지할 수 있습니다. 다른 모든 브라이트코브 플레이어 오류와 마찬가지로, 플레이어에 리스너를 설정하여 새로운 오류 코드에 대응할 수 있습니다.
// Listen for error events on a player instance:
player.on('error', function() {
// When your listener is invoked, check the error property on the player for details.
var error = player.error();
// Errors have a code and a message
console.log('Uh-oh...', error.code, error.message);
});새로운 오류 코드는 미디어 제한으로 인한 재생 실패에 대한 인사이트를 제공하고 몇 가지 일반적인 통합 문제를 좀 더 쉽게 디버깅할 수 있게 해줍니다. 전체 목록은 다음과 같습니다.
| 코드 | 설명 |
|---|---|
| PLAYER_ERR_DOMAIN_RATED | 도메인 제한으로 인해 현재 페이지에서 플레이어 또는 기본 동영상을 실행할 수 없습니다. |
| PLAYER_ERR_IP_RESTRICTED | 이 사용자의 IP 주소에서는 기본 동영상이 허용되지 않습니다. |
| PLAYER_ERR_GEO_RESTRICTED | 이 사용자의 지역에서는 기본 동영상을 사용할 수 없습니다. |
| VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUNDED | 플레이어가 잘못된 계정 ID로 구성되었습니다. |
| VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUNDED | 기본 재생목록 ID가 잘못되었습니다. |
| VIDEO_CLOUD_ERR_VIDEO_NOT_FOUNDED | 기본 동영상이 유효하지 않습니다. |
새로운 오류 코드의 대부분은 플레이어로 구성된 기본 동영상 또는 재생목록에만 나타납니다. 즉, 동영상 또는 재생목록을 구성할 때 videoId 쿼리 매개변수 또는 data-playlist-id 속성을 추가할 수 있습니다. 카탈로그를 사용하여 프로그래밍 방식으로 동영상을 가져오는 경우에도 응답 콜백에서 오류를 확인하고 거기서 처리해야 합니다.
5.22.0은 누구나 사용할 수 있으며 자동 업데이트를 받는 플레이어를 대상으로 배포되고 있습니다. 플레이어 오류를 수집하고 분석하는 경우, 새로운 오류 코드를 통해 고객 경험을 더 잘 이해하고 문제가 발생했을 때 최종 사용자의 혼란을 줄일 수 있기를 바랍니다.
