Dosyalara Geri Dön
Dosyalarım CanlıHalay — TikTok LIVE etkileşimli sahne
zip
zip

CanlıHalay — TikTok LIVE etkileşimli sahne

177.5 KB 0 kez indirildi Mehmet Sancak 15.11.2026

Dosya Açıklaması

CanlıHalay — TikTok LIVE etkileşimli sahne

TikTok canlı yayınındaki izleyicileri halay, horon, zeybek ve daha fazlasını oynayan karakterlere dönüştüren, OBS uyumlu etkileşimli bir sahne.

Yorum yazan izleyici halkaya katılır ve mesajı karakterinin üstünde balon olarak çıkar. Hediyeler sahnede gerçek etkiler yaratır: havai fişek, para yağmuru, gelin-damat, şans çarkı… Beğeniler müziğin temposunu yükseltir.

Özellikler

Sahneler (7): Halay, Horon, Ankara Havası, Düğün, Kına Gecesi, Zeybek, Kulüp/DJ. Her birinin kendi arka planı, yöresel kıyafetleri, dans figürleri ve müziği var.

İzleyici etkileşimi

  • Yorum = karakter: yorum yazan halkaya katılır, mesajı konuşma balonu olur
  • kız / erkek yazınca kıyafet değişir
  • Ücretsiz sohbet hareketleri: hop zıplatır, selam el sallatır, ❤️ kalp çıkarır
  • Hoş geldin animasyonu, en çok hediye atanlar tablosu
  • 120 kişiye kadar iç içe iki halkada dans

Hediye → eylem sistemi (yayına özel, arayüzden düzenlenir)

  • 15 eylem: Tempoyu artır, Para yağdır, Gelin, Damat, Havai fişek, Konfeti, Sıkıştır, Mendil salla, Başa geç, Kıyafet yükselt (3 seviye), Davulcu/Zurnacı/Kemençeci ol, Hoppa, Şans çarkı
  • Sahnenin üstünde hangi hediyenin ne yaptığını gösteren kayan şerit
  • Her eylem için "Dene" düğmesi

Görsel şölen

  • Hediye büyüklüğüne göre kademeli şov: ışık patlaması, uçan yazılar, roketli havai fişek, ekran sarsıntısı; 1000+ elmasta MEGA şov
  • TikTok tarzı canlı sayan hediye bantları, kombo patlamaları (x10, x25, x50…)
  • Beğeni hedefi: her X beğenide bütün halka coşar

Oyunlar

  • 🎡 Şans çarkı: ödüller sahneye etki eder, yayıncı görevleri yazılabilir
  • 🔴🔵 Takım yarışı: izleyiciler 1 / 2 yazarak takım seçer, hediyeler ve beğeniler puan, süreli turlar

Ses ve müzik

  • Kodla üretilen telifsiz müzik (davul, zurna, kemençe, darbuka, bağlama, elektronik); tempo sahne enerjisine uyar
  • Hediye ses efektleri
  • İsteğe bağlı: sahne başına kendi müzik dosyanı yükle

Yayıncı araçları

  • 📱 Telefondan kumanda (QR kodla): sahne değiştir, efekt tetikle, çarkı çevir, ekrana yazı yaz, ses ve oran ayarla
  • OBS yayın modu (H tuşu veya ?clean), 16:9 ve 9:16 (dik yayın) desteği
  • Ayarlar şifreyle korunur
  • 🧪 Demo modu: canlı yayın açmadan sahte izleyicilerle test

Kurulum

Gereksinim: Node.js 20+

npm install
cp .env.example .env
npm run dev

Tarayıcıda http://localhost:3000 adresini aç. Denemek için Demoyu izle'ye bas.

Yayında kullanırken üretim modunda çalıştır:

npm run build
npm start

Ortam değişkenleri (.env)

DeğişkenAçıklama
TIKTOK_SIGN_API_KEYEuler Stream ücretsiz API anahtarı. TikTok bağlantısı için gereken imza servisinin limitlerini yükseltir. Önerilir.
SETTINGS_PASSWORDAyarları kaydetmek ve kumandayı kullanmak için şifre. İnternete açık kurulumda mutlaka ayarla.

OBS'e ekleme

  1. OBS'te Kaynak ekle → Tarayıcı seç.
  2. Adres: http://localhost:3000/live/KULLANICI_ADI/halay?clean
    • Dik yayın için sonuna &oran=9:16 ekle.
  3. Genişlik/yükseklik: 1920×1080 (dik yayında 1080×1920).
  4. Sesin yayına gitmesi için "Sesi OBS üzerinden kontrol et" kutusunu işaretle.

Telefondan kumanda

Yayın ekranındaki 📱 düğmesine bas, çıkan QR kodu telefonla okut. Telefon bilgisayarla aynı Wi-Fi ağında olmalı. Açılmazsa Windows güvenlik duvarında Node.js'e "Özel ağ" izni ver.

Teknik notlar

  • Next.js 16, React 19, TypeScript, Tailwind CSS 4
  • TikTok bağlantısı TikTok-Live-Connector ile yapılır. Aynı kullanıcı adı için bütün sekmeler ve OBS tek bir TikTok bağlantısını paylaşır; böylece imza servisi limiti boşa harcanmaz.
  • Uzun süreli bağlantı (SSE) kullandığı için kendi bilgisayarında, bir VPS'te ya da Railway/Render gibi bir sunucuda çalıştırılması önerilir. Sunucusuz platformlar bağlantı süresini sınırlar.
  • Ayarlar ve yüklenen müzikler data/ klasöründe saklanır.

Uyarı

Bu proje TikTok ile bağlantılı değildir; resmi olmayan bir API kullanır.

Tıkladığınızda 10 saniyelik güvenli bağlantı geri sayımı başlayacaktır.