fca1fcc789
GitOrigin-RevId: a0cbc3baa32f3f5e2b2b73814daf060c2484df3d
39 KiB
39 KiB
Changes in 1.4.0:
- Added a TDLib build instructions generator, covering in details TDLib building on the most popular operating systems.
- Added an example of TDLib building and usage from a browser. See https://github.com/tdlib/td/blob/master/example/web/ for more details.
- Allowed to pass NULL pointer to
td_json_client_execute
instead of a previously created JSON client. Now you can use synchronous TDLib methods through a JSON interface before creating a TDLib JSON client. - Added support for media streaming by allowing to download any part of a file:
- Added the
offset
parameter todownloadFile
which specifies the starting position from which the file should be downloaded. - Added the
limit
parameter todownloadFile
which specifies how many bytes should be downloaded starting from theoffset
position. - Added the field
download_offset
to the classlocalFile
which contains the current download offset. - The field
downloaded_prefix_size
of thelocalFile
class now contains the number of available bytes from the positiondownload_offset
instead of from the beginning of the file. - Added the method
getFileDownloadedPrefixSize
which can be used to get the number of locally available file bytes from a given offset without actually changing the download offset.
- Added the
- Added the parameter
synchronous
todownloadFile
which causes the request to return the result only after the download is completed. - Added support for native polls in messages:
- Added
messagePoll
to the types of message content; contains a poll. - Added the classes
poll
andpollOption
describing a poll and a poll answer option respectively. - Added
inputMessagePoll
to the types of new input message content; can be used to send a poll. - Added the method
setPollAnswer
which can be used for voting in polls. - Added the method
stopPoll
which can be used to stop polls. Use theMessage.can_be_edited
field to check whether this method can be called on a message. - Added the update
updatePoll
for bots only. Ordinary users receive poll updates throughupdateMessageContent
.
- Added
- Added a Notification API. See article https://core.telegram.org/tdlib/notification-api for a detailed description.
- Added the class
pushReceiverId
which contains a globally unique identifier of the push notification subscription. - Changed the return type of the method
registerDevice
topushReceiverId
to allow matching of push notifications with TDLib instances. - Removed the fields
disable_notification
andcontains_mention
fromupdateNewMessage
. - Renamed the class
deviceTokenGoogleCloudMessaging
todeviceTokenFirebaseCloudMessaging
. - Added the field
encrypt
to classesdeviceTokenApplePushVoIP
anddeviceTokenFirebaseCloudMessaging
which allows to subscribe for end-to-end encrypted push notifications. - Added the option
notification_group_count_max
which can be used to enable the Notification API and set the maximum number of notification groups to be shown simultaneously. - Added the option
notification_group_size_max
which can be used to set the maximum number of simultaneously shown notifications in a group. - Added the synchronous method
getPushReceiverId
for matching a push notification with a TDLib instance. - Added the method
processPushNotification
for handling of push notifications. - Removed the method
processDcUpdate
in favor of the generalprocessPushNotification
method. - Added the update
updateNotificationGroup
, sent whenever a notification group changes. - Added the update
updateNotification
, sent whenever a notification changes. - Added the update
updateActiveNotifications
for syncing the list of active notifications on startup. - Added the update
updateHavePendingNotifications
which can be used to improve lifetime handling of the TDLib instance. - Added the possibility to disable special handling of notifications about pinned messages via the new settings
use_default_disable_pinned_message_notifications
,disable_pinned_message_notifications
in the classchatNotificationSettings
and the new settingdisable_pinned_message_notifications
in the classscopeNotificationSettings
. - Added the possibility to disable special handling of notifications about mentions and replies via the new settings
use_default_disable_mention_notifications
,disable_mention_notifications
in the classchatNotificationSettings
and the new settingdisable_mention_notifications
in the classscopeNotificationSettings
. - Added the class
PushMessageContent
describing the content of a notification, received through a push notification. - Added the class
NotificationType
describing a type of a notification. - Added the class
notification
containing information about a notification. - Added the class
NotificationGroupType
describing a type of a notification group. - Added the class
notificationGroup
describing a state of a notification group. - Added the methods
removeNotification
andremoveNotificationGroup
for handling notifications removal by the user. - Added the separate notification scope
notificationSettingsScopeChannelChats
for channel chats.
- Added the class
- Added support for pinned notifications in basic groups and Saved Messages:
- Added the field
pinned_message_id
to the classchat
. - Removed the field
pinned_message_id
from the classsupergroupFullInfo
in favor ofchat.pinned_message_id
. - Added the update
updateChatPinnedMessage
. - The right
can_pin_messages
is now applicable to both basic groups and supergroups. - Replaced the method
pinSupergroupMessage
withpinChatMessage
which can be used for any chat type. - Replaced the method
unpinSupergroupMessage
withunpinChatMessage
which can be used for any chat type.
- Added the field
- Added new synchronous methods for managing TDLib internal logging. The old functions are deprecated and
will be removed in TDLib 2.0.0.
- Added the synchronous method
setLogStream
for changing the stream to which the TDLib internal log is written. - Added the synchronous method
getLogStream
for getting information about the currently used log stream. - Added the classes
logStreamDefault
,logStreamFile
andlogStreamEmpty
describing different supported kinds of log streams. - Added the class
logVerbosityLevel
containing the verbosity level of the TDLib internal log. - Added the class
logTags
containing a list of available TDLib internal log tags. - Added the synchronous method
setLogVerbosityLevel
for changing verbosity level of logging. - Added the synchronous method
getLogVerbosityLevel
for getting the current verbosity level of logging. - Added the synchronous method
getLogTags
returning all currently supported log tags. - Added the synchronous method
setLogTagVerbosityLevel
for changing the verbosity level of logging for some specific part of the code. - Added the synchronous method
getLogTagVerbosityLevel
for getting the current verbosity level for a specific part of the code. - Added the synchronous method
addLogMessage
for using the TDLib internal log by the application.
- Added the synchronous method
- Added support for Instant View 2.0:
- Replaced the field
has_instant_view
in classwebPage
with theinstant_view_version
field. - Added the field
version
to the classwebPageInstantView
. - Added the class
pageBlockCaption
. - Changed the type of
caption
fields inpageBlockAnimation
,pageBlockAudio
,pageBlockPhoto
,pageBlockVideo
,pageBlockEmbedded
,pageBlockEmbeddedPost
,pageBlockCollage
andpageBlockSlideshow
fromRichText
topageBlockCaption
. - Added the class
pageBlockListItem
and replaced the content of thepageBlockList
class with a list ofpageBlockListItem
. - Added 6 new kinds of
RichText
:richTextSubscript
,richTextSuperscript
,richTextMarked
,richTextPhoneNumber
,richTextIcon
andrichTextAnchor
. - Added new classes
pageBlockRelatedArticle
,PageBlockHorizontalAlignment
,PageBlockVerticalAlignment
andpageBlockTableCell
. - Added new block types
pageBlockKicker
,pageBlockRelatedArticles
,pageBlockTable
,pageBlockDetails
andpageBlockMap
. - Added the flag
is_rtl
to the classwebPageInstantView
. - Renamed the field
caption
in classespageBlockBlockQuote
andpageBlockPullQuote
tocredit
. - Dimensions in
pageBlockEmbedded
can now be unknown. - Added the field
url
topageBlockPhoto
which contains a URL that needs to be opened when the photo is clicked. - Added the field
url
towebPageInstantView
which must be used for the correct handling of anchors.
- Replaced the field
- Added methods for confirmation of the 2-step verification recovery email address:
- Added the method
checkRecoveryEmailAddressCode
for checking the verification code. - Added the method
resendRecoveryEmailAddressCode
for resending the verification code. - Replaced the field
unconfirmed_recovery_email_address_pattern
in the classpasswordState
with therecovery_email_address_code_info
field containing full information about the code. - The necessity of recovery email address confirmation in
setPassword
andsetRecoveryEmailAddress
methods is now returned by the correspondingpasswordState
and not by the errorEMAIL_UNCONFIRMED
.
- Added the method
- Improved the
MessageForwardInfo
class and added support for hidden original senders:- Removed the old
messageForwardedPost
andmessageForwardedFromUser
classes. - Added the class
messageForwardInfo
which contains information about the origin of the message, original sending date and identifies the place from which the message was forwarded the last time for messages forwarded to Saved Messages. - Added the classes
messageForwardOriginUser
,messageForwardOriginHiddenUser
andmessageForwardOriginChannel
which describe the exact origins of a message.
- Removed the old
- Improved getting the list of user profile photos:
- Added the class
userProfilePhoto
, containingid
,added_date
andsizes
of a profile photo. - Changed the type of the field
photos
inuserProfilePhotos
to a list ofuserProfilePhoto
instead of a list ofphoto
.getUserProfilePhotos
now returns a date for each profile photo. - Removed the field
id
from the classphoto
(this field was only needed in the result ofgetUserProfilePhotos
).
- Added the class
- Added the possibility to get a Telegram Passport authorization form before asking the user for a password:
- Removed the parameter
password
from the methodgetPassportAuthorizationForm
. - Moved the fields
elements
anderrors
from the classpassportAuthorizationForm
to the new classpassportElementsWithErrors
. - Added the method
getPassportAuthorizationFormAvailableElements
that takes the user's password and returns previously uploaded Telegram Passport elements and errors in them.
- Removed the parameter
- Added the field
file_index
to the classespassportElementErrorSourceFile
andpassportElementErrorSourceTranslationFile
. - Added the method
getCurrentState
returning all updates describing the currentTDLib
state. It can be used to restore the correct state after connecting to a running TDLib instance. - Added the class
updates
which contains a list of updates and is returned by thegetCurrentState
method. - Added the update
updateChatOnlineMemberCount
which is automatically sent for open group chats if the number of online members in a group changes. - Added support for custom language packs downloaded from the server:
- Added the fields
base_language_pack_id`` to the class
languagePackInfo`. Strings from the base language pack must be used for untranslated keys from the chosen language pack. - Added the fields
plural_code
,is_official
,is_rtl
,is_beta
,is_installed
,total_string_count
,translated_string_count
,translation_url
to the classlanguagePackInfo
. - Added the method
addCustomServerLanguagePack
which adds a custom server language pack to the list of installed language packs. - Added the method
getLanguagePackInfo
which can be used for handlinghttps://t.me/setlanguage/...
links. - Added the method
synchronizeLanguagePack
which can be used to fetch the latest versions of all strings from a language pack. The method doesn't need to be called explicitly for the current used/base language packs. - The method
deleteLanguagePack
now also removes the language pack from the list of installed language packs.
- Added the fields
- Added the method
getChatNotificationSettingsExceptions
which can be used to get chats with non-default notification settings. - Added the parameter
hide_via_bot
tosendInlineQueryResultMessage
which can be used forgetOption("animation_search_bot_username")
,getOption("photo_search_bot_username")
andgetOption("venue_search_bot_username")
bots to hide that the message was sent via the bot. - Added the class
chatReportReasonChildAbuse
which can be used to report a chat for child abuse. - Added the method
getMessageLocally
which returns a message only if it is available locally without a network request. - Added the method
writeGeneratedFilePart
which can be used to write a generated file if there is no direct access to TDLib's file system. - Added the method
readFilePart
which can be used to read a file from the TDLib file cache. - Added the class
filePart
to represent the result of the newreadFilePart
method. - Added the field
log_size
to thestorageStatisticsFast
class which contains the size of the TDLib internal log. Previously the size was included into the value of thedatabase_size
field. - Added the field
language_pack_database_size
to thestorageStatisticsFast
class which contains the size of the language pack database. - Added the field
is_support
to the classuser
which can be used to identify Telegram Support accounts. - Added the class
HttpUrl
encapsulating an HTTP URL. - Added the method
getMessageLink
which can be used to create a private link (which works only for members) to a message in a supergroup or channel. - Added support for channel statistics (coming soon):
- Added the field
can_view_statistics
to thesupergroupFullInfo
class. - Added the method
getChatStatisticsUrl
which returns a URL with the chat statistics.
- Added the field
- Added support for server-side peer-to-peer calls privacy:
- Added the class
userPrivacySettingAllowPeerToPeerCalls
for managing privacy. - Added the field
allow_p2p
tocallStateReady
class which must be used to determine whether a peer-to-peer connection can be used.
- Added the class
- Added the option
ignore_background_updates
which allows to skip all updates received while the TDLib instance was not running. The option does nothing if the database or secret chats are used. - Added the read-only option
expect_blocking
, suggesting whether Telegram is blocked for the user. - Added the read-only option
enabled_proxy_id
, containing the ID of the enabled proxy. - Added the ability to identify password pending sessions (where the code was entered but not
the two-step verification password) via the flag
is_password_pending
in thesession
class. TDLib guarantees that the sessions will be returned by thegetActiveSessions
method in the correct order. - Added the classes
JsonValue
andjsonObjectMember
which represent a JSON value and a member of a JSON object respectively as TDLib API objects. - Added the synchronous methods
getJsonValue
andgetJsonString
for simple conversion between a JSON-encoded string andJsonValue
TDLib API class. - Added the methods
getApplicationConfig
andsaveApplicationLogEvent
to be used for testing purposes. - Added the temporarily class
databaseStatistics
and the methodgetDatabaseStatistics
for rough estimations of database tables size in a human-readable format. - Made the method
Client.Execute
static in .NET interface. - Removed the
on_closed
callback virtual method from low-level C++ ClientActor interface. Callback destructor can be used instead. - Updated dependencies in the prebuilt TDLib for Android:
- Updated SDK to SDK 28 in which helper classes was moved from
android.support.
toandroidx.
package. - Updated NDK to r19c, which dropped support for Android versions up to 4.0.4, so the minimum supported version is Android 4.1.
- Updated OpenSSL to version 1.1.1.
- Added x86_64 libraries.
- Updated SDK to SDK 28 in which helper classes was moved from
- Added out of the box
FreeBSD
support. - Significantly improved TDLib compilation time and decreased compiler RAM usage:
- In native C++ interface
td_api::object_ptr
is now a simple homebrew const-propagating class instead ofstd::unique_ptr
. - Added the script
SplitSource.php
, which can be used to split some source code files before building the library to reduce maximum RAM usage per file at the expense of increased build time.
- In native C++ interface
- The update
updateOption
with theversion
option is now guaranteed to come before all other updates. It can now be used to dynamically discover available methods. - Added the ability to delete incoming messages in private chats and revoke messages without a time limit:
- Added the parameter
revoke
to the methoddeleteChatHistory
; use it to delete chat history for all chat members. - Added the fields
can_be_deleted_only_for_self
andcan_be_deleted_for_all_users
to the classchat
which can be used to determine for whom the chat can be deleted through thedeleteChatHistory
method. - The fields
Message.can_be_deleted_only_for_self
andMessage.can_be_deleted_for_all_users
can still be used to determine for whom the message can be deleted through thedeleteMessages
method.
- Added the parameter
- Added support for server-generated notifications about newly registered contacts:
- Setting the option
disable_contact_registered_notifications
now affects all user sessions. When the option is enabled, the client will still receivemessageContactRegistered
message in the private chat, but there will be no notification about the message. getOption("disable_contact_registered_notifications")
can be used to fetch the actual value of the option, the option will not be updated automatically after a change from another device.
- Setting the option
- Decreased the maximum allowed first name and last name length to 64, chat title length to 128, matching the new server-side limits.
- Decreased the maximum allowed value of the
forward_limit
parameter of theaddChatMember
method from 300 to 100, matching the new server-side limit. - Added protection from opening two TDLib instances with the same database directory from one process.
- Added copying of notification settings of new secret chats from notification settings of the corresponding private chat.
- Excluded the sponsored chat (when using sponsored proxies) from unread counters.
- Allowed to pass decreased local_size in
setFileGenerationProgress
to restart the generation from the beginning. - Added a check for modification time of original file in
inputFileGenerated
whenever possible. If the original file was changed, then TDLib will restart the generation. - Added the destruction of MTProto keys on the server during log out.
- Added support for hexadecimal-encoded and decimal-encoded IPv4 proxy server addresses.
- Improved the behavior of
changeImportedContacts
which now also deletes contacts of users without Telegram accounts from the server. - Added the ability to call
getStorageStatistics
before authorization. - Allowed to pass
limit
= -offset
for negative offset in thegetChatHistory
method. - Changed the recommended
inputThumbnail
size to be at most 320x320 instead of the previous 90x90. - Disabled building by default of the native C interface. Use
cmake --build . --target tdc
to build it. - Numerous optimizations and bug fixes:
- Network implementation for Windows was completely rewritten to allow a literally unlimited number of simultaneously used TDLib instances.
- TDLib instances can now share working threads with each other. Only a limited number of threads will be created even if there are thousands of TDLib instances in a single process.
- Removed the restriction on the size of update or response result in JSON interface.
- Fixed pinning of the 5th chat when there is a sponsored chat.
- Fixed IPv6 on Windows.
- Improved network connections balancing, aliveness checks and overall stability.
- Various autogenerated documentation fixes and improvements.
Changes in 1.3.0:
- Added a review of existing TDLib based frameworks in different programming languages.
- Added a Getting started guide describing the main TDLib concepts and basic principles required for library usage.
- When a chat is opened, only those messages that have been viewed are marked as read.
- Improved the proxy settings API:
- A list of proxies is stored instead of just one proxy.
- New methods
addProxy
,editProxy
,enableProxy
,disableProxy
,removeProxy
andgetProxies
were added instead ofsetProxy
andgetProxy
. - Added the method
pingProxy
which can be used to compute time needed to receive a response from a Telegram server through a proxy or directly. - Added support for MTProto proxy via class
proxyTypeMtproto
. - Added support for HTTP proxy via class
proxyTypeHttp
. - For each proxy last time it was used is remembered.
- Added the method
getProxyLink
which returns an HTTPS link that can be used to share a proxy with others.
- Improved the notification settings API. Scope notification settings are now properly synchronized between all devices
and chat notification settings can be reset to their default values:
- The
notificationSettings
class was split intochatNotificationSettings
andscopeNotificationSettings
. - Only two notification settings scopes are left:
notificationSettingsScopePrivateChats
which is responsible for default notification settings for private and secret chats andnotificationSettingsScopeGroupChats
for all other chats. updateNotificationSettings
was split intoupdateChatNotificationSettings
andupdateScopeNotificationSettings
.setNotificationSettings
was split intosetChatNotificationSettings
andsetScopeNotificationSettings
.getNotificationSettings
was replaced withgetScopeNotificationSettings
.
- The
- Added the field
filter
to thesearchChatMembers
method to support searching among administrators, bots, restricted and banned members. - Added the ability to use synchronous requests and
setAlarm
before the library is initialized. - Added the ability to send requests that don't need authentication before the library is initialized. These requests
will be postponed and executed at the earliest opportunity. For example,
setNetworkType
can be used to disable the network for TDLib before the library tries to use it;addProxy
can be used to add a proxy before any network activity; orsetOption("use_pfs")
can be used to guarantee that PFS is used for all requests. - Added support for tg:// links in
inlineKeyboardButtonTypeUrl
andtextEntityTypeTextUrl
. - Added the ability to call
deleteAccount
in theauthorizationStateWaitPassword
authorization state. - Added the ability to call
checkAuthenticationCode
with an emptyfirst_name
for unregistered users to check the code validity. - Added the methods
editMessageMedia
andeditInlineMessageMedia
for editing media messages content. - Renamed the class
shippingAddress
toaddress
. - Changed the return value of the
requestPasswordRecovery
method frompasswordRecoveryInfo
toemailAddressAuthenticationCodeInfo
. - Added support for sponsored channels promoted by MTProto-proxies:
- Added the field
is_sponsored
to thechat
class. - Added
updateChatIsSponsored
, sent when this field changes.
- Added the field
- Added support for marking chats as unread:
- Added the field
is_marked_as_unread
tochat
. - Added the update
updateChatIsMarkedAsUnread
. - Added the method
toggleChatIsMarkedAsUnread
.
- Added the field
- Added support for a default value of
disable_notification
, used when a message is sent to the chat:- Added the field
default_disable_notification
tochat
class. - Added the update
updateChatDefaultDisableNotification
. - Added the method
toggleChatDefaultDisableNotification
.
- Added the field
- Added the field
vcard
to thecontact
class. - Added the field
type
tovenue
, which contains a provider-specific type of the venue, - Added the update
updateUnreadChatCount
, enabled when the message database is used and sent when the number of unread chats has changed. - Added the method
addLocalMessage
for adding a local message to a chat. - Added the method
getDeepLinkInfo
, which can return information abouttg://
links that are not supported by the client. - Added support for language packs:
- Added the writable option
language_pack_database_path
which can be used to specify a path to a database for storing language pack strings, so that this database can be shared between different accounts. If not specified, language pack strings will be stored only in memory. Changes to the option are applied only on the next TDLib launch. - Added the writable option
localization_target
for setting up a name for the current localization target (currently supported: "android", "android_x", "ios", "macos" and "tdesktop"). - Added the writable option
language_pack_id
for setting up an identifier of the currently used language pack from the current localization target (a "language pack" represents the collection of strings that can be used to display the interface of a particular application in a particular language). - Added the class
LanguagePackStringValue
describing the possible values of a string from a language pack. - Added the class
languagePackString
describing a string from a language pack. - Added the class
languagePackStrings
containing a list of language pack strings. - Added the class
languagePackInfo
containing information about a language pack from a localization target. - Added the class
localizationTargetInfo
containing information about a localization target. - Added the update
updateLanguagePackStrings
which is sent when some strings in a language pack have changed. - Added the synchronous method
getLanguagePackString
which can be used to get a language pack string from the local database. - Added the method
getLocalizationTargetInfo
which returns information about the current localization target. - Added the method
getLanguagePackStrings
which returns some or all strings from a language pack, possibly fetching them from the server. - Added the method
setCustomLanguagePack
for adding or editing a custom language pack. - Added the method
editCustomLanguagePackInfo
for editing information about a custom language pack. - Added the method
setCustomLanguagePackString
for adding, editing or deleting a string in a custom language pack. - Added the method
deleteLanguagePack
for deleting a language pack from the database. - Added the read-only option
suggested_language_pack_id
containing the identifier of the language pack, suggested for the user by the server.
- Added the writable option
- Added support for Telegram Passport:
- Added two new message contents
messagePassportDataSent
for ordinary users andmessagePassportDataReceived
for bots containing information about Telegram Passport data shared with a bot. - Added the new file type
fileTypeSecure
. - Added the class
datedFile
containing information about a file along with the date it was uploaded. - Added the helper classes
date
,personalDetails
,identityDocument
,inputIdentityDocument
,personalDocument
,inputPersonalDocument
,passportElements
. - Added the class
PassportElementType
describing all supported types of Telegram Passport elements. - Added the class
PassportElement
containing information about a Telegram Passport element. - Added the class
InputPassportElement
containing information about a Telegram Passport element to save. - Added the classes
passportElementError
andPassportElementErrorSource
describing an error in a Telegram Passport element. - Added the field
has_passport_data
to thepasswordState
class. - Added the methods
getPassportElement
,getAllPassportElements
,setPassportElement
,deletePassportElement
for managing Telegram Passport elements. - Added the methods
getPassportAuthorizationForm
andsendPassportAuthorizationForm
used for sharing Telegram Passport data with a service via a bot. - Added the methods
sendPhoneNumberVerificationCode
,resendPhoneNumberVerificationCode
andcheckPhoneNumberVerificationCode
for verification of a phone number used for Telegram Passport. - Added the methods
sendEmailAddressVerificationCode
,resendEmailAddressVerificationCode
andcheckEmailAddressVerificationCode
for verification of an email address used for Telegram Passport. - Added the method
getPreferredCountryLanguage
returning a most popular language in a country. - Added the classes
inputPassportElementError
andInputPassportElementErrorSource
for bots describing an error in a Telegram Passport element. - Added the method
setPassportElementErrors
for bots. - Added the class
encryptedPassportElement
andencryptedCredentials
for bots describing an encrypted Telegram Passport element.
- Added two new message contents
- Improved support for Telegram terms of service:
- Added the class
termsOfService
, containing information about the Telegram terms of service. - Added the field
terms_of_service
toauthorizationStateWaitCode
. - Added the update
updateTermsOfService
coming when new terms of service need to be accepted by the user. - Added the method
acceptTermsOfService
for accepting terms of service. - Removed the method
getTermsOfService
.
- Added the class
- Added the method
getMapThumbnailFile
which can be used to register and download a map thumbnail file. - Added the methods
sendPhoneNumberConfirmationCode
,resendPhoneNumberConfirmationCode
andcheckPhoneNumberConfirmationCode
which can be used to prevent an account from being deleted. - Added the convenience methods
joinChat
andleaveChat
which can be used instead ofsetChatMemberStatus
to manage the current user's membership in a chat. - Added the convenience method
getContacts
which can be used instead ofsearchContacts
to get all contacts. - Added the synchronous method
cleanFileName
which removes potentially dangerous characters from a file name. - Added the method
getChatMessageCount
which can be used to get the number of shared media. - Added the writable option
ignore_inline_thumbnails
which can be used to prevent file thumbnails sent by the server along with messages from being saved on the disk. - Added the writable option
prefer_ipv6
which can be used to prefer IPv6 connections over IPv4. - Added the writable option
disable_top_chats
which can be used to disable support for top chats. - Added the class
chatReportReasonCopyright
for reporting chats containing infringing content. - Added the method
clearAllDraftMessages
which can be used to delete all cloud drafts. - Added the read-only options
message_text_length_max
andmessage_caption_length_max
. - Added the read-only options
animation_search_bot_username
,photo_search_bot_username
andvenue_search_bot_username
containing usernames of bots which can be used in inline mode for animations, photos and venues search respectively. - Numerous optimizations and bug fixes:
- Fixed string encoding for C# binding.
- Fixed building TDLib SDK for Universal Windows Platform for ARM with MSVC 2017.
- Fixed the Swift example project.
- Fixed the syntax error in the Python example.
- Sticker thumbnails can now have
webp
extensions if they are more likely to be in WEBP format.
Changes in 1.2.0:
- Added support for native .NET bindings through
C++/CLI
andC++/CX
. See using in .NET projects for more details. - Added a C# example. See README for build and usage instructions.
- Added a build and usage example of TDLib SDK for Universal Windows Platform. See README for detailed build and usage instructions. Also see Unigram, which is a full-featured client rewritten from scratch using TDLib SDK for Universal Windows Platform in less than 2 months.
- Added a Swift example. See README for build and usage instructions.
- Added an example of building TDLib for iOS, watchOS, tvOS, and also macOS. See README for detailed build instructions.
- Added README to C++ and python examples.
- Link Time Optimization is disabled by default. Use
-DTD_ENABLE_LTO=ON
CMake option and CMake >= 3.9 to enable it. updateNotificationSettings
is now automatically sent when the mute time expires for a chat.- Added automatic sending of a corresponding
chatAction
when a file is being uploaded. updateUserChatAction
withchatActionCancel
is now automatically sent when the timeout expires for an action.- Authorization states
authorizationStateWaitCode
andauthorizationStateWaitPassword
are now saved between library restarts for 5 minutes. - Added new message content type
messageWebsiteConnected
. - Added new text entity types
textEntityTypeCashtag
andtextEntityTypePhoneNumber
. - Added new update
updateUnreadMessageCount
, enabled when message database is used. - Method
joinChatByInviteLink
now returns the joinedchat
. - Method
getWebPagePreview
now acceptsformattedText
instead of plainstring
. - Added field
phone_number
toauthenticationCodeInfo
, which contains a phone number that is being authenticated. - Added field
is_secret
tomessageAnimation
,messagePhoto
,messageVideo
andmessageVideoNote
classes, which denotes whether the thumbnail for the content must be blurred and the content must be shown only while tapped. - Added field
expires_in
tomessageLocation
for live locations. - Added flag
can_be_reported
tochat
class. - Added flag
supports_streaming
to classesvideo
andinputMessageVideo
. - Added parameter
message_ids
toreportChat
, which can be used to report specific messages. - Added method
checkChatUsername
for checking whether a username can be set for a chat. - Added method
getRepliedMessage
, which returns a message that is replied by a given message. - Added method
getChatPinnedMessage
, which returns the pinned message from a chat. - Added method
searchStickers
to search by emoji for popular stickers suggested by the server. - Added method
searchStickerSets
to search by title and name for popular sticker sets suggested by the server. - Added method
searchInstalledStickerSets
to search by title and name for installed sticker sets. - Added methods for handling connected websites:
getConnectedWebsites
,disconnectWebsite
anddisconnectAllWebsites
. - Added method
getCountryCode
, which uses current user IP to identify their country. - Added option
t_me_url
. - Fixed
BlackBerry
spelling indeviceTokenBlackBerryPush
. - Fixed return type of
getChatMessageByDate
method, which isMessage
and notMessages
. - Ensured that updateOption("my_id") comes before
updateAuthorizationState
withauthorizationStateReady
. - Numerous optimizations and bug fixes.
Changes in 1.1.1:
- Fixed C JSON bindings compilation error.
- Fixed locale-dependent JSON generation.
Changes in 1.1.0:
- Methods
td::Log::set_file_path
andtd_set_log_file_path
now return whether they succeeded. - Added methods
td::Log::set_max_file_size
andtd_set_log_max_file_size
for restricting maximum TDLib log size. - Added methods
td::Log::set_fatal_error_callback
andtd_set_log_fatal_error_callback
for providing callbacks on fatal errors. - JNI-bindings are now package-agnostic. Use CMake option
TD_ENABLE_JNI
to enable JNI-bindings. - Added a Java example. See README for build and usage instructions.
- Added support for text entities in media captions.
- Added new type
formattedText
containing a text with entities. - Replaced all string fields
caption
with fields of typeformattedText
. - Replaced fields
text
andentities
with the fieldtext
of typeformattedText
in classmessageText
. - Replaced fields
text
andentities
with the fieldtext
of typeformattedText
in classinputMessageText
. - Replaced fields
text
andtext_entities
with the fieldtext
of typeformattedText
in classgame
. - Removed field
parse_mode
from classinputMessageText
. - Added synchronous method
parseTextEntities
.
- Added new type
- updateNewMessage is now sent for all sent messages.
- updateChatLastMessage is now sent when any field of the last message in a chat changes.
- Reworked the
registerDevice
method:- Added parameter
other_user_ids
to methodregisterDevice
to support multiple accounts. - It is now possible to specify tokens for VoIP pushes, WNS, web Push API, Tizen Push Service as
DeviceToken
. - Added support for Apple Push Notification Service inside App Sandbox.
- Added parameter
- Added method
searchChatsOnServer
analogous tosearchChats
, but using server search. - Results from the
searchChatsOnServer
method are now excluded fromsearchPublicChats
results, sosearchChatsOnServer
(along withsearchContacts
) should be called wheneversearchPublicChats
is called to ensure that no results were omitted. - Added parameter
as_album
to methodgetPublicMessageLink
to enable getting public links for media albums. - Added field
html
to classpublicMessageLink
, containing HTML-code for message/message album embedding. - Added parameter
only_if_pending
to methodcancelDownloadFile
to allow keeping already started downloads. - Methods
createPrivateChat
,createBasicGroupChat
,createSupergroupChat
andcreateSecretChat
can now be called without a prior call togetUser
/getBasicGroup
/getSupergroup
/getSecretChat
. - Added parameter
force
to methodscreatePrivateChat
,createBasicGroupChat
andcreateSupergroupChat
to allow creating a chat without network requests. - Numerous optimizations and bug fixes.