Методы
Метод | Описание | Параметры | Пример | Версия |
---|---|---|---|---|
Client(phone) | Возвращает экземпляр клиента (TelegramClient) | phone - строка, номер телефона отправителя | var client = Telegram.Client("02"); | - |
Comb(name) Comb(name, args) Comb(name, type, args) | Создает экземпляр комбинатора (Combinator) | name - строка, имя комбинатора type - строка, имя generic типа. Актуально для vector args - объект или массив объектов, аргументы комбинатора | var boolFalse = Telegram.Comb("boolFalse"); var contact = Telegram.Comb("inputPhoneContact", [ 1, $.user, "User", "Name" ]); var vector = Telegram.Comb("vector", "InputContact", [ contact ]); | - |
GetRandom() | Возвращает случайное число | var client = Telegram.Client($.phone); client.Rpc("messages.sendMessage", [Telegram.Comb("inputPeerContact", $.userId), $.message, Telegram.GetRandom()]); | - |
TelegramClient
Модуль взаимодействия с Telegram
Свойства
Свойство | Тип | Описание | Пример | Версия |
---|---|---|---|---|
Authorized | логический | Возвращает true, если клиент успешно авторизован | var client = Telegram.Client($.phone); if(!client.Authorized) return Connect(client); | - |
Методы
Метод | Описание | Параметры | Исключения | Пример | Версия |
---|---|---|---|---|---|
Connect() | Соединяет с сервисом Telegram. Возвращает true, если необходима авторизация по sms | TlException
| function Connect(client){ if (!client.Connect()) return "sms"; return "connected";} | - | |
Authorize(smsCode) | Производит авторизацию по sms коду | smsCode - строка, код, переданный по sms | TlException
| function authorize() { try { var client = Telegram.Client($.phone); client.Authorize($.sms); return "success"; } catch (e) { return e.Message; } } | - |
Rpc(name,args) | Выполняет rpc вызов соответствующего комбинатора | name - строка, имя комбинатора удаленной процедуры args - объект или массив объектов, аргументы комбинатора | TlException
| return lient.Rpc("auth.checkPhone", $.user); | - |
GetUpdates() GetDifferences() | Получает входящие комбинаторы (Updates или Differences). Возвращает список комбинаторов. | TlException
| function getUpdates(){ try { var client = Telegram.Client($.phone); var updates = client.GetUpdates(); var result = ""; for (var update in updates) { result += GetInfo(update); } return result; } catch (e) { return e.Message; } } | - | |
SendMessage(phone, message) | Отправляет сообщение | phone - телефон адресата massage - текст сообщения | TlException
| function send(){ try { var client = Telegram.Client($.phone); client.SendMessage($.user, $.message); return "success"; } catch (e) { return e.Message; } } | - |
Combinator
Экземпляр комбинатора
Свойства
Свойство | Тип | Описание | Пример | Версия |
---|---|---|---|---|
Name | строка | Возвращает имя комбинатора | function GetInfo(combinator){ return combinator.Name; } | - |
IsVector | логический | Возвращает true, если данный комбинатор является вектором | function GetValue(combinator, index){ if(combinator.IsVector) return combinator[index]; return null; } | - |
Индексаторы
Индексатор | Описание | Параметры | Пример | Версия |
---|---|---|---|---|
[name] | Возвращает значение аргумента комбинатора | name - имя аргумента | function GetLangCode(combinator){ return combinator["Lang"]; } | - |
[index]* | Возвращает значение элемента вектора | index - индекс элемента | function GetValue(combinator, index){ if(combinator.IsVector) return combinator[index]; return null; } | - |
* - допустимо использовать комбинатор типа vector в итераторах, например for.
Пример
// Попытка соединения с сервисом Telegram // Параметры: // $.phone - номер телефона отправителя // Возвращает: // "success" - соединение успешно // "sms" - необходима авторизация, sms сообщение было выслано на соответствующий номер телефона // текст ошибки function connect() { try { var client = Telegram.Client($.phone); if(!client.Authorized) if (!client.Connect()) return "sms"; return "success"; } catch (e) { return e.Message; } } // Попытка авторизации по sms // Параметры: // $.phone - номер телефона отправителя // $.sms - смс код // Возвращает: // "success" - авторизация успешна // текст ошибки function authorize() { try { var client = Telegram.Client($.phone); client.Authorize($.sms); return "success"; } catch (e) { return e.Message; } } // Попытка отправки сообщения // Параметры: // $.phone - номер телефона отправителя // $.user - телефон адресата // $.message - текст сообщения // Возвращает: // "success" - сообщение успешно отправлено // текст ошибки function send(){ try { var client = Telegram.Client($.phone); if (client.Authorized) { client.SendMessage($.user, $.message); return "success"; } return "not_authorized" } catch (e) { return e.Message; } }
Версия
2.394
0 Комментариев