Overview
Error events can occur while doing following tasks,
- Creating an asset.
- Playing an asset.
- Downloading an asset.
The handling of error events for all above tasks is different.
- Creating an asset
Method createAsset of VdoAsset accepts a closure which returns an error if the request is failed
- Playing an asset
Protocol AssetPlaybackDelegate has streamLoadError method that will be called if any error event occurs while initiating playback
- Downloading an asset.
Notification Center is extended to provide a notification with key
AssetDownloadFailed in case any error occurs when download is initiated
Troubleshooting
Below are the possible error events that can occur when using iOS Native SDK.
| Code | Message | Meaning & Resolution |
|---|---|---|
| 3001 | Fairplay certificate request failed. | Certificate could not fetch. Check if video can play in Safari on macOS if the FPS configuration is correct. |
| 3002 | Empty license. Try again after some time. | Unlikely to happen. Please ask the client for IP address and contact us. |
| 3003 | License request failed to connect. Try again after some time. | It occurs when license key is not returned by the server, report VdoCipher team if this event is encountered |
| 3004 | Could not obtain license due to network error | It occurs when the license request is failed because of some network related issues |
| 3006 | Video is not enabled for this device. | Video does not have the required profiles for iOS. Go to your Dashboard > iOS DRM Config; or contact us. |
| 3007 | License Key Request failed. | It occurs when license key is not returned by the server, report VdoCipher team if this event is encountered |
| 3008 | Download is only supported with FPS Configuration. | It occurs when startDownload() is called for non-fairplay enabled asset |
| 3009 | Video meta-data load failed! | It occurs when meta data request has failed |
| 3010 | Rental Duration of this download has expired, Please download again to watch offline | It occurs when playOffline is initiad but is failed because rental duration of the downloaded is expired |
| 3011 | Asset Not Loaded | It occurs when play or download is initiated before asset is loaded |
| 3012 | File Not Found! | It occurs when downloaded file is deleted by either OS or by user |
| 3013 | Unexpected credential error. Try again after some time. | Unexpected credential error. Try again after some time. |
| 3014 | Asset meta-data request failed! Check video id and player config id. | It occurs when either video-id or the player config id are wrong |
| 3015 | OTP do not support download capability | It occurs when download is initiated with an otp that is not configured for offline use |
| 3016 | Playback Info passed to the SDK for the Vdo Asset is invalid. Try again with the valid playback info. | It occurs when attempting to initiate online playback the given playback info is wrong |
| 3017 | Unexpected error occured while processing the request. Try again after some time. | It occurs when server unavailable |
| 3018 | Unexpected error occured while loading the manifest. Try again after some time. | It occurs when manifest fails to load |
| 3019 | Media file could not be loaded... Please try after some time. | Generic media load error message string |
| 2xxx | Dynamic Message returned from server | License server denied access. Please check OTP and follow error message for resolution |