TDLib
.NET bindings for TDLib (Telegram Database Library): https://github.com/tdlib/td
- Generated API bindings
- Supports .NET Standard 2.0 and later
Installation
Install via NuGet: TDLib
Dependencies
You're recommended to use precompiled version of TDLib native artifacts from NuGet: TDLib.Native
Note that tdlib.native
is not a dependency of TDLib
, so you may choose to build the binaries yourself and provide them at the runtime.
To do that, build TDLib and put the compiled library into your project's output directory
- tdjson.dll (Windows) (optionally accompanied by other DLL files from the build directory if you want to bundle OpenSSL and ZLib dependencies as well)
- libtdjson.dylib (MacOS)
- libtdjson.so (Linux)
Have a question?
Report bugs to the issue tracker.
Ask questions at the discussion section on GitHub.
Using json client
TdJsonClient is a wrapper around native JSON APIs. Use it to send/receive data as strings.
using TdLib;
var json = ""; // json data
double timeout = 1.0; // 1 second
using (var jsonClient = new TdJsonClient())
{
jsonClient.Send(json); // send request
var result = jsonClient.Receive(timeout); // receive response
}
Using strongly typed APIs
This library contains generated classes for objects and functions. JSON serialization and deserialization is handled automatically. Use TdClient to asynchronously execute functions.
using TdLib;
using (var client = new TdClient())
{
try
{
// asynchronously execute function
TdApi.Ok ok = await client.ExecuteAsync(new TdApi.SetAuthenticationPhoneNumber
{
PhoneNumber = phoneNumber
});
// or use extension method
ok = await client.SetAuthenticationPhoneNumberAsync(phoneNumber);
// do something...
}
catch (ErrorException e)
{
TdApi.Error error = e.Error;
// handle error...
}
}
Overriding native bindings
By default, TdSharp will try to detect the platform and use the corresponding bindings to native td library. In case you want to override it (e.g. for Xamarin), create a custom implementation of ITdLibBindings
(which corresponds to native library interface used by TdSharp) and pass it to TdClient
constructor.