🔌 1. OBS WebSocket v5 Bağlantı Kılavuzu
CueDeck, OBS Studio sürüm 28 ve üstünde yerleşik gelen OBS WebSocket v5 sunucusunu kullanır. Ek bir eklenti veya masaüstü sunucu programı kurmanıza gerek yoktur.
- Bilgisayarınızda OBS Studio uygulamasını açın.
- Üst menüden Araçlar (Tools) -> WebSocket Sunucusu Ayarları (WebSocket Server Settings) seçeneğine tıklayın.
- "WebSocket Sunucusunu Etkinleştir" (Enable WebSocket server) kutucuğunu işaretleyin.
- Sunucu Portu varsayılan olarak 4455 olmalıdır.
- İsteğe bağlı olarak "Kimlik Doğrulamayı Etkinleştir" (Enable Authentication) seçeneğini açıp bir şifre belirleyebilirsiniz.
- Penceredeki "Show Connect Info" (Bağlantı Bilgilerini Göster) butonuna tıklayın.
- Ekrana gelen QR kodunu CueDeck mobil uygulamasındaki vizör ile okutun.
🛡️ 2. Windows Güvenlik Duvarı (Firewall) ve Ağ İzinleri
Telefonunuz OBS'e bağlanamıyorsa veya "Bağlantı Zaman Aşımına Uğradı" uyarısı alıyorsanız, en yaygın neden Windows Güvenlik Duvarı'nın port 4455'i engellemesidir.
Windows Güvenlik Duvarı Çözümü:
- Windows Arama çubuğuna
Windows Defender Güvenlik Duvarıyazın ve açın. - Sol taraftaki "Bir uygulamanın veya özelliğin Windows Defender Güvenlik Duvarını geçmesine izin ver" bağlantısına tıklayın.
- Listede OBS Studio'yu bulun. Hem Özel (Private) hem de Ortak (Public) kutucuklarının işaretli olduğundan emin olun.
- Ayrıca ağ bağlantınızın (Wi-Fi) Windows ayarlarında "Ortak Ağ" yerine "Özel Ağ" (Private Network) olarak seçildiğinden emin olun.
📱 3. Apple iOS "Yerel Ağ" (Local Network) İzni Sorunu
iOS 14 ve sonraki sürümlerde Apple, uygulamaların yerel ağınızdaki cihazlara bağlanması için açık onay gerektirir.
iPhone'unuzda Ayarlar -> Gizlilik ve Güvenlik -> Yerel Ağ (Local Network) yolunu izleyin. Listede CueDeck'in yanındaki anahtarın açık (yeşil) olduğundan emin olun. Bu izin kapalıysa telefonunuz bilgisayarınızdaki OBS sunucusunu göremez.
⚠️ 4. Sık Karşılaşılan Hata Kodları
Hata: "WebSocket Connection Failed (1006 / Timeout)"
Neden: Telefonunuz OBS'in çalıştığı IP ve porta ulaşamıyor.
Çözüm: Telefon ve PC'nin aynı Wi-Fi ağına bağlı olduğunu kontrol edin. OBS'te WebSocket sunucusunun açık olduğunu ve Windows Güvenlik Duvarı'nın izin verdiğini doğrulayın.
Hata: "Authentication Failed (4009 / Invalid Password)"
Neden: OBS WebSocket şifresi yanlış girildi.
Çözüm: OBS içindeki "Show Connect Info" ekranındaki şifreyi kontrol edin veya QR kodunu CueDeck ile tekrar tarayın.
Hata: "Program Monitörü Siyah Ekran Gösteriyor"
Neden: OBS Studio'da aktif sahnede herhangi bir video kaynağı bulunmuyor veya OBS sanal kamerası/ekran yakalaması arka planda donmuş.
Çözüm: OBS'te bir sahneye ekran yakalama veya kamera kaynağı ekleyin. CueDeck saniyeler içinde önizleme karesini yenileyecektir.
💬 5. Bize Ulaşın / Doğrudan Destek
Sorununuz çözülmediyse veya yeni bir özellik öneriniz varsa geliştirici ekibimizle doğrudan iletişime geçebilirsiniz:
- Destek E-Postası: dev@onuraksoy.com.tr (Maksimum 24 saat içinde yanıtlanır)
- GitHub Issue Tracker: Hata Bildirimi veya İstek Açın