La versión 5.22.0 del reproductor de Brightcove introduce códigos de error adicionales. En el contexto de nuestro reproductor de vídeo, los errores son condiciones en las que la reproducción no puede continuar, y volver a empezar requiere alguna acción fuera del propio reproductor.
Los nuevos códigos de error le permitirán detectar más fácilmente una serie de situaciones comunes (y a menudo intencionadas) en las que la reproducción se bloquea. Al igual que el resto de errores del reproductor de Brightcove, puede reaccionar a los nuevos códigos de error configurando un oyente en el reproductor.
// 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);
});
Los nuevos códigos de error proporcionan información sobre los fallos de reproducción debidos a restricciones de medios y facilitan la depuración de algunos problemas habituales de integración. Aquí está la lista completa.
Código | Descripción |
---|---|
PLAYER_ERR_DOMAIN_RESTRICTED | El reproductor o el vídeo predeterminado no pueden ejecutarse en la página actual debido a una restricción de dominio. |
PLAYER_ERR_IP_RESTRICTED | El vídeo por defecto no está permitido desde la dirección IP de este usuario. |
PLAYER_ERR_GEO_RESTRICTED | El vídeo por defecto no está disponible en la geografía de este usuario. |
VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUND | El jugador se ha configurado con un ID de cuenta no válido. |
VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND | El ID de la lista de reproducción por defecto no es válido. |
VIDEO_CLOUD_ERR_VIDEO_NOT_FOUND | El vídeo por defecto no es válido. |
Tenga en cuenta que muchos de los nuevos códigos de error sólo aparecen para el vídeo o la lista de reproducción por defecto configurados con un reproductor. Es decir, el vídeo o la lista de reproducción configurados mediante la opción videoId
parámetro de consulta o data-playlist-id
por ejemplo. Si obtiene vídeos mediante programación utilizando el catálogo, deberá comprobar si hay errores en la devolución de llamada de la respuesta y gestionarlos allí.
La versión 5.22.0 está disponible para todo el mundo y se está desplegando para los jugadores que reciben actualizaciones automáticas. Si recopilas y analizas los errores de los jugadores, esperamos que los nuevos códigos de error te ayuden a comprender mejor la experiencia de tu público (y a reducir la confusión de los usuarios finales si se encuentran con un problema).