THEOplayer iOS/tvOS 5.0 Feature Integrations
Modularization
The THEOplayer iOS 5.0 SDK uses modularized features, which means there is a base SDK that can handle basic playback and additional feature integrations are provided as separate modules that can be added as desired. This approach gives more flexibility and results in a reduced application size, since non-required parts are not included in the build of the application.
For example, the core SDK is provided by:
import THEOplayerSDK
Meanwhile, additional features such as Google IMA and Google Cast are provided by:
import THEOplayerGoogleIMAIntegration
import THEOplayerGoogleCastIntegration
Importing additional integration modules
As shown in the previous section, importing additional integration modules can be done by simply adding the dependency to your swift source file.
For more information on how to fetch the dependencies to your Xcode project, please check the getting started guide.
Important Note:
It is required to keep the THEOplayer core SDK and all the required feature modules on the same version number.
For example one should not import THEOplayerSDK-core~>5.6.0
and THEOplayer-Integration-GoogleIMA~>5.5.0
in the same project.
Adding integrations
After importing the dependencies, it's time to create the integrations and connect them to THEOplayer.
Each module provides a Factory class that allows the creation of that specific integration.
For example, the Google IMA module provides GoogleImaIntegrationFactory
and the Google Cast module provides GoogleCastIntegrationFactory
.
Additionally, the THEOplayer
class provides the addIntegration(_ integration: Integration)
API which allows adding the integration to the player.
Connecting the feature integration with the THEOplayer
will make them available to be used.
Otherwise, calling an API from an integration without adding it to the THEOplayer
will cause an error to be thrown.
Available feature integrations
With THEOplayer iOS 5.0 SDK we currently support the following feature integrations:
Feature | Dependency | Release | Documentation |
---|---|---|---|
Google IMA | THEOplayerGoogleIMAIntegration | 5.0.0 | documentation |
Chromecast | THEOplayerGoogleCastIntegration | 5.0.0 | documentation |