Локализация

Чтобы переопределить строковые ресурсы SDK, добавьте их с тем же name в strings.xml приложения — Android Resource Merger подменит значение SDK при сборке. Файл располагается в res/values-<locale>/strings.xml (например, values-ru/ для русской локали; подробнее — Supporting different languages).

Значения по умолчанию

В таблицах ниже в колонке «Значение по умолчанию» приведён текст из values-ru/strings.xml (русская локаль). Для остальных локалей значением по умолчанию выступает текст из values/strings.xml (английский) — например, для ecc_push_title это Threads, а не ChatCenter; для ecc_empty_chat_placeholder_title — Welcome!, а не Добро пожаловать.

Часть ключей определена одновременно в модулях chatcenter-core и chatcenterui (ecc_alert_timeout_message, ecc_chat_client_name, ecc_chat_title_waiting_for_specialist, ecc_error_when_history_load, ecc_errors_during_load_file, ecc_settings_not_loaded) — переопределение в strings.xml приложения покрывает обе копии за счёт стандартного Android Resource Merger.

Зарезервированные ключи

Часть ключей помечена в таблицах как «Зарезервирован.» — эти ключи определены в strings.xml SDK, но в коде модулей chatcenterui/chatcenter-core нет обращений к ним (R.string.<key> / @string/<key>). Переопределение таких ключей в strings.xml приложения не повлияет на UI до тех пор, пока SDK не начнёт их использовать.

Ключи локализации

Действия и кнопки

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_action_title_repeat	Повторить	Кнопка повтора инита SDK
ecc_action_title_cancel	Отмена	Кнопка отмены при записи голосового сообщения
ecc_action_title_yes	Да	Оценка при получении ответа
ecc_action_title_no	Нет	Оценка при получении ответа
ecc_permissions_access_allow	Разрешить	Запрос разрешений
ecc_permissions_close_dialog	Закрыть	Кнопка закрытия диалога
ecc_alert_resend_failed_ message_retry_btn	Повторить отправку	Меню сообщения
ecc_alert_resend_failed_ message_delete_btn	Удалить	Меню сообщения

Чат и заголовки

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_chat_title_working	Контакт центр	Заголовок чата
ecc_chat_title_opened	Контакт центр	Заголовок открытого чата
ecc_chat_title_ waiting_for_specialist	Поиск оператора…	Статус ожидания в тулбаре
ecc_chat_title_typing	оператор печатает…	Индикатор набора текста в тулбаре
ecc_chat_title_ unknown_operator	Неизвестный	Зарезервирован. По задумке — имя оператора, если оно не пришло с сервера
ecc_chat_title_connecting	Подключение...	Заголовок тулбара во время автоматического переподключения к WebSocket
ecc_chat_client_name	Вы	Имя пользователя (в цитатах)
ecc_operator_bot	Бот	Имя бота
ecc_chat_available_ readonly_text	Данный чат доступен только для просмотра	Режим чтения

Меню вложений

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_attachments_ menu_take_photo	Камера	Пункт нижнего меню
ecc_attachments_ menu_my_albums	Галерея	Пункт нижнего меню
ecc_attachments_menu_files	Файл	Пункт нижнего меню

Сообщения и статусы

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_message_system_ leave_chat_female	покинула диалог в	Зарезервирован. Системное (жен.)
ecc_message_system_ leave_chat_male	покинул диалог в	Зарезервирован. Системное (муж.)
ecc_message_system_ join_chat_female	подключилась к диалогу в	Зарезервирован. Системное (жен.)
ecc_message_system_ join_chat_male	подключился к диалогу в	Зарезервирован. Системное (муж.)
ecc_message_system_ date_recently	Недавно	Время сообщения
ecc_message_system_ date_yesterday	Вчера	Зарезервирован. По задумке — отметка времени «Вчера»
ecc_message_deleted_text	Сообщение удалено	Заглушка удаленного сообщения
ecc_message_system_ quote_content_descr	Цитата	Для Talkback

Ввод и запись

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_input_placeholder	Ваше сообщение…	Подсказка в поле ввода
ecc_input_voice_ recording_hint	Удерживайте, чтобы начать запись	Подсказка микрофона
ecc_message_voice_ slide_to_cancel	Влево - отмена	Анимация записи голосового сообщения (свайп влево для отмены)

Поиск

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_search_ placeholder_title	Поиск сообщений	Поле ввода поиска
ecc_search_ not_found_title	Результатов не найдено	Не найдено сообщений при поиске

Push-уведомления

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_push_title	ChatCenter	Заголовок уведомления

Опросы (Survey)

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_survey_message_ ask_for_rate	Пожалуйста, оцените качество нашего сервиса	Заголовок опроса
ecc_survey_message_ thanks_title	Спасибо за вашу оценку	Благодарность после прохождения опроса
ecc_survey_thanks_ for_buttons_survey	Спасибо за участие в опросе	Благодарность после прохождения опроса
ecc_survey_item_ user_rate_header	Оценка решения вопроса	Заголовок при опросе
ecc_survey_request_ close_thread_message	Специалист ответил на все ваши вопросы, продолжить консультацию?	Диалог закрытия треда

Пустой экран

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_empty_chat_ placeholder_title	Добро пожаловать	Заголовок экрана приветствия
ecc_empty_chat_ placeholder_desc	Отправьте ваш вопрос	Подзаголовок экрана приветствия
ecc_empty_chat_ placeholder_subtitle	Инициализация клиента	Лоадер инициализации
ecc_empty_chat_ loading_state	Загрузка	Текст лоадера
ecc_restoring_state	Восстановление состояния…	Подпись на full-screen экране, который SDK показывает, если чат открыт до завершения инициализации

Разрешения (Permissions)

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_permissions_help	Помощь	Заголовок диалога
ecc_permissions_ string_help_text	Отсутствуют разрешения.\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	Общий текст диалога
ecc_permissions_camera_ and_write_external_ storage_help_text	Отсутствуют разрешения на Камеру и Память (Запись на внешнее хранилище).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	Общий текст диалога
ecc_permissions_write_ external_storage_ help_text	Отсутствует разрешение на Память (Запись на внешнее хранилище).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	Общий текст диалога
ecc_permissions_record_ audio_help_text	Отсутствует разрешение на Аудиозапись (Микрофон).\n\nЧтобы предоставить разрешения, нажмите "Настройки", затем "Разрешения" и включите их.\n\nЗатем вернитесь в приложение.	Общий текст диалога
ecc_permissions_settings	Настройки	Кнопка перехода
ecc_permission_description_ access_to_files_title	Разрешите приложению доступ к файлам на вашем устройстве	Описание причины запроса разрешений
ecc_permission_description_ access_to_files_message	Это необходимо для отправки файлов	Описание причины запроса разрешений
ecc_permission_description_ access_to_audio_ recording_title	Разрешите приложению записывать аудио	Описание причины запроса разрешений
ecc_permission_description_ access_to_audio_ recording_message	Это необходимо для отправки голосовых сообщений	Описание причины запроса разрешений
ecc_permission_description_ access_to_camera_title	Разрешите приложению снимать фото	Описание причины запроса разрешений
ecc_permission_description_ access_to_camera_message	Это необходимо для отправки фото	Описание причины запроса разрешений

Ошибки и алерты

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_alert_camera_ not_found	На Вашем устройстве не найдена камера	Зарезервирован. По задумке — ошибка отсутствия камеры
ecc_alert_camera_ could_not_start_error	Не удалось запустить приложение камеры	Ошибка камеры
ecc_alert_file_sending_ denied_desc	Отправка файлов отключена на сервере	Ошибка при отправке файла (нет разрешения)
ecc_alert_resend_failed_ message_desc	Сообщение не было отправлено	Тост при ошибке отправки сообщения
ecc_alert_text_ copied_message	Текст скопирован в буфер обмена	Оповещение при копировании текста
ecc_alert_history_loading_ message_when_search	Выполняется загрузка сообщений из истории, подождите завершения	Зарезервирован. По задумке — оповещение о загрузке сообщений (напр., при поиске)
ecc_alert_timeout_message	Превышен интервал ожидания для запроса	Ошибка на весь экран
ecc_alert_saving_logs	Сохраняем логи, пожалуйста, подождите	Сообщение при сохранении логов после жеста шейка
ecc_errors_no_file_error	Файл удалён на сервере	Ошибка
ecc_errors_check_connection	Проблемы с доступом в интернет, проверьте соединение	Ошибка сети
ecc_errors_message_not_sent	Сообщение не отправлено, проверьте настройки подключения	Ошибка отправки
ecc_error_when_history_load	Ошибка при загрузке истории сообщений	Ошибка
ecc_errors_not_allowed_ file_extension	Недопустимый формат файла	Ошибка
ecc_errors_voice_ message_error	Ошибка обработки голосового сообщения	Ошибка
ecc_errors_disallowed_ file_loading	Загрузка файла не выполнена. Не удалось проверить файл	Ошибка
ecc_errors_timeout_ during_load_file	Не удалось завершить загрузку файла, истек таймаут.\nПопробуйте загрузить файл позже	Ошибка
ecc_errors_unexpected_ error_during_load_file	Не удалось завершить загрузку файла.\nПопробуйте отправить файл позже	Зарезервирован. По задумке — ошибка при непредвиденном сбое загрузки файла
ecc_errors_during_load_file	Произошла ошибка при загрузке\nили проверке файла	Ошибка
ecc_errors_when_chat_init	Ошибка при инициализации чата	Ошибка
ecc_errors_request_failed	Не удалось выполнить запрос, попробуйте повторить	Ошибка
ecc_settings_not_loaded	Не удалось загрузить настройки чата	Ошибка
ecc_errors_load_config	Не удалось загрузить настройки вложений	Зарезервирован. По задумке — ошибка загрузки настроек вложений
ecc_errors_code_ from_400_to_500_title	Извините за неудобства, чат в данный момент недоступен. Пожалуйста, попробуйте позднее.	Зарезервирован. По задумке — глобальная ошибка 4xx/5xx
ecc_errors_library_not_init	ChatCenter SDK не инициализирован	Ошибка
ecc_message_send_file_ limit_alert_message	Превышен размер файла (%1$d МБ)	Клиентская валидация размера перед отправкой. Сохраните плейсхолдер %1$d — без него строка упадёт в runtime

Файлы и разное

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_attachments_ failed_to_open_file	Невозможно открыть выбранный файл	Ошибка открытия файла
ecc_attachments_ saved_to_downloads	Сохранено в Загрузки	Успешное скачивание изображения на экране полного просмотра
ecc_attachments_ unable_to_save_file	Сейчас невозможно сохранить файл	Ошибка сохранения

Для Accessibility (Talkback)

Ключ	Значение по умолчанию	Пример использования / Примечания	Использование
ecc_content_descr_ search_talkback_icon	Иконка поиска	Зарезервирован. По задумке — описание иконки поиска для Talkback
ecc_content_descr_ operator_avatar	Аватар оператора	Описание элемента. В UI не отображается. Часть системы android для поддержки слабовидящих (озвучивание элементов)
ecc_content_descr_ play_button	Кнопка воспроизведения	Описание элемента. В UI не отображается. Часть системы android для поддержки слабовидящих (озвучивание элементов)
ecc_content_descr_ loading_animation	Загрузка	Описание элемента. В UI не отображается. Часть системы android для поддержки слабовидящих (озвучивание элементов)
ecc_content_descr_ error_image	Изображение с ошибкой	Описание элемента. В UI не отображается. Часть системы android для поддержки слабовидящих (озвучивание элементов)
ecc_content_descr_info_btn	Кнопка информации	Описание элемента. В UI не отображается. Часть системы android для поддержки слабовидящих (озвучивание элементов)

Дополнительные ключи

Ниже — строковые ресурсы, определённые в strings.xml модулей SDK, но не вошедшие в основные категории выше.

Модуль chatcenterui

Ключ	Значение по умолчанию (values-ru/)	Назначение
ecc_attachments_file_time_label_preposition	в	Предлог во временной метке файла («сохранён в 12:30»)
ecc_attachments_file_download	Загрузить	Действие «Загрузить» рядом с вложением
ecc_message_system_quote_image	изображение	Подпись «изображение» в цитате к сообщению с картинкой
ecc_message_voice_title	Голосовое сообщение	Заголовок голосового сообщения
ecc_message_photo	Фото	Подпись «Фото» (например, в цитате к сообщению с фото)
ecc_message_voice_is_processing	Голосовое сообщение обрабатывается	Состояние обработки голосового сообщения
ecc_push_channel_name	Контакт центр	Название канала Android-уведомлений (виден в системных настройках приложения)
ecc_survey_message_vote_from_title	из	Связка «4 из 5» в шкале оценки опроса
ecc_survey_popup_close	Закрыть	Кнопка закрытия попапа опроса
ecc_survey_popup_send	Отправить	Кнопка отправки результата опроса
ecc_survey_popup_textbox_hint	Ваш комментарий	Подсказка в поле комментария опроса
ecc_alert_back_camera_could_not_start_error	Не удалось запустить тыльную камеру	Зарезервирован. По задумке — ошибка запуска тыльной камеры
ecc_search_files	Искать файлы	Зарезервирован. По задумке — заголовок поиска по файлам

Модуль chatcenter-core

Ключ	Значение по умолчанию (values-ru/)	Назначение
ecc_message_status_not_delivered	Не доставлено	Статус недоставленного сообщения
ecc_attachments_download_media_description	ChatCenter	Описание источника при сохранении медиа в системный Downloads
ecc_attachments_bytes	Б	Единица измерения файла — байты
ecc_attachments_kbytes	КБ	Единица измерения файла — килобайты
ecc_attachments_mbytes	МБ	Единица измерения файла — мегабайты
ecc_attachments_gbytes	ГБ	Единица измерения файла — гигабайты
ecc_attachments_tbytes	ТБ	Единица измерения файла — терабайты
ecc_alert_not_enough_space	Недостаточно места в памяти устройства	Ошибка: недостаточно места
ecc_alert_file_restricted_type_error_during_load_file	Файл с таким расширением запрещен к загрузке	Серверная ошибка запрещённого типа файла (код file.restricted.type)
ecc_alert_file_restricted_size_error_during_load_file	Размер файла превышает допустимое значение	Серверная ошибка превышения лимита размера (код file.restricted.size)
ecc_alert_file_not_found_error_during_load_file	Файл для загрузки не найден	Серверная ошибка отсутствия файла (код file.not-found)
ecc_errors_no_user_id	Пользователь не установлен, выполните авторизацию	Ошибка: попытка отправить сообщение без авторизованного пользователя
ecc_error_websocket	Ошибка при получении сообщения в чате	Ошибка WebSocket при доставке входящих сообщений