Enable localization (Android)
Enable, customize, and improve player accessibility for your Android or Fire TV app.
The Android or Fire TV SDK selects the appropriate string from one of the available string tables. The SDK searches the string tables in the following order:
- Main bundle string tables in the app
- String tables in the Android or Fire TV SDK
- English string tables in the Android or Fire TV SDK.
By creating a string table for a language, you can customize the displayed string for menus, title bars, and strings in many other interfaces. Your language-specific string table will override the string tables in the Android or Fire TV SDK.
You can create string tables for any language, allowing you to customize the video experience for your global users.
- Android 4.3.0+
Language-specific Strings Table
Use the following video and steps to create a language-specific strings table.
- In Android Studio, right click on res package. A menu appears.
- Click New > Android Resource File. The New Resource File popup window appears
- In the File Name field, enter strings.
- Under Available qualifiers, select Locale.
- Click >> to add the Locale qualifier to Chosen qualifiers.
- Select a Language.
- Select a Specific Region Only.
- Click OK. A strings.xml file is created for the language and the open file appears in the main panel.
- Populate strings.xml with language-specific strings for the player. Refer to the String Table to see the list of customizable strings in the player.
By default, Google IMA uses the language specified in the user’s default settings.
Use the following steps to override the default settings:
- Create an
setLanguage()to define the two-letter language code.
// Create and configure the ImaSdkSettings object ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings(); imaSdkSettings.setLanguage("el");
Default Supported Languages
Both SDKs supports localization for the languages in the following table.
|Arabic (ar)||Chinese (zh)||Danish (da)||Dutch (nl)|
|English (en)||Finnish (fi)||French (fr)||German (de)|
|Greek (el)||Hebrew (he)||Indonesian (id)||Italian (it)|
|Japanese (ja)||Korean (ko)||Norwegian Bokmal (nb)||Occitan (oc)|
|Polish (pl)||Portuguese (pt)||Romanian (ro)||Russian (ru)|
|Slovenian (sl)||Spanish (es)||Swedish (sv)||Thai (th)|
|Turkish (tr)||Vietnamese (vi)|
The following table lists all strings that can be customized for a language-specific string table. The default English string is listed for each string.
|jwplayer_advertising_ad_x_of_y||Displayed in the control center when an advertisement is playing while the application is backgrounded|
English: Ad %1$d of %2$d.
|jwplayer_advertising_loading_ad||Override for the text shown when an ad is loading|
English: Loading ad
|jwplayer_advertising_remaining_time||Countdown text that displays during ad playback|
English: This ad will end in xx
NOTE: The letters, xx, are replaced with a number of seconds.
|jwplayer_advertising_skip_message||Skip countdown message during VAST ad playback|
English: Skip ad in xx
NOTE: The letters, xx, are replaced with a number of seconds.
|jwplayer_advertising_skip_text||Button text that appears when an ad is skippable|
|jwplayer_audio_and_subtitles||Menu header for subtitles and audio in the same menu|
English: Audio & Subtitles
|jwplayer_audio_tracks||Header above a selection of audio tracks in the Audio & Subtitles menu|
English: Audio Tracks
|jwplayer_auto||Label text for the default quality selection option that allows the player to automatically select the appropriate quality level for the viewer|
|jwplayer_back||Text displayed and used for a back button in a menu|
|jwplayer_cancel||Menu option for cancelling out of a menu|
|jwplayer_cast_connecting_to||Text shown when connecting to a Chromecast device|
English: Connect to a device
|jwplayer_cast_default_device_name||Fallback device name if no Chromecast device name is available|
English: Casting Info
|jwplayer_cast_disconnect||Menu option to disconnect from a casting or linked device|
|jwplayer_cast_playing_on||Text shown when playing on a Chromecast device|
English: Playing on %1$s
|jwplayer_cast_unable_to_connect_to||UI text shown when we failed to connect to a casting device|
English: Unable to connect to %1$s
|jwplayer_cast_use_same_wifi||Menu subtext for casting, informing the user to be on the same WiFi network as the device they are searching for and wish to connect to|
English: Make sure your device is connected to the same WiFi network.
|jwplayer_chromecast||Accessibility label for Chromecast button|
|jwplayer_close||Text on a close button used to close a menu or overlay|
|jwplayer_close_menu||Accessibility label for closing the menu|
English: close menu
|jwplayer_done||Button on menus labeled: done|
|jwplayer_elapsed||Used when announcing the elapsed time|
|jwplayer_error_message||Text-to-speech / screenreader description for the error message UI|
English: error message
|jwplayer_errors_bad_connection||Error message text displayed when a connection issue prevents playback|
English: This video cannot be played because of a problem with your internet connection.
|jwplayer_errors_cant_play_video||Error message text displayed when a media item fails to load and the reason is because of the media file itself|
English: This video file cannot be played.
|jwplayer_errors_cant_load_player||Error message text displayed when a player fails to set up for a non-network reason, like incorrect JSON or license keys|
English: Sorry, the video player failed to load.
|jwplayer_errors_live_stream_down||Error message text displayed when a live stream down or has ended|
English: The live stream is either down or has ended.
|jwplayer_errors_protected_content||Error message text displayed when DRM or protected content fails|
English: There was a problem providing access to protected content.
|jwplayer_errors_technical_error||Generic error message text for all cases that do not fit in another situation|
English: This video cannot be played because of a technical error.
|jwplayer_exit_fullscreen||Text in the control bar to exit fullscreen|
English: Exit Fullscreen
|jwplayer_forward_15_seconds||Accessibility label for fast forwarding|
English: fast forward 15 seconds
|jwplayer_fullscreen||Accessibility label for the full screen button|
|jwplayer_hour||Used when announcing timestamps|
|jwplayer_hours||Used when announcing timestamps|
|jwplayer_just_watched||Text shown on the current playlist item when in the playlist view|
English: Just watched
|jwplayer_learn_more||Tap-through button on the VAST ad UI|
English: Learn more
|jwplayer_live_broadcast||Label text for live streams, displayed in the control bar|
|jwplayer_menu||Accessibility label for opening the settings menu|
|jwplayer_minute||Used when announcing timestamps|
|jwplayer_minutes||Used when announcing timestamps|
|jwplayer_more_videos||Button text and overlay heading for recommended video interfaces|
English: More Videos
|jwplayer_next||Accessibility label for the right arrow in paginated overlays|
|jwplayer_next_up||Title of an overlay that displays the next item to automatically play|
English: Next Up
|jwplayer_next_up_countdown||Text shown when counting down auto-advancing recommendations|
English: Next up in xx
NOTE: The letters, xx, will be programmatically replaced by a number of seconds.
|jwplayer_normal||Word for 1x playback speed|
|jwplayer_off||Menu option text for turning an option off, such as closed captions|
|jwplayer_pause||Accessibility label for the pause button |
|jwplayer_picture_in_picture||Accessibility label for picture in picture button|
English: Picture in Picture
|jwplayer_play||Accessibility label for the play button|
|jwplayer_playback_rates||Header text for the playback rate controls menu|
English: Playback Rates
|jwplayer_playlist||Playlist menu header|
|jwplayer_previous_playlist_item||ARIA label of the left arrow in paginated overlays|
|jwplayer_quality||Header text for the video quality controls menu|
|jwplayer_recommendations||Recommendations menu header|
|jwplayer_remaining||Used when announcing the remaining time|
|jwplayer_replay||Accessibility label for the replay button|
|jwplayer_resume||Text for a button used to resume playback|
|jwplayer_rewind_15_seconds||ARIA label for the rewind button|
English: Rewind 15 seconds
|jwplayer_second||Used when announcing timestamps|
|jwplayer_seconds||Used when announcing timestamps|
|jwplayer_subtitles||Menu header for subtitles menu|
|jwplayer_title||Video title description displayed at top of screen|
|jwplayer_toggle_controls||ARIA Label to signify to the user that they can toggle the controls|
English: toggle controls
|jwplayer_unknown_audiotrack||Fallback label for unknown audiotracks|
English: Unknown Audio track
|jwplayer_unknown_cc||Fallback label for unknown captions|
English: Unknown CC
Updated 3 months ago