Troubleshooting and FAQs

the troubleshooting section provides solutions to common problems developers might encounter while using the core sdk for ios it offers practical advice on how to diagnose and resolve issues related to installation, integration, and functionality of the sdk troubleshooting fetching from github repository does not work please review the installation guide to check how to obtain access to the sdk repository swift package manager can't resolve the latest version try file > packages > reset package caches or file > packages > resolve package versions followed by file > packages > update to latest package versions if this doesn't work, try to remove the package from project navigator > package dependencies and re add by following the installation guide cocoapods can't resolve the latest version try running pod update nwcore class or methods not found ensure that the sdk is properly imported into your project and updated to the latest version also, check the spelling and casing of the class and method names playback doesn’t work as expected please ensure that you have followed the instructions in the getting started guide correctly verify that you have implemented the appid/appkey or programid accurately and that you have initialized the function with the appropriate parameters if you continue to experience issues, please refer back to the 'getting started' section for proper implementation guidelines sdk causes performance issues ensure your app meets the system requirements mentioned in this documentation if the issue persists, reach out to our developer support sync is constantly failing confirm that the necessary audio permissions have been granted also, check for any conflicts with other apps that might use audio resources the system's audio focus should be appropriately handled playback doesn't resume after internet reconnection ensure that the device is properly reconnected to the internet and the sdk is not blocked by any firewall or network restrictions if the issue persists, restarting the nativewaves exp might help reinitialize the sdk's network modules 'no video available' message appears this message may appear if the video content is unavailable or if the video file is corrupted please try seeking to a different offset to verify the integrity and availability of the video file on the server if you are streaming the video, ensure that your internet connection is stable remember, when reporting issues, always include error messages, logcat output, and steps to reproduce the issue this will help us diagnose and resolve your issue more quickly faqs the faqs section addresses common questions about the core sdk for ios it serves as a quick reference to understand the sdk's features, requirements, and behaviors, offering concise answers to frequently asked questions by developers what versions of ios does the sdk support? the sdk supports ios 14 0 or higher anyhow, keeping the devices and apps up to date is always recommended to improve performance issues where can i find my api key? you can contact nativewaves and request them to generate your github access api key, which will grant you permission to download the library is the sdk compatible with other ios libraries or frameworks? the core sdk is designed to work alongside most popular ios libraries and frameworks if you encounter any specific compatibility issues, please contact our support team can i use the sdk in multiple apps? yes, you can use the same sdk in multiple apps however, we recommend generating a unique api key for each application for better tracking and security why does the sdk require microphone usage permission? the microphone usage permission is required by the core sdk for second screen sync that involve sound input or recording if your app does not utilize this feature, you can safely omit this permission how do i handle a situation where a user denies the audio record permission? if a user denies the audio record permission, any voice input or recording features won't function your app should degrade gracefully in this situation, perhaps by notifying the user that certain features won't be available without this permission what is the guioverlay url, and how is it used? the guioverlay url is a link provided by nativewaves for specific features such as displaying the controller of the playback on top of the player you just have to call the appropriate sdk function and pass the overlay url as a parameter what if the guioverlay url is not working? please confirm that the correct url is passed to the sdk to test the url, you can try opening it in a web browser and inspect it using the browser's developer tools what happens if the internet connection is lost while using the sdk features? the core sdk is designed to handle intermittent network issues gracefully many features will continue to work offline and sync data when the connection is restored however, some features like live updates or certain api calls will require an active internet connection to function what happens to the media playback if the app is kept in the background for a long time? the behavior of media playback depends on the specifications set within your app by default, the video playback might continue in the background, but it will stop if the system kills the app due to resource constraints if you wish to have continuous background playback, you may need to implement background capabilities why does my app stop working when kept in the background for a long time? ios system manages its resources diligently if your app is in the background for an extended period, the system might stop it to free up resources for active apps you can handle this by saving the app state and restoring it when the app comes back to the foreground how can i ensure that certain operations continue even when my app is in the background? for operations that need to continue even when your app is in the background, consider using background capabilities however, be aware that continuous operation in the background may consume more battery what happens to the playback and program api fetch operation if the internet connection is lost? if the internet is not available, the sdk will pause the current playback and attempt to fetch the program api every 6 seconds once the internet connection is reestablished, the sdk will resume the playback and successfully update the program api why am i seeing a 'no video available' message? the 'no video available' message usually appears if the video content is not available or the video file is corrupted check your video source and make sure the file is not corrupted and is properly uploaded to the server if you're streaming, ensure a stable internet connection does the sdk support localization? no, currently we do not support the localization feature however, we have plans to add support for multiple languages and locales in the near future if your question is not addressed in the faq, feel free to reach out to our support team for further assistance