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

telegram-node-bot文件上传指南三种方式发送照片、视频和文档【免费下载链接】telegram-node-botNode module for creating Telegram bots.项目地址: https://gitcode.com/gh_mirrors/te/telegram-node-bottelegram-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或HTMLdisable_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 } } } 调试技巧查看文件信息使用$.message.document、$.message.photo等属性获取文件详情日志记录记录文件上传过程以便调试文件大小限制注意Telegram的文件大小限制照片20MB视频50MB文档50MB 总结telegram-node-bot提供了三种灵活的文件上传方式文件ID方式最快速适合重复发送相同文件本地文件方式最常用适合发送本地文件URL方式最方便适合发送网络文件通过本文的指南你应该已经掌握了telegram-node-bot文件上传的核心功能。记住查看lib/api/InputFile.js和lib/api/TelegramApi.js文件了解底层实现以及lib/mvc/Scope.js中的Scope类方法。现在就开始构建你的文件上传功能吧如果你遇到任何问题记得查阅官方文档或社区支持。【免费下载链接】telegram-node-botNode module for creating Telegram bots.项目地址: https://gitcode.com/gh_mirrors/te/telegram-node-bot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考