Yerleşik komutlar, otomasyon ve API entegrasyonuyla Social Stream Ninja'yı kontrol edin
Social Stream Ninja, izleyicilerinizin sohbette kullanabileceği veya sizin API üzerinden tetikleyebileceğiniz çeşitli yerleşik komutlar içerir.
| Komut | Açıklama | Nasıl etkinleştirilir? |
|---|---|---|
!joke |
Yanıt olarak rastgele, teknoloji meraklılarına yönelik bir baba şakası anlatır | Uzantı menüsündeki anahtarla etkinleştirin |
hi |
Sohbette “hi” diyen herkesi otomatik olarak karşılar | Uzantı menüsündeki anahtarla etkinleştirin |
!cycle |
Etkinleştirildiğinde izleyicilerin OBS sahnelerini değiştirmesine izin verir | Uzantı menüsündeki anahtarla etkinleştirin |
Not: Bot komutları yalnızca otomatik yanıtlayıcı doğru yapılandırıldığında ve ilgili platformlarda mesaj gönderme izniniz olduğunda çalışır.
Otomatik yanıtlayıcının doğru çalışması için:
Otomatik yanıtlar tetiklendiğinde mavi bir hata ayıklama çubuğu görüyorsanız Chrome'u şu seçenekle başlatarak gizleyebilirsiniz: --silent-debugger-extension-api .
Social Stream Ninja, yayın kurulumunuzun her yönünü programlı olarak kontrol etmenizi sağlayan güçlü bir API sunar. API sunucusu hem kurulumunuza komut gönderebilir hem de birleştirilmiş sohbet hizmetlerinden gelen mesajları dinleyebilir.
Öne çıkan mesajları kontrol edin, katmanları temizleyin ve yayınınızdaki içeriğin görünümünü değiştirin.
Stripe, Ko-Fi ve Buy Me A Coffee gibi üçüncü taraf hizmetlerden etkinlikler alın.
Özel entegrasyonlar için sohbet mesajlarını dosyaya aktarın veya webhook (POST) üzerinden iletin.
Gerekli ayarlar (Genel ayarlar → Mekanikler):
Bkz. tam API belgeleri ayrıntılı kurulum kılavuzları ve kod örnekleri için.
https://io.socialstream.ninja/{sessionID}/{action}/{target}/{value}
Stream Deck veya özel betiklerden gönderilen basit komutlar için idealdir.
wss://io.socialstream.ninja:443
Otomatik yeniden bağlanmalı, gerçek zamanlı çift yönlü iletişim için.
WebSocket modunu etkinleştirmeden bağlantıları eşler arası tutmayı tercih ederseniz Social Stream Ninja WebRTC SDK'sını kullanabilirsiniz. Şu gibi Node ve tarayıcı örnekleri içerir: Social Stream Ninja dinleyicisi.
https://io.socialstream.ninja/sse/{sessionID}
Sunucudan tek yönlü gerçek zamanlı güncellemeler için.
API, mesaj yönlendirme için bir kanal sistemi kullanır:
- Channel 1: Remote control commands (default for StreamDeck/Bitfocus) - Channel 2: Dock page output - Channel 3: Extension receives commands from Dock - Channel 4: Chat messages from Extension (use this to receive Twitch/YouTube chat!) - Channel 5: Waitlist/giveaway communication - Channels 6-9: Reserved for future use
İstediğiniz kanalla bağlanın:
// To receive chat messages (listen on channel 4): wss://io.socialstream.ninja/join/SESSION_ID/4 // To send commands (channel 1 default): wss://io.socialstream.ninja/join/SESSION_ID
| İşlem | Açıklama | Örnek |
|---|---|---|
sendChat |
Bağlı tüm sohbet platformlarına mesaj gönderir | https://io.socialstream.ninja/SESSIONID/sendChat/null/Hello everyone! |
sendEncodedChat |
URL kodlamalı bir mesajı tüm platformlara gönderir | https://io.socialstream.ninja/SESSIONID/sendEncodedChat/null/Hello%20everyone%21 |
clearOverlay |
Öne çıkan mesajı katmandan temizler | https://io.socialstream.ninja/SESSIONID/clearOverlay |
nextInQueue |
Kuyruktaki sonraki mesajı gösterir | https://io.socialstream.ninja/SESSIONID/nextInQueue |
autoShow |
Mesajların otomatik öne çıkarılmasını açar/kapatır | https://io.socialstream.ninja/SESSIONID/autoShow/toggle |
blockUser |
Belirli bir platformdaki bir kullanıcıyı engeller | https://io.socialstream.ninja/SESSIONID/blockUser/null/{"chatname":"username","type":"twitch"} |
extContent |
Harici içeriği sohbet mesajı olarak gönderir | https://io.socialstream.ninja/SESSIONID/extContent/null/{"chatname":"User","chatmessage":"Hello"} |
pin |
Mevcut bir panel mesajını mesaj kimliğiyle veya tam bir mesaj nesnesini sabitler. Şunu gerektirir: dock.html aynı oturumda açık olmalıdır. |
https://io.socialstream.ninja/SESSIONID/pin/null/MESSAGE_MID |
unpin |
Mevcut bir panel mesajının sabitlemesini mesaj kimliğiyle kaldırır. Etiketli bir panel için hedef alanını veya yol bölümünü kullanın. | https://io.socialstream.ninja/SESSIONID/unpin/null/MESSAGE_MID |
nextPinned |
Paneldeki ilk sabitlenmiş mesajı öne çıkarır. | https://io.socialstream.ninja/SESSIONID/nextPinned |
removefromwaitlist |
İlk etkin bekleme listesi kaydını veya şu alandaki numaralı etkin kaydı kaldırır: value |
https://io.socialstream.ninja/SESSIONID/removefromwaitlist/null/1 |
highlightwaitlist |
İlk etkin bekleme listesi kaydını veya şu alanda belirtilen numaralı etkin kaydı öne çıkarır: value |
https://io.socialstream.ninja/SESSIONID/highlightwaitlist/null/1 |
stopentries / startentries |
Mevcut listeyi temizlemeden yeni bekleme listesi kayıtlarını durdurur veya devam ettirir. openentries ve resumeentries şunun diğer adlarıdır: startentries. |
https://io.socialstream.ninja/SESSIONID/stopentries |
selectwinner |
Bekleme listesinden veya çekilişten rastgele bir ya da daha fazla kazanan seçer | https://io.socialstream.ninja/SESSIONID/selectwinner/null/1 |
downloadwaitlist |
Mevcut bekleme listesini çalışan Social Stream sayfasından veya uygulamasından TSV dosyası olarak indirir | https://io.socialstream.ninja/SESSIONID/downloadwaitlist |
drawmode |
Çekiliş modunu açar/kapatır veya şu durumda değiştirir: value eşittir toggle |
https://io.socialstream.ninja/SESSIONID/drawmode/null/toggle |
waitlistmessage |
Bekleme listesi sayfasında gösterilen bekleme listesi veya çekiliş başlık mesajını ayarlar | https://io.socialstream.ninja/SESSIONID/waitlistmessage/null/Type%20!join%20to%20enter |
resetwaitlist |
Bekleme listesini temizler ve katılımı yeniden açar | https://io.socialstream.ninja/SESSIONID/resetwaitlist |
Tüm komutlara ve özelliklere kolay erişim sağlayan etkileşimli deneme alanımızda API'yi deneyin:
OBS'de daha az sayıda canlı yayın düğmesi için şunu kullanın: Social Stream kontrol paneli ve şu kılavuzu izleyin: OBS kurulum kılavuzu.
Tüm API komutlarını güvenli bir ortamda deneyin
HTTP, WebSocket ve SSE için kod örnekleri alın
Komutlarınızın yanıtlarını gerçek zamanlı görün
Rastgele içerikli test mesajları oluşturun
Not: Şunu değiştirmeyi unutmayın: SESSIONID Social Stream Ninja'daki gerçek oturum kimliğinizle!
Social Stream Ninja, StreamDeck ile birden fazla yöntemle entegre olur: yerel HTTP işlemleri ve Bitfocus Companion entegrasyonu.
API'ye doğrudan komut göndermek için StreamDeck'in “Website” işlemini “GET request in background” etkin olacak şekilde kullanın.
Hazır işlemler, gerçek zamanlı geri bildirim ve dinamik içerik değişkenleriyle yerel entegrasyon.
Bitfocus Companion, WebSocket veya HTTP API'lerini kullanarak Social Stream Ninja üzerinde güçlü kontrol sağlar.
| İşlem | Açıklama | API yöntemi |
|---|---|---|
| Öne çıkan mesajı temizle | Şu anda öne çıkarılan mesajı katmandan kaldırır | WebSocket/HTTP |
| Kuyruktaki sonraki | Sıradaki mesajı gösterir | WebSocket/HTTP |
| Otomatik gösterimi aç/kapat | Mesajların otomatik öne çıkarılmasını açar/kapatır | WebSocket/HTTP |
| Sohbet mesajı gönder | Bağlı tüm platformlara mesaj gönderir | WebSocket/HTTP |
featured_message - Şu anda öne çıkarılan mesajın metnifeatured_username - Şu anda öne çıkarılan kullanıcı adıqueue_size - Kuyruktaki mesaj sayısıSocial Stream Ninja, yayınlarınızı yapay zekâ destekli sohbet yanıtları, moderasyon ve daha fazlasıyla geliştirmek için kapsamlı yapay zekâ entegrasyonu sunar. İhtiyacınıza uygun yerel veya bulut tabanlı yapay zekâ sağlayıcılarından seçim yapın.
Siz içeriğinize odaklanırken bile yapay zekânın izleyicilerinizle otomatik olarak etkileşime girmesine, soruları yanıtlamasına ve sohbeti canlı tutmasına izin verin.
Potansiyel olarak zararlı mesajları belirleyip tercihlerinize göre otomatik işleyerek sohbet moderasyonuna yardımcı olması için yapay zekâ kullanın. Engellemeyen mod ile sıkı engelleme modu arasından seçim yapın.
Bilgi getirmeyle desteklenen üretim (RAG), içeriğinize özel doğru yanıtlar sunmak için yapay zekânın özel bilgi tabanınızda arama yapmasını sağlar.
Farklı amaçlar için farklı bot örnekleri çalıştırın: herkese açık sohbet botu, özel bire bir bot, sansür botu ve hatta görüp duyabilen çok kipli bir yapay zekâ yardımcı sunucusu.
Social Stream Ninja, tamamen yerel tarayıcı/çalışma ortamı modellerinden barındırılan API'lere kadar birden fazla yapay zekâ sağlayıcısını destekler:
Ollama'nın kendi API'si üzerinden bilgisayarınızda çalışan ücretsiz, gizlilik odaklı, kendi barındırdığınız yapay zekâ modelleri.
Model dosyalarını kendi dosya sunucunuza yansıttıktan sonra Gemma 4'ü tarayıcıda çalıştırın; SSN largefiles sunucusu şu anda Gemma dosyalarını içermez.
Yerel ve özel yanıtlar için Qwen 3.5'i kendi barındırdığınız model dosyalarından tarayıcıda çalıştırın.
Modern sohbet ve gerçek zamanlı ses modellerini içeren OpenAI API'leri.
Güncel Gemini 2.5 metin ve canlı çok kipli seçenekleri dahil Google Gemini modelleri.
Konuşma görevleri için optimize edilmiş verimli ve uygun maliyetli yapay zekâ modelleri.
Geçici istemci sırları kullanıldığında gerçek zamanlı ses oturumları da dahil xAI Grok API'leri.
Claude ve Llama dahil çeşitli sağlayıcılardan kurumsal düzeyde yapay zekâ modelleri.
Tek bir API arayüzü üzerinden birden fazla yapay zekâ modeline erişim.
Hızlı sohbet yanıtları için düşük gecikmeli, OpenAI uyumlu sohbet çıkarımı.
llama.cpp, LM Studio, vLLM veya başka bir OpenAI uyumlu uç noktaya bağlanın.
Not: Ollama kendi yerel API'sini kullanır. llama.cpp, LM Studio, vLLM veya diğer OpenAI uyumlu sunucular için şunu seçin: Özel API.
Social Stream Ninja, bot mesajları ve öne çıkan sohbet içeriği için kapsamlı TTS desteği içerir:
İşletim sisteminizin ses sentezleyicisini kullanan ücretsiz, yerleşik TTS.
Gizliliğe önem veren kullanıcılar için WebGPU/CPU ile yerel çalışan ücretsiz TTS.
Yerel ses üretimi için küçük bir model indiren hafif, tarayıcı tabanlı TTS.
Doğal duyulan, özelleştirilebilir seslerle ücretli konuşma sentezi.
Kapsamlı dil ve özelleştirme seçenekleri sunan yüksek kaliteli sesler.
Seçilebilir ses ve dil seçenekleri sunan Google önizleme nöral ses modelleri.
Doğal ses dönüştürme yetenekleri sunan yapay zekâ destekli metinden konuşma.
Seçilebilir sesler, modeller ve isteğe bağlı uyumlu uç noktalarla OpenAI konuşma sentezi.
Not: TTS işlevi için ilgili katman sayfasının OBS'de açık olması gerekir. Her TTS sağlayıcısının ses seçenekleri, gecikmesi ve fiyatlandırma veya donanım gereksinimleri farklıdır.
Social Stream Ninja, farklı kullanım senaryoları için birden fazla bot örneği sunar:
| Bot türü | URL | Açıklama |
|---|---|---|
| Ana Sohbet Botu | /bot.html |
İsteğe bağlı TTS ve herkese açık sohbet yanıtları sunan ana bot katmanı |
| Özel Sohbet Arayüzü | /chatbot.html |
Ana botun RAG veri kümesini veya sohbet geçmişini paylaşmayan, ayrı bir bire bir bot sayfası |
| Sansür Botu | (arka planda çalışır) | Gelen mesajları otomatik olarak filtreler, temizler veya engeller |
| Yapay zekâ yardımcı sunucusu | /cohost.html |
Ekranınızı görebilen, sesi duyabilen ve etkileşime girebilen çok kipli yapay zekâ |
Mevcut menüyle yapay zekâ entegrasyonunu kurmak için şu adımları izleyin:
Sağlayıcınızı şu bölümde seçin: LLM hizmet sağlayıcısını yapılandır ve ilgili alanları doldurun:
Yerleşik düğmeyi kullanın: Seçili sohbet botunu test et . Canlı yayından önce sağlayıcınızı, modelinizi ve kimlik bilgilerinizi doğrulayın.
Botun sohbetteki davranışını özelleştirin:
Botla birlikte kullanmak istediğiniz özellikleri açın:
/bot.html; kullanın: clearBotOverlay elle temizleme için/bot.html, /chatbot.html, veya /cohost.html gerektiği şekilde OBS'de veya bir tarayıcıdaEksiksiz kurulum yönergeleri ve TTS hakkında daha ayrıntılı bilgi için bu kılavuzları kullanın:
MIDI kontrolcüleri, klavye kısayolları veya MIDI eklentili StreamDeck kullanarak Social Stream Ninja'yı kontrol edin.
| CC numarası | Değer | İşlem | Notlar |
|---|---|---|---|
| 102 | 1 | Sohbete “1” gönder | Hızlı tepki |
| 102 | 2 | Sohbete “LUL” gönder | İfade tepkisi |
| 102 | 3 | Şaka anlat | Bot yanıtını tetikler |
| 102 | 4 | Katmanı temizle | Öne çıkan mesajı kaldırır |
İpucu: MIDI kontrolü en iyi fiziksel kontrolcülerle çalışır, ancak sanal MIDI aygıtlarıyla da tetiklenebilir.
Yaygın işlevlere hızlı erişmek için klavye kısayollarını kullanın.
Kısayol tuşları menü ayarlarından yapılandırılabilir; tarayıcı odaktayken veya uygulama kullanılırken sistem genelinde çalışır.
Social Stream Ninja, webhook'lar üzerinden üçüncü taraf hizmetlerden bağışlar ve etkinlikler alabilir; popüler olanlardan bazıları aşağıdadır:
Kredi kartıyla yapılan bağışları doğrudan Stripe hesabınız üzerinden işleyin.
https://io.socialstream.ninja/SESSIONID/stripecheckout.session.completed&server panel URL'nizeDestekçilerinizden kahve bağışları alın.
https://io.socialstream.ninja/SESSIONID/kofi webhook URL'si olarak&server panel URL'nizePopüler Buy Me A Coffee platformu üzerinden bağış toplayın.
https://io.socialstream.ninja/SESSIONID/bmac webhook URL'si olarak&server etkinlikleri almak için panel URL'nizeGüvenlik notu: Oturum kimliğinizi gizli tutun; bu kimliğe sahip herkes katmanınıza sahte bağışlar gönderebilir. Webhook URL'si hassas bilgi olarak ele alınmalıdır.
Social Stream Ninja, üçüncü taraf hizmetlere de veri gönderebilir:
| Hizmet | URL parametresi | Açıklama |
|---|---|---|
| Singular Live | &singular=IDENTIFIER |
Öne çıkan mesaj katmanı için seçili mesajları Singular Live'a gönderir |
| H2R | &h2r=IDENTIFIER |
Seçili mesajları yerel bir H2R sunucusuna gönderir |
| Genel POST | &postserver=URL |
Seçili mesajları POST ile özel bir uç noktaya gönderir |
| Genel PUT | &putserver=URL |
Seçili mesajları PUT ile özel bir uç noktaya gönderir |
Bu parametreler panel sayfasının URL'sine eklenmelidir.
JavaScript kodunu özelleştirerek kendi komutlarınızı ve işlevlerinizi oluşturabilirsiniz:
custom_sample.js yeni dosya adı olarak şunu kullanın: custom.jsBu yöntem karmaşık özelleştirmelere ve tetikleyicilere olanak tanır.
Yayınınızın kendine özgü tarzına ve işlevine uygun, tamamen özel sohbet katmanlarını sıfırdan oluşturabilirsiniz. Social Stream Ninja üzerine geliştirme yapabileceğiniz esnek bir temel sunar.
timer.htmlZamanlayıcı sayfasının kapsamı bilerek dardır: tek zamanlayıcı, isteğe bağlı operatör kontrolleri, uyarı durumları, süre aşımı ve birkaç görsel stil.
Yararlı işlemler şunlardır: starttimer, pausetimer, resettimer, timeradd, timersubtract, ve settimer.
{
"action": "settimer",
"value": {
"seconds": 300,
"label": "Interview",
"mode": "countdown",
"style": "stage",
"warnSeconds": 60,
"dangerSeconds": 15
}
}
Mevcut zamanlayıcı durumunu sorgulamak için şunu kullanın: gettimerstate bir geri çağrı tokeniyle.
{ "action": "gettimerstate", "get": "timer-state-1" }
Sayfayı şu seçenekle kullanın: timer.html?session=YOUR_SESSION&server doğrudan API sunucusuyla kontrol edilmesini istiyorsanız.
startgiveaway, closegiveaway, drawgiveaway, resetgiveaway, ve getgiveawaystate aynı API/Stream Deck kontrollerini kullanarak özel çekiliş havuzunu yönetir. Çekiliş, katılımı otomatik olarak kapatır. Yeni tur, önceki kazanan geçmişini korur ve ödenmemiş rezervasyonları reddeder. İptal et ve iade et, bekleyen bilet ödemelerini geri verir. Ücretli biletler, Sayı Avı, Yazı Tura Havuzu ve Etkinlik Akışı aynı yayıncı hizmetini kullanır. Kurulum, sunumlar, komut değerleri ve kurtarma.
Bu güçlü komutlar ve API seçenekleriyle benzersiz ve etkileşimli bir yayın deneyimi oluşturabilirsiniz.