نصب برنامه و اجرای اولین ربات
یک دانلود، یک دوبار کلیک، و شروع به برنامهنویسی می‌کنید. برنامهی لیگ خانه هوشمند کل مسابقه را داخل خودش دارد — خانهی شبیهسازیشده، ربات، سنسورها، پایتون، درسها و ابزارهای کمکیِ کدساز. هیچ چیز دیگری لازم نیست نصب کنید.
🆕 لیگ خانه هوشمند ۲٫۱٫۱ منتشر شد — ۱۳ آبان ۱۴۰۵.
برنامه را دوباره دانلود کنید: فایل‌های پایین همان ۲٫۱٫۱ هستند و نسخه‌ی مرورگری در /game هم همان را اجرا میکند. قوانین عوض شد و برنامه با قوانین تازه بازی میکند:
- ۱۸۰ ثانیه در هر سه رده، فرستاستپ هم.
- ناظرِ گیر کردن ۱۰ ثانیه داخل دایره‌ی ۰٫۸۵ متری؛ ربات روی یک کاشی آزادِ تصادفی دست‌کم ۶ کاشی دورتر فرود می‌آید.
- جابه‌جایی ۲ کاشیِ ثابت جریمه دارد — و تا وقتی کمتر از ۱۰ کاشی داری، هیچ. جریمه‌ی پله‌ای ۵ / ۱۰ / ۱۲ برداشته شد.
- وقت اضافه نداریم. تساوی، تساوی است و یک امتیاز میدهد؛ بازی حذفیِ مساوی دوباره اجرا میشود.
- کتابچه‌ی قوانین (PDF و Word، هر دو زبان) از روی موتور بازی از نو نوشته شد و حالا سوییس‌لیگ، بای، تای‌برک و پلی‌آف را هم دارد.
قوانین کامل در صفحه‌ی قوانین مسابقات است و کتابچه‌ی داور با همهی
عددها به اسم RULES.md داخل خود برنامه می‌آید.
۱. دانلود برنامه — یا بازی در مرورگر
نمی‌خواهید چیزی دانلود کنید؟ کل بازی همین‌جا در مرورگر هم اجرا میشود: باز کردن بازی در مرورگر همان نسخه‌ی فایل‌های پایین است، با همان خانه و ربات و قوانین. کروم، اج، فایرفاکس و سافاری همه کار میکنند؛ لپ‌تاپ یا کامپیوتر بهتر است چون ویرایشگر به کیبورد نیاز دارد. برای روز مسابقه و برای باشگاهی که اینترنت ضعیفی دارد، برنامهی دانلودی انتخاب بهتری است، چون بعد از دانلود هیچ اینترنتی لازم ندارد.
فایل متناسب با کامپیوتر خود را انتخاب کنید. هر سه فایل یک نسخه‌اند — ۲٫۱٫۱ — و یک مسابقه: تیمی که روی ویندوز، تیمی که روی مک و تیمی که روی لینوکس کار میکند، خانهی یکسان، ربات یکسان و قوانین یکسان می‌بینند.
ویندوز · ۲٫۱٫۱ — 9.6 MB مک · ۲٫۱٫۱ — 0.7 MB لینوکس · ۲٫۱٫۱ — 0.7 MB
| کامپیوتر شما | فایل | داخلش چیست |
|---|---|---|
| ویندوز ۱۰ / ۱۱ | SmartHomeLeague-Windows.exe | یک برنامه. دوبار کلیک — نه نصب‌کننده‌ای در کار است نه پایتونی که باید نصب کنید |
| مک | SmartHomeLeague-Mac.zip | یک فایل .command به‌علاوه‌ی راهنما. پایتونی که لازم دارد، روی مک هست |
| لینوکس | SmartHomeLeague-Linux.zip | یک فایل .sh به‌علاوه‌ی راهنما. به python3 نیاز دارد که روی لینوکس دسکتاپ از قبل هست |
فایل مک و لینوکس کوچک‌اند چون بازی را فشرده داخل خودِ لانچر حمل میکنند؛ فایل ویندوز فقط به این دلیل بزرگ‌تر است که پایتون را هم با خودش می‌آورد. هیچ‌کدام از این سه تا چیزی نصب نمی‌کنند — بازی از داخل حافظه اجرا میشود و چیزی روی دیسک باقی نمی‌گذارد.
بعد از دانلود به اینترنت نیازی نیست. برنامه کاملاً روی کامپیوتر خودتان اجرا میشود، پس باشگاهی هم که اینترنت ضعیفی دارد میتواند تمرین کند و مسابقه بدهد.
۲. باز کردن — ویندوز، مک، لینوکس یا مرورگر
در مرورگر
- به
smarthomeleague.ir/gameبروید. نه چیزی نصب میشود، نه اجازه‌ای لازم است. - بار اول چند مگابایت دانلود میشود؛ بعد از آن صفحه فوری بالا می‌آید و کدتان در همین مرورگر می‌ماند (روی دستگاه خودتان ذخیره میشود، نه روی سرور ما).
- هر چه برنامه دارد این‌جا هم هست: سه رده، ویرایشگر، درسها، ابزارهای کمکی و ابزار داور. برای این‌که کد ذخیره‌شده‌تان را دوباره پیدا کنید، با همان مرورگر و همان کامپیوتر برگردید.
ویندوز
- روی
SmartHomeLeague-Windows.exeدوبار کلیک کنید. - اگر ویندوز پیام آبی Windows protected your PC را نشان داد، More info و سپس Run anyway را بزنید. این پیام برای هر برنامهی تازهای که هنوز هزاران نفر دانلودش نکردهاند نمایش داده میشود و هشدار درباره‌ی این فایل به‌طور خاص نیست.
- لیگ در پنجرهی خودش باز میشود. همین — نه نصب‌کننده‌ای در کار است و نه تنظیماتی.
مک
- فایل
SmartHomeLeague-Mac.zipرا باز کنید (دوبار کلیک). - داخلش فایل
Smart Home League (Mac).commandرا می‌بینید. رویش راستکلیک کنید و Open را بزنید، بعد در پنجره‌ای که می‌آید دوباره Open را بزنید. - مک فقط بار اول این را میپرسد. بعد از آن دوبار کلیک ساده کافی است.
اگر مک باز هم باز نکرد: ترمینال را باز کنید،
bash و یک فاصله بنویسید، بعد فایل
.command را داخل پنجرهی ترمینال بکشید و Enter بزنید.
لینوکس
- فایل
SmartHomeLeague-Linux.zipرا از حالت فشرده دربیاورید. - در ترمینال، داخل همان پوشه، اجرا کنید:
./'Smart Home League (Linux).sh' - اگر پیام permission denied داد، یعنی بیت اجرا در مسیر گم شده است: یا
chmod +x 'Smart Home League (Linux).sh'بزنید، یا از راه شل اجرایش کنید که هرگز به آن بیت نیاز ندارد:sh 'Smart Home League (Linux).sh' - اگر کروم، کرومیوم، اج، بریو یا ویوالدی نصب باشد، لیگ در پنجرهی خودش باز میشود؛ وگرنه در مرورگر پیش‌فرض. بستن ترمینال، بازی را می‌بندد و فایل‌های موقتش را پاک میکند.
تنها پیش‌نیاز، python3 است که عملاً روی هر لینوکس دسکتاپی از قبل
هست. اگر نبود: sudo apt install python3 (دبیان، اوبونتو، مینت)،
sudo dnf install python3 (فدورا) یا
sudo pacman -S python (آرچ، منجارو).
۳. انتخاب رده
برنامه با صفحه‌ی انتخاب رده باز میشود. رده‌ای را انتخاب کنید که با سن تیم شما می‌خواند — خانه، سنسورها و قوانین با آن عوض می‌شوند.
| رده | سن | تفاوتش چیست |
|---|---|---|
| فرستاستپ | تازه‌واردها | حس کن و واکنش نشان بده. سه سنسور فاصله و یک بامپر؛ امتیاز فقط بر پایه‌ی درصد نظافت است. |
| زیر ۱۴ سال | پرایمری | سنسور رنگ، قطب‌نما، شماره‌ی اتاق و درصد تمیزی هر اتاق اضافه میشود، به‌همراه ایستگاه‌های بوست. |
| زیر ۱۹ سال | سکندری | جی‌پی‌اس با goto(x, y) اضافه میشود، و باتری‌ای که تمام میشود و باید در ایستگاه شارژ شود. |
۴. اجرای اولین ربات
- حالت مسابقه را باز کنید.
- دکمه‌ی کد پایه را بزنید تا برنامهی شروع بارگذاری شود — خط به خط و دوزبانه توضیح داده شده است و از همان اول حرکت میکند و از دیوار فاصله می‌گیرد.
- شروع را بزنید. هر کاشی از کف که ربات از رویش رد شود رنگ تیم شما را می‌گیرد و امتیاز، درصدِ سطحی از خانه است که تا پایان زمان تمیز کرده‌اید.
- یک عدد را در کد عوض کنید، دوباره اجرا کنید و ببینید چه میشود. همین حلقه — تغییر بده، اجرا کن، نگاه کن — تمام مسابقه است.
ربات آماده است. هیچ تیمی سخت‌افزار نمی‌سازد. چیزی که شما می‌سازید مغزِ ربات است: برنامه‌ای به زبان پایتون که ده بار در ثانیه اجرا میشود و به چرخها فرمان میدهد.
۵. درسها، ابزارهای کمکی و کد پایه
- آموزش گام‌به‌گام داخل خود برنامه است — هفده درس، به فارسی و انگلیسی، از اولین
forward()تا خواندن سنسورها و نوشتن تابع‌های خودتان. - ابزارهای کمکی برای دانش‌آموزی که هنوز نمی‌تواند کد بنویسد، پایتونِ واقعی میسازند: یکی پرسش میکند، دیگری بلوکهای پازلی را روی هم می‌چیند. هر دو کدی تحویل میدهند که می‌توانید بخوانید و تغییرش دهید.
- کتابچه‌ی قوانین و جزوه‌های آموزشی فایل‌های پی‌دی‌اف جداگانهای هستند، برای هر رده یکی، به هر دو زبان — از بخش تیم بگیریدشان.
پیش از شرکت در مسابقه
- حساب تیم خود را بسازید در صفحه‌ی عضویت تا برگزارکننده تأییدتان کند و همهی فایل‌ها را یک‌جا در اختیار داشته باشید.
- کتابچه‌ی قوانین را بخوانید — امتیازدهی، جریمه‌ها و مصاحبه‌ی فنی همه در آن هست.
- معلم، مربی یا والدین؟ راهنمای مدارس و مربیان توضیح میدهد چطور لیگ را در کلاس یا باشگاه رباتیک برگزار کنید.
- سؤالی دارید؟ در کانال تلگرام یا دیسکورد لیگ بپرسید.
بازی جوانمردانه: کدی که ارائه می‌دهید باید کار خودتان باشد. کپی‌کردن کار تیم دیگر پذیرفته نیست و تصمیم برگزارکنندگان در این موارد قطعی است.
پرسش‌های پرتکرار
چه چیزی باید نصب کنیم؟
هیچ چیز. برنامه یک فایل است و همه چیز داخلش هست — خانه، ربات، پایتون، درسها و ابزارهای کمکی. فقط یک لپ‌تاپ ویندوز، مک یا لینوکس لازم دارید.
ویندوز میگوید این فایل را افراد کمی دانلود کردهاند.
این پیام برای هر برنامهی تازهای می‌آید. More info و سپس Run anyway را بزنید.
روی مک فایل باز نمیشود.
اول zip را باز کنید، بعد راستکلیک ← Open ← Open. مک فقط بار اول میپرسد.
اگر باز هم نشد، از ترمینال با bash و کشیدن فایل داخل پنجره
اجرایش کنید.
دانشآموزان با چه زبانی برنامه مینویسند؟
پایتون. برنامه ده بار در ثانیه اجرا میشود و به چرخها فرمان میدهد.
آیا باید ربات بسازیم؟
خیر. ربات در همهی ردهها آماده است؛ شما کد می‌نویسید و رنگ تیم را انتخاب می‌کنید.
اگر دانشآموز اصلاً برنامهنویسی بلد نباشد چه؟
فرستاستپ برای تازهواردهاست و ابزارهای کمکی داخل برنامه، پرسشوپاسخ یا بلوکهای پازلی را به پایتونِ واقعی تبدیل میکنند. بیشتر در راهنمای لیگ ربات جاروبرقی.