Troubleshooting (iOS v3)


Use of the iOS SDK v3 requires a JWP Enterprise license. Please contact our team if you would like to upgrade your account.

Known issue

  • Unintended behavior may appear during Fullscreen on iPad devices if upside down orientation is enabled. For optimal behavior please disable the upside down device orientation.

For more information about JWP Ads Edition features, see


Where can I find the JWP demo app?

Where can I find the CocoaPods for this SDK?

How do I change the information in the Control Center?

We recommend to avoid using the MPNowPlayingInfoCenter to modify the information in the Control Center when using the SDK; modifying it will lead to unpredictable behavior. Instead, allow the SDK to handle conveying your media's metadata to the Control Center.

If you nevertheless wish to override the Control Center yourself, make sure to inform the SDK by setting the JWPlayerController's displayLockScreenControls property to false.

I received an error on my import header: 'JWPlayer-iOS-SDK/JWPlayerController.h' file not found. What should I do?

This error is most likely due to XCode not being able to find the path of the SDK framework. Please go to 'Build Settings', 'Search Paths' then 'Framework Search Path' and examine the path listed for the framework.

Why is my app not playing any sound? AND Why is my app playing another app's audio at the same time as mine?

(a) This could be for a number of reasons, but check to see if your device is on silent mode, and if sound is restored when silent mode is off. If so, and also for issue (b), you just need to add a couple of lines of code to your project to let iOS know to handle your app for media playback – where your app is not silenced by the ring/silent switch or screen locking, and by default it interrupts a 'nonmixable' app's audio. Specifically, set the audio session's category to 'playback', and set your audio session to be the active one. See the overview and snippets on the Advanced Features page in this guide.