Utils

В этом разделе рассматриваются более сложные аспекты API CactusLib, предназначенные для опытных разработчиков.

• Прямые вызовы TLRPC
  • CactusUtils.Telegram.send_request(req, callback=None, *, wait_response: bool = True, timeout: int = 10, raise_errors: bool = True)
  • Пример: получение фотографий профиля пользователя
  • Синхронный запрос (стандартное поведение)
  • Запрос «Fire-and-Forget» (без ожидания ответа)
  • Использование callback (как обычно)
  • Вспомогательные методы
  • Готовые методы-обертки
  • Доступ к кэшу
• Работа с сообщениями
  • CactusUtils.send_message(peer: int, text: str, *, parse_message: bool = True, parse_mode: str = "HTML", markup: Any = None, on_sent: Optional[Callable] = None, **kwargs)
  • CactusUtils.edit_message(message_object: MessageObject, text: str, *, parse_message: bool = True, parse_mode: str = "HTML", markup: Any = None, **kwargs)
  • CactusUtils.edit_message_markup(cell: ChatMessageCell, markup)
  • self.answer_file(self, params, path: str, caption: Optional[str] = None, *, parse_markdown: bool = True, **kwargs) (CactusUtils.Plugin.answer_file)
• CactusUtils
  • Методы класса
  • Класс FileSystem (вложенный в CactusUtils)
  • Другие методы класса
  • Классы Uri и MessageUri (вложенные в CactusUtils)

Когда это нужно?

Стандартных утилит, команд и обработчиков колбэков достаточно для 95% всех плагинов. Однако иногда вам может потребоваться:

• Создать и выполнить запрос API Telegram самостоятельно.

• Работать с файлами на устройстве.

• Показывать кастомные системные диалоги.

Используйте эти возможности с осторожностью, так как они требуют более глубокого понимания работы Telegram и Android.