Mit Version 5.22.0 des Brightcove-Players werden zusätzliche Fehlercodes eingeführt. Im Kontext unseres Videoplayers sind Fehler Bedingungen, unter denen die Wiedergabe nicht fortgesetzt werden kann und der Neustart eine Aktion außerhalb des Players selbst erfordert.
Mit den neuen Fehlercodes können Sie eine Reihe von häufigen (und oft absichtlichen) Situationen, in denen die Wiedergabe blockiert wird, leichter erkennen. Wie bei allen anderen Fehlern im Brightcove-Player können Sie auf die neuen Fehlercodes reagieren, indem Sie einen Listener im Player einrichten.
// 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);
});Die neuen Fehlercodes geben Aufschluss über Wiedergabefehler aufgrund von Medienbeschränkungen und erleichtern die Fehlersuche bei einigen häufigen Integrationsproblemen. Hier ist die vollständige Liste.
| Code | Beschreibung |
|---|---|
| PLAYER_ERR_DOMAIN_RESTRICTED | Der Player oder das Standardvideo kann aufgrund von Domäneneinschränkungen nicht auf der aktuellen Seite ausgeführt werden. |
| PLAYER_ERR_IP_RESTRICTED | Das Standardvideo wird von der IP-Adresse dieses Benutzers nicht zugelassen. |
| PLAYER_ERR_GEO_RESTRICTED | Das Standardvideo ist in der Geografie dieses Benutzers nicht verfügbar. |
| VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUND | Der Spieler wurde mit einer ungültigen Konto-ID konfiguriert. |
| VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND | Die Standard-Wiedergabelisten-ID ist ungültig. |
| VIDEO_CLOUD_ERR_VIDEO_NOT_FOUND | Das Standardvideo ist ungültig. |
Beachten Sie, dass viele der neuen Fehlercodes nur für das mit einem Player konfigurierte Standardvideo oder die Wiedergabeliste angezeigt werden. Das heißt, das Video oder die Wiedergabeliste, die mit der Option videoId Abfrageparameter oder data-playlist-id Attribut, zum Beispiel. Wenn Sie Videos mithilfe des Katalogs programmatisch abrufen, müssen Sie dennoch im Antwort-Callback auf Fehler prüfen und diese dort behandeln.
5.22.0 ist für alle Spieler verfügbar und wird für Spieler, die automatische Updates erhalten, ausgerollt. Wenn Sie Spielerfehler sammeln und analysieren, hoffen wir, dass die neuen Fehlercodes Ihnen dabei helfen, die Erfahrungen Ihres Publikums besser zu verstehen (und die Verwirrung Ihrer Endbenutzer zu verringern, wenn sie auf ein Problem stoßen).
