У TDLib есть множество параметров, которые влияют на поведение библиотеки. У каждого параметра есть имя и значение. Значение должно быть одного из следующих типов:
| Тип | Значение по умолчанию | Диапазон значений |
|---|---|---|
| Integer | 0 | 32-битное целое число |
| Boolean | false | True или false |
| String | Любая юникод строка |
Параметры, не указанные в списке, можно опустить.
| Имя | Тип | Запись? | Описание |
|---|---|---|---|
| disable_contact_registered_notifications | Boolean | Да | Если значение=true, уведомления о контактах пользователя, присоединившихся к Telegram, будут отключены. Пользователь все равно получит соответствующее сообщение в приватном чате. getOption должен вызываться явно для получения последнего значения параметра, изменённого с другого устройства. |
| disable_top_chats | Boolean | Да | Если значение=true, поддержка частых чатов и сбора статистики будет отключена. |
| ignore_background_updates | Boolean | Да | Параметр позволяет пропустить все обновления, полученные во время работы экземпляра TDLib. Опция ничего не делает, если используется база данных или секретные чаты. |
| ignore_inline_thumbnails | Boolean | Да | Параметр предотвращает сохранение на диск миниатюр-превью файлов, отправленных сервером вместе с сообщениями. |
| language_pack_database_path | String | Да | Путь к базе данных для хранения строк языковых пакетов, чтобы эта база данных могла совместно использоваться разными учетными записями. По умолчанию строки языковых пакетов хранятся только в памяти. |
| language_pack_id | String | Да | Идентификатор используемого в данный момент языкового пакета. |
| localization_target | String | Да | Название цели для локализации (в настоящее время поддерживается: «Android», «android_x», «ios», «macos» и «tdesktop»). |
| notification_group_count_max | Integer | Да | Максимальное количество одновременно отображаемых групп уведомлений, 0-25 |
| notification_group_size_max | Integer | Да | Максимальное количество одновременно отображаемых уведомлений в группе — 1-25. По умолчанию: 10 |
| online | Boolean | Да | Онлайн-статус текущего пользователя |
| prefer_ipv6 | Boolean | Да | Если значение=true, IPv6-адреса будут предпочтительнее IPv4-адресов. |
| use_pfs | Boolean | Да | Если значение=true, функция Perfect Forward Secrecy будет включена для взаимодействия с серверами Telegram в «облачных» чатах. |
| use_quick_ack | Boolean | Да | Если установлено значение true, для исходящих сообщений будет включено быстрое квитирование. |
| use_storage_optimizer | Boolean | Да | Если переменная имеет значение true, будет включён фоновый оптимизатор хранилища. |
| animation_search_bot_username | String | Нет | Юзернейм бота, который будет использован для поиска анимации в инлайн-режиме |
| authorization_date | Integer | Нет | Дата (Unix timetamp), когда была получена авторизация. |
| basic_group_size_max | Integer | Нет | Максимальное количество участников в обычной группе |
| call_connect_timeout_ms | Integer | Нет | Максимальное время ожидания подключения при звонке (libtgvoip) |
| call_packet_timeout_ms | Integer | Нет | Максимальное время ожидания передачи пакета вызова при звонке (libtgvoip) |
| enabled_proxy_id | Integer | Нет | Идентификатор используемого прокси-сервера |
| expect_blocking | Boolean | Нет | Если установлено значение true, доступ к Telegram для пользователя, скорее всего, заблокирован |
| favorite_stickers_limit | Integer | Нет | Максимальное количество избранных стикеров |
| forwarded_message_count_max | Integer | Нет | Максимальное количество пересылаемых сообщений за один запрос |
| message_caption_length_max | Integer | Нет | Максимальная длина подписи к файлу или фото |
| message_text_length_max | Integer | Нет | Максимальная длина текста сообщения |
| my_id | Integer | Нет | Идентификатор текущего пользователя |
| pinned_chat_count_max | Integer | Нет | Максимальное количество закреплённых чатов. То же значение используется для закрепления секретных чатов (локально). |
| photo_search_bot_username | String | Нет | Юзернейм бота, который будет использован для поиска фото в инлайн-режиме |
| suggested_language_pack_id | String | Нет | Идентификатор языкового пакета, предложенный сервером |
| supergroup_size_max | Integer | Нет | Максимальное количество участников в супергруппе |
| t_me_url | String | Нет | Текущее значение ссылки t.me, например: https://t.me/ |
| test_mode | Boolean | Нет | Используется тестовое окружение |
| venue_search_bot_username | String | Нет | Юзернейм бота, который будет использован для поиска мест и адресов в инлайн-режиме |
| version | String | Нет | Версия TDLib. Этот параметр гарантированно появится прежде всех остальных (для TDLib >= 1.4.0) |
Любой параметр, имя которого начинается с ‘x’ или ‘X’ доступен для записи и может быть безопасно использован для хранения небольшого количества данных.