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:
  • Style and resource overrides
  • Component visibility adjustments
  • Theme and color updates
  • Basic layout modifications
Custom Implements fully customized UI components and interaction patterns

Common Uses:
  • Complex UI requirements beyond default components
  • Deep integration with player events
  • Complete UI overhauls
  • Specialized playback experiences


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:

  1. Open Android Studio.
  2. Navigate to the .aar files location. These files are typically located in the app/libs folder.
  3. Double click the jwplayer-core module to view its contents.
  4. Expand the res/values folder.
  5. Click values.xml.

Maven

Follow these steps to view the original resource definitions:

  1. Open Android Studio.
  2. In the project view expand External Libraries.
  3. Navigate to the jwplayer-core module.
  4. Double click the jwplayer-core module to view its contents.
  5. Expand the res/values folder.
  6. Click values.xml.

© 2007- Longtail Ad Solutions, Inc.