Enable localization (iOS)

The iOS or tvOS 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 JWPlayerKit (iOS SDK) or JWPlayerTVKit (tvOS SDK)
• English string tables in the iOS SDK or tvOS 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 iOS SDK or tvOS SDK.

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

📘

There are a handful of classes created by our builders which take a string as an argument. These values are not localized by the SDK. Instead, you should provide a localized string to these structures, or override their default in your string tables using our string keys.

For example, in JWAdInterfaceStyleBuilder there are string properties for skipText, countdownText, and skipDelayText. These strings will be displayed as provided. Thus, if you set one to “Skip Ahead” the text displayed is “Skip Ahead” and is not looked up from the string table.

Requirements

• JWPlayerKit 4.3.0+ (iOS)
• JWPlayerTVKit 1.0.0+ (tvOS)

Enable localization

General

Use the following steps to enable localization:

1. Create language-specific string tables for the app. Refer to the String Table to see the list of customizable strings in the player.
2. In the info.plist of the app, add the CGBundleAllowMixedLocalizations key and set the value to YES. When added to info.plist, the key appears as Localized resources can be mixed.

<key>CGBundleAllowMixedLocalizations</key>
<string>YES</string>

Google IMA

By default, Google IMA uses the language specified in the user’s default settings.

Use the following steps to override the default settings:

1. Use JWImaSettingsBuilder() to create a JWImaSettings object.
2. Define locale with the two-letter language code.

let imaSettings = try! JWImaSettingsBuilder()
       .locale("en") // Set to English
       .build()
// adConfigBuilder is a JWImaAdvertisingConfigBuilder
adConfigBuilder.imaSettings(imaSettings)

JWImaSettings *imaSettings = [[[[JWImaSettingsBuilder alloc] init] locale:@"en"] build];

// adConfigBuilder is a JWImaAdvertisingConfigBuilder
[adConfigBuilder imaSettings:imaSettings];

Localization Reference

Default Supported Languages

Both SDKs support localization for the languages in the following table.

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.