@jwplayer/jwplayer-react-native 1.0.3 → 1.1.1

package/android/src/main/java/com/jwplayer/rnjwplayer/RNJWPlayerView.java

@@ -40,6 +40,7 @@ import com.facebook.react.bridge.LifecycleEventListener;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.ReadableType;
 import com.facebook.react.bridge.WritableArray;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.common.MapBuilder;
@@ -156,6 +157,7 @@ public class RNJWPlayerView extends RelativeLayout implements
         VideoPlayerEvents.OnCaptionsListListener,
         VideoPlayerEvents.OnCaptionsChangedListener,
         VideoPlayerEvents.OnMetaListener,
+        VideoPlayerEvents.PlaylistItemCallbackListener,
 
         CastingEvents.OnCastListener,
 
@@ -236,6 +238,9 @@ public class RNJWPlayerView extends RelativeLayout implements
     private MediaServiceController mMediaServiceController;
     private PipHandlerReceiver mReceiver = null;
 
+    // Add completion handler field
+    PlaylistItemDecision itemUpdatePromise = null;
+
     private void doBindService() {
         if (mMediaServiceController != null) {
             if (!isBackgroundAudioServiceRunning()) {
@@ -379,6 +384,9 @@ public class RNJWPlayerView extends RelativeLayout implements
             mActivity.getLifecycle().removeObserver(lifecycleObserver);
             mPlayer.deregisterActivityForPip();
 
+            // Remove playlist item callback listener
+            mPlayer.removePlaylistItemCallbackListener();
+
             mPlayer.removeListeners(this,
                     // VideoPlayerEvents
                     EventType.READY,
@@ -456,7 +464,7 @@ public class RNJWPlayerView extends RelativeLayout implements
         }
     }
 
-    public void setupPlayerView(Boolean backgroundAudioEnabled) {
+    public void setupPlayerView(Boolean backgroundAudioEnabled, Boolean playlistItemCallbackEnabled) {
         if (mPlayer != null) {
 
             mPlayer.addListeners(this,
@@ -470,6 +478,8 @@ public class RNJWPlayerView extends RelativeLayout implements
                     EventType.SETUP_ERROR,
                     EventType.BUFFER,
                     EventType.TIME,
+                    EventType.AUDIO_TRACKS,
+                    EventType.AUDIO_TRACK_CHANGED,
                     EventType.PLAYLIST,
                     EventType.PLAYLIST_ITEM,
                     EventType.PLAYLIST_COMPLETE,
@@ -519,9 +529,33 @@ public class RNJWPlayerView extends RelativeLayout implements
             } else {
                 mPlayer.setFullscreenHandler(new fullscreenHandler());
             }
-
             mPlayer.allowBackgroundAudio(backgroundAudioEnabled);
+
+            if (playlistItemCallbackEnabled) {
+                mPlayer.setPlaylistItemCallbackListener(this);
+            }
+        }
+    }
+
+   public void resolveNextPlaylistItem(ReadableMap playlistItem) {
+        if (itemUpdatePromise == null) {
+            return;
+        }
+
+        if (playlistItem == null) {
+            itemUpdatePromise.continuePlayback();
+            itemUpdatePromise = null;
+            return;
         }
+
+        try {
+            PlaylistItem updatedPlaylistItem = Util.getPlaylistItem(playlistItem);
+            itemUpdatePromise.modify(updatedPlaylistItem);
+        } catch (Exception exception) {
+            itemUpdatePromise.continuePlayback();
+        }
+
+        itemUpdatePromise = null;
     }
 
     /**
@@ -625,6 +659,18 @@ public class RNJWPlayerView extends RelativeLayout implements
         return delegate;
     }
 
+    @Override
+    public void onBeforeNextPlaylistItem(PlaylistItemDecision playlistItemDecision, PlaylistItem nextItem, int indexOfNextItem) {
+        WritableMap event = Arguments.createMap();
+        Gson gson = new Gson();
+        event.putString("message", "onBeforeNextPlaylistItem");
+        event.putInt("index", indexOfNextItem);
+        event.putString("playlistItem", gson.toJson(nextItem));
+        getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topBeforeNextPlaylistItem", event);
+
+        itemUpdatePromise = playlistItemDecision;
+    }
+
     private class fullscreenHandler implements FullscreenHandler {
         ViewGroup mPlayerViewContainer = (ViewGroup) mPlayerView.getParent();
         private View mDecorView;
@@ -901,7 +947,7 @@ public class RNJWPlayerView extends RelativeLayout implements
         return differences.size() == 1 && differences.containsKey(keyName);
     }
 
-    boolean playlistNotTheSame(ReadableMap prop) {
+    private boolean playlistNotTheSame(ReadableMap prop) {
         return prop.hasKey("playlist") && mPlaylistProp != prop.getArray("playlist") && !Arrays
                 .deepEquals(new ReadableArray[]{mPlaylistProp}, new ReadableArray[]{prop.getArray("playlist")});
     }
@@ -913,6 +959,7 @@ public class RNJWPlayerView extends RelativeLayout implements
         JSONObject obj;
         PlayerConfig jwConfig = null;
         Boolean forceLegacy = prop.hasKey("forceLegacyConfig") ? prop.getBoolean("forceLegacyConfig") : false;
+        Boolean playlistItemCallbackEnabled = prop.hasKey("playlistItemCallbackEnabled") ? prop.getBoolean("playlistItemCallbackEnabled") : false;
         Boolean isJwConfig = false;
         if (!forceLegacy) {
             try {
@@ -1019,9 +1066,11 @@ public class RNJWPlayerView extends RelativeLayout implements
                 ReadableArray uiGroupsArray = prop.getArray("hideUIGroups");
                 UiConfig.Builder hideConfigBuilder = new UiConfig.Builder().displayAllControls();
                 for (int i = 0; i < uiGroupsArray.size(); i++) {
-                    UiGroup uiGroup = GROUP_TYPES.get(uiGroupsArray.getString(i));
-                    if (uiGroup != null) {
-                        hideConfigBuilder.hide(uiGroup);
+                    if (uiGroupsArray.getType(i) == ReadableType.String) {
+                        UiGroup uiGroup = GROUP_TYPES.get(uiGroupsArray.getString(i));
+                        if (uiGroup != null) {
+                            hideConfigBuilder.hide(uiGroup);
+                        }
                     }
                 }
                 UiConfig hideJwControlbarUiConfig = hideConfigBuilder.build();
@@ -1046,7 +1095,7 @@ public class RNJWPlayerView extends RelativeLayout implements
         addView(mPlayerView);
 
         // Ensure we have a valid state before applying to the player
-        registry.setCurrentState(Lifecycle.State.STARTED);
+        registry.setCurrentState(registry.getCurrentState()); // This is a hack to ensure player and view know the lifecycle state
 
         mPlayer = mPlayerView.getPlayer(this);
 
@@ -1150,7 +1199,7 @@ public class RNJWPlayerView extends RelativeLayout implements
             backgroundAudioEnabled = prop.getBoolean("backgroundAudioEnabled");
         }
 
-        setupPlayerView(backgroundAudioEnabled);
+        setupPlayerView(backgroundAudioEnabled, playlistItemCallbackEnabled);
 
         if (backgroundAudioEnabled) {
             audioManager = (AudioManager) simpleContext.getSystemService(Context.AUDIO_SERVICE);
@@ -1312,7 +1361,7 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdLoaded(AdLoadedEvent adLoadedEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adLoadedEvent.getClient().toString());
+        event.putInt("client", Util.getAdEventClientValue(adLoadedEvent));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1320,7 +1369,7 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdLoadedXml(AdLoadedXmlEvent adLoadedXmlEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adLoadedXmlEvent.getClient().toString());
+        event.putInt("client", Util.getAdEventClientValue(adLoadedXmlEvent));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1329,7 +1378,8 @@ public class RNJWPlayerView extends RelativeLayout implements
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
         event.putString("reason", adPauseEvent.getAdPauseReason().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypePause));
+        event.putInt("client", Util.getAdEventClientValue(adPauseEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypePause));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1338,7 +1388,8 @@ public class RNJWPlayerView extends RelativeLayout implements
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
         event.putString("reason", adPlayEvent.getAdPlayReason().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypePlay));
+        event.putInt("client", Util.getAdEventClientValue(adPlayEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypePlay));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1346,8 +1397,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdBreakEnd(AdBreakEndEvent adBreakEndEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adBreakEndEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeAdBreakEnd));
+        event.putInt("client", Util.getAdEventClientValue(adBreakEndEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeAdBreakEnd));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1355,8 +1406,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdBreakStart(AdBreakStartEvent adBreakStartEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adBreakStartEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeAdBreakStart));
+        event.putInt("client", Util.getAdEventClientValue(adBreakStartEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeAdBreakStart));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1364,7 +1415,7 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdBreakIgnored(AdBreakIgnoredEvent adBreakIgnoredEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adBreakIgnoredEvent.getClient().toString());
+        event.putInt("client", Util.getAdEventClientValue(adBreakIgnoredEvent));
         // missing type code
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
@@ -1373,8 +1424,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdClick(AdClickEvent adClickEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adClickEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeClicked));
+        event.putInt("client", Util.getAdEventClientValue(adClickEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeClicked));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1382,7 +1433,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdCompanions(AdCompanionsEvent adCompanionsEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeCompanion));
+        event.putInt("client", Util.getAdEventClientValue(adCompanionsEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeCompanion));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1390,8 +1442,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdComplete(AdCompleteEvent adCompleteEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adCompleteEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeComplete));
+        event.putInt("client", Util.getAdEventClientValue(adCompleteEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeComplete));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1419,8 +1471,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdImpression(AdImpressionEvent adImpressionEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adImpressionEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeImpression));
+        event.putInt("client", Util.getAdEventClientValue(adImpressionEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeImpression));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1428,8 +1480,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdMeta(AdMetaEvent adMetaEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adMetaEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeMeta));
+        event.putInt("client", Util.getAdEventClientValue(adMetaEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeMeta));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1437,8 +1489,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdRequest(AdRequestEvent adRequestEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adRequestEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeRequest));
+        event.putInt("client", Util.getAdEventClientValue(adRequestEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeRequest));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1446,8 +1498,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdSchedule(AdScheduleEvent adScheduleEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adScheduleEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeSchedule));
+        event.putInt("client", Util.getAdEventClientValue(adScheduleEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeSchedule));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1455,8 +1507,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdSkipped(AdSkippedEvent adSkippedEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putString("client", adSkippedEvent.getClient().toString());
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeSkipped));
+        event.putInt("client", Util.getAdEventClientValue(adSkippedEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeSkipped));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 
@@ -1464,7 +1516,8 @@ public class RNJWPlayerView extends RelativeLayout implements
     public void onAdStarted(AdStartedEvent adStartedEvent) {
         WritableMap event = Arguments.createMap();
         event.putString("message", "onAdEvent");
-        event.putInt("type", Util.getEventTypeValue(Util.AdEventType.JWAdEventTypeStarted));
+        event.putInt("client", Util.getAdEventClientValue(adStartedEvent));
+        event.putInt("type", Util.getAdEventTypeValue(Util.AdEventType.JWAdEventTypeStarted));
         getReactContext().getJSModule(RCTEventEmitter.class).receiveEvent(getId(), "topAdEvent", event);
     }
 

package/android/src/main/java/com/jwplayer/rnjwplayer/RNJWPlayerViewManager.java

@@ -1,4 +1,3 @@
-
 package com.jwplayer.rnjwplayer;
 
 import com.facebook.react.bridge.ReactApplicationContext;
@@ -41,6 +40,9 @@ public class RNJWPlayerViewManager extends SimpleViewManager<RNJWPlayerView> {
 
   @ReactProp(name = "controls")
   public void setControls(RNJWPlayerView view, Boolean controls) {
+    if (view == null || view.mPlayerView == null) {
+      return;
+    }
     view.mPlayerView.getPlayer().setControls(controls);
   }
 
@@ -171,6 +173,10 @@ public class RNJWPlayerViewManager extends SimpleViewManager<RNJWPlayerView> {
                     MapBuilder.of(
                             "phasedRegistrationNames",
                             MapBuilder.of("bubbled", "onLoaded")))
+            .put("topBeforeNextPlaylistItem",
+                    MapBuilder.of(
+                            "phasedRegistrationNames",
+                            MapBuilder.of("bubbled", "onBeforeNextPlaylistItem")))
             .build();
   }
 

package/android/src/main/java/com/jwplayer/rnjwplayer/Util.java

@@ -9,6 +9,8 @@ import android.webkit.URLUtil;
 import com.facebook.react.bridge.ReadableArray;
 import com.facebook.react.bridge.ReadableMap;
 import com.jwplayer.pub.api.JsonHelper;
+import com.jwplayer.pub.api.configuration.ads.AdvertisingConfig;
+import com.jwplayer.pub.api.events.Event;
 import com.jwplayer.pub.api.media.ads.AdBreak;
 import com.jwplayer.pub.api.media.captions.Caption;
 import com.jwplayer.pub.api.media.captions.CaptionType;
@@ -253,7 +255,42 @@ public class Util {
     }
 
     // Method to get the event type value
-    public static int getEventTypeValue(AdEventType eventType) {
+    public static int getAdEventTypeValue(AdEventType eventType) {
         return eventType.getValue();
     }
-}
+
+    public enum AdEventClient {
+        JWAdEventClientJWPlayer(0),
+        JWAdEventClientGoogleIMA(1),
+        JWAdEventClientGoogleIMADAI(2),
+        JWAdEventClientUnknown(3);
+
+        private final int value;
+
+        AdEventClient(int value) {
+            this.value = value;
+        }
+
+        public int getValue() {
+            return value;
+        }
+    }
+
+    public static int getAdEventClientValue(Event adEvent) {
+        AdvertisingConfig adConfig = adEvent.getPlayer().getConfig().getAdvertisingConfig();
+        if (adConfig == null) {
+            return AdEventClient.JWAdEventClientUnknown.getValue();
+        }
+
+        switch (adConfig.getAdClient()) {
+            case IMA:
+                return AdEventClient.JWAdEventClientGoogleIMA.getValue();
+            case IMA_DAI:
+                return AdEventClient.JWAdEventClientGoogleIMADAI.getValue();
+            case VAST:
+                return AdEventClient.JWAdEventClientJWPlayer.getValue();
+            default:
+                return AdEventClient.JWAdEventClientUnknown.getValue();
+        }
+    }
+}

package/badges/version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="90" height="20" role="img" aria-label="version: 1.0.3"><title>version: 1.0.3</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="90" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="51" height="20" fill="#555"/><rect x="51" width="39" height="20" fill="#007ec6"/><rect width="90" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text aria-hidden="true" x="265" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="410">version</text><text x="265" y="140" transform="scale(.1)" fill="#fff" textLength="410">version</text><text aria-hidden="true" x="695" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="290">1.0.3</text><text x="695" y="140" transform="scale(.1)" fill="#fff" textLength="290">1.0.3</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="90" height="20" role="img" aria-label="version: 1.1.1"><title>version: 1.1.1</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="90" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="51" height="20" fill="#555"/><rect x="51" width="39" height="20" fill="#007ec6"/><rect width="90" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text aria-hidden="true" x="265" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="410">version</text><text x="265" y="140" transform="scale(.1)" fill="#fff" textLength="410">version</text><text aria-hidden="true" x="695" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="290">1.1.1</text><text x="695" y="140" transform="scale(.1)" fill="#fff" textLength="290">1.1.1</text></g></svg>

package/index.d.ts

@@ -6,6 +6,10 @@ declare module "@jwplayer/jwplayer-react-native" {
     pid?: string;
     mute?: boolean;
     forceLegacyConfig?: boolean;
+    /**
+     * If true, `onBeforeNextPlaylistItem` MUST be impelemented with `player.resolveNextPlaylistItem()` called in the callback or content will hang
+     */
+    playlistItemCallbackEnabled?: boolean;
     useTextureView?: boolean;
     autostart?: boolean;
     nextupoffset?: string | number; // String with % or number
@@ -518,7 +522,7 @@ declare module "@jwplayer/jwplayer-react-native" {
     adErrorCode?: number; // Android only
   }
   interface AdEventProps {
-    client?: string;
+    client: number;
     reason?: string;
     type: number;
   }
@@ -570,6 +574,7 @@ declare module "@jwplayer/jwplayer-react-native" {
     onCaptionsList?: (event: BaseEvent<CaptionsListEventProps>) => void;
     onAudioTracks?: () => void;
     shouldComponentUpdate?: (nextProps: any, nextState: any) => boolean;
+    onBeforeNextPlaylistItem?: (event: BaseEvent<PlaylistItemEventProps>) => void;
   }
 
   export default class JWPlayer extends React.Component<PropsType> {
@@ -586,7 +591,16 @@ declare module "@jwplayer/jwplayer-react-native" {
     setControls(show: boolean): void;
     setLockScreenControls(show: boolean): void;
     seekTo(time: number): void;
-    loadPlaylist(playlistItems: PlaylistItem[] | JwPlaylistItem[] | string): void;
+    /**
+     * Side load playlist items into an already setup player
+     * @param playlistItems `PlaylistItem` or `JwPlaylistItem`
+     */
+    loadPlaylist(playlistItems: PlaylistItem[] | JwPlaylistItem[]): void;
+    /**
+     * Side load playlist via URL into an already setup player
+     * @param playlistUrl URL for playlist to load (format for response: json)
+     */
+    loadPlaylistWithUrl(playlistUrl: string): void;
     setFullscreen(fullScreen: boolean): void;
     position(): Promise<number>;
     setUpCastController(): void;
@@ -601,5 +615,10 @@ declare module "@jwplayer/jwplayer-react-native" {
     setCurrentCaptions(index: number): void;
     getCurrentCaptions(): Promise<number | null>; 
     setVisibility(visibility: boolean, controls: JWControlType[]): void;
+    /**
+     * Only called inside `onBeforeNextPlaylistItem` callback, and once per callback
+     * @param playlistItem  `PlaylistItem` or  `JwPlaylistItem`
+     */
+    resolveNextPlaylistItem(playlistItem: PlaylistItem | JwPlaylistItem): void;
   }
 }

package/index.js

@@ -174,6 +174,12 @@ export default class JWPlayer extends Component {
 		config: PropTypes.shape({
 			license: PropTypes.string.isRequired,
 			forceLegacyConfig: PropTypes.bool,
+			/**
+			 * Only enable if you are prepared to implement `onBeforeNextPlaylistItem` on the JS side
+			 * And resolve the promise with `resolveNextPlaylistItem` inside the callback
+			 * Otherwise, the player will not proceed to the next item
+			 */
+			playlistItemCallbackEnabled: PropTypes.bool,
 			backgroundAudioEnabled: PropTypes.bool,
 			category: PropTypes.oneOf([
 				'Ambient',
@@ -374,6 +380,16 @@ export default class JWPlayer extends Component {
 		onCaptionsChanged: PropTypes.func,
 		onCaptionsList: PropTypes.func,
 		onAudioTracks: PropTypes.func,
+		/**
+		 * Callback that is fired when the player is about to play the next playlist item.
+		 * Indented to be paired with `playlistItemCallbackEnabled` prop
+		 * 
+		 * Android will only fire after index 0 (starting at index 1) 
+	 	 * 
+	     * iOS will fire all playlist items (including index 0)
+		 */
+		onBeforeNextPlaylistItem: PropTypes.func,
+		resolveNextPlaylistItem: PropTypes.func
 	};
 
 	constructor(props) {
@@ -381,8 +397,7 @@ export default class JWPlayer extends Component {
 
 		this._playerId = playerId++;
 		this.ref_key = `${RCT_RNJWPLAYER_REF}-${this._playerId}`;
-
-		this.quite();
+	
 	}
 
 	shouldComponentUpdate(nextProps, nextState) {
@@ -520,6 +535,11 @@ export default class JWPlayer extends Component {
 			RNJWPlayerManager.loadPlaylist(this.getRNJWPlayerBridgeHandle(), playlistItems);
 	}
 
+	loadPlaylistWithUrl(playlistUrl) {
+		if (RNJWPlayerManager)
+			RNJWPlayerManager.loadPlaylistWithUrl(this.getRNJWPlayerBridgeHandle(), playlistUrl);
+	}
+
 	setFullscreen(fullscreen) {
 		if (RNJWPlayerManager)
 			RNJWPlayerManager.setFullscreen(
@@ -707,6 +727,22 @@ export default class JWPlayer extends Component {
 		}
 	}
 
+	/**
+	 * Only to be called in the onBeforeNextPlaylistItem callback.
+	 * If called outside of the callback, it will not have any effect.
+	 * 
+	 * Can only be called once inside the onBeforeNextPlaylistItem callback.
+	 * @param {PlaylistItem | JwPlaylistItem} playlistItem 
+	 */
+	resolveNextPlaylistItem(playlistItem) { 
+		if (RNJWPlayerManager) {
+			RNJWPlayerManager.resolveNextPlaylistItem(
+				this.getRNJWPlayerBridgeHandle(),
+				playlistItem
+			);
+		}
+	}
+
 	getRNJWPlayerBridgeHandle() {
 		return findNodeHandle(this[this.ref_key]);
 	}

package/ios/RNJWPlayer/RNJWPlayerView.swift

@@ -16,7 +16,12 @@ import JWPlayerKit
     import GoogleCast
 #endif
 
-class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDelegate, JWAVDelegate, JWPlayerViewDelegate, JWPlayerViewControllerDelegate, JWDRMContentKeyDataSource, JWTimeEventListener, AVPictureInPictureControllerDelegate {
+class RNJWPlayerView: UIView, JWPlayerDelegate, JWPlayerStateDelegate,
+    JWAdDelegate, JWAVDelegate, JWPlayerViewDelegate,
+    JWPlayerViewControllerFullScreenDelegate, JWPlayerViewControllerUIDelegate,
+    JWPlayerViewControllerRelatedDelegate, JWDRMContentKeyDataSource,
+    JWTimeEventListener, AVPictureInPictureControllerDelegate
+{ 
     
     // MARK: - RNJWPlayer allocation
 
@@ -41,6 +46,7 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
     var castController: JWCastController!
     var isCasting: Bool = false
     var availableDevices: [AnyObject]!
+    var onBeforeNextPlaylistItemCompletion: ((JWPlayerItem?) -> ())?
     
     @objc var onBuffer: RCTDirectEventBlock?
     @objc var onUpdateBuffer: RCTDirectEventBlock?
@@ -87,6 +93,7 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
     @objc var onCastingFailed: RCTDirectEventBlock?
     @objc var onCaptionsChanged: RCTDirectEventBlock?
     @objc var onCaptionsList: RCTDirectEventBlock?
+    @objc var onBeforeNextPlaylistItem: RCTDirectEventBlock?
     
     init() {
         super.init(frame: CGRect(x: 20, y: 0, width: UIScreen.main.bounds.width - 40, height: 300))
@@ -283,6 +290,7 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
 
     func setNewConfig(config: [String : Any]) {
         let forceLegacyConfig = config["forceLegacyConfig"] as? Bool?
+        let playlistItemCallback = config["playlistItemCallbackEnabled"] as? Bool?
         let data:Data! = try? JSONSerialization.data(withJSONObject: config, options:.prettyPrinted)
         let jwConfig = try? JWJSONParser.config(from:data)
         
@@ -348,6 +356,11 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
                         self.setupPlayerViewController(config: config, playerConfig: jwConfig!)
                     }
                 }
+                
+                if playlistItemCallback == true {
+                    self.setupPlaylistItemCallback()
+                }
+
             } catch {
                 print(error)
             }
@@ -362,6 +375,47 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
         }
     }
 
+    func setupPlaylistItemCallback() {
+        playerViewController.player.setPlaylistItemCallback { [weak self] item, index, completion in
+            print("setPlaylistItemCallback called with index \(index)")
+            guard let self = self else {
+                print("setPlaylistItemCallback: self is nil, resuming normally")
+                completion(item)
+                return
+            }
+            
+            if let onBeforeNextPlaylistItem = self.onBeforeNextPlaylistItem {
+                print("Storing completion handler and triggering onBeforeNextPlaylistItem")
+                // Store the completion handler first, before any other operations
+                self.onBeforeNextPlaylistItemCompletion = completion
+                print("Completion handler stored: \(self.onBeforeNextPlaylistItemCompletion != nil)")
+
+                do {
+                    let data = try JSONSerialization.data(withJSONObject: item.toJSONObject(), options: [.prettyPrinted])
+                    let jsonString = String(data: data, encoding: .utf8) ?? "{}"
+
+                    print("Triggering onBeforeNextPlaylistItem with index \(index)")
+                    print("Completion handler before event: \(self.onBeforeNextPlaylistItemCompletion != nil)")
+
+                    // Pass the playlist item to the React Native side
+                    onBeforeNextPlaylistItem([
+                        "playlistItem": jsonString,
+                        "index": index
+                    ])
+                    print("Completion handler after event: \(self.onBeforeNextPlaylistItemCompletion != nil)")
+                
+                } catch {
+                    print("Error serializing playlist item: \(error)")
+                    self.onBeforeNextPlaylistItemCompletion?(item) // Call completion handler directly on error
+                    self.onBeforeNextPlaylistItemCompletion = nil
+                }
+            } else {
+                print("No onBeforeNextPlaylistItem handler set, calling completion directly")
+                completion(item)
+            }
+        }
+    }
+
     // MARK: - RNJWPlayer styling
 
     func colorWithHexString(hex:String!) -> UIColor! {
@@ -1231,10 +1285,6 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
     func jwplayerContentDidComplete(_ player:JWPlayer) {
         self.onComplete?([:])
     }
-    
-    func jwplayerContentIsBuffering(_ player: any JWPlayerKit.JWPlayer) {
-
-    }
 
     func jwplayer(_ player:JWPlayer, didLoadPlaylistItem item:JWPlayerItem, at index:UInt) {
 //        var sourceDict: [String: Any] = [:]
@@ -1384,7 +1434,7 @@ class RNJWPlayerView : UIView, JWPlayerDelegate, JWPlayerStateDelegate, JWAdDele
     // MARK: - JWPlayer Ad Delegate
 
     func jwplayer(_ player:JWPlayer, adEvent event:JWAdEvent) {
-        self.onAdEvent?(["client": event.client, "type": event.type])
+        self.onAdEvent?(["client": event.client.rawValue, "type": event.type.rawValue])
     }
 
     // MARK: - JWPlayer AV Delegate