کلاس Bot – ساختار اصلی ربات در Rubika
کلاس Bot هسته‌ی اصلی برای ایجاد و مدیریت ربات در کتابخانه Rubika است. این کلاس با ترکیب ماژول‌های مختلف مانند مدیریت نشست (Session)، شبکه (Network)، متدها و هندلرها، ساختار پایه‌ای برای اجرای ربات‌ها را فراهم می‌کند.
ساختار کلی
class Bot extends Methods {
...
}
ورودی سازنده
constructor(token: string ,config: {
logLevel: "debug",
retryCount: 3,
timeout: 10000,
})
-
token: توکن اختصاصی ربات Rubika که به صورت رشته (string) دریافت می‌شود. این مقدار نقش کلید اصلی را دارد و برای شناسایی هویت ربات و برقراری ارتباط امن با سرورهای Rubika استفاده می‌شود. -
timeout: مدت زمان انتظار (به میلی‌ثانیه) برای تکمیل هر درخواست. پیش‌فرض آن 10000 میلی‌ثانیه (۱۰ ثانیه) است. اگر پاسخ سرور در این بازه زمانی دریافت نشود، درخواست قطع شده و خطای Timeout رخ می‌دهد. -
retryCount: تعداد دفعاتی که سیستم در صورت بروز خطا یا عدم دریافت پاسخ، تلاش می‌کند درخواست را مجدداً ارسال کند. پیش‌فرض آن3بار است. این قابلیت به پایداری ارتباط در شرایط ناپایدار شبکه کمک می‌کند.
ویژگی‌ها و اجزای اصلی کلاس
| ویژگی | توضیح |
|---|---|
BASE_URL | آدرس پایه API رسمی ربات‌های روبیکا (https://botapi.rubika.ir/v3/${token}) |
initialize | پرچمی برای بررسی وضعیت اولیه‌سازی (مقدار پیش‌فرض: false) |
network | نمونه‌ای از کلاس Network برای مدیریت درخواست‌ها |
handlers | مجموعه‌ای از هندلرها برای مدیریت پیام‌ها و پیام‌های اینلاین |
bot | اطلاعات عمومی مربوط به ربات مانند آیدی و نام (در صورت نیاز) |
وظایف کلاس
1. ارتباط با API روبیکا
کلاس Network برای ارسال درخواست به API ربات‌ها استفاده می‌شود. مانند دریافت پیام، پاسخ‌دهی، و مدیریت فایل‌ها.
2. سیستم رویدادها (Handler)
هر نوع پیام، مانند update , inline یا error ، می‌تواند مجموعه‌ای از هندلرها داشته باشد که با دریافت پیام یا ارور اجرا می‌شوند.
نتیجه‌گیری
کلاس Bot یکی از ارکان اصلی Rubika است و پایه‌ای برای ساخت ربات‌های پیشرفته روی پلتفرم روبیکا فراهم می‌کند. با استفاده از این کلاس، توسعه‌دهنده‌ها می‌توانند سریعاً یک ربات با قابلیت‌های مختلف ایجاد کنند.