🇹🇷 Türkçe · 🇬🇧 English · 🇨🇳 中文

Cihaz Studio

Cihaz, çocukların ve öğrenmek isteyen herkesin yaparak öğrendiği açık kaynak bir öğrenme platformudur. Bir ürün değil, bir başlangıç noktası: ilk projesi bir el konsolu — ama aynı temelle isteyen programlamayı öğrenir, isteyen oyun yapar, isteyen MP3 çalar, isteyen kendi mini "işletim sistemini" kurar. Platformun dört parçası:

• Console — projelerini çalıştıran gerçek donanım (ESP32-S3 + renkli ekran + joystick/tuşlar)
• Studio — bu araç 👉 tarayıcıda çalışan, fikirlerini (JavaScript) anında deneme tahtası
• Chat — fikirlerini birlikte tasarlayıp kodladığın masaüstü asistanı
• Case — 3D baskı kasa + parametrik CAD (ayrı depo)

Studio, hiç donanım gerektirmeden fikrini tarayıcıda anında çalıştırır — programlamaya giriş kapısı burasıdır. Oyununu, deneyini, aracını burada dene; beğenince Console'a (C++) taşı. Tek dosya, kurulum yok, çevrimdışı çalışır.

---

Nasıl kullanılır?

1. cihaz-studio.html'i çift tıkla (herhangi bir tarayıcıda açılır — kurulum yok).
2. Kod sekmesine bir oyun yaz ya da Cihaz Sohbet'te ürettiğin kodu yapıştır.
   • İlk kez mi? 💡 Örnek butonuna bas, hazır bir oyun (Sektir) yüklensin.
3. ▶ ÇALIŞTIR → oyun soldaki sanal cihazın menüsüne eklenir. A ile oyna.

Kod sekmesi butonları

Buton	Ne yapar
▶ ÇALIŞTIR	Kodu çalıştırır, oyunu cihaz menüsüne ekler
💾 Kaydet	Oyunu tarayıcıya kaydeder (Oyunlarım sekmesi)
💡 Örnek	Hazır örnek oyunu editöre yükler
🧹 Temizle	Kod alanını tamamen boşaltır (onay ister)
🔍 Kontrol Et	Kodu gözden geçirir (uyarılar) + .js olarak indirir

Kontroller (klavye)

• Joystick → ok tuşları · bas → Boşluk
• A → A tuşu · B → D tuşu
• START → B · SELECT → N · HOME → M
• Ekrandaki tuşlara fareyle/dokunarak da basabilirsin.

---

İyi bilinmesi gereken (küçük davranış)

Oyun ekleyip sildikten sonra sayfayı yenile (F5). Her ÇALIŞTIR, oyunu sanal cihazın menüsüne ekler; bir oyunu silip menüden tamamen kaldırmak için sayfayı bir kez yenilemek gerekir. Kaydedilmiş oyunlarına (Oyunlarım) dokunmaz — onlar tarayıcı hafızasında güvende.

Kaydettiğin oyunları Oyunlarım sekmesinden istediğin an tekrar açabilirsin. 🎮

---

Cihaz Sohbet ile birlikte

Studio en güzel, Cihaz Sohbet ile birlikte çalışır: Sohbet'te "düşen kutuları yakala gibi bir oyun yap" dersin, gelen kodu 📋 kopyala, Studio'ya yapıştır, ÇALIŞTIR. Beğenince Konsol'a taşıyıp gerçek cihazında oynarsın.

Kendi cihazına göre uyarladıysan, Studio'yu da uyarlat

Cihazında donanımla ilgili bir değişiklik yaptıysan — ikinci bir joystick eklediysen, klavye bağladıysan, fazladan tuş koyduysan, ekranı büyüttüysen, fark etmez — bunu doğrudan Cihaz Sohbet'e anlat: "ikinci bir joystick ekledim, X ekseni GPIO 5'te" gibi bir cümle yeterli. Sohbet, hem Konsol (C++) tarafını hem de bu Studio'yu senin elindeki donanıma göre güncellemene yardım eder.

Studio tek bir düz HTML/JavaScript dosyası (cihaz-studio.html) — kontroller (klavye eşleşmeleri, sanal cihazın görünümü) dosyanın içinde. Sohbet'in söylediği değişikliği bu dosyaya sen uygularsın (ya da Sohbet'ten doğrudan güncellenmiş kod bloğu iste, yapıştır). Bir kere kendi donanımına göre ayarladıktan sonra kontrol tamamen sende — dosya tek parça, sunucu yok, istediğin gibi değiştir. Gerisi ihtiyacına göre sana kalmış. 🎮

---

Dosya yapısı

Cihaz-Studio/
├── cihaz-studio.html   # Studio'nun tamamı (tek dosya, çevrimdışı)
├── README.md
└── LICENSE

Oyunların ve ayarların tarayıcının yerel hafızasında (localStorage) durur — depoya girmez, başka bir yere gitmez.

---

Lisans

MIT — dilediğin gibi kullan, değiştir, dağıt, sat; sadece telif satırını koru. İstersen tamamen değiştir, istersen sil, istersen bambaşka bir şeye dönüştür — özgürsün. 🌱

Cihaz Studio, Cihaz öğrenme platformunun parçasıdır — Console, Chat ve Case ayrı depolardadır.