Android Styling Guide (Android)
The JWP Android SDK provides a focused UI customization framework that lets you align the video player's appearance with your application design. The framework offers specific controls over visual elements and their display states while maintaining the stability and performance of the core playback engine:
- Visual Customization: Replace icons, modify colors, and adjust backgrounds using Android resource overrides and style definitions
- Component Visibility: Configure which player elements are displayed, such as control bars, center controls, and preview overlays
- State-Responsive Display: Update UI elements based on player events and states through the
ViewModel
architecture
For example, you can establish your brand presence by defining custom colors in colors.xml, adding your logo through LogoConfig
, and using UiConfig
to show only the controls relevant to your use case.
Prerequisites
Item | Notes |
---|---|
JWP Android SDK 4.5.0+ | Minimum version required for UI customization capabilities |
Android Studio | Installed and properly configured |
Android Knowledge | Familiarity with Android development, particularly working with styles, drawables, and resource files |
Customization Approaches
The JWP Android SDK provides two approaches to tailoring the player UI. These methods are designed to address both simple and advanced requirements, giving you the flexibility to adapt the player to your appβs needs.
Customization Type | Details |
---|---|
Simple | (Recommended) Modifies basic UI elements and behaviors through configuration
Common Uses:
|
Custom | Implements fully customized UI components and interaction patterns
Common Uses:
|
Default JWP Resource Definitions
To customize the player appearance in your Android app, you may need to reference the original SDK resource definitions. These resources enable you to identify the necessary style properties for customization and locate drawable elements for modification while preserving functionality.
AAR
Follow these steps to view the original resource definitions:
- Open Android Studio.
- Navigate to the .aar files location. These files are typically located in the app/libs folder.
- Double click the jwplayer-core module to view its contents.
- Expand the res/values folder.
- Click values.xml.
Maven
Follow these steps to view the original resource definitions:
- Open Android Studio.
- In the project view expand External Libraries.
- Navigate to the jwplayer-core module.
- Double click the jwplayer-core module to view its contents.
- Expand the res/values folder.
- Click values.xml.
Updated 13 days ago