Hello! I work on the Stream team and I wanted to share an upcoming Stream Player change that could impact developers who may be making customizations to the player DOM elements.
You can stop reading if you aren’t making changes to the contents of the element or if you only use the official player API. Similarly, if you use the official React or Angular components, this change will not affect you.
Please keep reading if you use functions such as “document.getElementById()” in or CSS selectors with “stream” to modify the player.
What is changing, when and why?
The update will improve the reliability and the viewing experience using an iframe element to sandbox the player. The change will provide the following benefits:
- Fewer unintended CSS collisions
- Better error monitoring
- Persistent client bandwidth estimation so videos start playing at the optimal resolution
- Security benefits from Stream Player code executing in a separate context from your website
How can I access a preview build?
We have released an early build of the new player. Please test your website with the preview player:
No further action is needed if you see no change in playback behavior.
We plan to start a gradual roll out in two weeks to the existing embed URLs, beginning August 3, 2020.
One of the features/customizations I built will break! Is there a way to support a new player API?
Yes! Please share your use case below and we’ll do our best to show you how to do it with the existing API or figure out how we can support it officially. You can also email me at [email protected].