Localization with the Brightcove Native SDKs

In this topic, you will learn about localizing the player with the Brightcove Native SDKs.

Overview

By default, the Brightcove Native SDKs use English for player controls, including caption selection and advertising messages such as "Skip Ad", “Learn More” and "Ad 1 of 3". You can localize the player controls in other languages, as described in this document.

Text for some languages, such as Arabic, are read from right-to-left (RTL).

Android

The Native SDK for Android version 6.15.1 and later supports localizing the player in the following language:

  • Arabic (ar)
  • English (en)

Currently, the Native SDK only supports the left-to-right (LTR) layout for playback and ad controls.

Working with IMA Ads

If you are working with IMA advertising, be aware that the IMA SDK does not localize text automatically. Therefore, you must set it manually.

  1. First, find the current language of the device:

    Locale.getDefault().getLanguage();
  2. Then, set the language when initializing the GoogleIMAComponent:

    ImaSdkSettings settings = ImaSdkFactory.getInstance().createImaSdkSettings();
    settings.setLanguage("ar");
    googleIMAComponent = new GoogleIMAComponent(
        brightcoveVideoView, 
        eventEmitter, 
        settings);
    

iOS

The Native SDK for iOS version 6.7.4 and later supports localizing the player in the following languages:

  • Arabic (ar)
  • Chinese, Simplified (zh-Hans)
  • Chinese, Traditional (zh-Hant)
  • English (en)
  • French (fr)
  • German (de)
  • Japanese (ja)
  • Korean (ko)
  • Spanish (es)

The built-in playback and ad controls follow a modern RTL layout, with the progress bar moving from LTR.

Working with IMA Ads

If you are working with IMA advertising, be aware that the language will not be set by the Brightcove SDK. Therefore, you must set it manually.

Here is an example:

IMASettings *imaSettings = [[IMASettings alloc] init];
imaSettings.language = [NSLocale currentLocale].localeIdentifier;