Tek düğme, kendi iş akışınız

Çağrılabilen bir iş akışı oluşturun

1. Adlandırılmış tetikleyiciStream Deck / API
2. Koşullar ve eylemlerKayıtlı Etkinlik Akışınız
3. HedefFlow Actions, OBS veya başka bir entegrasyon

1. Açın: Etkinlik Akışı SSN'den. Ayrı bir akış oluşturun veya şu şablonu seçin: Stream Deck / API düğmesi .
2. Ekleyin: Stream Deck / API'den çalıştır şu bölümde: Stream Deck ve API tetikleyici grubu.
3. Şu adı verin: intermission. Adlar tam eşleşir ve büyük/küçük harfe duyarlıdır; kısa, açıklayıcı bir ad kullanın.
4. Çıkışını şuna bağlayın: Metin Göster. Metni şu değere ayarlayın: Back in five minutes ve istenen süreyi ve katmanı seçin.
5. Akışı kaydedin, ardından etkinleştirin. Kaydedilmemiş akış yalnızca düzenleyicide bulunur; devre dışı akış çağrılamaz. Başlangıç şablonu, kurulumu bitirene kadar bilinçli olarak devre dışıdır.
6. Şunu açın: Flow Actions katmanı SSN'nin oluşturduğu bağlantıyı kullanarak. İzleyicileriniz için bu URL'yi OBS Tarayıcı Kaynağı olarak ekleyin. Düzenleyicinin kendisi katman değildir.

Bu adlandırılmış tetikleyicisi olmayan akışlar iş akışı API'si üzerinden çağrılamaz. İş akışı çağırmak panele sahte sohbet eklemez. Mevcut OBS etkinlikleri ve normal sohbet mevcut tetikleyicilerini kullanmaya devam eder.

Akış, mantık düğümleriyle adlandırılmış tetikleyicisini filtrelerle birleştirebilir. İlgisiz otomasyonları ayrı akışlarda tutun: seçilen akıştaki tüm tetikleyici/mantık dalları API etkinliğiyle değerlendirilir. Tekrarlanan basışlar ayrı çalıştırmalar başlatır; bir Hız Sınırlayıcı durum düğümünü tetikleyiciden sonra koyun; bekleme süresi istiyorsanız.

Bir Stream Deck tuşu bağlayın

1. Eklentinin şu ayarını yapılandırın: Kurulum eylemini SSN oturumunuz ve isteğe bağlı parolayla. Şunu kullanın: Bağlantıyı Test Et.
2. Sürükleyin: Ön Ayarlı Komut bir tuşun üzerine.
3. Seçin: Etkinlik Akışı iş akışları → İş akışını çalıştır.
4. Seçin: İş akışlarını yenile, ardından kayıtlı akışınızı ve tetikleyicinizi seçin. Tuş, tetikleyici adının yanı sıra akış kimliğini de saklar.
5. Bir kez basın ve Flow Actions katmanını izleyin. Tuşun onay işareti, SSN'nin çalıştırmayı kabul ettiği anlamına gelir.

İş akışı seçicisi eksik seçimleri korur. Akışı yeniden adlandırdıktan, devre dışı bıraktıktan, sildikten veya içe aktardıktan sonra yenileyip yeniden seçin. Yeni akış olarak içe aktarılan iş akışının kimliği farklıdır. Bunun yerine birkaç akışı ada göre hedeflemek için Değer alanını kullanın.

Özel Komut: Eylem'i şu değere ayarlayın: triggerWorkflow, Hedef'i boş bırakın ve şunu girin: {"trigger":"intermission"} Değer olarak ve şunu etkinleştirin: Yanıtı bekle. Ön ayar, rehberli seçim ve yetenek filtreleme sunar.

Çoklu Eylemler: her iş akışı isteği kabulü hızlıca onaylar. Sonraki Stream Deck adımı gecikmeli iş akışı eylemleri bitmeden başlayabilir. Sıra önemliyse sıralamayı ve gecikmeleri Etkinlik Akışı'nın içine koyun.

Özel değerler geçirin

Tuşun Değer alanında veya API isteğinizde:

{
  "trigger": "intermission",
  "flowId": "YOUR_SAVED_FLOW_ID",
  "data": { "name": "Back in five minutes", "minutes": 5 }
}

Metin Göster'i şu değere ayarlayın: {meta.workflow.data.name}. Özelliği Karşılaştır şunu okuyabilir: meta.workflow.data.minutes. Veri, isteğe bağlı bir JSON nesnesidir; şurada kalır: meta.workflow.data ve etkinliğin kimliğini değiştiremez veya sohbet ayrıcalığı veremez.

Şunu atlayın: flowId tam olarak bu tetikleyici adına sahip tüm etkin akışları çağırmak için. Aynı akıştaki birden fazla eşleşen tetikleyici düğümü yine o akışı yalnızca bir kez değerlendirir. Yalnızca tek akışı çalıştırmak için seçiciden veya keşif yanıtından kimliğini koruyun.

Seçilen akışta kullanılan etkinlik şu alanları içerir: type: "api", event: "workflow_trigger", chatname: "Stream Deck / API", boş bir chatmessage ve yukarıdaki verileri. Bu alanları kopyalayan normal sohbet, adlandırılmış API tetikleyicisini etkinleştiremez.

API örnekleri

SSN'yi etkin ve çalışır durumda tutun. Bunlar Social Stream uzaktan kontrol çağrılarıdır; SSApp'in ayrı yerel yapay zekâ/MCP API'sini kullanmazlar. Gerçek oturum kimliğinizi gizli tutun.

Kullanılabilir tetikleyicileri keşfedin

{"action":"getWorkflowTriggers","get":"list-1","apiid":"YOUR_SESSION"}

Geri çağrı şunu içerir: result.payload.triggers:

{"triggers":[{"flowId":"flow-123","flowName":"Intermission","trigger":"intermission"}]}

Adlandırılmış iş akışını çalıştırın

{
  "action": "triggerWorkflow",
  "value": {"trigger":"intermission","flowId":"flow-123","data":{"name":"Back shortly"}},
  "get": "run-1",
  "apiid": "YOUR_SESSION"
}

Benzersiz bir get dizesini her istek için kullanın. Başarılı geri çağrı şunu içerir: result.ok: true, result.status: "accepted", ve result.payload.matchedFlows. Kabul, etkin akışın bulunduğu ve çalıştırılmak üzere planlandığı anlamına gelir. Her gecikmeli eylemin, webhook'un, OBS çağrısının veya medya oynatımının tamamlandığı anlamına gelmez.

WebSocket

Şunu etkinleştirin: uzantının uzaktan API kontrolü SSN'de. Şuna bağlayın: wss://io.socialstream.ninja. Şununla katılın: {"join":"YOUR_SESSION","out":1,"in":2}, ardından yukarıdaki isteği gönderin. Kanal 1 kontrolleri; kanal 2 geri çağrıları taşır. İş akışları için sohbet kanalını etkinleştirmeniz gerekmez.

HTTP

Aynı uzaktan API kontrolü ayarını etkinleştirin. Kullanmadan önce oturum yer tutucusunu değiştirin:

POST https://io.socialstream.ninja/YOUR_SESSION
Content-Type: application/json

{"action":"triggerWorkflow","value":{"trigger":"intermission","data":{"name":"Back shortly"}}}

Basit bir adlandırılmış tetikleyici için şunu da kullanabilirsiniz: GET https://io.socialstream.ninja/YOUR_SESSION/triggerWorkflow/null/intermission. Dördüncü yol bölümü yapılandırılmış değerler için URL kodlamalı JSON içerebilir. Tüm JSON değerini şununla kodlayın: encodeURIComponent(JSON.stringify(value)). Özel gönderim kanalları şunu kullanır: ?channel=N.

P2P

Eklentinin varsayılan P2P modu, aynı veri yükünü SSN'nin mevcut VDO.Ninja veri kanalı aktarımı üzerinden gönderir. P2P için barındırılan WebSocket API anahtarı gerekmez. Mevcut P2P istemcileri bu isteği kurulu SSN kontrol bağlantıları üzerinden göndermelidir; yerel yapay zekâ API'sini açmak gerekmez.

Hatalar ve uyumluluk

• WORKFLOW_NOT_FOUND: tetikleyici/akış kimliğiyle eşleşen kayıtlı, etkin akış yok.
• INVALID_VALUE: eksik/geçersiz tetikleyici, hatalı JSON, geçersiz akış kimliği veya nesne olmayan veri.
• CONTROL_UNAVAILABLE: SSN veya uzaktan yayıncı kontrolü devre dışı.
• TARGET_UNAVAILABLE: Etkinlik Akışı hâlâ yükleniyor.
• Eski Social Stream varlıkları bu eylemleri bildirmeyebilir. Şunu kontrol edin: getCapabilities → ssn.actions.triggerWorkflow ve getWorkflowTriggers. Yeni tetikleyici ve güncellenen eklenti birlikte yüklü olmalıdır; tek başına SSApp sürüm numarası uzaktan yüklenen Social Stream varlıklarını belirlemez.

Onay kaybolduktan sonra durumu değiştiren çağrıyı otomatik tekrarlamayın: iş akışı zaten başlamış olabilir. Önce çıktısını kontrol edin. Bu API çalıştırma durumu kuyruğu sağlamaz.

Her entegrasyon ne gerektirir?

Tam Etkinlik Akışı kılavuzu · Tarifler · API başvuru kaynağı

Zamanlayıcı ve sohbet hareketleri

Zamanlayıcı: varsayılan olarak ±10 saniye için bir tık çevirin; çevirirken döner düğmeyi basılı tutun ±1 dakika için (yapılandırılan adımın 6 katı). Başlatmak/duraklatmak için çevirmeden basıp bırakın. Yenilemek için zamanlayıcı ekranına dokunun; şu ekranı sıfırlamak için basılı tutun. Yalnızca fiziksel döner düğmeyi basılı tutmak sıfırlamaz.

Sohbet İnceleme: eski sohbet için sola, yeni sohbet için sağa çevirin; incelenen mesajı sabitlemek için döner düğmeye basın. Sonraki sabitlenmiş mesajı öne çıkarmak için ekrana dokunun; incelenen mesajın sabitlemesini kaldırmak için ekranı basılı tutun. Varsayılan paneli açık tutun. WebSocket modunda 4. kanalda sohbet aktarmayı etkinleştirin.

Açın: Yardım ve tanılama → Kontroller, simgeler ve iş akışı kılavuzu eklenti içinde; tam çevrimdışı kılavuz, beş eylem türünün tamamı, tüm ön ayarlar/simgeler, sıfırlama davranışı, varsayılanlar ve sorun giderme için.

Etkinlik Akışı paleti başvuru kaynağı

Palette 45 tetikleyici, 67 eylem, beş mantık düğümü ve dört durum düğümü bulunur. Her kayıtta simgesinin yanında metin etiketi vardır. Ayarlarını ve entegrasyon ön koşullarını görmek için düğüm seçin; palet simgesi hedefin bağlı olduğunu kanıtlamaz.

Tetikleyiciler akışın ne zaman başlayacağını belirler. Gerektiğinde koşulları AND/OR ile bağlayın. Eylemler bağlandıkları sırayla çalışır. Durum düğümleri etkinlikler arasında değerleri hatırlar. Düğme bekleme süresi için şunu seçin: Hız Sınırlayıcı (THROTTLE) seçin, Gecikme eylemini değil: Gecikme her çalıştırmayı erteler ve tekrarlanan basışları engellemez.

Mesaj filtreleri, izleyici puanları ve hatırlanan kullanıcı eylemleri anlamlı mesaj/kullanıcı verisi gerektirir. Yayıncı düğmesi ne gerçek izleyici ne de kaynak yanıt hedefi sağlar. Yayıncı kontrollerini veya açıkça yapılandırılmış hedefi seçin; izleyici gibi davranmak için adlandırılmış iş akışı kullanmayın.

Ayrıntılı bağlantı için şuna bakın: Etkinlik Akışı kılavuzu, durum düğümleri kılavuzu, kullanıcı belleği kılavuzu, ve OBS kılavuzu.

Bir hatayı çözme

1. Önce basit bir Metin Göster akışı kullanın ve çıktısını doğrulayın.
2. Kaydedip etkinleştirin; Stream Deck iş akışı listesini yenileyin. Hem tetikleyici adını hem akış kimliğini doğrulayın.
3. SSN'nin etkin olduğunu, bağlantının Çevrimiçi olduğunu ve hedef katmanın aynı oturuma bağlı olduğunu doğrulayın.
4. Arama/doğrulama hataları için API geri çağrısını veya eklenti tanılama bilgilerini kontrol edin. Kabulden sonraki hatalar için hedefi ve Etkinlik Akışı çalışma zamanı günlüklerini inceleyin.
5. Diğer entegrasyonları teker teker ekleyin. Canlı kullanmadan önce tekrarlanan basışları, devre dışı akışı ve yeniden bağlantıyı test edin.

Düzenleyicinin normal sohbet test paneli sohbet etkinliği gönderir. Adlandırılmış API tetikleyicisi gibi davranmaz. Tüm yolu doğrulamak için bu tetikleyiciyi Stream Deck veya API üzerinden test edin.