Enable localization (Android)

Enable, customize, and improve player accessibility for your Android app.



The Android 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 SDK
  • English string tables in the Android 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 SDK.

You can create string tables for any language, allowing you to customize the video experience for your global users.



Requirement

  • Android 4.3.0+


Enable localization

Use the following video and steps to enable localization by creating a language-specific strings table.

  1. In Android Studio, right click on res package. A menu appears.
  2. Click New > Android Resource File. The New Resource File popup window appears
  3. In the File Name field, enter strings.
  4. Under Available qualifiers, select Locale.
  5. Click >> to add the Locale qualifier to Chosen qualifiers.
  6. Select a Language.
  7. Select a Specific Region Only.
  8. Click OK. A strings.xml file is created for the language and the open file appears in the main panel.
  9. 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 always uses the language specified in the end user’s device settings. IMA's default language settings cannot be overridden.



Localization Reference

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)

String Table

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.

StringDescription
jwplayer_advertising_ad_x_of_yDisplayed in the control center when an advertisement is playing while the application is backgrounded

English: Ad %1$d of %2$d.
jwplayer_advertising_loading_adOverride for the text shown when an ad is loading

English: Loading ad
jwplayer_advertising_remaining_timeCountdown 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_messageSkip 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_textButton text that appears when an ad is skippable

English: Skip
jwplayer_audio_and_subtitlesMenu header for subtitles and audio in the same menu

English: Audio & Subtitles
jwplayer_audio_tracksHeader above a selection of audio tracks in the Audio & Subtitles menu

English: Audio Tracks
jwplayer_autoLabel text for the default quality selection option that allows the player to automatically select the appropriate quality level for the viewer

English: Auto
jwplayer_backText displayed and used for a back button in a menu

English: Back
jwplayer_cancelMenu option for cancelling out of a menu

English: Cancel
jwplayer_cast_connecting_toText shown when connecting to a Chromecast device

English: Connect to a device
jwplayer_cast_default_device_nameFallback device name if no Chromecast device name is available

English: Casting Info
jwplayer_cast_disconnectMenu option to disconnect from a casting or linked device

English: Disconnect
jwplayer_cast_playing_onText shown when playing on a Chromecast device

English: Playing on %1$s
jwplayer_cast_unable_to_connect_toUI text shown when we failed to connect to a casting device

English: Unable to connect to %1$s
jwplayer_cast_use_same_wifiMenu 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_chromecastAccessibility label for Chromecast button

English: Chromecast
jwplayer_closeText on a close button used to close a menu or overlay

English: Close
jwplayer_close_menuAccessibility label for closing the menu

English: close menu
jwplayer_doneButton on menus labeled: done

English: Done
jwplayer_elapsedUsed when announcing the elapsed time

English: elapsed
jwplayer_error_messageText-to-speech / screenreader description for the error message UI

English: error message
jwplayer_errors_bad_connectionError 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_videoError 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_playerError 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_downError message text displayed when a live stream down or has ended

English: The live stream is either down or has ended.
jwplayer_errors_protected_contentError message text displayed when DRM or protected content fails

English: There was a problem providing access to protected content.
jwplayer_errors_technical_errorGeneric 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_fullscreenText in the control bar to exit fullscreen

English: Exit Fullscreen
jwplayer_forward_15_secondsAccessibility label for fast forwarding

English: fast forward 15 seconds
jwplayer_fullscreenAccessibility label for the full screen button

English: Fullscreen
jwplayer_hourUsed when announcing timestamps

English: hour
jwplayer_hoursUsed when announcing timestamps

English: hours
jwplayer_just_watchedText shown on the current playlist item when in the playlist view

English: Just watched
jwplayer_learn_moreTap-through button on the VAST ad UI

English: Learn more
jwplayer_live_broadcastLabel text for live streams, displayed in the control bar

English: Live
jwplayer_menuAccessibility label for opening the settings menu

English: menu
jwplayer_minuteUsed when announcing timestamps

English: minute
jwplayer_minutesUsed when announcing timestamps

English: minutes
jwplayer_more_videosButton text and overlay heading for recommended video interfaces

English: More Videos
jwplayer_nextAccessibility label for the right arrow in paginated overlays

English: Next
jwplayer_next_upTitle of an overlay that displays the next item to automatically play

English: Next Up
jwplayer_next_up_countdownText 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_normalWord for 1x playback speed

English: Normal
jwplayer_offMenu option text for turning an option off, such as closed captions

English: Off
jwplayer_pauseAccessibility label for the pause button

English: Pause
jwplayer_picture_in_pictureAccessibility label for picture in picture button

English: Picture in Picture
jwplayer_playAccessibility label for the play button

English: Play
jwplayer_playback_ratesHeader text for the playback rate controls menu

English: Playback Rates
jwplayer_playlistPlaylist menu header

English: Playlist
jwplayer_previous_playlist_itemARIA label of the left arrow in paginated overlays
jwplayer_qualityHeader text for the video quality controls menu

English: Quality
jwplayer_recommendationsRecommendations menu header

English: Recommendations
jwplayer_remainingUsed when announcing the remaining time

English: remaining
jwplayer_replayAccessibility label for the replay button

English: Replay
jwplayer_resumeText for a button used to resume playback

English: Resume
jwplayer_rewind_15_secondsARIA label for the rewind button

English: Rewind 15 seconds
jwplayer_secondUsed when announcing timestamps

English: second
jwplayer_secondsUsed when announcing timestamps

English: seconds ​
jwplayer_subtitlesMenu header for subtitles menu

English: Subtitles
jwplayer_titleVideo title description displayed at top of screen

English: title
jwplayer_toggle_controlsARIA Label to signify to the user that they can toggle the controls

English: toggle controls
jwplayer_unknown_audiotrackFallback label for unknown audiotracks

English: Unknown Audio track
jwplayer_unknown_ccFallback label for unknown captions

English: Unknown CC