当前位置：首页 > news >正文

telegram-node-bot文件上传指南：三种方式发送照片、视频和文档

news 2026/7/19 13:53:00

telegram-node-bot文件上传指南：三种方式发送照片、视频和文档

【免费下载链接】telegram-node-botNode module for creating Telegram bots.项目地址: https://gitcode.com/gh_mirrors/te/telegram-node-bot

telegram-node-bot是一个功能强大的Node.js模块，专门用于创建Telegram机器人。本文将详细介绍如何使用telegram-node-bot实现文件上传功能，涵盖发送照片、视频和文档的三种不同方式。无论你是新手还是有经验的开发者，这篇完整指南都将帮助你快速掌握telegram-node-bot的文件上传技巧。

📁 为什么需要文件上传功能？

在Telegram机器人开发中，文件上传是核心功能之一。无论是发送图片、视频、音频还是文档，telegram-node-bot都提供了简单易用的API。通过本文，你将学习到：

使用文件ID快速发送已存在的文件
从本地文件系统上传文件
通过URL远程发送文件
处理不同类型文件的最佳实践

🔧 准备工作：安装与基础配置

首先，确保你已经安装了telegram-node-bot模块：

npm install --save telegram-node-bot

创建基础机器人结构：

const Telegram = require('telegram-node-bot') const TelegramBaseController = Telegram.TelegramBaseController const TextCommand = Telegram.TextCommand const tg = new Telegram.Telegram('YOUR_BOT_TOKEN')

📤 方法一：使用文件ID发送文件（最快方式）

文件ID是Telegram服务器上文件的唯一标识符。当你收到用户发送的文件或之前发送过文件时，Telegram会返回一个文件ID，你可以重复使用这个ID发送相同的文件。

发送照片示例

class FileUploadController extends TelegramBaseController { async photoHandler($) { // 使用文件ID发送照片 await $.sendPhoto('AgACAgUAAxkBAAIB...') // 替换为实际的文件ID // 或者使用InputFile.byId()方法 const InputFile = require('telegram-node-bot').InputFile await $.sendPhoto(InputFile.byId('AgACAgUAAxkBAAIB...')) } get routes() { return { '/sendphoto': 'photoHandler' } } }

发送视频示例

class VideoUploadController extends TelegramBaseController { async videoHandler($) { // 使用文件ID发送视频 await $.sendVideo('BAACAgUAAxkBAAIB...') // 可选参数：添加标题和时长 await $.sendVideo('BAACAgUAAxkBAAIB...', { caption: '这是一个有趣的视频！🎬', duration: 120 }) } get routes() { return { '/sendvideo': 'videoHandler' } } }

发送文档示例

class DocumentUploadController extends TelegramBaseController { async documentHandler($) { // 使用文件ID发送文档 await $.sendDocument('BQACAgUAAxkBAAIB...') // 可选参数：添加文件名和缩略图 await $.sendDocument('BQACAgUAAxkBAAIB...', { caption: '重要文档请查收 📄', disable_notification: true }) } get routes() { return { '/senddoc': 'documentHandler' } } }

💾 方法二：从本地文件系统上传文件

这是最常用的文件上传方式，允许你发送本地计算机上的文件。

发送本地照片

class LocalFileController extends TelegramBaseController { async localPhotoHandler($) { const InputFile = require('telegram-node-bot').InputFile // 方式一：使用InputFile.byFilePath() await $.sendPhoto(InputFile.byFilePath('./images/photo.jpg')) // 方式二：使用对象格式 await $.sendPhoto({ path: './images/photo.jpg' }) // 添加照片描述和可选参数 await $.sendPhoto(InputFile.byFilePath('./images/photo.jpg'), { caption: '美丽的风景照片 🌄', parse_mode: 'HTML' }) } get routes() { return { '/localphoto': 'localPhotoHandler' } } }

发送本地视频

class LocalVideoController extends TelegramBaseController { async localVideoHandler($) { const InputFile = require('telegram-node-bot').InputFile // 发送本地视频文件 await $.sendVideo(InputFile.byFilePath('./videos/demo.mp4'), { caption: '演示视频 🎥', supports_streaming: true, width: 1280, height: 720 }) } get routes() { return { '/localvideo': 'localVideoHandler' } } }

发送本地文档

class LocalDocumentController extends TelegramBaseController { async localDocumentHandler($) { const InputFile = require('telegram-node-bot').InputFile // 发送PDF文档 await $.sendDocument(InputFile.byFilePath('./docs/report.pdf'), { caption: '月度报告 📊', disable_content_type_detection: false }) // 发送Excel文件 await $.sendDocument(InputFile.byFilePath('./data/sales.xlsx'), { caption: '销售数据表格 📈' }) } get routes() { return { '/localdoc': 'localDocumentHandler' } } }

🌐 方法三：通过URL远程发送文件

telegram-node-bot支持直接从URL发送文件，这对于发送网络上的图片或文档非常有用。

发送远程照片

class RemoteFileController extends TelegramBaseController { async remotePhotoHandler($) { const InputFile = require('telegram-node-bot').InputFile // 方式一：使用InputFile.byUrl() await $.sendPhoto( InputFile.byUrl( 'https://example.com/images/landscape.jpg', 'landscape.jpg' ) ) // 方式二：使用对象格式 await $.sendPhoto({ url: 'https://example.com/images/landscape.jpg', filename: 'landscape.jpg' }) // 添加可选参数 await $.sendPhoto( InputFile.byUrl('https://example.com/images/sunset.jpg', 'sunset.jpg'), { caption: '日落美景 🌅', disable_notification: true } ) } get routes() { return { '/remotephoto': 'remotePhotoHandler' } } }

发送远程视频

class RemoteVideoController extends TelegramBaseController { async remoteVideoHandler($) { const InputFile = require('telegram-node-bot').InputFile // 发送远程视频 await $.sendVideo( InputFile.byUrl( 'https://example.com/videos/tutorial.mp4', 'tutorial.mp4' ), { caption: '教程视频 📺', duration: 300, width: 1920, height: 1080 } ) } get routes() { return { '/remotevideo': 'remoteVideoHandler' } } }

发送远程文档

class RemoteDocumentController extends TelegramBaseController { async remoteDocumentHandler($) { const InputFile = require('telegram-node-bot').InputFile // 发送远程PDF文档 await $.sendDocument( InputFile.byUrl( 'https://example.com/docs/manual.pdf', 'user_manual.pdf' ), { caption: '用户手册 📖', disable_web_page_preview: true } ) } get routes() { return { '/remotedoc': 'remoteDocumentHandler' } } }

🔄 支持的文件类型和参数

telegram-node-bot支持多种文件类型，每种类型都有特定的参数：

照片上传参数

caption: 照片描述文字
parse_mode: 解析模式（Markdown或HTML）
disable_notification: 静默发送
reply_to_message_id: 回复特定消息

视频上传参数

duration: 视频时长（秒）
width: 视频宽度
height: 视频高度
supports_streaming: 是否支持流式传输
thumb: 缩略图文件ID

文档上传参数

caption: 文档描述
disable_content_type_detection: 禁用内容类型检测
thumb: 缩略图文件ID

🚀 高级技巧：组合使用三种方式

在实际项目中，你可能需要根据不同的场景选择不同的上传方式。以下是一个综合示例：

class AdvancedUploadController extends TelegramBaseController { async uploadHandler($) { const InputFile = require('telegram-node-bot').InputFile const fileType = $.message.text.split(' ')[1] switch(fileType) { case 'id': // 使用文件ID（最快） await $.sendPhoto('AgACAgUAAxkBAAIB...') break case 'local': // 使用本地文件 await $.sendDocument(InputFile.byFilePath('./files/data.csv')) break case 'remote': // 使用远程URL await $.sendVideo({ url: 'https://cdn.example.com/video.mp4', filename: 'video.mp4' }) break default: await $.sendMessage('请指定上传方式：id、local 或 remote') } } get routes() { return { '/upload :type': 'uploadHandler' } } }

⚡ 性能优化建议

优先使用文件ID：文件ID方式最快，因为不需要重新上传文件
本地文件缓存：对于经常发送的文件，可以先上传一次获取文件ID，然后重复使用
URL文件处理：telegram-node-bot会自动下载URL文件并上传到Telegram
错误处理：始终添加错误处理代码

class SafeUploadController extends TelegramBaseController { async safeUploadHandler($) { try { await $.sendPhoto(InputFile.byFilePath('./images/photo.jpg'), { caption: '上传成功！✅' }) } catch (error) { console.error('文件上传失败:', error) await $.sendMessage('抱歉，文件上传失败，请稍后重试。❌') } } get routes() { return { '/safeupload': 'safeUploadHandler' } } }

📝 实际应用场景

场景一：图片分享机器人

class ImageBotController extends TelegramBaseController { async imageHandler($) { const command = $.message.text if (command.includes('cat')) { await $.sendPhoto(InputFile.byUrl( 'https://example.com/cats/random.jpg', 'cat.jpg' ), { caption: '可爱的猫咪！🐱' }) } else if (command.includes('dog')) { await $.sendPhoto(InputFile.byFilePath('./images/dogs/dog1.jpg'), { caption: '忠诚的狗狗！🐶' }) } } get routes() { return { '/image :type': 'imageHandler' } } }

场景二：文档管理机器人

class DocumentBotController extends TelegramBaseController { async documentHandler($) { // 获取用户上传的文件ID const fileId = $.message.document.file_id // 保存文件ID到数据库 await saveFileIdToDatabase(fileId, $.message.document.file_name) // 确认收到文件 await $.sendMessage(`已收到文件：${$.message.document.file_name}`) // 稍后可以重复发送该文件 // await $.sendDocument(fileId) } get routes() { return { 'documentCommand': 'documentHandler' } } }