Media & Files

Source:

Types: Media & Files

Download ack result

Source:

  • backend/tg_client/dialogs/tdlib/services/media_command_service.py
  • backend/tg_client/dialogs/tdlib/normalizers/media_command_normalizer.py

download_file returns an immediate acknowledgement for accepted targets, not the final media path.

Accepted target families in code:

  • files
  • media
  • remote_unique_ids / remote_ids
  • remote_unique_id / remote_id / remote
  • file_ids / file_id

media_ready event

Published later by media_loader.py after cache/cloud resolution or Telegram download.

Typical payload families:

  • file payload
  • kind: file
  • file_id
  • remote_unique_id
  • path
  • custom emoji payload
  • kind: custom_emoji
  • emoji_id
  • file_id
  • asset path / metadata

Sticker result

StickerNormalizer builds:

  • get_recent_stickers
  • grouped sticker pack result
  • sticker set search result

Sticker item fields include:

  • kind
  • file_id
  • remote_file_id
  • thumb_file_id
  • emoji
  • set_id
  • sticker_format
  • sticker_full_type
  • optional premium animation refs

File generation

services/file_generation.py handles TDLib generated-file lifecycle for cloud-backed media conversions.

Requires verification in deployment docs: the exact conversion scenarios and operational guarantees depend on external storage configuration and runtime environment.