Localization

Specifying language

The IMA SDK allows you to specify the language to be used to localize ads and the player UI controls. To do so, use the ImaSdkSettings.setLanguage() method with the appropriate locale code as demonstrated in the code snippet below.

  // Create an AdsLoader and optionally set the language.
  ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
  imaSdkSettings.setLanguage('fr');
  mSdkFactory = ImaSdkFactory.getInstance();

  mAdDisplayContainer = mSdkFactory.createAdDisplayContainer();
  mAdDisplayContainer.setPlayer(mVideoPlayerWithAdPlayback.getVideoAdPlayer());
  mAdDisplayContainer.setAdContainer(mVideoPlayerWithAdPlayback.getAdUiContainer());
  mAdsLoader = mSdkFactory.createAdsLoader(context, imaSdkSettings, mAdDisplayContainer);

To set the language within the BasicExample which uses the Exoplayer-IMA extension, a modification needs to be made to set ImaSdkSettings. Please follow the following code snippet to do so:

VideoPlayerController.java

@Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);

    playerView = findViewById(R.id.player_view);

    ImaSdkSettings imaSdkSettings = ImaSdkFactory.getInstance().createImaSdkSettings();
    imaSdkSettings.setLanguage("fr");
    ImaAdsLoader.Builder builder = new ImaAdsLoader.Builder(this).setImaSdkSettings(imaSdkSettings);

    adsLoader = builder.buildForAdTag(Uri.parse(getString(R.string.ad_tag_url)));
  }

Locale codes

IMA supports the following locale codes:

Language	Country code
Arabic	`ar`
Arabic (Egypt)	`ar_eg`
Arabic (Saudi Arabia)	`ar_sa`
Bulgarian	`bg`
Catalan	`ca`
Chinese (Simplified)	`zh`
Chinese (Simplified, China)	`zh_cn`
Chinese (Traditional, Hong Kong)	`zh_hk`
Chinese (Traditional, Taiwan)	`zh_tw`
Croatian	`hr`
Czech	`cs`
Danish	`da`
Dutch	`nl`
English	`en`
English (Australia)	`en_au`
English (Canada)	`en_ca`
English (United Kingdom)	`en_gb`
English (Ireland)	`en_ie`
English (India)	`en_in`
English (Singapore)	`en_sg`
English (South Africa)	`en_za`
Estonian	`et`
Filipino	`fil`
Finnish	`fi`
French	`fr`
French (Canada)	`fr_ca`
French (Switzerland)	`fr_ch`
German	`de`
German (Austria)	`de_at`
Greek	`el`
Hebrew	`he`
Hindi	`hi`
Hungarian	`hu`
Icelandic	`is`
Indonesian	`id`
Italian	`it`
Japanese	`ja`
Korean	`ko`
Latvian	`lv`
Lithuanian	`lt`
Malay	`ms`
Norwegian	`no`
Polish	`pl`
Portuguese	`pt`
Portuguese (Brazil)	`pt_br`
Portuguese (Portugal)	`pt_pt`
Romanian	`ro`
Russian	`ru`
Serbian	`sr`
Slovak	`sk`
Slovenian	`sl`
Spanish	`es`
Spanish (Latin America)	`es_419`
Spanish (Argentina)	`es_ar`
Spanish (Chile)	`es_cl`
Spanish (Colombia)	`es_co`
Spanish (Costa Rica)	`es_cr`
Spanish (Dominican Republic)	`es_do`
Spanish (Ecuador)	`es_ec`
Spanish (El Salvador)	`es_sv`
Spanish (Guatemala)	`es_gt`
Spanish (Honduras)	`es_hn`
Spanish (Mexico)	`es_mx`
Spanish (Nicaragua)	`es_ni`
Spanish (Panama)	`es_pa`
Spanish (Peru)	`es_pe`
Spanish (Puerto Rico)	`es_pr`
Spanish (Paraguay)	`es_py`
Spanish (United States)	`es_us`
Spanish (Uruguay)	`es_uy`
Spanish (Venezuela)	`es_ve`
Swedish	`sv`
Thai	`th`
Turkish	`tr`
Ukrainian	`uk`
Vietnamese	`vi`