download_media()

Client.download_media()

下载消息对象包含的媒体文件。

注解

如果下载太慢，则应考虑安装 cryptg （pip3 install cryptg）

参数:

entity (user | chat | channel):

需要发送文件的对话的对象。

file (str | file):

输出文件路径，目录或流等对象。如果该路径存在并且是文件，则将覆盖。

返回:

None: 如果消息中不存在媒体文件，如果为指定路径则将返回文件路径。

示例

path = await client.download_media(message)
await client.download_media(message, filename)
# 或者
path = await message.download_media()
await message.download_media(filename)

# 提示下载进度
def callback(current, total):
    print('Downloaded', current, 'out of', total,
          'bytes: {:.2%}'.format(current / total))

await client.download_media(message, progress_callback=callback)