Localizing text

This section shows you how to localize or customize strings in the Talk SDK UI.

Strings in the Talk SDK are localized into the languages listed in Supported languages below.

Customizing existing strings

The Talk SDK provides localizations for all the strings used throughout the UI. You can override them if required.

If your project does not yet have a Localizable.strings file with the different language variants, you can create one by following these steps:

  1. In Xcode, select File > New > File, then select Resource in the iOS category in the sidebar.

  2. Select Strings File from the files and click Next.

  3. Name the file Localizable and click Create.

To customize the Talk SDK's strings with new values:

  1. Choose the strings to customize and add them to the Localizable.strings file in your app as follows. Make sure to include placeholders in the replacements of any strings that contain them.

    // add a key and change the value to what you want"microphone_permission_screen_message" = "This app needs permission to use your microphone before you can start a call.";
  2. Make sure that the file is in the Copy Bundle Resources section of the Build Phases tab in Xcode.

Adding a new localization

If the Talk SDK does not include localized strings for the language you are interested in, you can add new ones.

Select your Localizable.strings file, and in the right pane click Localize. When you select the missing language, a new variant of Localizable.strings will be created for it.

In the new file, add translations for all of the strings in the Talk SDK's Strings.bundle.

List of localized strings

"microphone_permission_screen_allow" = "Allow";"microphone_permission_screen_cancel" = "Cancel";"microphone_permission_screen_message" = "This app needs permission to use your microphone before you can start a call.";"microphone_permission_screen_title" = "Allow microphone";"microphone_permission_settings_alert_cancel" = "Cancel";"microphone_permission_settings_alert_message" = "This app needs permission to use your microphone before you can start a call. Go to your app settings and allow access.";"microphone_permission_settings_alert_settings" = "Settings";"microphone_permission_settings_alert_title" = "Allow microphone";
"recording_consent_digital_line_or_agent_unavailable_error_cancel_button" = "Cancel";"recording_consent_digital_line_or_agent_unavailable_error_message" = "Check your connection and try again.";"recording_consent_digital_line_or_agent_unavailable_error_retry_button" = "Reconnect";"recording_consent_digital_line_or_agent_unavailable_error_title" = "Couldn't connect to an agent";"recording_consent_network_cancel_button" = "Cancel";"recording_consent_network_error_message" = "Check your connection and try again.";"recording_consent_network_error_title" = "Couldn't connect";"recording_consent_network_retry_button" = "Reconnect";"recording_consent_screen_cancel" = "Cancel";"recording_consent_screen_consent_description" = "I consent to this call being recorded";"recording_consent_screen_message" = "This call will be recorded for quality purposes.";"recording_consent_screen_start_call" = "Start call";"recording_consent_screen_title" = "Recording this call";
"call_screen_call_ended_title" = "Call ended";"call_screen_call_failed_alert_message" = "Check your internet connection and try calling again.";"call_screen_call_failed_alert_ok_button" = "OK";"call_screen_call_failed_alert_title" = "Call failed";"call_screen_call_failed_title" = "Call failed";"call_screen_call_in_progress_title" = "Call in progress";"call_screen_call_reconnecting_title" = "Reconnecting call...";"call_screen_hang_up_button" = "Hang up";"call_screen_mute_button" = "Mute";"call_screen_speaker_button" = "Speaker";"call_screen_starting_title" = "Starting call...";

Supported languages

Strings in the Talk SDK are localized into the following languages:

Language code Language
ar Arabic
bg Bulgarian
cs Czech
da Danish
de German
el Greek
en-GB British English
en American English
es Spanish
fi Finnish
fil Filipino
fr French
fr-CA French Canadian
he Hebrew
hi Hindi
hu Hungarian
id Indonesian
it Italian
ja Japanese
ko Korean
ms Malay
nb Norwegian
nl Dutch
pl Polish
pt-BR Brazilian Portuguese
pt Portuguese
ro Romanian
ru Russian
sv Swedish
th Thai
tr Turkish
vi Vietnamese
zh-Hans Simplified Chinese
zh-Hant Traditional Chinese