Specify a language
The IMA SDK lets you 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:
// 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:
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
|