telegram.InputMediaVideo¶
-
class
telegram.
InputMediaVideo
(media: Union[str, IO, InputFile, pathlib.Path, telegram.files.video.Video], caption: str = None, width: int = None, height: int = None, duration: int = None, supports_streaming: bool = None, parse_mode: Union[str, telegram.utils.helpers.DefaultValue] = <telegram.utils.helpers.DefaultValue object>, thumb: Union[str, IO, InputFile, pathlib.Path] = None, caption_entities: Union[List[telegram.messageentity.MessageEntity], Tuple[telegram.messageentity.MessageEntity, ...]] = None)¶ Bases:
telegram.files.inputmedia.InputMedia
Represents a video to be sent.
-
type
¶ video
.Type: str
-
media
¶ Video file to send.
Type: str
|telegram.InputFile
Optional. Caption of the document to be sent.
Type: str
-
parse_mode
¶ Optional. The parse mode to use for text formatting.
Type: str
Optional. List of special entities that appear in the caption.
Type: List[ telegram.MessageEntity
]
-
width
¶ Optional. Video width.
Type: int
-
height
¶ Optional. Video height.
Type: int
-
duration
¶ Optional. Video duration.
Type: int
-
supports_streaming
¶ Optional. Pass
True
, if the uploaded video is suitable for streaming.Type: bool
-
thumb
¶ Optional. Thumbnail of the file to send.
Type: telegram.InputFile
Parameters: - media (
str
| filelike object |pathlib.Path
|telegram.Video
) – File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet. Lastly you can pass an existingtelegram.Video
object to send. - caption (
str
, optional) – Caption of the video to be sent, 0-1024 characters after entities parsing. - parse_mode (
str
, optional) – Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption. See the constants intelegram.ParseMode
for the available modes. - caption_entities (List[
telegram.MessageEntity
], optional) – List of special entities that appear in the caption, which can be specified instead of parse_mode. - width (
int
, optional) – Video width. - height (
int
, optional) – Video height. - duration (
int
, optional) – Video duration. - supports_streaming (
bool
, optional) – PassTrue
, if the uploaded video is suitable for streaming. - thumb (filelike object |
pathlib.Path
, optional) – Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail’s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file.
Note
- When using a
telegram.Video
for themedia
attribute. It will take the width, height and duration from that video, unless otherwise specified with the optional arguments. thumb
will be ignored for small video files, for which Telegram can easily generate thumb nails. However, this behaviour is undocumented and might be changed by Telegram.
-