myetv-player 1.1.0 → 1.1.2

package/README.md

@@ -119,6 +119,7 @@ const player = new MYETVvideoplayer('my-video', {
 | `brandLogoEnabled` | boolean | `false` | Show/hide the brand logo in the controlbar |
 | `brandLogoUrl` | string | `''` | Brand logo url in the controlbar (png, jpg, gif) - image height 44px - image width 120px |
 | `brandLogoLinkUrl` | string | `''` | Optional URL to open in a new page when clicking the brand logo in the controlbar
+| `brandLogoTooltipText` | string | `''` | Optional Custom tooltip of the brand logo (the default is the url of the brand logo, if present)
 | `watermarkUrl` | string | `''` | Optional URL of the image watermark over the video, reccomended dimension: width: 180px, height: 100px
 | `watermarkLink` | string | `''` | Optional URL to open in a new page when clicking the watermark logo in the video
 | `watermarkPosition` | string | `''` | Optional where to show the watermark logo in the video (values are: top-left, top-right, bottom-left, bottom-right)
@@ -283,8 +284,21 @@ console.log(player.getCurrentResolution()); // Get current resolution
 ```
 ## API Events
 The MYETV Video Player includes a comprehensive custom event system that allows you to monitor all player state changes in real-time.
+### on player ready
+Description: Triggered when the video player is ready
+
+When: Player is ready to receive other events
+```
+player.addEventListener('playerready', (event) => {
+    console.log('Player is ready!', event);
+//now it's secure to call other apis method
+        player.setVolume(0.8);
+        player.play();
+});
+```
 ### on played
 Description: Triggered when the video starts playing
+
 When: User presses play or video starts automatically
 ```
 player.addEventListener('played', (event) => {
@@ -294,24 +308,72 @@ player.addEventListener('played', (event) => {
     });
 });
 ```
+### on playing
+Description: Triggered when the video is playing
+
+When: Video is effectively playing
+```
+player.addEventListener('playing', (event) => {
+    console.log('Video is playing at', event.currentTime);
+});
+```
 ### on paused
 Description: Triggered when the video is pause
+
 When: User presses pause or video stops
 ```
 player.addEventListener('paused', (event) => {
     console.log('Video paused at:', event.currentTime + 's');
 });
 ```
+### on waiting
+Description: Triggered when the video is buffering
+
+When: Video is buffering and is waiting
+```
+player.addEventListener('waiting', (event) => {
+    console.log('Video is buffering...');
+});
+```
+### on seeking
+Description: Triggered when the video is being seeking
+
+When: The user is seeking over the video
+```
+player.addEventListener('seeking', (event) => {
+    console.log('User is seeking to', event.targetTime);
+});
+```
+### on seeked
+Description: Triggered when the video is finished seeked
+
+When: The user have finished seeking and seeked the video
+```
+player.addEventListener('seeked', (event) => {
+    console.log('Seek completed at', event.currentTime);
+});
+```
 ### on ended
 Description: Triggered when the video is ended
+
 When: Video is ended
 ```
 player.addEventListener('ended', (e) => {
     console.log('Video terminato!', e.currentTime, e.duration, e.playlistInfo);
 });
 ```
+### on error
+Description: Triggered when the video have some error
+
+When: Video have some error on load
+```
+player.addEventListener('error', (event) => {
+    console.error('Playback error:', event.message);
+});
+```
 ### on subtitle change
 Description: Triggered when subtitles are enabled/disabled or track changes
+
 When: User toggles subtitles or switches subtitle tracks
 ```
 player.addEventListener('subtitlechange', (event) => {
@@ -324,6 +386,7 @@ player.addEventListener('subtitlechange', (event) => {
 ```
 ### on chapters change
 Description: Triggered when chapters are changes
+
 When: User switches chapters tracks
 ```
 player.on('chapterchange', (data) => {
@@ -332,6 +395,7 @@ player.on('chapterchange', (data) => {
 ```
 ### on pip change
 Description: Triggered when Picture-in-Picture mode changes
+
 When: Video enters or exits PiP mode
 ```
 player.addEventListener('pipchange', (event) => {
@@ -340,6 +404,7 @@ player.addEventListener('pipchange', (event) => {
 ```
 ### on fullscreen change
 Description: Triggered when fullscreen mode changes
+
 When: Player enters or exits fullscreen mode
 ```
 player.addEventListener('fullscreenchange', (event) => {
@@ -348,6 +413,7 @@ player.addEventListener('fullscreenchange', (event) => {
 ```
 ### on speed change
 Description: Triggered when playback speed changes
+
 When: User modifies playback speed (0.5x, 1x, 1.5x, 2x, etc.)
 ```
 player.addEventListener('speedchange', (event) => {
@@ -356,6 +422,7 @@ player.addEventListener('speedchange', (event) => {
 ```
 ### on time update
 Description: Triggered during playback to update progress
+
 When: Every 250ms during playback (throttled for performance)
 ```
 player.addEventListener('timeupdate', (event) => {
@@ -366,6 +433,7 @@ player.addEventListener('timeupdate', (event) => {
 ```
 ### on volumechange
 Description: Triggered when volume or mute state changes
+
 When: User modifies volume or toggles mute
 ```
 player.addEventListener('volumechange', (event) => {
@@ -384,6 +452,7 @@ player.addEventListener('playlistchange', (e) => {
 ```
 ### Main APIs
 getEventData()
+
 Returns all requested state data in a single object:
 ```
 const state = player.getEventData();