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.
- 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 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.
| String | Description |
|---|---|
| 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 English: Skip |
| 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 English: Auto |
| jwplayer_back | Text displayed and used for a back button in a menu English: Back |
| jwplayer_cancel | Menu option for cancelling out of a menu English: Cancel |
| 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 English: Disconnect |
| 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 English: Chromecast |
| jwplayer_close | Text on a close button used to close a menu or overlay English: Close |
| jwplayer_close_menu | Accessibility label for closing the menu English: close menu |
| jwplayer_done | Button on menus labeled: done English: Done |
| jwplayer_elapsed | Used when announcing the elapsed time English: elapsed |
| 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 English: Fullscreen |
| jwplayer_hour | Used when announcing timestamps English: hour |
| jwplayer_hours | Used when announcing timestamps English: hours |
| 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 English: Live |
| jwplayer_menu | Accessibility label for opening the settings menu English: menu |
| jwplayer_minute | Used when announcing timestamps English: minute |
| jwplayer_minutes | Used when announcing timestamps English: minutes |
| 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 English: Next |
| 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 English: Normal |
| jwplayer_off | Menu option text for turning an option off, such as closed captions English: Off |
| jwplayer_pause | Accessibility label for the pause button English: Pause |
| jwplayer_picture_in_picture | Accessibility label for picture in picture button English: Picture in Picture |
| jwplayer_play | Accessibility label for the play button English: Play |
| jwplayer_playback_rates | Header text for the playback rate controls menu English: Playback Rates |
| jwplayer_playlist | Playlist menu header English: Playlist |
| jwplayer_previous_playlist_item | ARIA label of the left arrow in paginated overlays |
| jwplayer_quality | Header text for the video quality controls menu English: Quality |
| jwplayer_recommendations | Recommendations menu header English: Recommendations |
| jwplayer_remaining | Used when announcing the remaining time English: remaining |
| jwplayer_replay | Accessibility label for the replay button English: Replay |
| jwplayer_resume | Text for a button used to resume playback English: Resume |
| jwplayer_rewind_15_seconds | ARIA label for the rewind button English: Rewind 15 seconds |
| jwplayer_second | Used when announcing timestamps English: second |
| jwplayer_seconds | Used when announcing timestamps English: seconds |
| jwplayer_subtitles | Menu header for subtitles menu English: Subtitles |
| jwplayer_title | Video title description displayed at top of screen English: title |
| 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 about 1 year ago