![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUwOTIuMjUiIHgyPSIxNiIgeTI9Ii01MTIzLjk4IiBncmFkaWVudFRyYW5zZm9ybT0ibWF0cml4KDEsIDAsIDAsIC0xLCAwLCAtNTA5Mi4xMikiIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIj48c3RvcCBvZmZzZXQ9IjAiIHN0b3AtY29sb3I9IiMxYWIzZmYiLz48c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiMwZTgyZmYiLz48L2xpbmVhckdyYWRpZW50PjwvZGVmcz48dGl0bGU+SWNvbnM8L3RpdGxlPjxwYXRoIGQ9Ik0xLjUsMTAuNDh2MTFhNC44MSw0LjgxLDAsMCwwLDIuNDMsNC4xN2w5LjY1LDUuNTJhNC44MSw0LjgxLDAsMCwwLDQuODQsMGw5LjY1LTUuNTJhNC44LDQuOCwwLDAsMCwyLjQzLTQuMTd2LTExYTQuODEsNC44MSwwLDAsMC0yLjQzLTQuMTdMMTguNDIuNzlhNC44MSw0LjgxLDAsMCwwLTQuODQsMEwzLjkzLDYuMzFBNC43OCw0Ljc4LDAsMCwwLDEuNSwxMC40OFoiIHN0eWxlPSJmaWxsOnVybCgjYSkiLz48cGF0aCBkPSJNMjQuODMsMTZsLS43MS0xLjIxYS42My42MywwLDAsMC0uNTItLjMxSDIyLjJhLjU4LjU4LDAsMCwwLS41Mi4zMWwtLjQ5Ljg1SDE4LjlhLjEzLjEzLDAsMCwwLDAsMEwxOCwxNC4wNmExLjQxLDEuNDEsMCwwLDAtMS4yMi0uNzFIMTVMMTMuNjgsMTEuMmwuNTQtLjkzYS42LjYsMCwwLDAsMC0uNjFsLS43MS0xLjIxQS42MS42MSwwLDAsMCwxMyw4LjE0aC0xLjRhLjU4LjU4LDAsMCwwLS41Mi4zMWwtLjcxLDEuMjFhLjYuNiwwLDAsMCwwLC42MWwuNzEsMS4yMWEuNjMuNjMsMCwwLDAsLjUyLjMxaC44OWwxLjM0LDIuMjZoMEwxMywxNS41NUExLjQxLDEuNDEsMCwwLDAsMTMsMTdsLjg2LDEuNDkuMDcuMTItMS4yOSwyLjE1aC0xYS42LjYsMCwwLDAtLjUyLjMxbC0uNzEsMS4yMmEuNTkuNTksMCwwLDAsMCwuNmwuNzEsMS4yMmEuNjMuNjMsMCwwLDAsLjUyLjMxSDEzYS42LjYsMCwwLDAsLjUyLS4zMWwuNzEtMS4yMmEuNTkuNTksMCwwLDAsMC0uNmwtLjQ4LS44MywxLjM0LTIuMjVoMS43MWExLjQsMS40LDAsMCwwLDEuMjItLjdsLjg2LTEuNXMwLDAsMCwwaDIuMjlsLjQ5Ljg1YS42NS42NSwwLDAsMCwuNTIuMzFoMS40YS42LjYsMCwwLDAsLjUyLS4zMWwuNzEtMS4yMkEuNjIuNjIsMCwwLDAsMjQuODMsMTZabS03LjEuMzYtLjg2LDEuNDlzMCwwLS4wOCwwSDE1czAsMCwwLDBsLS44Ni0xLjQ5YS4wOC4wOCwwLDAsMSwwLS4wOUwxNSwxNC43NHMwLDAsMCwwYTAsMCwwLDAsMSwwLDBoMS43NGEuMTUuMTUsMCwwLDEsLjA4LjA1bC44NiwxLjQ5QS4xNC4xNCwwLDAsMSwxNy43MywxNi4zMloiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTEuNDgsMTUuNzRhLjY2LjY2LDAsMCwxLC42Ny42NS42NS42NSwwLDAsMS0uNjcuNjZIMTAuMTVhLjY2LjY2LDAsMSwxLDAtMS4zMVoiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTcuOTEsMTkuNjNhLjY3LjY3LDAsMCwxLC45MS4yNEwxOS41LDIxYS42NC42NCwwLDAsMS0uMjQuODkuNzIuNzIsMCwwLDEtLjM0LjA5LjY4LjY4LDAsMCwxLS41OC0uMzRsLS42Ny0xLjE0QS42My42MywwLDAsMSwxNy45MSwxOS42M1oiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTguMjUsMTMuMjVhLjgxLjgxLDAsMCwxLS4zNC0uMDguNjMuNjMsMCwwLDEtLjIzLS45bC42Ny0xLjE1YS42OC42OCwwLDAsMSwuOTEtLjIzLjY1LjY1LDAsMCwxLC4yNC44OWwtLjY3LDEuMTRBLjY1LjY1LDAsMCwxLDE4LjI1LDEzLjI1WiIgc3R5bGU9ImZpbGw6I2ZmZiIvPjwvc3ZnPg==)
![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUyNjguNjQiIHgyPSIxNiIgeTI9Ii01MzAwLjM2IiBncmFkaWVudFRyYW5zZm9ybT0ibWF0cml4KDEsIDAsIDAsIC0xLCAwLCAtNTI2OC41KSIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPjxzdG9wIG9mZnNldD0iMCIgc3RvcC1jb2xvcj0iIzFhYjNmZiIvPjxzdG9wIG9mZnNldD0iMSIgc3RvcC1jb2xvcj0iIzBlODJmZiIvPjwvbGluZWFyR3JhZGllbnQ+PC9kZWZzPjx0aXRsZT5JY29uczwvdGl0bGU+PHBhdGggZD0iTTEuNSwxMC40OHYxMWE0LjgxLDQuODEsMCwwLDAsMi40Myw0LjE3bDkuNjUsNS41MmE0LjgxLDQuODEsMCwwLDAsNC44NCwwbDkuNjUtNS41MmE0LjgsNC44LDAsMCwwLDIuNDMtNC4xN3YtMTFhNC44MSw0LjgxLDAsMCwwLTIuNDMtNC4xN0wxOC40Mi43OWE0LjgxLDQuODEsMCwwLDAtNC44NCwwTDMuOTMsNi4zMUE0Ljc4LDQuNzgsMCwwLDAsMS41LDEwLjQ4WiIgc3R5bGU9ImZpbGw6dXJsKCNhKSIvPjxwYXRoIGQ9Ik0xMy42LDIxLjI5YTEuNzksMS43OSwwLDAsMS0uOS0uMjVBMS4zNywxLjM3LDAsMCwxLDEyLDE5Ljg5VjEzYTEuMzUsMS4zNSwwLDAsMSwuNjgtMS4xNSwxLjc4LDEuNzgsMCwwLDEsMS43MiwwbDYuNTIsMy40N2ExLjMsMS4zLDAsMCwxLDAsMi4zNkwxNC40MiwyMS4xQTEuOSwxLjksMCwwLDEsMTMuNiwyMS4yOVptMC03Ljg4djYuMDZhLjE1LjE1LDAsMCwwLC4yMi4xNGw1LjcxLTNhLjE4LjE4LDAsMCwwLDAtLjMybC01LjcxLTNBLjE1LjE1LDAsMCwwLDEzLjU5LDEzLjQxWiIgc3R5bGU9ImZpbGw6I2ZmZiIvPjwvc3ZnPg==)
![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUxNzUuMDciIHgyPSIxNiIgeTI9Ii01MjA2LjgiIGdyYWRpZW50VHJhbnNmb3JtPSJtYXRyaXgoMSwgMCwgMCwgLTEsIDAsIC01MTc0LjkzKSIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPjxzdG9wIG9mZnNldD0iMCIgc3RvcC1jb2xvcj0iIzFhYjNmZiIvPjxzdG9wIG9mZnNldD0iMSIgc3RvcC1jb2xvcj0iIzBlODJmZiIvPjwvbGluZWFyR3JhZGllbnQ+PC9kZWZzPjx0aXRsZT5JY29uczwvdGl0bGU+PHBhdGggZD0iTTEuNSwxMC40OHYxMWE0LjgxLDQuODEsMCwwLDAsMi40Myw0LjE3bDkuNjUsNS41MmE0LjgxLDQuODEsMCwwLDAsNC44NCwwbDkuNjUtNS41MmE0LjgsNC44LDAsMCwwLDIuNDMtNC4xN3YtMTFhNC44MSw0LjgxLDAsMCwwLTIuNDMtNC4xN0wxOC40Mi43OWE0LjgxLDQuODEsMCwwLDAtNC44NCwwTDMuOTMsNi4zMUE0Ljc4LDQuNzgsMCwwLDAsMS41LDEwLjQ4WiIgc3R5bGU9ImZpbGw6dXJsKCNhKSIvPjxwYXRoIGQ9Ik05LjMzLDE3YS42OC42OCwwLDAsMC0uNjcuNjh2My40MWEuNjcuNjcsMCwxLDAsMS4zNCwwVjE3LjY0QS42Ny42NywwLDAsMCw5LjMzLDE3Wm0zLTIuNjNhLjY3LjY3LDAsMCwwLS42Ny42OHY2YS42Ny42NywwLDEsMCwxLjM0LDBWMTVBLjY3LjY3LDAsMCwwLDEyLjM2LDE0LjMzWm02LjA2LTEuOWEuNjcuNjcsMCwwLDAtLjY3LjY4djcuOTRhLjY3LjY3LDAsMSwwLDEuMzQsMFYxMy4xMUEuNjcuNjcsMCwwLDAsMTguNDIsMTIuNDNaIiBzdHlsZT0iZmlsbDojZmZmIi8+PHBhdGggZD0iTTE0LjcxLDE2LjJhLjY3LjY3LDAsMSwxLDEuMzQsMHY0Ljg2YS42Ny42NywwLDEsMS0xLjM0LDBaIiBzdHlsZT0iZmlsbDojZmZmIi8+PHBhdGggZD0iTTIwLjc3LDEwLjk0YS42Ny42NywwLDAsMSwuNjctLjY4LjY4LjY4LDAsMCwxLC42Ny42OXYxMC4xYS42Ny42NywwLDEsMS0xLjM0LDBaIiBzdHlsZT0iZmlsbDojZmZmIi8+PC9zdmc+)
Android / AndroidTV SDK
The following tutorials show you how to integrate, configure and customize your Bitmovin Player on Android.
Quick Start Guide
This Quick Start Video will walk you the initial steps to run the Android SDK Example Repository using Google Android Studio! In no time you will get started with Player & Analytics, for which you'll need the code snippet below!
Get Started with your own Project
The following steps will walk you through adding the SDK to an new or existing Android Project step by step. If you don't know yet how to start such a project, please visit this Android Developer Guide first, or try the Quick Start Guide above first :)
Step 1: Add the SDK
Add a Link to the Player SDK to the Project
Add a link to our release repository to your application's build.gradle file. In addition to that, the google maven repository must be added.
Add the Dependency to the Project
Add the Bitmovin Player Android SDK as a dependency to your project as shown below, while replacing {version-number} with the desired SDK version number. The available SDK versions are listed in our maven repository.
Step 2: Setup Project
Edit Manifest
The Bitmovin Player license key and the necessary permissions have to be added to the manifest file. The license key should be added inside the application element.
Alternatively, you can specify the license key in the PlayerConfig.
The player requires the INTERNET permission. The following line should be added inside the manifest element.
Step 3: Setup the Player
Instantiate the Player (quick setup)
To get started quickly with the default Bitmovin Web UI, the PlayerView can be added to the layout:
Then you need to create the source.
The last step is to get the player instance in the Activity and load the source into it:
Instantiate the Player (advanced setup)
For more elaborate work flows like specific configurations or a custom UI, the player can be created explicitly as such:
This player can then be attached to a PlayerView:
Alternatively, a custom UI can be implemented. See the corresponding sample for details.
Finally, a source is created and loaded into the player.
Step 4: Configure your Player License
Allowlist Application ID
In order to use the player in your app you have to allowlist the application ID (package name) of your app. This is a security mechanism and protects your license from being used elsewhere.
Application ID allowlisting can be done in the dashboard under Player -> Licenses.
Step 5: Final Review
In this tutorial you learned how to add the Bitmovin Player Android SDK to your project, set up the player license, use the player and how to configure it.
Now you can start having a look at the API reference and adapt the player to your needs.
More Examples
You can find many more fully functional code examples in our Github Repository.